Работа със списъци
Списък в Microsoft Word документът е набор от свойства, форматиращи параграфа. Списъците могат да се използват в документи за структуриране, подреждане и подчертаване на текст. Списъците са чудесен начин да се организират данни в документи по начин, който прави лесно за читателите да абсорбират и разбират ключови точки.
Всеки списък може да има до 9 нива и форматиращи свойства като стил брой, начална стойност, вдлъбнатина, позиция подпрозорец и други се определят отделно за всяко ниво.
В Aspose.Words, работата със списъци е представена от Lists Имепространство. Все пак, List Обектът винаги принадлежи на ListCollection.
Тази статия описва programmically работа със списъци, използвайки Aspose.Words.
Създаване на списъци чрез форматиране на списъка
Aspose.Words позволява лесното създаване на списъци чрез прилагане на форматиране на списъка. DocumentBuilder осигурява ListFormat имот, който връща a ListFormat Възразявам. Този обект има няколко метода за стартиране и приключване на списък и за увеличаване / намаляване на тирето. Има два общи вида списъци в Microsoft Word: куршуми и номерирани:
- За да направиш списък с куршуми, се обади. ApplyBulletDefault
- За да започнете номериран списък, обадете се ApplyNumberDefault
Куршумът или броят и форматирането се добавят към настоящия параграф и всички допълнителни параграфи, създадени с помощта на DocumentBuilder до RemoveNumbers е призован да спре форматирането на списъка с куршуми.
В документите на Word списъците могат да се състоят от до девет нива. Форматиране на списък за всяко ниво определя какъв куршум или номер се използва, ляво тире, пространство между куршума и текста и т.н. Следните методи променят нивото на списъка и прилагат новото ниво на форматиране свойства:
- За да увеличите нивото на списъка на настоящия параграф с едно ниво, се обадете ListIndent
- За да намалите нивото на списъка на настоящия параграф с едно ниво, се обадете ListOutdent
Можете също така да използвате ListLevelNumber собственост, която да получи или определи нивото на списъка за параграфа.
Следният пример за код показва как да се изгради многостепенен списък:
Задаване на форматиране за ниво на списъка
Обектите на ниво списък се създават автоматично при създаването на списък. Използване на свойствата и методите на ListLevel клас за контрол на форматирането на отделните нива на списъка.
Рестартиране на списъка за всеки раздел
Можете да рестартирате списък за всеки раздел с помощта на IsRestartAtEachSection собственост. Имайте предвид, че тази опция се поддържа само във формати на RTF, DOC и DOX документ. Тази опция ще бъде написана на DOCX само ако OoxmlCompliance е по-висока от Ecma376.
Следният пример за код показва как да се създаде списък и да се рестартира за всеки раздел: