文档宿主项
Document 宿主项类型从 Word 的主互操作程序集扩展 Microsoft.Office.Interop.Word.Document 类型。Document 宿主项提供的属性、方法和事件与 Microsoft.Office.Interop.Word.Document 对象提供的属性、方法和事件完全相同,但它也公开其他事件并且充当宿主控件和 Windows 窗体控件的容器。
**适用于:**本主题中的信息适用于 Word 2013 和 Word 2010 的文档级项目和应用程序级项目。有关更多信息,请参见按 Office 应用程序和项目类型提供的功能。
在文档级项目中,有一个表示项目中的文档的默认 Document 宿主项。在应用程序级项目中,可以在运行时生成 Document 宿主项。
了解文档级项目中的文档宿主项
若要访问项目中的文档,请使用 ThisDocument 类。当创建文档级项目时,Visual Studio 会生成 ThisDocument 类以充当 Word 与您的自定义项代码之间的通信链接。通过使用 ThisDocument 类,可以访问 Document 宿主项的成员,以执行自定义项中的基本任务,如在打开或关闭文档时运行代码。还可以使用选件类用于向文档添加控件。通过组合不同的控件集并编写代码,可将控件绑定到数据,从用户那里收集信息并对用户操作做出响应。有关更多信息,请参见对文档级自定义项进行编程。
可以从 ThisDocument 类开始在项目中编写代码。因为此类提供的属性、方法和事件与 Word 的主互操作程序集中的 Microsoft.Office.Interop.Word.Document 对象提供的属性、方法和事件完全相同,所以也可以使用 ThisDocument 访问 Word 的对象模型。有关更多信息,请参见Word 对象模型概述。
文档级项目中文档宿主项的限制
文档级项目只能包含一个 Document 宿主项(即 ThisDocument 类)。无法在设计时向项目添加新的 Document 宿主项,并且无法在运行时从文档级自定义项创建新的 Document 宿主项。
如果在运行时创建新的 Word 文档,则该文档将为 Microsoft.Office.Interop.Word.Document 类型。因为它不是一个宿主项,所以它不能包含任何宿主控件或 Windows 窗体控件。有关在运行时创建文档的更多信息,请参见如何:以编程方式新建文档。
了解应用程序级项目中的文档宿主项
在应用程序级项目中,可以在运行时为 Word 中打开的任何文档生成 Document 宿主项。可以使用 Document 宿主项将控件添加到关联的文档,或对不在 Microsoft.Office.Interop.Word.Document 对象的事件。
若要生成 Document 宿主项,请使用 GetVstoObject 方法。有关更多信息,请参见在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿。
请参见
概念
在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿