Використання `DocumentBuilder` Модифікувати документ
Форматування
Форматування шрифту
Поточна форматування шрифтів представлена форматуванням Font об’єкт, що повертається DocumentBuilder.Font майно. Про нас Font клас містить широкий спектр властивостей шрифтів, можливо в Microsoft Wordй
 |
|---|
| Приклад коду показує, як встановити форматування шрифтів. |
Форматування клітин
У процесі будівництва таблиці використовується форматування клітин. Він представлений CellFormat об’єкт, що повертається DocumentBuilder.CellFormat майно. CellFormat інкапсулює різні властивості комірки, такі як ширина або вертикальне вирівнювання.
 |
|---|
| Приклад коду показує, як створити таблицю, що містить один відформатований клітинку. |
Форматування
Форматування поточного ряду визначається за допомогою RowFormat об’єкт, який повертається DocumentBuilder.RowFormat майно. Об’єкт закріплює інформацію про всі форматування рядків таблиці.
 |
|---|
| Бутиlow code Приклад показує, як створити таблицю, що містить один елемент і застосувати форматування рядків. |
Список форматування
Aspose.Words дозволяє легко створювати списки за допомогою форматування списку. DocumentBuilder надає послуги DocumentBuilder.ListFormat майно, що повертає майно ListFormat об’єкт. Цей об’єкт має кілька способів запуску і завершення списку і для збільшення / виведення відступу.
 |
|---|
| Є два загальні типи списку Microsoft Word: броньовані та нумеровані. |
- Для запуску списку бюлетенів, виклику ListFormat.applyBulletDefault й
- Для запуску списку, виклику ListFormat.applyNumberDefault й
До поточного абзацу додаються кулі або номер і форматування. DocumentBuilder до ListFormat.removeNumbers це називається, щоб зупинити форматування списку.
У документах Word можуть складатися списки до дев’яти рівнів. Форматування списку для кожного рівня визначає, яку використовується куля або номер, лівий відступ, простір між кулі та текстом тощо.
- до Для збільшення рівня списку поточного абзацу за одним рівнем виклику ListFormat.listIndentй
- до Для зменшення рівня списку поточного абзацу за одним рівнем виклику ListFormat.listOutdentй
Методи зміни рівня списку і застосовуються форматувальні властивості нового рівня.
Приклад коду показує, як побудувати багаторівневий список.
Форматування сторінок
Настроювання сторінок та властивості розділів наведено в PageSetup об’єкт, який повертається DocumentBuilder.PageSetup майно. Об’єкт містить всі атрибути налаштування сторінки розділу (лівий край, нижній край, розмір паперу тощо) як властивості.
 |
|---|
| Приклад коду показує, як встановити такі властивості, як розмір сторінки та спрямованість на поточний розділ. |
Застосування стилю
Деякі форматування об’єктів, таких як шрифт або ParagraphFormat стилі підтримки. Одномісний вбудований або користувацький стиль представлений Style об’єкт, який містить відповідні властивості стилю, такі як ім’я, базовий стиль, шрифт і форматування абзаців стилю, і так далі.
До того ж, Style об’єкт забезпечує Style.getStyleIdentifier майно, що повертає ідентифікатор локального стилю, представлений Style.StyleIdentifier значення нумерації. Точка полягає в тому, що назви вбудованих стилів в Microsoft Word локалізуються для різних мов. Використовуючи ідентифікатор стилю, ви можете знайти правильний стиль незалежно від мови документа. Значення занурення відповідають значенням Microsoft Word вбудовані стилі, такі як Нормальний, Заголовок 1, Заголовок 2 і т.д. Всі стилі, призначені для користувача СтильВиявлення. Вартість користувачай
 |
|---|
| Приклад коду показує, як застосувати стиль абзацу. |
Прикордони та затінки
Прикордони представлені прикордонним Це збірка прикордонних об’єктів, які доступні за індексом або за типом кордону. Тип кордону представлений BorderType заохочення. Деякі значення генерації застосовуються до декількох або тільки одного елемента документа. Наприклад, BorderType.Bottom застосовується до абзацу або настільної комірки в той час як BorderType.DiagonalDown визначає діагональний кордон в таблиці тільки.
Як бордюрний збір, так і кожен окремий кордон має схожі атрибути, такі як колір, стиль лінії, ширина лінії, відстань від тексту, і додаткові тіні. Вони представлені властивостями тієї ж назви. Ви можете досягти різних типів кордону, поєднуючи цінності нерухомості. Крім того, як BorderCollection і Border об’єкти дозволяють скидати ці значення за замовчуванням, викликаючи Border.clearFormatting метод. Зауважте, що при русі властивості скидаються до значень за замовчуванням, кордон невидимий.
 |
|---|
| Про нас Shading Клас містить атрибути затінення для елементів документа. Ви можете встановити бажану текстуру затінення і кольори, які наносяться на фон і фон елемента. |
Текстура затінення встановлюється з ТекстураІндекс значення нумерації, що дозволяє застосування різних візерунків до Shading об’єкт. Наприклад, для встановлення фонового кольору для елемента документа використовуйте Текстура.TextureSolid значення і встановити колір переднього затінення відповідно.
 |
|---|
| Нижче наведене нижче приклад показує, як застосувати кордони та затінки до абзацу. |
Snap в Сітка
Aspose.Words надає два властивості ParagraphFormat.SnapToGrid і Font.SnapToGrid щоб отримати і встановити пункт нерухомості оснащення до сітки
Переміщення куратора
Виявлення позиції поточної кривої
Ви можете отримати де курсор будівельника в будь-який час. Про нас DocumentBuilder.getCurrentNode майно повертає вузол, який в даний час вибирається в цьому конструкторі. Вуз є безпосередню дитину абзацу. Будь-які операції вставки, які ви виконуєте DocumentBuilder вставить перед DocumentBuilder.CurrentNodeй Коли поточний пункт порожній або курсор розміщується безпосередньо перед закінченням пункту, DocumentBuilder.CurrentNode повертає null.
Також можна використовувати DocumentBuilder.getCurrentParagraph власність, яка отримує абзац, який в даний час вибрано в цьому DocumentBuilderй Бутиlow code Приклад показує, як отримати доступ до поточного вузла в конструкторі документів.
Переїзд в будь-який Нод (Параграфи та їхні діти)
Якщо у вас є вершина об’єкта документа, який є абзацом або безпосередньою дитиною абзацу, ви можете вказати курсор будівельника до цієї вершини. Використання DocumentBuilder.moveTo спосіб виконання цього. Приклад коду показує, як перемістити позицію курсора в зазначений вузол.
Переміщення до документа Старт/Ед
Якщо необхідно перейти до початку документа, зателефонуйте DocumentBuilder.moveToDocumentStartй Якщо необхідно перейти до кінця документа, зателефонуйте DocumentBuilder.moveToDocumentEndй
Переїзд до розділу
Якщо ви працюєте з документом, який містить кілька розділів, ви можете перемістити до потрібного розділу, використовуючи DocumentBuilder.moveToSectionй Цей метод переміщує курсор до початку зазначеного розділу і приймає індекс необхідного розділу. Коли індекс розділу перевищує або дорівнює 0, він визначає індекс від початку документа з 0, який є першим розділом. При індексі розділу менше 0, він визначає індекс з кінця документа з -1, який є останній розділ. Бутиlow code Приклад показує, як перемістити позицію курсора до вказаного розділу. Ви можете завантажити файл шаблону цього прикладу з Головнай
Переміщення на заголовок / дросель
Коли потрібно розмістити деякі дані в заголовок або нижній колонтитул, необхідно перемістити його спочатку за допомогою DocumentBuilder.moveToHeaderFooterй Метод приймає значення зазначення HeaderFooterType, що визначає тип заголовка або нижній колонтитул, де курсор повинен бути переміщений.
Якщо ви хочете створити головки та ножиці, які різні для першої сторінки, вам потрібно встановити PageSetup.getDifferentFirstPageHeaderFooter нерухомість trueй Якщо ви хочете створити заголовки та нижній колонтитул, які різні для парних і непарних сторінок, вам потрібно встановити PageSetup.getOddAndEvenPagesHeaderFooter до trueй
Якщо потрібно повернутися до головної історії, скористайтеся формоюDocumentBuilder.moveToSection щоб вийти з заголовка або нижній колонтитул. Нижче наведено приклади створення заголовків та нижній колонтитулів у документі за допомогою DocumentBuilder.
Переміщення до пункту
ЗареєструватисяDocumentBuilder.moveToParagraph перемістити курсор на бажаний пункт в поточному розділі. Ви повинні пройти два параметри до цього методу: абзац (Індекс абзацу для переміщення в) і символІндекс (Індекс характеру всередині абзацу).
Навігація здійснюється в поточній історії поточного розділу. Що таке, якщо ви переїхали курсор до основного заголовка першого розділу, то абзац Індекс визначає індекс абзацу всередині, який заголовок цього розділу.
Коли абзацІндекс більший або дорівнює 0, він визначає індекс від початку розділу з 0 є першим пунктом. Коли абзацІндекс менше 0, він визначає індекс з кінця розділу з -1, будучи останній пункт. Індекс характеру може бути вказаний тільки в якості 0 для переміщення до початку абзацу або -1 для переміщення до кінця абзацу. Приклад наступного коду показує, як перемістити позицію курсора в зазначений пункт. Ви можете завантажити файл шаблону цього прикладу з Головнай
Переміщення на стіл клітинку
Зареєструватися DocumentBuilder.moveToCell якщо необхідно перемістити курсор на стільницю в поточному розділі. Цей метод приймає чотири параметри:
- таблицяІндекс - індекс таблиці для переміщення.
- рядІндекс - індекс рядка в таблиці.
- стовпчикІндекс - індекс стовпця в таблиці.
- характерІндекс - індекс характеру всередині комірки.
Навігація здійснюється в поточній історії поточного розділу.
Для показників індексу, коли індекс більший або дорівнює 0, він визначає індекс від початку з 0, будучи першим елементом. Коли індекс менше 0, він визначає індекс з кінця з -1, будучи останній елемент.
Також зверніть увагу, що характерIndex в даний час може вказати лише 0 для переходу на початок комірки або -1 для переміщення до кінця комірки. Приклад коду показує, як перемістити позицію курсора до вказаної таблиці комірки. Ви можете завантажити файл шаблону цього прикладу з Головнай
Переміщення в закладку
Замітки часто використовуються для позначення окремих місць у документі, де будуть вставлятися нові елементи. Щоб перейти в закладку, використовуйте DocumentBuilder.moveToBookmarkй Цей метод має два перевантаження. Найстарішіший, але ім’я закладки, де курсор повинен бути переміщений. Приклад коду показує, як перемістити позицію курсора до закладки.
Цей перевантаження пересуває курсор на позицію тільки після початку закладки з вказаною назвою. Ще одне перевантаження DocumentBuilder.moveToBookmark переходить курсор до закладки з більшою точністю. Прийняття двох додаткових параметрів болеана:
- Старт визначає, чи перемістити курсор до початку або до кінця закладки.
- цеАфтер визначає, чи слід перемістити курсор після початку закладки або кінцевого положення, або перемістити курсор, щоб бути до початку закладки або кінцевого положення.
Приклад коду показує, як перемістити позицію курсора лише після закінчення закладки.
Вставляючи новий текст таким чином не замінює існуючий текст закладки. Зауважте, що деякі закладки в документі присвоєно для формування полів. Переміщення такої закладки та вставки тексту вводиться текст у форму поле коду. Хоча це не визнає поле форми, вставлений текст не буде видно, оскільки він стає частиною поля.
Переміщення до Merge Сфера
Іноді можна виконати “ручну” mail merge використання DocumentBuilder або заповніть поле зливу особливим способом всередині mail merge обробник заходу. Що таке коли DocumentBuilder.moveToMergeField може бути корисним. Метод приймає назву поля злиття. Він переміщує курсор на позицію за межами зазначеного поля злиття і видаляє поле зливу. Приклад наступного коду показує, як перемістити курсор на позицію лише за вказаною концентрацією поля.
Як перетворити між блоками вимірювання
Більшість властивостей об’єкта, передбачених в Aspose.Words API що відображає деякі вимірювання (ширина/висота, запаси та різні відстані) приймають значення в точках (1 дюйма дорівнює 72 балів). Іноді це не зручно, тому є ConvertUtil клас, який надає функції помічника для перетворення між різними блоками вимірювання. Дозволяє конвертувати дюйми в точки, точки в дюйми, пікселі в точки, і точки в пікселів. Коли пікселі перетворюються на точки і навпаки, вона може бути виконана при 96 dpi (доти на дюйм) дозволів або при визначеному роздільній здатності dpi.
ConvertUtil є дуже корисним при налаштуванні різних властивостей сторінок, тому що наприклад, дюйми є більш звичайними вимірюваннями, ніж точки. Наступний приклад показує, як встановити властивості сторінок в дюймах.
Приклад коду показує, як вказати властивості сторінок в дюймах.