---
title: "Python 中的文档生成器概述"
---

[DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 是一个功能强大的类，它与 [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) 相关联，使您能够从头开始构建动态文档或向现有文档添加新元素。

[DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 提供了插入文本、复选框、ole 对象、段落、列表、表格、图像和其他内容元素的方法。它允许您指定字体、段落或部分格式以及执行其他操作。

## 文档生成器或 Aspose.Words DOM

[DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 补充了 Aspose.Words Document Object Model (DOM) 中可用的类和方法，以简化最常见的文档构建任务。也就是说，您可以通过 Aspose.Words DOM（这需要很好地理解树结构）和使用 DocumentBuilder 来创建和修改文档内容。 `DocumentBuilder` 是复杂 **Document** 结构的"外观"，允许您快速轻松地插入内容和格式。

直接使用 Aspose.Words DOM 的类时，也可以使用 [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 进行的操作。然而，直接使用 Aspose.Words DOM 类通常比使用 [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 需要更多的代码行。

## 文档导航

文档导航基于虚拟光标的概念，通过虚拟光标，您可以使用各种 **DocumentBuilder.move_to_XXX** 方法（例如 [move_to_document_start](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/move_to_document_start/) 和 [move_to_field](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/move_to_field/)）移动到文档中的另一个位置。该虚拟光标指示调用 [write](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/write/)、[writeln](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/writeln/)、[insert_break](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_break/) 等方法时文本将插入的位置。请参阅以下文章"使用光标导航"以了解有关虚拟光标的更多信息。

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

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Document-add_content_using_document_builder-MoveToBookmarkEnd.py" >}}

## 文档构建和修改

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

您还可以使用 `Write` 方法或任何 **DocumentBuilder.insert_XXX** 方法（例如 [insert_field](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_field/)、[insert_html](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_html/) 和类似方法）在光标位置插入文本、复选框、ole 对象、图像、书签、表单字段和其他文档元素。

让我们看看如何使用 [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 创建一个简单的文档。

### 使用 DocumentBuilder 创建文档

首先，您需要创建一个 [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 并将其与 [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) 对象关联。您可以通过调用其构造函数来创建 [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 的新实例，并将其传递给 [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) 对象以附加到构建器。

要插入文本，请将需要插入到文档中的文本字符串传递给 [write](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/write/) 方法。

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

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Document-add_content_using_document_builder-MoveToDocumentStartEnd.py" >}}

### 指定文档格式

[font](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/font/) 属性定义文本格式。该对象包含不同的字体属性（字体名称、字体大小、颜色等）。一些重要的字体属性也由 [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 属性表示，以便您可以直接访问它们。这些是 [Font.bold](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/bold/)、[Font.italic](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/italic/) 和 [Font.underline](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/underline/) 布尔属性。

以下代码示例演示如何使用 [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) 插入格式化文本：

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Document-add_content_using_document_builder-InsertParagraph.py" >}}

```

- [font](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/font/) 指定将应用于从文档当前位置开始插入的所有文本的字符格式。
- [paragraph_format](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/paragraph_format/) 指定当前段落和所有要插入的段落的段落格式。
- [page_setup](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/page_setup/) 指定当前节和将插入的整个节的页面和节属性。
- [cell_format](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/cell_format/) 和 [row_format](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/row_format/) 指定格式属性，这些属性将从文档中的当前位置开始应用于表格单元格和行。

在这种情况下，"当前"是指光标所在的位置、段落、部分、单元格或行。

```

```

请注意，每当您导航到文档中的其他位置时，[font](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/font/)、[paragraph_format](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/paragraph_format/) 和 [page_setup](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/page_setup/) 属性都会更新，以反映该位置的格式设置属性。

```