Работа со списками

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

Каждый список может иметь до 9 уровней, и свойства форматирования, такие как стиль цифр, начальное значение, отступ, позиция табуляции и т.д., определяются отдельно для каждого уровня.

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

В этом разделе описывается, как программно работать со списками, используя Aspose.Words.

Создание списков с помощью форматирования списков

Aspose.Words позволяет легко создавать списки, применяя форматирование списка. DocumentBuilder предоставляет свойство DocumentBuilder.list_format, которое возвращает объект 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 для управления форматированием отдельных уровней списка.

Список перезапусков для каждого раздела

Вы можете перезапустить список для каждого раздела, используя свойство is_restart_at_each_section property. Обратите внимание, что этот параметр поддерживается только в форматах документов RTF, DOC и DOCX. Этот параметр будет записан в DOCX только в том случае, если OoxmlCompliance выше, чем Ecma376.

В следующем примере кода показано, как создать список и перезапустить его для каждого раздела: