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à current_node. Inoltre, invece di ottenere il nodo corrente, puoi ottenere il paragrafo o la sezione attualmente selezionati utilizzando le proprietà current_paragraph e current_section.

Qualsiasi operazione di inserimento eseguita utilizzando DocumentBuilder verrà inserita prima di current_node. Quando il paragrafo corrente è vuoto o il cursore è posizionato appena prima della fine del paragrafo, il current_node restituisce None.

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 move_to.

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

Ma oltre al metodo move_to 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 move_to_document_start e move_to_document_end.

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 move_to_bookmark.

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 move_to_cell. 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 move_to_cell.

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 move_to_field. Inoltre, puoi spostarti in un campo unione specifico utilizzando il metodo move_to_merge_field.

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 move_to_header_footer

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 move_to_paragraph o move_to_section. Inoltre, puoi specificare un indice per spostare il cursore in qualsiasi posizione o carattere specificato in un paragrafo all’interno del metodo move_to_paragraph.

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