ApplicationFactory.GetVstoObject 方法

發行項
08/12/2011

傳回 Microsoft.Office.Tools.Word.Document 主項目，這個主項目可擴充指定之原生文件物件的功能。

命名空間： Microsoft.Office.Tools.Word
組件： Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.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
可擴充原生文件物件功能的主項目。

備註

在應用程式層級增益集 (Add-In) 內呼叫這個方法，即可自訂任何以 Word 開啟的文件。如果之前沒有產生任何 Microsoft.Office.Tools.Word.Document 物件，這個方法會產生此一新物件。對這個方法的後續呼叫會傳回現有 Microsoft.Office.Tools.Word.Document 物件的快取執行個體 (Instance)。如需詳細資訊，請參閱在應用程式層級增益集的執行階段中擴充 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 加入文件中。若要使用這個程式碼，請在以 .NET Framework 4 為目標的 Word 增益集專案中，從 ThisAddIn 類別執行。

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";