Работа со списками
Список в документе Microsoft Word - это набор свойств форматирования списков. Списки можно использовать в ваших документах для форматирования, упорядочивания и выделения текста. Списки - это отличный способ организации данных в документах, и они облегчают читателям понимание ключевых моментов.
Каждый список может иметь до 9 уровней, и свойства форматирования, такие как стиль цифр, начальное значение, отступ, позиция табуляции и другие, определяются отдельно для каждого уровня.
В этой статье описывается программная работа со списками с использованием Aspose.Words.
Создание списков с помощью форматирования списков
Aspose.Words позволяет легко создавать списки, применяя форматирование списка. DocumentBuilder предоставляет свойство ListFormat, которое возвращает объект ListFormat. У этого объекта есть несколько методов для начала и завершения списка, а также для увеличения/уменьшения отступа. В Microsoft Word есть два основных типа списков: маркированные и нумерованные:
- Чтобы запустить маркированный список, вызовите ListFormat.ApplyBulletDefault
- Чтобы запустить нумерованный список, наберите ListFormat.ApplyNumberDefault
Маркер или число и форматирование добавляются к текущему абзацу и всем последующим абзацам, созданным с использованием DocumentBuilder, пока не будет вызван RemoveNumbers для остановки форматирования маркированного списка.
В документах Word списки могут состоять максимум из девяти уровней. Форматирование списка для каждого уровня определяет, какой маркер или число используется, отступ слева, расстояние между маркером и текстом и т.д. Следующие методы изменяют уровень списка и применяют свойства форматирования нового уровня:
- Чтобы увеличить уровень списка текущего абзаца на один уровень, вызовите ListFormat.ListIndent
- Чтобы уменьшить уровень списка текущего абзаца на один уровень, вызовите ListFormat.ListOutdent
Методы изменяют уровень списка и применяют свойства форматирования нового уровня.
В следующем примере кода показано, как создать многоуровневый список:
Укажите форматирование для уровня списка
Объекты уровня списка создаются автоматически при создании списка. Используйте свойства и методы класса ListLevel для управления форматированием отдельных уровней списка.
Список перезапусков для каждого раздела
Вы можете перезапустить список для каждого раздела, используя свойство IsRestartAtEachSection. Обратите внимание, что этот параметр поддерживается только в форматах документов RTF, DOC и DOCX. Этот параметр будет записан в DOCX только в том случае, если OoxmlCompliance выше, чем Ecma376.
В следующем примере кода показано, как создать список и перезапустить его для каждого раздела: