DocumentExtensions.GetVstoObject Método

Definición

Sobrecargas

GetVstoObject(_Document, ApplicationFactory)

Devuelve un elemento host Document que extiende las funciones del objeto Document actual en un complemento en el nivel de la aplicación. Pase el objeto Globals.Factory de su proyecto al parámetro factory.

GetVstoObject(_Document, Factory)

Devuelve un elemento host Document que extiende las funciones del objeto Document actual en una personalización de nivel de documento. Pase el objeto Globals.Factory de su proyecto al parámetro factory.

GetVstoObject(_Document, ApplicationFactory)

Devuelve un elemento host Document que extiende las funciones del objeto Document actual en un complemento en el nivel de la aplicación. Pase el objeto Globals.Factory de su proyecto al parámetro factory.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Office::Tools::Word::Document ^ GetVstoObject(Microsoft::Office::Interop::Word::_Document ^ document, Microsoft::Office::Tools::Word::ApplicationFactory ^ factory);
public static Microsoft.Office.Tools.Word.Document GetVstoObject (this Microsoft.Office.Interop.Word._Document document, Microsoft.Office.Tools.Word.ApplicationFactory factory);
static member GetVstoObject : Microsoft.Office.Interop.Word._Document * Microsoft.Office.Tools.Word.ApplicationFactory -> Microsoft.Office.Tools.Word.Document
<Extension()>
Public Function GetVstoObject (document As _Document, factory As ApplicationFactory) As Document

Parámetros

document
_Document

El objeto de documento nativo que se va a extender. No proporcione este parámetro personalmente. Cuando llame a este método en un documento de Word, el tiempo de ejecución proporciona este parámetro.

factory
ApplicationFactory

Un objeto que proporciona acceso a determinadas características en su complemento en el nivel de la aplicación. Pase el objeto Globals.Factory a este parámetro.

Devoluciones

Un elemento host que extiende las funciones del objeto Document actual.

Comentarios

En un complemento de nivel de aplicación, llame a este método para extender cualquier documento que esté abierto en Word. Este método genera un nuevo Microsoft.Office.Tools.Word.Document elemento host si no se ha generado este objeto para el objeto en el Microsoft.Office.Interop.Word.Document que se llama a este método. Las llamadas posteriores a este método en el mismo Microsoft.Office.Interop.Word.Document objeto devuelven la misma Microsoft.Office.Tools.Word.Document instancia.

Este método se proporciona para la compatibilidad con versiones anteriores con proyectos de Office que se reasignan de .NET Framework 3.5 a .NET Framework 4 o .NET Framework 4.5. En proyectos nuevos que tienen como destino .NET Framework 4 o .NET Framework 4.5, debe llamar al GetVstoObject método proporcionado por el objeto en el Globals.Factory proyecto.

Para obtener más información, consulta Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.

Nota

El document parámetro es de tipo Microsoft.Office.Interop.Word._Document, que es la interfaz primaria de Microsoft.Office.Interop.Word.Document. Por lo tanto, este método extiende ambos tipos: Microsoft.Office.Interop.Word._Document y Microsoft.Office.Interop.Word.Document. Normalmente, cuando se hace referencia a un documento de Word, se usa .Microsoft.Office.Interop.Word.Document

Se aplica a

GetVstoObject(_Document, Factory)

Devuelve un elemento host Document que extiende las funciones del objeto Document actual en una personalización de nivel de documento. Pase el objeto Globals.Factory de su proyecto al parámetro factory.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Office::Tools::Word::Document ^ GetVstoObject(Microsoft::Office::Interop::Word::_Document ^ document, Microsoft::Office::Tools::Word::Factory ^ factory);
public static Microsoft.Office.Tools.Word.Document GetVstoObject (this Microsoft.Office.Interop.Word._Document document, Microsoft.Office.Tools.Word.Factory factory);
static member GetVstoObject : Microsoft.Office.Interop.Word._Document * Microsoft.Office.Tools.Word.Factory -> Microsoft.Office.Tools.Word.Document
<Extension()>
Public Function GetVstoObject (document As _Document, factory As Factory) As Document

Parámetros

document
_Document

El objeto de documento nativo que se va a extender. No proporcione este parámetro personalmente. Cuando llame a este método en un documento de Word, el tiempo de ejecución proporciona este parámetro.

factory
Factory

Un objeto que proporciona acceso a determinadas características en su personalización de nivel de documento. Pase el objeto Globals.Factory a este parámetro.

Devoluciones

Un elemento host que extiende las funciones del objeto Document actual.

Comentarios

En una personalización de nivel de documento, puede llamar a este método para obtener un Microsoft.Office.Tools.Word.Document elemento host que se encuentra en la personalización actual. Si el objeto en el Microsoft.Office.Interop.Word.Document que se llama a este método no es el objeto subyacente de un Microsoft.Office.Tools.Word.Document elemento host en la personalización actual, este método devuelve null.

Este método se proporciona para la compatibilidad con versiones anteriores con proyectos de Office que se reasignan de .NET Framework 3.5 a .NET Framework 4 o .NET Framework 4.5. En proyectos nuevos que tienen como destino .NET Framework 4 o .NET Framework 4.5, debe llamar al GetVstoObject método proporcionado por el objeto en el Globals.Factory proyecto. Para obtener más información, consulta Programming Document-Level Customizations.

Nota

El document parámetro es de tipo Microsoft.Office.Interop.Word._Document, que es la interfaz primaria de Microsoft.Office.Interop.Word.Document. Por lo tanto, este método extiende ambos tipos: Microsoft.Office.Interop.Word._Document y Microsoft.Office.Interop.Word.Document. Normalmente, cuando se hace referencia a un documento de Word, se usa .Microsoft.Office.Interop.Word.Document

Se aplica a