ApplicationFactory.GetVstoObject – metoda

Článek
08/11/2011

Vrátí hostitelMicrosoft.Office.Tools.Word.Documentpoložka rozšiřuje funkčnost zadaný nativní objektdokumentu.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Function GetVstoObject ( _
    document As _Document _
) As Document

Document GetVstoObject(
    _Document document
)

Parametry

document
Typ: Microsoft.Office.Interop.Word._Document
objekt rozšíření dokumentu nativní .Ačkoli je tento parametr typu Microsoft.Office.Interop.Word._Document, obvykle předat Microsoft.Office.Interop.Word.Document objekt metody.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.Document
hostitelpoložka která rozšiřuje funkce nativní objektdokumentu.

Poznámky

Volání této metoda aplikace-úroveň doplněk upravit jakýkoli dokument otevřený v aplikaci Word. Tato metoda generuje nový Microsoft.Office.Tools.Word.Document objektu, pokud žádný takový objekt již byl vygenerován. Následná volání této metody vrátit mezipaměti existující instanci Microsoft.Office.Tools.Word.Document objektu. Další informace naleznete v tématu Extending Word Documents and Excel Workbooks in Application-Level Add-ins at Run Time.

Poznámka

document Typ parametru je Microsoft.Office.Interop.Word._Document, která je nadřazená rozhraní Microsoft.Office.Interop.Word.Document. Tuto metoda lze proto přijmout obou typů objektů: Microsoft.Office.Interop.Word._Documentand Microsoft.Office.Interop.Word.Document. Obvykle při odkazu na dokument aplikace Word použít Microsoft.Office.Interop.Word.Document.

Příklady

Následující příklad kódu vytváří Microsoft.Office.Tools.Word.Document hostitel položka pro aktivní dokument aplikace Word. Příklad přidá PlainTextContentControl do dokumentů. Chcete-li použít tento kód spustit z ThisAddIn třída v slovo doplněk projekt , který zaměřuje .NET Framework 4.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.