Огляд конструктора документів
DocumentBuilder є потужним класом, який асоціюється з Document і дозволяє будувати динамічні документи з нуля або додати нові елементи до існуючого.
DocumentBuilder надає методи вставити текст, прапорці, оле об’єкти, абзаци, списки, таблиці, зображення та інші елементи вмісту. Ви можете вказати шрифти, пункт або форматування розділу та виконувати інші операції.
Конструктор документів або Aspose.Words DOM
DocumentBuilder доповнює класи та методи, доступні в Aspose.Words Document Object Model (Українська)DOM) спростити найбільш поширені завдання з побудови документів. Таким чином, ви можете створити і змінити зміст документів як через Aspose.Words DOM, яка вимагає гарного розуміння структури дерева, а також використання DocumentBuilder. Про нас DocumentBuilder – “фасад” для комплексу Document структура, яка дозволяє швидко і легко вставляти вміст і форматування.
Операції, які можливо з DocumentBuilder Можливі також при використанні занять Aspose.Words DOM прямо. Однак, використовуючи Aspose.Words DOM класи безпосередньо зазвичай вимагають більше рядків коду, ніж використання DocumentBuilderй
Навігація документів
Навігація документів базується на концепції віртуального курсора, за допомогою якого можна переходити в інше місце в документі, використовуючи різні DocumentBuilder.MoveToXXX методи, такі як MoveToDocumentStart і MoveToFieldй Цей віртуальний курсор вказує, де текст буде вставлятися при виклику методів Write, Writeln, InsertBreak, та інші. Детальніше про віртуальний курсор читайте в розділі “Навігація з куратором”.
Приклад коду показує, як орієнтуватися на закладку:
Будівництво документів та модифікація документів
Aspose.Words API надає кілька класів, які відповідають за форматування різних елементів документа. Кожен з класів визначає форматування властивостей, пов’язаних з певним елементом документа, таких як текст, абзац, розділ та інші. Наприклад, Font клас являє собою характерні властивості форматування, ParagraphFormat клас являє собою абзационно-форматні властивості, і так далі. Об’єкти цих класів повертаються відповідним DocumentBuilder властивості, які мають однакові імена як класи. Таким чином, ви можете отримати доступ до них і встановити бажаний форматування під час складання документа.
Ви також можете вставляти текст, прапорець, ole об’єкт, зображення, закладки, форми поля та інші елементи документа на позиції курсора за допомогою пункту Write метод або будь-який з DocumentBuilder.InsertXXX методи, такі як InsertField, InsertHtml, і подібні методи.
Давайте подивимося, як створити простий документ, використовуючи DocumentBuilderй
Створити документ за допомогою DocumentBuilder
Для початку необхідно створити DocumentBuilder і пов’язувати його з Document об’єкт. Ви створюєте новий екземпляр DocumentBuilder за викликом конструктора і перейде його до Document об’єкт для кріплення будівельника.
Щоб вставити текст, пропустіть рядок тексту, потрібно вставити в документ до Write метод.
Приклад коду показує, як створити простий документ за допомогою конструктора документів.
Вказати форматування документів
Про нас Font властивість визначає форматування тексту. Цей об’єкт містить різні атрибути шрифтів (ім’я шрифту, розмір шрифту, колір тощо). Деякі важливі атрибути шрифтів також представлені DocumentBuilder властивості, які дозволяють отримати доступ до них безпосередньо. Ці Font.Bold, Font.Italic, і Font.Underline булеві властивості.
Приклад коду показує, як вставити форматований текст за допомогою DocumentBuilder:
- до Font визначає форматування символів, який буде застосовано до всіх текстових вставлених з поточного положення в документі.
- до ParagraphFormat визначає форматування абзаців для поточного та всіх абзаців, які будуть вставлятися.
- до PageSetup визначає властивості сторінки та розділу для поточного розділу та всієї секції, яка буде вставлятися.
- до CellFormat і RowFormat вкажіть форматування властивостей, які будуть застосовуватися до комірок та рядків з поточного положення в документі.
У цій ситуації “поточний” означає позицію, абзац, розділ, клітинку або ряд, в якому курсор знаходиться.