DocumentExtensions.GetVstoObject Méthode

Définition

Surcharges

GetVstoObject(_Document, ApplicationFactory)

Retourne un élément hôte Document qui étend les fonctionnalités de l’objet Document actuel dans un complément de niveau application. Transmettez l’objet Globals.Factory de votre projet au paramètre factory.

GetVstoObject(_Document, Factory)

Retourne un élément hôte Document qui étend les fonctionnalités de l’objet Document actuel dans une personnalisation au niveau du document. Transmettez l’objet Globals.Factory de votre projet au paramètre factory.

GetVstoObject(_Document, ApplicationFactory)

Retourne un élément hôte Document qui étend les fonctionnalités de l’objet Document actuel dans un complément de niveau application. Transmettez l’objet Globals.Factory de votre projet au paramètre factory.

public static Microsoft.Office.Tools.Word.Document GetVstoObject (this Microsoft.Office.Interop.Word._Document document, Microsoft.Office.Tools.Word.ApplicationFactory factory);

Paramètres

document
_Document

Objet document natif à étendre. Ne spécifiez pas ce paramètre vous-même. Si vous appelez cette méthode sur un document Word, le runtime fournit ce paramètre.

factory
ApplicationFactory

Objet qui fournit l’accès à certaines fonctionnalités de votre complément de niveau application. Transmettez l’objet Globals.Factory à ce paramètre.

Retours

Document

Élément hôte qui étend les fonctionnalités de l’objet Document actuel.

Remarques

Dans un complément au niveau de l’application, appelez cette méthode pour étendre tout document ouvert dans Word. Cette méthode génère un nouvel Microsoft.Office.Tools.Word.Document élément hôte si aucun objet de ce type n’a déjà été généré pour l' Microsoft.Office.Interop.Word.Document objet sur lequel vous appelez cette méthode. Les appels suivants à cette méthode sur le même Microsoft.Office.Interop.Word.Document objet retournent la même Microsoft.Office.Tools.Word.Document instance.

Cette méthode est fournie pour des raisons de compatibilité descendante avec les projets Office que vous reciblez du .NET Framework 3.5 vers .NET Framework 4 ou .NET Framework 4.5. Dans les projets qui ciblent .NET Framework 4 ou .NET Framework 4.5, vous devez appeler la méthode GetVstoObject fournie par l'objet Globals.Factory de votre projet.

Pour plus d'informations, consultez Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.

Notes

Le document paramètre est de type Microsoft.Office.Interop.Word._Document , qui est l’interface parente de Microsoft.Office.Interop.Word.Document . Par conséquent, cette méthode étend les deux types : Microsoft.Office.Interop.Word._Document et Microsoft.Office.Interop.Word.Document . En règle générale, lorsque vous référencez un document Word, vous utilisez un Microsoft.Office.Interop.Word.Document .

S’applique à

GetVstoObject(_Document, Factory)

Retourne un élément hôte Document qui étend les fonctionnalités de l’objet Document actuel dans une personnalisation au niveau du document. Transmettez l’objet Globals.Factory de votre projet au paramètre factory.

public static Microsoft.Office.Tools.Word.Document GetVstoObject (this Microsoft.Office.Interop.Word._Document document, Microsoft.Office.Tools.Word.Factory factory);

Paramètres

document
_Document

Objet document natif à étendre. Ne spécifiez pas ce paramètre vous-même. Si vous appelez cette méthode sur un document Word, le runtime fournit ce paramètre.

factory
Factory

Objet qui fournit l’accès à certaines fonctionnalités de votre personnalisation au niveau du document. Transmettez l’objet Globals.Factory à ce paramètre.

Retours

Document

Élément hôte qui étend les fonctionnalités de l’objet Document actuel.

Remarques

Dans une personnalisation au niveau du document, vous pouvez appeler cette méthode pour obtenir un Microsoft.Office.Tools.Word.Document élément hôte qui se trouve dans la personnalisation actuelle. Si l' Microsoft.Office.Interop.Word.Document objet sur lequel vous appelez cette méthode n’est pas l’objet sous-jacent d’un Microsoft.Office.Tools.Word.Document élément hôte dans la personnalisation actuelle, cette méthode retourne null .

Cette méthode est fournie pour des raisons de compatibilité descendante avec les projets Office que vous reciblez du .NET Framework 3.5 vers .NET Framework 4 ou .NET Framework 4.5. Dans les projets qui ciblent .NET Framework 4 ou .NET Framework 4.5, vous devez appeler la méthode GetVstoObject fournie par l'objet Globals.Factory de votre projet. Pour plus d'informations, consultez Programming Document-Level Customizations.

Notes

Le document paramètre est de type Microsoft.Office.Interop.Word._Document , qui est l’interface parente de Microsoft.Office.Interop.Word.Document . Par conséquent, cette méthode étend les deux types : Microsoft.Office.Interop.Word._Document et Microsoft.Office.Interop.Word.Document . En règle générale, lorsque vous référencez un document Word, vous utilisez un Microsoft.Office.Interop.Word.Document .

S’applique à