Document (Belge) Konak Öğesi

Makale
02/26/2013

Document konak öğesi, Word içim birincil birlikte çalışma derlemesinden Microsoft.Office.Interop.Word.Document türünü genişleten bir türdür.Document konak öğesi, aynı özelliklerin, yöntemlerin ve olayların hepsini Microsoft.Office.Interop.Word.Document nesnesi olarak sağlar. Ayrıca ek olaylar da sağlar ve konak kontrolleriyle Windows Forms denetimleri için kapsayıcı olarak davranır.

Uygulama alanı: Bu konudaki bilgiler Word 2013 ve Word 2010 uygulamalarının belge düzeyi projelerine ve uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Belge düzeyi projelerinde, projenizi temsil eden varsayılan bir Document konak öğesi vardır.Uygulama düzeyi projesinde, çalışma zamanında Document konak öğelerini yaratabilirsiniz.

Belge Düzeyi Projelerinde Document Konak Öğesini Anlama

Projenizdeki belgeye erişmek için ThisDocument sınıfını kullanın.Visual Studio, Word için belge düzeyi projesi oluşturduğunuzda Word ve özelleştirme kodunuz arasında bir iletişim bağlantısı olarak hizmet vermesi için ThisDocument sınıfını oluşturur.Belge açıldığında ya da kapandığında kodu çalıştırmak gibi özelleştirmenizdeki temel görevleri gerçekleştirmeniz için, ThisDocument sınıfı Document konak öğesine erişiminizi sağlar.Sınıf belgeye denetim eklemek için de kullanabilirsiniz.Farklı denetim kümelerini ve kod yazmayı birleştirerek, veriyi denetimlere bağlayabilirsiniz, kullanıcıdan bilgi toplayabilirsiniz ve kullanıcı eylemlerine yanıt verebilirsiniz.Daha fazla bilgi için bkz. Belge Düzeyi Özelleştirmelerini Programlama.

ThisDocument sınıfı projenizde kod yazmaya başlayabileceğiniz bir yer sağlar.Bu sınıf Word için birincil birlikte çalışma derlemesindeki Microsoft.Office.Interop.Word.Document nesnesindeki özelliklerin, yöntemlerin ve olayların tümünün aynısını sağladığı için, ThisDocument öğesini Word'ün nesne modeline erişmek için de kullanabilrsiniz. Daha fazla bilgi için bkz. Word Nesne Modeline Genel Bakış.

Belge Düzeyi Projelerinde Document Konak Öğesinin Sınırlamaları

Belge düzeyi bir projede sadece bir tane Document konak öğesi olabilir, o da ThisDocument sınıfıdır.Projenize tasarım zamanında yeni Document konak öğeleri ekleyemezsiniz ve bir belge düzeyi özelleştirmesinde çalışma anında yeni Document konak öğeleri oluşturamazsınız.

Çalışma zamanında yeni bir Word belgesi oluşturursanız, bu Microsoft.Office.Interop.Word.Document'in türü olur.Bu bir konak öğesi olmadığı için, hiçbir konak kontrolü veya Windows Forms denetimi içermez.Çalışma zamanında belge oluşturma hakkında daha fazla bilgi için, bkz. Nasıl yapılır: Program Aracılığıyla Yeni Belgeler Oluşturma.

Uygulama Düzeyi Projelerinde Document Konak Öğelerini Anlama

Uygulama düzeyi projelerinde, Word'de açık olan herhangi bir belgede çalışma anında Document konak öğesini yaratabilirsiniz.Kullanabileceğiniz Document ilgili belgeye denetimler eklemek veya kullanılamaz olan olayları işlemek için konak öğesinin Microsoft.Office.Interop.Word.Document nesneler.

Document konak öğesi yaratmak için, GetVstoObject yöntemini kullanın.Daha fazla bilgi için bkz. Word Belgelerini ve Excel Çalışma Kitaplarını Çalıştırma Zamanında Uygulama Düzeyi Eklentileri İçinde Genişletme.