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