Práce se seznamy
Seznam Microsoft Word dokument je soubor vlastností formátování seznamu. Seznamy lze použít ve vašich dokumentech pro formátování, uspořádání a zdůraznění textu. Seznamy jsou skvělým způsobem, jak zorganizovat data v dokumentech, a umožňují čtenářům pochopit klíčové body.
Každý seznam může mít až 9 úrovní a vlastnosti formátování, jako je například styl čísel, počáteční hodnota, odrážka, umístění záložky a další jsou definovány zvlášť pro každou úroveň.
Tento článek popisuje programově práci se seznamy pomocí Aspose.Words.
Tvorba seznamů pomocí formátování seznamu
Aspose.Words umožňuje snadné vytváření seznamů pomocí formátování seznamu. DocumentBuilder poskytuje ListFormat vlastnost, která vrací a ListFormat objekt. Tento objekt má několik metod ke spuštění a ukončení seznamu a ke zvýšení nebo snížení odrážky. Existují dva obecné typy seznamů v Microsoft Word: kulky a čísla:
- Chcete-li začít seznam kulky, zavolejte ListFormat.ApplyBulletDefault
- Chcete-li začít číslovaný seznam, zavolejte ListFormat.ApplyNumberDefault
Kulka nebo číslo a formátování jsou přidány do současného odstavce a všechny další odstavce vytvořené pomocí DocumentBuilder až RemoveNumbers se volá, aby zastavil formátování seznamu.
V dokumentech Word se seznamy mohou skládat až z devíti úrovní. Seznam formátování pro každou úroveň určuje, jaká kulka nebo číslo se používá, levá odrážka, prostor mezi kulkou a textem atd. Následující metody mění úroveň seznamu a uplatňují vlastnosti formátování nové úrovně:
- Pro zvýšení úrovně seznamu aktuálního odstavce o jednu úroveň volejte ListFormat.ListIndent
- Pro snížení úrovně seznamu aktuálního odstavce o jednu úroveň volejte ListFormat.ListOutdent
Metody mění úroveň seznamu a uplatňují formátovací vlastnosti nové úrovně.
Následující příklad kódu ukazuje, jak vytvořit víceúrovňový seznam:
Upřesnit formát pro úroveň seznamu
Objekty úrovně seznamu se vytvoří automaticky při vytvoření seznamu. Použijte vlastnosti a metody ListLevel třída pro kontrolu formátování jednotlivých úrovní seznamu.
Restartovat seznam pro každou část
Můžete restartovat seznam pro každou sekci pomocí IsRestartAtEachSection majetek. Všimněte si, že tato volba je podporována pouze ve formátech dokumentů RTF, DOC a DOCX. Tato volba bude zapsána do DOCX pouze v případě, že OoxmlCompliance je vyšší pak Ecma376.
Následující příklad kódu ukazuje, jak vytvořit seznam a restartovat pro každou sekci: