Navigare cu cursorul mouse-ului

Când lucrezi cu un document, chiar dacă este scurt sau lung, va trebui să navighezi prin documentul tău. Navigarea cu un cursor virtual reprezintă capacitatea de a naviga între noduri diferite dintr-un document.

În cadrul unui document scurt, navigarea este simplă deoarece poți muta punctul de inserare și prin intermediul tastelor săgeată ale tastaturii sau făcând clic cu butonul mouse-ului pentru a plasa punctul de inserare oriunde dorești. Dar odată ce ai un document mare care are multe pagini, aceste tehnici de bază vor fi insuficiente.

Acest articol explică modul în care se poate deplasa într-un document și naviga cu un cursor virtual către diferite părți ale acestuia.

Detectarea poziţiei cursorului curent

Înainte de a începe procesul de navigare prin documentul dvs., va trebui să obțineți nodul care este selectat în prezent. Poți obține poziția exactă a cursorului la un nod selectat folosind proprietatea CurrentNode. În plus, în loc să obții nodul curent, poți obține paragraful selectat sau secțiunea selectată folosind proprietățile CurrentParagraph și CurrentSection.

“Orice operații de inserare pe care le efectuați folosind DocumentBuilder vor fi introduse înaintea CurrentNode”. Când paragraf actual este gol sau cursorul este poziționat chiar înainte de sfârşitul paragrafului, CurrentNode returnează null.

Metodele de navigare într-un document

Când editezi un text, este important să știi cum să navighezi prin document și unde exact să te deplasezi. Aspose.Words îți permite să te deplasezi în cadrul unui document și să navighezi către diferitele secțiuni și părți ale acestuia – acest lucru asemănător funcționalității panoului de navigare din Microsoft Word pentru a ajunge la o pagină sau o antet dintr-un document Word fără a derula.

Metoda principală este să poți muta poziția cursorului la un anumit nod din documentul tău; poți realiza acest lucru folosind metoda MoveTo.

Exemplul următor de cod arată cum să mutați DocumentBuilder la noduri diferite într-un document:

Dar, pe lângă metoda de bază MoveTo, există metode mai specifice.

Puteți să mergeți la începutul sau sfârșitul documentului dvs. folosind MoveToDocumentStart și MoveToDocumentEnd metodele.

Exemplul următor de cod arată cum să mute poziția cursorului la începutul sau sfârșitul unui document:

Poţi marca un loc pe care vrei să-l găseşti şi te poţi deplasa cu uşurinţă către el din nou. Puteți insera în documentul dumneavoastră atâtea semnale de carte cât doriți și apoi să navigați prin ele identificându-le pe cele cu nume unice. Puteți muta la un marcaj folosind metoda MoveToBookmark.

Următorul exemplu de cod arată cum se mută poziția cursorului către un bookmark:

Poţi să te muţi într-o celulă de tabel folosind MoveToCell metoda. Această metodă va permite să navigați cursorul către orice celulă într-o anumită tabelă. “În plus, puteți specifica un indice pentru a muta cursorul la orice poziție sau la un caracter specific într-o celulă în metoda MoveToCell.”

Exemplul de cod următor arată cum să se mute poziția cursorului într-o anumită celulă de tabelă:

Puteți să vă mutați către un anumit câmp în documentul dvs. folosind metoda MoveToField. În plus, poți să te muți la un câmp specific prin folosirea metodei MoveToMergeField.

Exemplul următor de cod arată cum să mutați cursorul constructorului de documente către un câmp specific:

Puteți să vă mutați la începutul unui antet sau subsol folosind MoveToHeaderFooter metoda

Exemplul de cod următor arată cum se deplasează cursorul constructorului de documente la un antet sau subsol de document:

Puteți să treceți la o secțiune sau paragraf specific folosind MoveToParagraph sau MoveToSection metode. În plus, poți specifica un index pentru a muta cursorul la orice poziție sau un caracter specific într-un paragraf folosind metoda MoveToParagraph.

Exemplul următor de cod arată cum să se meargă la o secțiune și un paragraf specific într-un document: