ApplicationFactory.GetVstoObject – metoda

Článek
01/03/2014

Vrátí Microsoft.Office.Tools.Word.Document položku hostitele, který rozšiřuje funkčnost nativní zadaný dokument objektu.

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

Syntaxe

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

Document GetVstoObject(
    _Document document
)

Parametry

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

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.Document
Položku hostitele, který rozšiřuje funkčnost nativní document object.

Poznámky

Tuto metodu lze volejte v úrovni aplikace doplňku aplikace upravit libovolný dokument, který je otevřen v aplikaci Word.Tato metoda generuje nový Microsoft.Office.Tools.Word.Document objektu, pokud žádný takový objekt již byl vygenerován.Následující volání této metody vrátit existující instance mezipaměti Microsoft.Office.Tools.Word.Document objektu.Další informace naleznete v tématu Rozšíření dokumentů aplikace Word a sešitů aplikace Excel v doplňcích na úrovni aplikace za běhu.

[!POZNÁMKA]

document Parametr je typu Microsoft.Office.Interop.Word._Document, která je nadřazená rozhraní Microsoft.Office.Interop.Word.Document.Tato metoda proto přijmout obou typů objektů: Microsoft.Office.Interop.Word._Document a Microsoft.Office.Interop.Word.Document.Obvykle při odkazu dokument aplikace Word slouží Microsoft.Office.Interop.Word.Document.

Příklady

Následující příklad kódu vytvoří Microsoft.Office.Tools.Word.Document položku hostitele aktivního dokumentu aplikace Word.V příkladu je potom přidán PlainTextContentControl k dokumentu.Chcete-li použít tento kód, spusťte jej z ThisAddIn třídy v aplikaci Word přidat do projektu, který zaměřuje .NET Framework 4 nebo .NET Framework 4.5.

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.