Metodo ApplicationFactory.GetVstoObject

Articolo
05/17/2013

Restituisce un elemento host Microsoft.Office.Tools.Word.Document che estende la funzionalità dell'oggetto documento nativo specificato.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Function GetVstoObject ( _
    document As _Document _
) As Document

Document GetVstoObject(
    _Document document
)

Parametri

document
Tipo: Microsoft.Office.Interop.Word._Document
Oggetto documento nativo da estendere.Sebbene questo parametro sia di tipo Microsoft.Office.Interop.Word._Document, a questo metodo viene in genere passato un oggetto Microsoft.Office.Interop.Word.Document.

Valore restituito

Tipo: Microsoft.Office.Tools.Word.Document
Elemento host che estende la funzionalità dell'oggetto documento nativo.

Note

Chiamare questo metodo in un componente aggiuntivo a livello di applicazione per personalizzare qualsiasi documento aperto in Word.Questo metodo genera un nuovo oggetto Microsoft.Office.Tools.Word.Document se un oggetto di questo tipo non è già stato generato.Le chiamate successive a questo metodo restituiscono l'istanza memorizzata nella cache dell'oggetto Microsoft.Office.Tools.Word.Document esistente.Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

[!NOTA]

Il parametro document è di tipo Microsoft.Office.Interop.Word._Document, che è l'interfaccia padre di Microsoft.Office.Interop.Word.Document.Pertanto, questo metodo può accettare oggetti di entrambi i tipi: Microsoft.Office.Interop.Word._Document e Microsoft.Office.Interop.Word.Document.In genere, quando si fa riferimento un documento di Word, si utilizza un oggetto Microsoft.Office.Interop.Word.Document.

Esempi

Nell'esempio di codice seguente viene creato un elemento host Microsoft.Office.Tools.Word.Document per il documento di Word attivo.Nell'esempio viene quindi aggiunto un oggetto PlainTextContentControl al documento.Per utilizzare questo codice, eseguirlo dalla classe di ThisAddIn in un progetto di componente aggiuntivo di Word destinato 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";

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.