Преглед на строителя на документи
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 посочва свойствата на форматирането, които ще се прилагат към таблиците и редовете от текущата позиция в документа нататък.
В тази ситуация “текущ” означава позицията, параграф, раздел, клетка или ред, в който курсорът е.