Преглед на строителя на документи
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.
Навигация на документа
Навигацията на документа се основава на концепцията за виртуален курсор, с който можете да се преместите на друго място в документа с помощта на различни Документ Builder.move_to_XXX методи като move_to_document_start както и move_to_field. Този виртуален курсор показва къде ще бъде поставен текстът при свикване на методите write, writeln, insert_break, и други. Вижте следващата статия “Навигация с курсор,” за да научите повече за виртуалния курсор.
Следният пример за код показва как да преминете към отметки:
Сграда и промяна на документи
Aspose.Words API осигурява няколко класа, които са отговорни за форматиране на различни елементи на документ. Всеки от класовете капсулира форматиращи свойства, свързани с конкретен документен елемент, като текст, параграф, раздел и други. Например, Font клас представлява символично форматиране свойства, ParagraphFormat Класът представлява свойства, форматиращи параграфа, и така нататък. Обектите на тези класове се връщат от съответния DocumentBuilder имоти, които имат същите имена като класовете. Ето защо можете да получите достъп до тях и да зададете желания формат по време на изграждането на документа.
Можете също така да вмъкнете текст, чекова кутия, ole обект, изображения, отметки, форма полета, и други елементи на документа в позицията на курсора с помощта на Write метод или нещо от Документ Builder.enter_XXX методи като insert_field, insert_html, и подобни методи.
Да видим как да създадем прост документ с помощта на DocumentBuilder.
Създаване на документ с помощта на DocumentBuilder
За начало, трябва да се създаде DocumentBuilder и го свързва с Document Възразявам. Създавате нов случай на DocumentBuilder като се обади на конструктора си и го предаде на Document обект за привързаност към строителя.
За да въведете текст, подайте низ от текста, който трябва да въведете в документа write метод.
Следният пример за код показва как да се създаде прост документ с помощта на строител на документи.
Посочете форматирането на документа
На font Имотът определя форматирането на текст. Този обект съдържа различни атрибути на шрифта (фонт име, размер на шрифта, цвят и така нататък). Някои важни атрибути на шрифта също са представени от DocumentBuilder Имоти, които ви позволяват да получите достъп до тях директно. Това са Font.bold, Font.italic, както и Font.underline Булеански имоти.
Следният пример с код показва как да се вмъкне форматиран текст, като се използва DocumentBuilder:
- font посочва формата на символите, които ще бъдат приложени към целия текст, поставен от текущата позиция в документа нататък.
- paragraph_format определя формата на параграфа за текущия и всички параграфи, които се вмъкват.
- page_setup определя свойствата на страницата и раздела за текущия раздел и целия раздел, който ще бъде поставен.
- cell_format както и row_format посочва свойствата на форматирането, които ще се прилагат към таблиците и редовете от текущата позиция в документа нататък.
В тази ситуация “текущ” означава позицията, параграф, раздел, клетка или ред, в който курсорът е.