Navigazione con il cursore

Mentre lavori con un documento, anche se è breve o lungo, dovrai navigare all’interno del documento. La navigazione con un cursore virtuale rappresenta la possibilità di navigare tra diversi nodi in un documento.

All’interno di un documento breve, spostarsi all’interno di un documento è semplice poiché puoi spostare il punto di inserimento anche utilizzando i tasti freccia della tastiera o facendo clic con il mouse per posizionare il punto di inserimento dove preferisci. Ma una volta che hai un documento di grandi dimensioni con molte pagine, queste tecniche di base saranno insufficienti.

Questo articolo spiega come spostarsi all’interno di un documento e navigare con un cursore virtuale nelle diverse parti di esso.

Rilevamento della posizione corrente del cursore

Prima di iniziare il processo di navigazione nel documento, dovrai ottenere il nodo attualmente selezionato. Puoi ottenere la posizione esatta del cursore su un nodo selezionato utilizzando la proprietà CurrentNode. Inoltre, invece di ottenere il nodo corrente, puoi ottenere il paragrafo o la sezione attualmente selezionati utilizzando le proprietà CurrentParagraph e CurrentSection.

Qualsiasi operazione di inserimento eseguita utilizzando DocumentBuilder verrà inserita prima di CurrentNode. Quando il paragrafo corrente è vuoto o il cursore è posizionato subito prima della fine del paragrafo, l'CurrentNode restituisce null.

Metodi di navigazione in un documento

Quando modifichi il testo, è importante sapere come navigare nel documento e dove spostarti esattamente al suo interno. Aspose.Words ti consente di spostarti in un documento e navigare nelle sue diverse sezioni e parti: è simile alla funzionalità del riquadro di spostamento in Microsoft Word per andare a una pagina o un’intestazione in un documento Word senza scorrere.

Il metodo principale è poter spostare la posizione del cursore su un nodo specifico nel documento, puoi ottenerlo utilizzando il metodo MoveTo.

Il seguente esempio di codice mostra come spostare il DocumentBuilder su diversi nodi in un documento:

Ma oltre al metodo MoveTo di base, ce ne sono altri più specifici.

Passare all’inizio o alla fine di un documento

Puoi andare all’inizio o alla fine del tuo documento utilizzando i metodi MoveToDocumentStart e MoveToDocumentEnd.

L’esempio di codice seguente mostra come spostare la posizione del cursore all’inizio o alla fine di un documento:

Puoi contrassegnare un luogo che desideri trovare e spostarti di nuovo facilmente. Puoi inserire tutti i segnalibri che desideri nel tuo documento, quindi spostarti al loro interno identificando i segnalibri con nomi univoci. È possibile spostarsi su un segnalibro utilizzando il metodo MoveToBookmark.

I seguenti esempi di codice mostrano come spostare la posizione del cursore su un segnalibro:

Passare a Celle della tabella

Puoi spostarti in una cella della tabella utilizzando il metodo MoveToCell. Questo metodo ti consentirà di spostare il cursore in qualsiasi cella di una tabella specifica. Inoltre, puoi specificare un indice per spostare il cursore in qualsiasi posizione o carattere specificato in una cella all’interno del metodo MoveToCell.

L’esempio di codice seguente mostra come spostare la posizione del cursore su una cella di tabella specificata:

Passare a un campo

Puoi spostarti in un campo specifico nel tuo documento utilizzando il metodo MoveToField. Inoltre, puoi spostarti in un campo unione specifico utilizzando il metodo MoveToMergeField.

Il seguente esempio di codice mostra come spostare il cursore del generatore di documenti su un campo specifico:

Passare a un’intestazione o a un piè di pagina

Puoi spostarti all’inizio di un’intestazione o di un piè di pagina utilizzando il metodo MoveToHeaderFooter

Il seguente esempio di codice mostra come spostare il cursore del generatore di documenti sull’intestazione o sul piè di pagina del documento:

Passare a una sezione o un paragrafo

Puoi spostarti a una sezione o paragrafo specifico utilizzando i metodi MoveToParagraph o MoveToSection. Inoltre, puoi specificare un indice per spostare il cursore in qualsiasi posizione o in un carattere specificato in un paragrafo all’interno del metodo MoveToParagraph.

L’esempio di codice seguente mostra come spostarsi a una sezione specifica e a un paragrafo specifico in un documento: