Lavorare con i segnalibri
I segnalibri identificano in un documento Microsoft Word le posizioni o i frammenti che nomini e identifichi per riferimento futuro. Ad esempio, potresti utilizzare un segnalibro per identificare il testo che desideri rivedere in seguito. Invece di scorrere il documento per individuare il testo, puoi accedervi utilizzando la finestra di dialogo Segnalibro.
Le azioni che possono essere eseguite con i segnalibri utilizzando Aspose.Words sono le stesse che puoi eseguire utilizzando Microsoft Word. È possibile inserire un nuovo segnalibro, eliminare, spostarsi in un segnalibro, ottenere o impostare il nome di un segnalibro, ottenere o impostare il testo racchiuso al suo interno. Con Aspose.Words è inoltre possibile utilizzare i segnalibri nei report o nei documenti per inserire alcuni dati nel segnalibro o applicare una formattazione speciale al relativo contenuto. Puoi anche utilizzare i segnalibri per recuperare testo da una determinata posizione nel documento.
Inserisci un segnalibro
Utilizza start_bookmark e end_bookmark per creare un segnalibro contrassegnandone rispettivamente l’inizio e la fine. Non dimenticare di passare lo stesso nome del segnalibro a entrambi i metodi. I segnalibri in un documento possono sovrapporsi e estendersi su qualsiasi intervallo. I segnalibri formati in modo errato o i segnalibri con nomi duplicati verranno ignorati quando il documento viene salvato.
L’esempio di codice seguente mostra come creare un nuovo segnalibro:
Ottieni segnalibri
A volte è necessario ottenere una raccolta di segnalibri per scorrere i segnalibri o per altri scopi. Utilizza la proprietà Node.range esposta da qualsiasi nodo di documento che restituisce un oggetto Range che rappresenta la parte del documento contenuta in questo nodo. Utilizzare questo oggetto per recuperare un BookmarkCollection e quindi utilizzare l’indicizzatore della raccolta per ottenere un segnalibro specifico.
L’esempio di codice seguente mostra come ottenere segnalibri da una raccolta di segnalibri:
L’esempio di codice seguente mostra come ottenere o impostare il nome e il testo di un segnalibro:
L’esempio di codice seguente mostra come aggiungere un segnalibro a una tabella:
Se si modifica il nome di un segnalibro con un nome già esistente nel documento, non verrà generato alcun errore e quando si salva il documento verrà memorizzato solo il primo segnalibro.
Tieni presente che alcuni segnalibri nel documento sono assegnati a campi modulo. Passando a un segnalibro di questo tipo e inserendovi del testo, il testo viene inserito nel codice del campo del modulo. Sebbene ciò non invaliderà il campo del modulo, il testo inserito non sarà visibile perché diventa parte del codice del campo.
L’esempio di codice seguente mostra come accedere alle colonne della tabella con segnalibri:
Passare a un segnalibro
Se è necessario inserire contenuto avanzato (non solo testo semplice) in un segnalibro, è necessario utilizzare move_to_bookmark per spostare il cursore sul segnalibro e quindi utilizzare i metodi e le proprietà DocumentBuilder’s per inserire il contenuto.
Mostra Nascondi contenuto segnalibro
L’intero segnalibro (incluso il contenuto aggiunto ai segnalibri) può essere incapsulato nella parte vera del campo IF utilizzando Aspose.Words. Può succedere che il campo IF contenga un campo unione nidificato nell’espressione (a sinistra dell’operatore) e, a seconda del valore del campo unione, il campo IF mostra o nasconde il contenuto del segnalibro nel documento Word.
Il seguente esempio di codice mostra come mostrare/nascondere i segnalibri: