ApplicationFactory.GetVstoObject 方法

项目
05/20/2013

返回一个 Microsoft.Office.Tools.Word.Document 宿主项，该宿主项可扩展指定的本机文档对象的功能。

命名空间： Microsoft.Office.Tools.Word
程序集： Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）
Microsoft.Office.Tools.Word.v4.0.Utilities（在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中）

语法

声明
Function GetVstoObject ( _
    document As _Document _
) As Document

Document GetVstoObject(
    _Document document
)

参数

document
类型：Microsoft.Office.Interop.Word._Document
要扩展的本机文档对象。尽管此参数的类型为 Microsoft.Office.Interop.Word._Document，但通常可将 Microsoft.Office.Interop.Word.Document 对象传递给此方法。

返回值

类型：Microsoft.Office.Tools.Word.Document
一个扩展本机文档对象功能的宿主项。

备注

在应用程序级外接程序中调用此方法可自定义在 Word 中打开的任何文档。此方法会生成一个新的 Microsoft.Office.Tools.Word.Document 对象（如果还没有生成此类对象）。对此方法的后续调用会返回现有的 Microsoft.Office.Tools.Word.Document 对象的缓存实例。有关更多信息，请参见在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿。

备注

document 参数属于 Microsoft.Office.Interop.Word._Document 类型，后者是 Microsoft.Office.Interop.Word.Document 的父接口。因此，此方法可以接受这两种类型的对象：Microsoft.Office.Interop.Word._Document 和 Microsoft.Office.Interop.Word.Document。通常情况下，引用 Word 文档时，使用 Microsoft.Office.Interop.Word.Document。

示例

下面的代码示例为活动 Word 文档创建 Microsoft.Office.Tools.Word.Document 主机项。该示例然后将 PlainTextContentControl 添加到文档。使用此代码，请运行它。ThisAddIn 选件类在面向 .NET Framework 4 或 .NET Framework 4.5的 Word 外接程序项目。

Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

vstoDoc.Paragraphs.Last.Range.InsertParagraphAfter()
Dim myPlainTextControl As PlainTextContentControl = _
    vstoDoc.Controls.AddPlainTextContentControl( _
    vstoDoc.Paragraphs.Last.Range, _
    "myPlainTextControl")
myPlainTextControl.PlaceholderText = "Insert first name"

Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

vstoDoc.Paragraphs.Last.Range.InsertParagraphAfter();
PlainTextContentControl myPlainTextControl =
    vstoDoc.Controls.AddPlainTextContentControl(
    vstoDoc.Paragraphs.Last.Range,
    "myPlainTextControl");
myPlainTextControl.PlaceholderText = "Insert first name";