DocumentExtensions.GetVstoObject Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 |
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 |
GetVstoObject(_Document, ApplicationFactory)
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)
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