Nawigacja z kursorem

Podczas pracy z dokumentem, nawet jeśli jest on krótki lub długi, musisz poruszać się po dokumencie. Nawigacja za pomocą wirtualnego kursora reprezentuje możliwość poruszania się między różnymi węzłami w dokumencie.

W krótkim dokumencie poruszanie się w dokumencie jest proste, ponieważ możesz przesunąć punkt wstawiania nawet za pomocą klawiszy strzałek na klawiaturze lub klikając myszką, aby zlokalizować punkt wstawiania w dowolnym miejscu. Ale gdy masz duży dokument, który ma wiele stron, te podstawowe techniki będą niewystarczające.

W tym artykule wyjaśniono, jak poruszać się w dokumencie i nawigować za pomocą wirtualnego kursora do różnych jego części.

Wykrywanie Aktualnej Pozycji Kursora

Przed rozpoczęciem procesu poruszania się po dokumencie musisz uzyskać aktualnie wybrany węzeł. Dokładne położenie kursora w wybranym węźle można uzyskać za pomocą właściwości CurrentNode. Ponadto zamiast pobierać bieżący węzeł, możesz uzyskać aktualnie wybrany akapit lub aktualnie wybraną sekcję, używając właściwości CurrentParagraph i CurrentSection.

Wszelkie operacje wstawiania wykonywane przy użyciu DocumentBuilder zostaną wstawione przed CurrentNode. Gdy bieżący akapit jest pusty lub kursor znajduje się tuż przed końcem akapitu, CurrentNode zwraca nullptr.

Metody nawigacji w dokumencie

Podczas edycji tekstu ważne jest, aby wiedzieć, jak poruszać się po dokumencie i gdzie dokładnie się w nim poruszać. Aspose.Words umożliwia poruszanie się w dokumencie i przechodzenie do jego różnych sekcji i części – jest to podobne do funkcji okienka nawigacji w Microsoft Word, aby przejść do strony lub nagłówka w dokumencie Word bez przewijania.

Główną metodą jest przesunięcie pozycji kursora do określonego węzła w dokumencie, można to osiągnąć za pomocą metody MoveTo.

Poniższy przykład kodu pokazuje, jak przenieść DocumentBuilder do różnych węzłów w dokumencie:

Ale oprócz podstawowej metody MoveTo istnieją bardziej szczegółowe.

Przejdź do początku lub końca dokumentu

Możesz przejść do początku lub końca dokumentu za pomocą metod MoveToDocumentStart i MoveToDocumentEnd.

Poniższy przykład kodu pokazuje, jak przesunąć pozycję kursora na początek lub koniec dokumentu:

Nawiguj Za Pomocą Zakładek

Możesz zaznaczyć miejsce, które chcesz znaleźć i łatwo się do niego przenieść. Możesz wstawić do dokumentu dowolną liczbę zakładek, a następnie poruszać się po nich, identyfikując zakładki z unikalnymi nazwami. Możesz przejść do zakładki za pomocą metody MoveToBookmark.

Poniższe przykłady kodu pokazują, jak przenieść pozycję kursora do zakładki:

Przejdź do komórek tabeli

Możesz przejść do komórki tabeli za pomocą metody MoveToCell. Ta metoda umożliwi nawigację kursorem do dowolnej komórki w określonej tabeli. Ponadto można określić indeks, aby przesunąć kursor do dowolnej pozycji lub określonego znaku w komórce w metodzie MoveToCell.

Poniższy przykład kodu pokazuje, jak przenieść pozycję kursora do określonej komórki tabeli:

Przejdź do pola

Możesz przejść do określonego pola w dokumencie za pomocą metody MoveToField. Ponadto możesz przejść do określonego pola scalania za pomocą metody MoveToMergeField.

Poniższy przykład kodu pokazuje, jak przenieść kursor kreatora dokumentów do określonego pola:

Przejdź do nagłówka lub stopki

Możesz przejść na początek nagłówka lub stopki, używając metody MoveToHeaderFooter.

Poniższy przykład kodu pokazuje, jak przenieść kursor kreatora dokumentów do nagłówka lub stopki dokumentu:

Przejdź do sekcji lub akapitu

Możesz przejść do określonej sekcji lub akapitu, używając metod MoveToParagraph LUB MoveToSection. Ponadto można określić indeks, aby przesunąć kursor do dowolnej pozycji lub określonego znaku w akapicie w metodzie MoveToParagraph.

Poniższy przykład kodu pokazuje, jak przejść do określonej sekcji i określonego akapitu w dokumencie: