Word 文档级自定义项编程入门
更新：2007 年 11 月
适用对象 |
|---|
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。 项目类型
Microsoft Office 版本
有关更多信息，请参见 按应用程序和项目类型提供的功能。 |
如果您是刚开始使用 Visual Studio Tools for Office 创建 Microsoft Office Word 的文档级自定义项，则需要了解下面的内容。
单文档应用程序模型
创建的每个 Word 自定义项都基于单个文档。要开始使用自定义项，最终用户需打开文档或者基于 Word 模板创建文档。文档中的事件（例如将光标移入特定区域，或单击按钮和菜单项）可以调用程序集中的事件处理方法。有关更多信息，请参见文档级自定义项的体系结构。
使用宿主项宿主控件对 Word 文档编程
“宿主项”和“宿主控件”是为文档级自定义项提供编程模型的类。
宿主项为代码提供入口点，并且还充当诸如宿主控件和 Windows 窗体控件等控件的容器。Word 自定义项使用 Microsoft.Office.Tools.Word.Document 宿主项。此宿主项拥有设计器，它是项目中 Word 文档的可视化表示形式，与 Windows 窗体设计器相似。在项目中，此宿主项由 ThisDocument 类表示，该类派生自 Microsoft.Office.Tools.Word.Document 宿主项。有关更多信息，请参见宿主项和宿主控件概述和文档宿主项。
宿主控件基于本机 Word 对象，比如内容控件、书签和 XML 节点。宿主控件提供与本机 Word 对象类似的功能，但它们还具有新的事件、设计器支持和数据绑定功能。它们在 Visual Studio Tools for Office 编程模型和 IntelliSense 中作为第一类对象出现，从而可以更轻松地在您的代码中直接引用特定对象，而无需定位 Word 对象模型。有关更多信息，请参见宿主项和宿主控件概述和 Word 宿主控件。
Word 2003 和 Word 2007 的文档级项目中可用的宿主控件有所不同。在这两组项目中，您都可以使用 Bookmark 和 XMLNode 控件。在 Word 2007 项目中，您还可以使用内容控件。有关更多信息，请参见内容控件、Bookmark 控件和 XMLNode 控件。
将控件绑定到数据
内容控件和 Bookmark 控件位于可从“数据源”窗口中拖出的控件的列表中。以这种方式添加内容控件和书签会将它们自动绑定到您使用该窗口设置的数据源。无需编写任何代码，您就能够显示来自数据库、Web 服务和文档中的对象的数据。有关更多信息，请参见将数据绑定到控件。
自定义 Word 的用户界面
大多数 Microsoft Office 解决方案都会修改 Office 应用程序的用户界面 (UI)，以便为用户提供某种与解决方案交互的方式。使用文档级自定义项，可通过多种方式来修改 Word 的 UI。例如，您可以向功能区中添加控件、可以显示操作窗格，并且可以创建对用户在文档中键入的特定字符串进行响应的智能标记。有关更多信息，请参见 Office UI 自定义。
后续步骤
有关指导您完成 Word 自动化中的一些常见任务的主题列表，请参见 Office 编程中的常见任务。