ApplicationFactory.GetVstoObject(_Document) Yöntem

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools.Word

Bütünleştirilmiş Kodlar:: Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

DocumentBelirtilen yerel belge nesnesinin işlevselliğini genişleten bir konak öğesi döndürür.

public Microsoft.Office.Tools.Word.Document GetVstoObject (Microsoft.Office.Interop.Word._Document document);

Parametreler

document: _Document

Genişletilecek yerel belge nesnesi. Bu parametre türünde olsa da _Document , genellikle Document Bu yönteme bir nesne geçirirsiniz.

Döndürülenler

Document

Yerel belge nesnesinin işlevselliğini genişleten bir konak öğesi.

Örnekler

Aşağıdaki kod örneği, Microsoft.Office.Tools.Word.Document etkin Word belgesi için bir konak öğesi oluşturur. Örnek daha sonra belgeye bir ekler PlainTextContentControl . Bu kodu kullanmak için, ThisAddIn veya öğesini hedefleyen bir Word eklentisi projesindeki sınıfından çalıştırın .NET Framework 4 .NET Framework 4.5 .

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

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"

Açıklamalar

Word 'de açık olan herhangi bir belgeyi özelleştirmek için uygulama düzeyi eklentideki bu yöntemi çağırın. Bu yöntem Microsoft.Office.Tools.Word.Document , böyle bir nesne oluşturulmadıysanız yeni bir nesne oluşturur. Bu yöntemin sonraki çağrıları, varolan nesnenin önbelleğe alınmış örneğini döndürür Microsoft.Office.Tools.Word.Document . Daha fazla bilgi için bkz. çalışma ZAMANıNDA VSTO Eklentilerindeki Word belgelerini ve Excel çalışma kitaplarını genişletme.

Not

VSTO, "makrolar etkin" veya "varsayılan olarak makroları devre dışı bırak" olarak ayarlandığında "Otomasyon güvenliği" Office Grup İlkesi ayarını izler. Ancak, uygulama ayarından bağımsız olarak, bu ayar "uygulama makrosu güvenlik düzeyini kullan" olarak ayarlandıysa, VSTO her zaman otomasyonun çalışmasına izin verir. VSTO 'ın Otomasyon çalışmasına izin vermesini engellemek için, "varsayılan olarak makroları devre dışı bırak" ayarını seçin.

documentParametresi Microsoft.Office.Interop.Word._Document , öğesinin üst arabirimi olan türüdür Microsoft.Office.Interop.Word.Document . Bu nedenle, bu yöntem her iki türdeki nesneleri kabul edebilir: Microsoft.Office.Interop.Word._Document ve Microsoft.Office.Interop.Word.Document . Genellikle, bir Word belgesine başvuru yaptığınızda bir kullanırsınız Microsoft.Office.Interop.Word.Document .

Şunlara uygulanır