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

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

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

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

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

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

Aspose.Words Это позволяет легко создавать списки, применяя форматирование списков. DocumentBuilder обеспечивает ListFormat Имущество, которое возвращает ListFormat объект. Этот объект имеет несколько способов начать и закончить список и увеличить / уменьшить отступ. Существует два основных типа списков в Microsoft Word: пронумеровано и пронумеровано:

  • Чтобы начать список, звоните. ApplyBulletDefault
  • Чтобы начать пронумерованный список, позвоните ApplyNumberDefault

Пуля или номер и форматирование добавляются к текущему абзацу и всем последующим абзацам, созданным с использованием DocumentBuilder до RemoveNumbers Он призван остановить форматирование списка.

В документах Word списки могут состоять до девяти уровней. Форматирование списка для каждого уровня определяет, какая пуля или номер используется, левый отступ, пространство между пулей и текстом и т.д. Следующие методы изменяют уровень списка и применяют свойства форматирования нового уровня:

  • Чтобы повысить уровень списка текущего пункта на один уровень, звоните ListIndent
  • Чтобы понизить уровень списка текущего абзаца на один уровень, звоните ListOutdent

Вы также можете использовать ListLevelNumber собственности, чтобы получить или установить уровень списка для пункта.

Следующий пример кода показывает, как построить многоуровневый список:

Укажите форматирование для уровня списка

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

Перезагрузить список для каждого раздела

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

Следующий пример кода показывает, как создать список и перезапустить его для каждого раздела: