Método ApplicationFactory.GetVstoObject

Artigo
08/01/2011

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

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.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 de documento nativo para estender.Embora esse parâmetro é do tipo Microsoft.Office.Interop.Word._Document, você normalmente passar um Microsoft.Office.Interop.Word.Document o objeto a este método.

Valor de retorno

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

Comentários

Chame esse método em um suplemento do nível do aplicativo para personalizar qualquer documento que está aberto no Word. Esse método gera um novo Microsoft.Office.Tools.Word.Document se não há tal objeto já foi gerado de objeto. As chamadas subseqüentes a esse método retornam a instância em cache do existente Microsoft.Office.Tools.Word.Document objeto. For more information, see 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 document parâmetro é do tipo Microsoft.Office.Interop.Word._Document, que é a interface do pai do Microsoft.Office.Interop.Word.Document. Portanto, esse método pode aceitar objetos dos dois tipos: Microsoft.Office.Interop.Word._Document and Microsoft.Office.Interop.Word.Document. Normalmente, quando você faz referência a um documento do Word, você usa um Microsoft.Office.Interop.Word.Document.

O document parâmetro é do tipo Microsoft.Office.Interop.Word._Document, que é a interface do pai do Microsoft.Office.Interop.Word.Document. Portanto, esse método pode aceitar objetos dos dois tipos: Microsoft.Office.Interop.Word._Document and Microsoft.Office.Interop.Word.Document. Normalmente, quando você faz referência a um documento do Word, você usa um Microsoft.Office.Interop.Word.Document.

Exemplos

O exemplo de código a seguir cria um Microsoft.Office.Tools.Word.Document o item de host para o documento ativo do Word. O exemplo adiciona um PlainTextContentControl para o documento. Para usar esse código, executá-lo na ThisAddIn classe em um suplemento do projeto do Word que se destina a .NET Framework 4.

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.