Praca z listami

Lista w dokumencie Microsoft Word to zestaw właściwości formatowania akapitu. List można używać w dokumentach do strukturyzowania, porządkowania i wyróżniania tekstu. Listy to świetny sposób organizowania danych w dokumentach w sposób ułatwiający czytelnikom przyswojenie i 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, położenie tabulacji i inne, są definiowane osobno dla każdego poziomu.

W Aspose.Words praca z listami jest reprezentowana przez przestrzeń nazw Lists. Jednak obiekt List zawsze należy do formatu ListCollection.

W tym artykule opisano programową pracę z listami przy użyciu formatu Aspose.Words.

Twórz listy, stosując formatowanie listy

Aspose.Words umożliwia łatwe tworzenie list poprzez zastosowanie formatowania list. DocumentBuilder udostępnia właściwość ListFormat, 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 ApplyBulletDefault
• Aby rozpocząć listę numerowaną, zadzwoń do ApplyNumberDefault

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 RemoveNumbers 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 ListIndent
• Aby zmniejszyć poziom listy bieżącego akapitu o jeden poziom, wywołaj ListOutdent

Możesz także użyć właściwości ListLevelNumber, aby uzyskać lub ustawić poziom listy dla akapitu.

Poziomy listy są ponumerowane od 0 do 8.

Poniższy przykład kodu 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 IsRestartAtEachSection. 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: