ApplicationFactory.GetVstoObject-Methode

Artikel
08/10/2011

Gibt ein Microsoft.Office.Tools.Word.Document-Hostelement zurück, das die Funktionalität des angegebenen systemeigenen Dokumentobjekts erweitert.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

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

Document GetVstoObject(
    _Document document
)

Parameter

document
Typ: Microsoft.Office.Interop.Word._Document
Das zu erweiternde systemeigene Dokumentobjekt.Obwohl dieser Parameter vom Typ Microsoft.Office.Interop.Word._Document ist, übergeben Sie i. d. R. ein Microsoft.Office.Interop.Word.Document-Objekt an diese Methode.

Rückgabewert

Typ: Microsoft.Office.Tools.Word.Document
Ein Hostelement, das die Funktionalität des systemeigenen Dokumentobjekts erweitert.

Hinweise

Rufen Sie diese Methode in einem Add-In auf Anwendungsebene auf, um ein beliebiges, in Word geöffnetes Dokument anzupassen. Diese Methode generiert ein neues Microsoft.Office.Tools.Word.Document-Objekt, falls ein solches Objekt nicht bereits generiert wurde. Nachfolgende Aufrufe dieser Methode geben die zwischengespeicherte Instanz des vorhandenen Microsoft.Office.Tools.Word.Document-Objekts zurück. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

Tipp

Der document-Parameter ist vom Typ Microsoft.Office.Interop.Word._Document, bei dem es sich um die übergeordnete Schnittstelle von Microsoft.Office.Interop.Word.Document handelt. Daher kann diese Methode Objekte beider Typen akzeptieren: Microsoft.Office.Interop.Word._Document und Microsoft.Office.Interop.Word.Document. Normalerweise wird mithilfe von Microsoft.Office.Interop.Word.Document auf ein Word-Dokument verwiesen.

Beispiele

Im folgenden Codebeispiel wird ein Microsoft.Office.Tools.Word.Document-Hostelement für das aktive Word-Dokument erstellt. Anschließend wird im Beispiel ein PlainTextContentControl zum Dokument hinzugefügt. Wenn Sie diesen Code verwenden möchten, führen Sie ihn von der ThisAddIn-Klasse in einem Word-Add-In-Projekt aus, das auf .NET Framework 4 abzielt.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.