Nawigacja kursorem
Podczas pracy z dokumentem, nawet jeśli jest krótki lub długi, trzeba będzie przejść przez dokument. Nawigacja z wirtualnym kursorem reprezentuje zdolność do nawigacji między różnymi węzłami w dokumencie.
W krótkim dokumencie, poruszanie się w dokumencie jest proste, ponieważ można przenieść punkt wprowadzania nawet za pomocą klawiszy strzałek klawiatury lub klikając myszką, aby zlokalizować punkt wprowadzania, gdzie chcesz. Ale kiedy masz duży dokument, który ma wiele stron, te podstawowe techniki będą niewystarczające.
Ten artykuł wyjaśnia jak poruszać się w dokumencie i poruszać się z wirtualnym kursorem do różnych jego części.
Wykrywanie bieżącej pozycji kursora
Przed rozpoczęciem procesu nawigacji przez dokument, trzeba będzie uzyskać węzeł, który jest aktualnie wybrany. Możesz uzyskać dokładną pozycję kursora w wybranym węźle za pomocą CurrentNode nieruchomości. Ponadto, zamiast uzyskania bieżącego węzła, można uzyskać wybrany obecnie akapit lub aktualnie wybraną sekcję za pomocą CurrentParagraph oraz CurrentSection nieruchomości.
Wszelkie operacje wstawiania wykonywane przy użyciu DocumentBuilder zostaną wprowadzone przed CurrentNode. Gdy bieżący akapit jest pusty lub kursor jest umieszczony tuż przed końcem akapitu, CurrentNode zwraca null.
Metody nawigacji w dokumencie
Podczas edycji tekstu ważne jest, aby wiedzieć, jak poruszać się po dokumencie i gdzie dokładnie przenieść się w nim. Aspose.Words pozwala poruszać się w dokumencie i poruszać się do różnych sekcji i części - jest to podobne do funkcjonalności panela nawigacyjnego w Microsoft Word przejść do strony lub nagłówka w dokumencie Word bez przewijania.
Głównym sposobem jest możliwość przesunięcia pozycji kursora do określonego węzła w dokumencie, można to osiągnąć za pomocą MoveTo Metoda.
Poniższy przykład kodu pokazuje jak przenieść DocumentBuilder do różnych węzłów w dokumencie:
Ale poza podstawowymi MoveTo Metoda, są bardziej konkretne.
Przejdź do początku lub końca dokumentu
Można przejść do początku lub końca dokumentu za pomocą MoveToDocumentStart oraz MoveToDocumentEnd metody.
Poniższy przykład kodu pokazuje jak przenieść pozycję kursora na początek lub koniec dokumentu:
Nawigacja z zakładkami
Możesz zaznaczyć miejsce, które chcesz znaleźć i przejść do niego ponownie łatwo. Można umieścić w dokumencie tyle zakładek, ile chcesz, a następnie przejść przez nie poprzez identyfikację zakładek o unikalnych nazwach. Można przejść do zakładki za pomocą MoveToBookmark Metoda.
Poniższe przykłady kodowe pokazują jak przenieść pozycję kursora do zakładki:
Nawigacja do komórek tabeli
Można przenieść się do komórki tabeli za pomocą MoveToCell Metoda. Metoda ta pozwala na nawigację kursora do dowolnej komórki w określonej tabeli. Dodatkowo, możesz określić indeks, aby przenieść kursor do dowolnej pozycji lub określonego znaku w komórce wewnątrz MoveToCell Metoda.
Poniższy przykład kodu pokazuje jak przenieść pozycję kursora do określonej komórki tabeli:
Przejdź na pole
Można przenieść się do określonego pola w dokumencie za pomocą MoveToField Metoda. Dodatkowo, można przejść do konkretnego pola połączenia za pomocą MoveToMergeField Metoda.
Poniższy przykład kodu pokazuje jak przenieść kursor konstruktora dokumentu do określonego pola:
Przejdź do nagłówka lub footera
Można przejść do początku nagłówka lub stopki za pomocą MoveToHeaderFooter Metoda
Poniższy przykład kodu pokazuje jak przenieść kursor builder dokumentu do nagłówka lub stopki dokumentu:
Przejdź do sekcji lub ustępu
Można przejść do określonej sekcji lub paragrafu za pomocą MoveToParagraph lub MoveToSection metody. Dodatkowo, możesz określić indeks, aby przenieść kursor do dowolnej pozycji lub określonego znaku w akapicie w MoveToParagraph Metoda.
Poniższy przykład kodu pokazuje, jak przejść do konkretnej sekcji i konkretnego akapitu w dokumencie: