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: