Работа с абзацами
Абзац – это набор символов, объединенных в логический блок и заканчивающихся специальным символом paragraph break. В Aspose.Words абзац представлен классом Paragraph.
Вставить абзац
Чтобы вставить новый абзац в документ, на самом деле, вам нужно вставить в него символ разрыва абзаца. DocumentBuilder.writeln также вставляет строку текста в документ, но, кроме того, добавляет разрыв абзаца.
Текущее форматирование шрифта также определяется свойством font, а текущее форматирование абзаца определяется свойством paragraph_format.
В следующем примере кода показано, как вставить абзац в документ:
Форматировать абзац
Текущее форматирование абзаца представлено объектом ParagraphFormat, который возвращается свойством paragraph_format. Этот объект инкапсулирует различные свойства форматирования абзаца, доступные в Microsoft Word. Вы можете легко изменить форматирование абзаца по умолчанию на обычный стиль, выровненный по левому краю, без отступов, без интервалов, без границ и без затенения, вызвав команду clear_formatting.
В следующем примере кода показано, как задать форматирование абзаца:
Применение стиля абзаца
Некоторые объекты форматирования, такие как Font или ParagraphFormat, поддерживают стили. Отдельный встроенный или определяемый пользователем стиль представлен объектом Style, который содержит соответствующие свойства стиля, такие как название, базовый стиль, форматирование шрифта и абзаца стиля и так далее.
Кроме того, объект Style предоставляет свойство Style.style_identifier, которое возвращает идентификатор стиля, не зависящий от языка, представленный значением перечисления StyleIdentifier. Дело в том, что названия встроенных стилей в Microsoft Word локализованы для разных языков. Используя идентификатор стиля, вы можете найти правильный стиль независимо от языка документа. Значения перечисления соответствуют встроенным стилям Microsoft Word, таким как обычный, Heading 1, Heading 2 и т.д. Всем пользовательским стилям присваивается значение StyleIdentifier.USER.
В следующем примере кода показано, как применить стиль абзаца:
Вставьте разделитель стилей для размещения различных стилей абзацев
Разделитель стилей можно добавить в конец абзаца, используя сочетание клавиш Ctrl + Alt + Enter в MS Word. Эта функция позволяет использовать два разных стиля абзаца в одном логичном печатном абзаце. Если вы хотите, чтобы какой-то текст из начала определенного заголовка отображался в оглавлении, но не весь заголовок целиком, вы можете воспользоваться этой функцией.
В следующем примере кода показано, как вставить разделитель стилей для соответствия различным стилям абзацев:
Определить разделитель стилей абзацев
Aspose.Words предоставляет общедоступное свойство break_is_style_separator классу Paragraph, позволяющее идентифицировать абзац-разделитель стилей, как показано в примере, приведенном ниже:
Примените границы и затенение к абзацу
Границы представлены символом BorderCollection. Это набор из Border объектов, доступ к которым осуществляется по индексу или по типу границы. Тип границы представлен перечислением BorderType. Некоторые значения перечисления применимы к нескольким или только к одному элементу документа. Например, BorderType.BOTTOM применимо к абзацу или ячейке таблицы, в то время как BorderType.DIAGONALDOWN определяет диагональную границу только в ячейке таблицы.
Как коллекция границ, так и каждая отдельная граница имеют схожие атрибуты, такие как цвет, стиль линии, ширина линии, расстояние от текста и необязательная тень. Они представлены одноименными свойствами. Комбинируя значения свойств, вы можете создавать различные типы границ. Кроме того, оба объекта BorderCollection и Border позволяют вам сбросить эти значения до значений по умолчанию, вызвав метод Border.clear_formatting.
Aspose.Words также содержит класс Shading, содержащий атрибуты затенения для элементов документа. Вы можете задать желаемую текстуру затенения и цвета, которые будут применяться к фону и переднему плану элемента.
Текстура затенения задается значением перечисления TextureIndex, которое позволяет применять различные узоры к объекту Shading. Например, чтобы задать цвет фона для элемента документа, используйте значение TextureIndex.TEXTURE_SOLID и соответствующим образом задайте цвет затенения переднего плана. В приведенном ниже примере показано, как применить границы и затенение к абзацу.
В следующем примере кода показано, как применить границы и затенение к абзацу: