Lavorare con Segnalibri
Segnalibri identificarsi in un Microsoft Word documentare le posizioni o i frammenti che si nomina e identificare per riferimento futuro. Ad esempio, si potrebbe utilizzare un segnalibro per identificare il testo che si desidera rivedere in seguito. Invece di scorrere attraverso il documento per individuare il testo, è possibile andare a esso utilizzando la finestra di dialogo Segnalibro.
Con Aspose.Words, è possibile utilizzare segnalibri in report o documenti per inserire alcuni dati nel bookmark o applicare una formattazione speciale al suo contenuto. È inoltre possibile utilizzare segnalibri per recuperare il testo da una determinata posizione nel documento.
Le azioni che possono essere eseguite con segnalibri utilizzando Aspose.Words sono gli stessi di quelli che puoi eseguire utilizzando Microsoft Word. È possibile inserire un nuovo segnalibro, eliminare, passare a un segnalibro, ottenere o impostare un nome del segnalibro, ottenere o impostare il testo racchiuso in esso.
Inserisci un segnalibro
Uso startBookmark e endBookmark per creare un segnalibro marcando il suo inizio e la sua fine, rispettivamente. Non dimenticare di passare lo stesso nome del segnalibro a entrambi i metodi. I segnalibri in un documento possono sovrapporre e abbracciare qualsiasi intervallo. Segnalibri o segnalibri mal formati con nomi duplicati verranno ignorati quando il documento viene salvato.
Il seguente esempio di codice mostra come creare un nuovo segnalibro:
Ottenere segnalibri
A volte è necessario ottenere una raccolta di segnalibri per iterare attraverso segnalibri o per altri scopi. Utilizzare Node.getRange proprietà esposta da qualsiasi nodo documento che restituisce un Range oggetto che rappresenta la parte del documento contenuto in questo nodo. Utilizzare questo oggetto per recuperare un BookmarkCollection e quindi utilizzare l’indicizzatore di raccolta per ottenere un segnalibro specifico.
Il seguente esempio di codice mostra come ottenere segnalibri da una raccolta di segnalibri:
Il seguente esempio di codice mostra come ottenere o impostare un nome e un testo del segnalibro:
Il seguente esempio di codice mostra come bookmark una tabella:
Se si modifica il nome di un segnalibro a un nome che esiste già nel documento, nessun errore verrà generato e solo il primo segnalibro verrà memorizzato quando si salva il documento.
Si noti che alcuni segnalibri nel documento sono assegnati a campi di forma. Passare a un tale segnalibro e inserire il testo lì inserisce il testo nel codice campo del modulo. Anche se questo non invaliderà il campo di forma, il testo inserito non sarà visibile perché diventa parte del codice di campo.
Il seguente esempio di codice mostra come accedere alle colonne della tabella segnalibro:
Spostarsi in un segnalibro
Se è necessario inserire contenuti ricchi (non solo testo normale) in un segnalibro, si dovrebbe utilizzare moveToBookmark per spostare il cursore sul segnalibro e quindi utilizzare DocumentBuilder metodi e proprietà per inserire contenuti.
Mostra contenuti preferiti
L’intero Segnalibro (compreso il contenuto segnalato) può essere incapsulato nella parte vera della IF campo usando Aspose.Words. Può essere in modo tale che IF il campo contiene un campo di concentramento nidificato nell’espressione (Left of Operator) e a seconda del valore di Campo di fusione, il IF campo mostra o nasconde il contenuto di Bookmark in Word Document.
Il seguente esempio di codice mostra come mostrare / nascondere segnalibri.