ApplicationFactory.GetVstoObject, méthode

Article
08/10/2011

Retourne un élément hôte Microsoft.Office.Tools.Word.Document qui étend les fonctionnalités de l'objet de document natif spécifié.

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Function GetVstoObject ( _
    document As _Document _
) As Document

Document GetVstoObject(
    _Document document
)

Paramètres

document
Type : Microsoft.Office.Interop.Word._Document
Objet de document natif à étendre.Bien que ce paramètre soit de type Microsoft.Office.Interop.Word._Document, vous passez généralement un objet Microsoft.Office.Interop.Word.Document à cette méthode.

Valeur de retour

Type : Microsoft.Office.Tools.Word.Document
Élément hôte qui étend les fonctionnalités de l'objet de document natif.

Notes

Appelez cette méthode dans un complément d'application pour personnaliser tout document ouvert dans Word. Cette méthode génère un nouvel objet Microsoft.Office.Tools.Word.Document si aucun objet de ce type n'a déjà été généré. Les appels suivants à cette méthode retournent l'instance mise en cache de l'objet Microsoft.Office.Tools.Word.Document existant. Pour plus d'informations, consultez Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution..

Notes

Le paramètre document est de type Microsoft.Office.Interop.Word._Document, ce qui correspond à l'interface parente de Microsoft.Office.Interop.Word.Document. Par conséquent, cette méthode peut accepter des objets de deux types: Microsoft.Office.Interop.Word._Document et Microsoft.Office.Interop.Word.Document. En général, lorsque vous référencez un document Word, vous utilisez Microsoft.Office.Interop.Word.Document.

Exemples

L'exemple de code suivant crée un élément hôte Microsoft.Office.Tools.Word.Document pour le document Word actif. L'exemple ajoute ensuite un PlainTextContentControl au document. Pour utiliser ce code, exécutez-le à partir de la classe ThisAddIn dans un projet de complément Word qui cible le .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";

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.