Nawigacja za pomocą kursora

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

W krótkim dokumencie poruszanie się po dokumencie jest proste, ponieważ punkt wstawiania można przesuwać nawet za pomocą klawiszy strzałek na klawiaturze lub klikając myszą, aby umieścić punkt wstawiania w dowolnym miejscu. Ale gdy masz duży dokument, który ma wiele stron, te podstawowe techniki okażą się niewystarczające.

W tym artykule wyjaśniono, jak poruszać się po dokumencie i nawigować wirtualnym kursorem do różnych jego części.

Wykrywanie aktualnej pozycji kursora

Przed rozpoczęciem procesu nawigacji po dokumencie musisz uzyskać aktualnie wybrany węzeł. Dokładną pozycję kursora w wybranym węźle można uzyskać za pomocą właściwości CurrentNode. Ponadto zamiast pobierać bieżący węzeł, można uzyskać aktualnie wybrany akapit lub aktualnie wybraną sekcję, korzystając z właściwości CurrentParagraph i CurrentSection.

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

Nawigowanie po metodach 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ę po dokumencie i przechodzenie do jego różnych sekcji i części – jest to podobne do funkcjonalności okienka nawigacji w Microsoft Word, umożliwiającego przejście do strony lub nagłówka w dokumencie Word bez przewijania.

Główną metodą jest możliwość przeniesienia 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ść na początek lub na koniec dokumentu, korzystając z metod MoveToDocumentStart i MoveToDocumentEnd.

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

Nawiguj za pomocą zakładek

Możesz zaznaczyć miejsce, które chcesz znaleźć i łatwo do niego ponownie przenieść. Możesz wstawić do dokumentu dowolną liczbę zakładek, a następnie przeglądać je, identyfikując zakładki za pomocą unikalnych nazw. Do zakładki można przejść metodą MoveToBookmark.

Poniższy przykład kodu pokazuje, jak przenieść pozycję kursora do zakładki:

Przejdź do komórek tabeli

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

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

Przejdź do pola

Do konkretnego pola w dokumencie możesz przejść korzystając z metody MoveToField. Ponadto możesz przejść do konkretnego pola scalania, korzystając z metody MoveToMergeField.

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

Przejdź do nagłówka lub stopki

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

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

Przejdź do sekcji lub akapitu

Możesz przejść do określonej sekcji lub akapitu, korzystając z metod MoveToParagraph lub MoveToSection. Ponadto można określić indeks, aby przenieść kursor do dowolnej pozycji lub określonego znaku w akapicie w ramach metody MoveToParagraph.

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