Método ApplicationFactory.GetVstoObject

Artigo
05/21/2013

Retorna um item de host de Microsoft.Office.Tools.Word.Document que estende a funcionalidade do objeto nativo de documento especificado.

Namespace: Microsoft.Office.Tools.Word
Assemblies: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)
Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxe

'Declaração
Function GetVstoObject ( _
    document As _Document _
) As Document

Document GetVstoObject(
    _Document document
)

Parâmetros

document
Tipo: Microsoft.Office.Interop.Word._Document
O objeto nativo de documento para estender.Embora esse parâmetro é do tipo Microsoft.Office.Interop.Word._Document, você normalmente passa um objeto de Microsoft.Office.Interop.Word.Document para este método.

Valor de retorno

Tipo: Microsoft.Office.Tools.Word.Document
Um item host que estende a funcionalidade do objeto nativo do documento.

Comentários

Chamar esse método em um suplemento ao nível para personalizar qualquer documento que está aberto em Word.Este método gera um novo objeto de Microsoft.Office.Tools.Word.Document se nenhum tal objeto já foi gerado.Chamadas subsequentes a esse método retornar a instância em cache do objeto existente de Microsoft.Office.Tools.Word.Document .Para obter mais informações, consulte Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

Observação
O parâmetro de document é do tipo Microsoft.Office.Interop.Word._Document, que é a interface pai de Microsoft.Office.Interop.Word.Document.Como consequência, esse método pode aceitar objetos de dois tipos: Microsoft.Office.Interop.Word._Document e Microsoft.Office.Interop.Word.Document.Normalmente, quando você referencia um documento do Word, você usa Microsoft.Office.Interop.Word.Document.

O parâmetro de document é do tipo Microsoft.Office.Interop.Word._Document, que é a interface pai de Microsoft.Office.Interop.Word.Document.Como consequência, esse método pode aceitar objetos de dois tipos: Microsoft.Office.Interop.Word._Document e Microsoft.Office.Interop.Word.Document.Normalmente, quando você referencia um documento do Word, você usa Microsoft.Office.Interop.Word.Document.

Exemplos

O exemplo de código a seguir cria um item de host de Microsoft.Office.Tools.Word.Document para o documento ativo do Word.O exemplo adiciona em PlainTextContentControl ao documento.Para usar este código, ele execução da classe de ThisAddIn em um projeto do suplemento ao Word que tem como alvo .NET Framework 4 ou .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";

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.