Praca z zakładkami
Zakładki identyfikują w dokumencie Microsoft Word lokalizacje lub fragmenty, które nadajesz i identyfikujesz do wykorzystania w przyszłości. Możesz na przykład użyć zakładki, aby zidentyfikować tekst, który chcesz później sprawdzić. Zamiast przewijać dokument w celu zlokalizowania tekstu, możesz przejść do niego, korzystając z okna dialogowego Zakładka.
Działania, które można wykonać na zakładkach przy użyciu Aspose.Words, są takie same, jak te, które można wykonać przy użyciu Microsoft Word. Możesz wstawić nową zakładkę, usunąć, przejść do zakładki, uzyskać lub ustawić nazwę zakładki, uzyskać lub ustawić zawarty w niej tekst.
Wstaw zakładkę
Użyj StartBookmark i EndBookmark, aby utworzyć zakładkę, zaznaczając odpowiednio jej początek i koniec. Nie zapomnij przekazać tej samej nazwy zakładki do obu metod. Zakładki w dokumencie mogą nakładać się na siebie i obejmować dowolny zakres. Źle utworzone zakładki lub zakładki ze zduplikowanymi nazwami zostaną zignorowane podczas zapisywania dokumentu.
Poniższy przykład kodu pokazuje, jak utworzyć nową zakładkę:
Zdobądź zakładki
Czasami konieczne jest uzyskanie kolekcji zakładek w celu przeglądania zakładek lub w innych celach. Użyj właściwości Node.Range dostępnej w dowolnym węźle dokumentu, który zwraca obiekt Range reprezentujący część dokumentu zawartą w tym węźle. Użyj tego obiektu, aby pobrać plik BookmarkCollection, a następnie użyj indeksatora kolekcji, aby uzyskać określoną zakładkę.
Poniższy przykład kodu pokazuje, jak uzyskać zakładki z kolekcji zakładek:
Poniższy przykład kodu pokazuje, jak uzyskać lub ustawić nazwę i tekst zakładki:
Poniższy przykład kodu pokazuje, jak dodać tabelę do zakładek:
Jeśli zmienisz nazwę zakładki na nazwę, która już istnieje w dokumencie, nie zostanie wygenerowany żaden błąd i podczas zapisywania dokumentu zostanie zapisana tylko pierwsza zakładka.
Należy pamiętać, że niektóre zakładki w dokumencie są przypisane do pól formularzy. Przejście do takiej zakładki i wstawienie tam tekstu powoduje wstawienie tekstu do kodu pola formularza. Chociaż nie spowoduje to unieważnienia pola formularza, wstawiony tekst nie będzie widoczny, ponieważ stanie się częścią kodu pola.
Poniższy przykład kodu pokazuje, jak uzyskać dostęp do kolumn tabeli z zakładkami:
Przejdź do zakładki
Jeśli chcesz wstawić bogatą zawartość (nie tylko zwykły tekst) do zakładki, powinieneś użyć MoveToBookmark, aby przesunąć kursor do zakładki, a następnie użyć metod i właściwości DocumentBuilder’s, aby wstawić treść.
Pokaż Ukryj zawartość zakładek
Całą zakładkę (łącznie z zawartością zakładek) można umieścić w części True pola IF przy użyciu formatu Aspose.Words. Może być tak, że pole IF zawiera zagnieżdżone w wyrażeniu pole scalania (na lewo od operatora) i w zależności od wartości pola scalania pole IF pokazuje lub ukrywa zawartość Zakładki w dokumencie Word.
Poniższy przykład kodu pokazuje, jak pokazać/ukryć zakładki: