Работа със списъци

Списък в Microsoft Word документът е набор от свойства за форматиране на списъка. Списъците могат да се използват във вашите документи за форматиране, подреждане и подчертаване на текст. Списъците са чудесен начин да се организират данни в документи, и те правят по-лесно за читателите да разберат ключови точки

Всеки списък може да има до 9 нива и форматиращи свойства, като стил номер, начална стойност, тире, позиция подпрозорец и т.н. се определят отделно за всяко ниво.

В Aspose.Words, работата със списъци е представена от Lists модул. Все пак, List Обектът винаги принадлежи на ListCollection Колекция.

Тази тема описва как да се работи programmatically със списъци използване Aspose.Words

Създаване на списъци чрез прилагане на списък форматиране

Aspose.Words позволява лесното създаване на списъци чрез прилагане на форматиране на списъка. DocumentBuilder осигурява DocumentBuilder.list_format имот, който връща a ListFormat Възразявам. Този обект има няколко метода за стартиране и приключване на списък и за увеличаване / намаляване на тирето. Има два общи вида списъци в Microsoft WordКуршум и номериран.

• За да направиш списък с куршуми, се обади. ListFormat.apply_bullet_default.
• За да започнете номериран списък, обадете се ListFormat.apply_number_default.

Куршумът или броят и форматирането се добавят към настоящия параграф и всички допълнителни параграфи, създадени с помощта на DocumentBuilder до ListFormat.remove_numbers е призован да спре форматирането на списъка с куршуми.

В документите на Word списъците могат да се състоят от до девет нива. Форматиране на списък за всяко ниво определя какъв куршум или номер се използва, ляво тире, пространство между куршума и текста и т.н. Следните методи променят нивото на списъка и прилагат новото ниво на форматиране свойства:

• За да увеличите нивото на списъка на настоящия параграф с едно ниво, се обадете ListFormat.list_indent
• За да намалите нивото на списъка на настоящия параграф с едно ниво, се обадете ListFormat.list_outdent

Методите променят нивото на списъка и прилагат форматиращите свойства на новото ниво.

Можете също така да използвате ListFormat.list_level_number собственост, която да получи или определи нивото на списъка за параграфа. Нивата на списъка са номерирани от 0 до 8.

По-долу пример показва как да се изгради многостепенен списък.

Задаване на форматиране за ниво на списъка

Обектите на ниво списък се създават автоматично при създаването на списък. Използване на свойствата и методите на ListLevel клас за контрол на форматирането на отделните нива на списъка.

Рестартиране на списъка за всеки раздел

Можете да рестартирате списък за всеки раздел с помощта на е_restart_at_each_section имот собственост. Имайте предвид, че тази опция се поддържа само във формати на RTF, DOC и DOX документ. Тази опция ще бъде написана на DOCX само ако OoxmlCompliance е по-висока от Ecma376.

Следният пример за код показва как да се създаде списък и да се рестартира за всеки раздел: