Praca z listami
Lista w dokumencie Microsoft Word to zestaw właściwości formatowania listy. List można używać w dokumentach do formatowania, porządkowania i podkreślania tekstu. Listy to świetny sposób organizowania danych w dokumentach i ułatwiają czytelnikom zrozumienie kluczowych punktów
Każda lista może mieć maksymalnie 9 poziomów, a właściwości formatowania, takie jak styl liczb, wartość początkowa, wcięcie, pozycja tabulacji itp. są definiowane osobno dla każdego poziomu.
W Aspose.Words pracę z listami reprezentuje moduł Lists. Jednak obiekt List zawsze należy do kolekcji ListCollection.
W tym temacie opisano, jak programowo pracować z listami przy użyciu formatu Aspose.Words
Tworzenie list poprzez zastosowanie formatowania listy
Aspose.Words umożliwia łatwe tworzenie list poprzez zastosowanie formatowania list. DocumentBuilder udostępnia właściwość DocumentBuilder.list_format, która zwraca obiekt ListFormat. Obiekt ten ma kilka metod rozpoczynania i kończenia listy oraz zwiększania/zmniejszania wcięcia. W Microsoft Word istnieją dwa ogólne typy list: wypunktowane i numerowane.
- Aby rozpocząć listę punktowaną, zadzwoń do ListFormat.apply_bullet_default.
- Aby rozpocząć listę numerowaną, zadzwoń do ListFormat.apply_number_default.
Punktor lub numer i formatowanie są dodawane do bieżącego akapitu i wszystkich kolejnych akapitów tworzonych przy użyciu formatu DocumentBuilder, dopóki nie zostanie wywołane ListFormat.remove_numbers w celu zatrzymania formatowania listy punktowanej.
W dokumentach programu Word listy mogą składać się z maksymalnie dziewięciu poziomów. Formatowanie listy dla każdego poziomu określa, jaki punktor lub numer jest używany, wcięcie z lewej strony, odstęp między punktorem a tekstem itp. Następujące metody zmieniają poziom listy i stosują właściwości formatowania nowego poziomu:
- Aby zwiększyć poziom listy bieżącego akapitu o jeden poziom, wywołaj ListFormat.list_indent
- Aby zmniejszyć poziom listy bieżącego akapitu o jeden poziom, wywołaj ListFormat.list_outdent
Metody zmieniają poziom listy i stosują właściwości formatowania nowego poziomu.
Poniższy przykład pokazuje jak zbudować listę wielopoziomową.
Określ formatowanie dla poziomu listy
Obiekty na poziomie listy są tworzone automatycznie podczas tworzenia listy. Użyj właściwości i metod klasy ListLevel do kontrolowania formatowania poszczególnych poziomów listy.
Lista ponownego uruchomienia dla każdej sekcji
Możesz zrestartować listę dla każdej sekcji, używając właściwości is_restart_at_each_section właściwość. Należy pamiętać, że ta opcja jest obsługiwana tylko w formatach dokumentów RTF, DOC i DOCX. Ta opcja zostanie zapisana w DOCX tylko wtedy, gdy zgodność Ooxml jest wyższa niż Ecma376.
Poniższy przykład kodu pokazuje, jak utworzyć listę i uruchomić ją ponownie dla każdej sekcji: