文档生成器概述

DocumentBuilder 是一个功能强大的类,它与 Document 相关联,使您能够从头开始构建动态文档或向现有文档添加新元素。

DocumentBuilder 提供了插入文本、复选框、ole 对象、段落、列表、表格、图像和其他内容元素的方法。它允许您指定字体、段落或部分格式以及执行其他操作。

文档生成器或 Aspose.Words DOM

DocumentBuilder 补充了 Aspose.Words Document Object Model (DOM) 中可用的类和方法,以简化最常见的文档构建任务。也就是说,您既可以通过Aspose.Words DOM(这需要很好地了解树结构)也可以使用DocumentBuilder 创建和修改文档内容。 DocumentBuilder 是复杂 Document 结构的"外观",允许您快速轻松地插入内容和格式。

直接使用 Aspose.Words DOM 的类时,也可以使用 DocumentBuilder 进行的操作。然而,直接使用 Aspose.Words DOM 类通常比使用 DocumentBuilder 需要更多的代码行。

文档导航

文档导航基于虚拟光标的概念,通过虚拟光标,您可以使用各种 DocumentBuilder.MoveToXXX 方法(例如 MoveToDocumentStartMoveToField)移动到文档中的另一个位置。该虚拟光标指示调用 WriteWritelnInsertBreak 等方法时文本将插入的位置。请参阅以下文章"使用光标导航"以了解有关虚拟光标的更多信息。

以下代码示例展示了如何导航到书签:

文档构建和修改

Aspose.Words API 提供了几个类,负责格式化文档的各种元素。每个类都封装与特定文档元素相关的格式化属性,例如文本、段落、部分等。例如,Font 类表示字符格式化属性,ParagraphFormat 类表示段落格式化属性,等等。这些类的对象由相应的 DocumentBuilder 属性返回,这些属性与类具有相同的名称。因此,您可以在文档构建期间访问它们并设置所需的格式。

您还可以使用 Write 方法或任何 DocumentBuilder.InsertXXX 方法(例如 InsertFieldInsertHtml 和类似方法)在光标位置插入文本、复选框、ole 对象、图像、书签、表单字段和其他文档元素。

让我们看看如何使用 DocumentBuilder 创建一个简单的文档。

使用 DocumentBuilder 创建文档

首先,您需要创建一个 DocumentBuilder 并将其与 Document 对象关联。您可以通过调用其构造函数来创建 DocumentBuilder 的新实例,并将其传递给 Document 对象以附加到构建器。

要插入文本,请将需要插入到文档中的文本字符串传递给 Write 方法。

以下代码示例演示如何使用文档生成器创建简单文档。

指定文档格式

Font 属性定义文本格式。该对象包含不同的字体属性(字体名称、字体大小、颜色等)。一些重要的字体属性也由 DocumentBuilder 属性表示,以便您直接访问它们。这些是 Font.BoldFont.ItalicFont.Underline 布尔属性。

以下代码示例演示如何使用 DocumentBuilder 插入格式化文本: