ApplicationFactory.GetVstoObject (Método)

Devuelve un elemento host Microsoft.Office.Tools.Word.Document que extiende la funcionalidad del objeto de documento nativo especificado.

Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblados: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Microsoft.Office.Tools.Word.v4.0.Utilities (en Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxis

'Declaración
Function GetVstoObject ( _
    document As _Document _
) As Document

Document GetVstoObject(
    _Document document
)

Parámetros

document
Tipo: Microsoft.Office.Interop.Word._Document
Objeto de documento nativo que se va a extender.Aunque este parámetro es de tipo Microsoft.Office.Interop.Word._Document, normalmente se pasa un objeto Microsoft.Office.Interop.Word.Document a este método.

Valor devuelto

Tipo: Microsoft.Office.Tools.Word.Document
Elemento host que extiende la funcionalidad del objeto de documento nativo.

Comentarios

Llame a este método en un complemento en el nivel de la aplicación para personalizar cualquier documento que esté abierto en Word.Este método genera un nuevo objeto Microsoft.Office.Tools.Word.Document si aún no se ha generado ninguno.Llamadas subsiguientes a este método devuelven la instancia almacenada en memoria caché del objeto Microsoft.Office.Tools.Word.Document existente.Para obtener más información, vea Ampliar documentos de Word y libros de Excel en complementos en el nivel de la aplicación en tiempo de ejecución.

[!NOTA]

El parámetro document es de tipo Microsoft.Office.Interop.Word._Document, que es la interfaz primaria de Microsoft.Office.Interop.Word.Document.Por consiguiente, este método puede aceptar objetos de ambos tipos: Microsoft.Office.Interop.Word._Document y Microsoft.Office.Interop.Word.Document.Normalmente, al hacer referencia a un documento de Word, se utiliza un Microsoft.Office.Interop.Word.Document.

Ejemplos

En el ejemplo de código siguiente se crea un elemento host Microsoft.Office.Tools.Word.Document para el documento de Word activo.A continuación, el ejemplo agrega un PlainTextContentControl al documento.Para utilizar este código, ejecútelo desde la clase de ThisAddIn en un proyecto de complemento de word destinado a .NET Framework 4 o .NET Framework 4.5.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.