Navigazione con Cursor

Mentre si lavora con un documento, anche se è breve o lungo, è necessario navigare attraverso il documento. La navigazione con un cursore virtuale rappresenta la possibilità di navigare tra diversi nodi in un documento.

All’interno di un breve documento, muoversi in un documento è semplice come è possibile spostare il punto di inserimento anche utilizzando i tasti freccia della tastiera o facendo clic sul mouse per individuare il punto di inserimento ovunque si desidera. Ma una volta che avete un grande documento che ha molte pagine, queste tecniche di base saranno insufficienti.

Questo articolo spiega come muoversi in un documento e navigare con un cursore virtuale in diverse parti di esso.

Rilevamento della posizione attuale

Prima di iniziare il processo di navigazione attraverso il documento, è necessario ottenere il nodo che è attualmente selezionato. È possibile ottenere la posizione esatta del cursore su un nodo selezionato utilizzando il CurrentNode proprieta'. Inoltre, invece di ottenere il nodo corrente, è possibile ottenere il paragrafo attualmente selezionato o la sezione attualmente selezionata utilizzando il CurrentParagraph e CurrentSection proprietà.

Tutte le operazioni di inserto eseguite utilizzando DocumentBuilder sarà inserito prima del CurrentNode. Quando il paragrafo corrente è vuoto o il cursore è posizionato poco prima della fine del paragrafo, il CurrentNode restituisce null.

Metodi di navigazione in un documento

Quando si sta modificando il testo, è importante sapere come navigare il documento e dove esattamente muoversi in esso. Aspose.Words consente di muoversi in un documento e di navigare nelle sue diverse sezioni e parti – questo è simile alla funzionalità del riquadro di spostamento in Microsoft Word andare a una pagina o in un documento di Word senza scorrere.

Il metodo principale è quello di essere in grado di spostare la posizione del cursore in un nodo specifico nel documento, è possibile ottenere questo utilizzando il MoveTo metodo.

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

Ma oltre alla base MoveTo metodo, ci sono più specifici.

È possibile andare all’inizio o alla fine del documento utilizzando il MoveToDocumentStart e MoveToDocumentEnd metodi.

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

Si può segnare un posto che si desidera trovare e muoversi di nuovo facilmente. È possibile inserire il maggior numero di segnalibri nel documento che si desidera, e quindi navigare attraverso di loro identificando i segnalibri con nomi unici. È possibile passare a un segnalibro utilizzando il MoveToBookmark metodo.

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

Passare a celle da tavolo

È possibile passare a una cella di tabella utilizzando MoveToCell metodo. Questo metodo consente di navigare il cursore in qualsiasi cella in una tabella specifica. Inoltre, è possibile specificare un indice per spostare il cursore in qualsiasi posizione o carattere specificato in una cella all’interno della MoveToCell metodo.

Il seguente esempio di codice mostra come spostare una posizione del cursore in una cella di tabella specificata:

È possibile passare a un campo specifico nel documento utilizzando MoveToField metodo. Inoltre, è possibile passare a un campo di fusione specifico utilizzando MoveToMergeField metodo.

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

È possibile passare all’inizio di un intestazione o piè di pagina utilizzando il MoveToHeaderFooter metodo

Il seguente esempio di codice mostra come spostare il cursore del costruttore di documenti in un’intestazione del documento o un piè di pagina:

È possibile passare a una specifica sezione o paragrafo utilizzando MoveToParagraph o MoveToSection metodi. Inoltre, è possibile specificare un indice per spostare il cursore in qualsiasi posizione o un carattere specificato in un paragrafo all’interno del MoveToParagraph metodo.

Il seguente esempio di codice mostra come passare a una sezione specifica e a un paragrafo specifico in un documento:

Uso `DocumentBuilder` per inserire elementi di documento