Робота з абзацами
Абзац - це набір символів, об’єднаних в логічний блок і закінчуються спеціальним символом paragraph break. В Aspose.Words абзац представлений класом Paragraph.
Вставити абзац
Щоб вставити в документ новий абзац, насправді, вам потрібно вставити в нього символ розриву абзацу. DocumentBuilder.Writeln вставляє в документ не тільки рядок тексту, але і додає розрив абзацу.
Поточне форматування шрифту також визначається властивістю Font, а поточне форматування абзацу визначається властивістю ParagraphFormat. У наступному розділі ми детальніше розглянемо форматування абзацу.
Наступний приклад коду показує, як вставити абзац у документ:
Форматувати абзац
Поточне форматування абзацу представлено об’єктом ParagraphFormat, який повертається властивістю ParagraphFormat. Цей об’єкт інкапсулює різні властивості форматування абзацу, доступні в Microsoft Word. Ви можете легко змінити форматування абзацу за замовчуванням на звичайний стиль, вирівняний за лівим краєм, без відступів, без інтервалів, без меж і без затінення, викликавши команду ClearFormatting.
У наступному прикладі коду показано, як задати форматування абзацу:
Застосувати стиль абзацу
Деякі об’єкти форматування, такі як шрифт або ParagraphFormat, підтримують стилі. Окремий вбудований або визначений користувачем стиль представлений об’єктом Style, який містить відповідні властивості стилю, такі як назва, базовий стиль, форматування шрифту та абзацу стилю тощо.
Крім того, об’єкт Style надає властивість StyleIdentifier, яка повертає незалежний від мови ідентифікатор стилю, представлений значенням перерахування StyleIdentifier. Справа в тому, що назви вбудованих стилів в Microsoft Word локалізовані для різних мов. Використовуючи ідентифікатор стилю, ви можете знайти правильний стиль незалежно від мови документа. Значення перерахування відповідають вбудованим стилям Microsoft Word, таким як Normal, Heading 1, Heading 2 і т.д. всім призначеним для користувача стилям присвоюється значення StyleIdentifier.User.
Наступний приклад коду показує, як застосувати стиль абзацу:
Вставте роздільник стилів для розміщення різних стилів абзаців
Роздільник стилів можна додати до кінця абзацу за допомогою комбінації клавіш Ctrl + Alt + Enter у MS Word. Ця функція дозволяє використовувати два різні стилі абзацу в одному логічному друкованому абзаці. Якщо ви хочете, щоб якийсь текст із початку певного заголовка відображався у змісті, але не весь заголовок, ви можете скористатися цією функцією.
Наступний приклад коду показує, як вставити роздільник стилів, щоб відповідати різним стилям абзаців:
Визначте роздільник стилів абзаців
Aspose.Words надає загальнодоступну властивість BreakIsStyleSeparator для класу Paragraph, що дозволяє ідентифікувати абзац-роздільник стилів, як показано в прикладі, наведеному нижче:
Застосуйте межі та затінення до абзацу
Межі в Aspose.Words представлені класом BorderCollection – це колекція об’єктів Border, доступ до яких здійснюється за індексом або за типом кордону. Тип кордону представлений перерахуванням BorderType. Деякі значення перерахування стосуються кількох або лише одного елемента документа. Наприклад, BorderType.Bottom застосовується до абзацу або комірки таблиці, тоді як BorderType.DiagonalDown визначає діагональну межу лише в комірці таблиці.
Як колекція кадрів, так і кожна окрема межа мають подібні атрибути, такі як колір, стиль лінії, ширина лінії, відстань від тексту та необов’язкова тінь. Вони представлені однойменними властивостями. Поєднуючи значення властивостей, ви можете створювати різні типи меж. Крім того, обидва об’єкти BorderCollection і Border дозволяють скинути ці значення до значень за замовчуванням, викликавши метод ClearFormatting.
Aspose.Words також містить клас Shading, що містить атрибути затінення для елементів документа. Ви можете задати бажану текстуру затінення і кольору, які будуть застосовуватися до фону і переднього плану елемента.
Текстура затінення задається значенням перерахування TextureIndex, яке дозволяє застосовувати різні шаблони до об’єкта Shading. Наприклад, щоб встановити колір фону для елемента документа, використовуйте значення TextureIndex.TextureSolid і відповідно встановіть колір затінення переднього плану.
Наступний приклад коду показує, як застосувати межі та затінення до абзацу: