Belge ana bilgisayar öğesi

Şunlar için geçerlidir:yes Mac noiçin Visual Studio noVisual Studio Visual Studio Code

Konak Document öğesi, türü Word için birincil birlikte çalışma derlemesinden genişleten Document bir türdür. Konak Document öğesi bir nesneyle Document aynı özelliklerin, yöntemlerin ve olayların tümünü sağlar, ancak ek olayları da kullanıma sunar ve konak denetimleri ile Windows Forms denetimleri için kapsayıcı görevi görür.

Şunlar için geçerlidir: Bu konudaki bilgiler, Word için belge düzeyi projeler ve VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Belge düzeyi projelerinde, projenizdeki belgeyi temsil eden varsayılan Document bir konak öğesi vardır. VSTO Eklenti projelerinde, çalışma zamanında konak öğeleri oluşturabilirsiniz Document .

Belge düzeyi projelerindeki belge konak öğesini anlama

Projenizdeki belgeye erişmek için sınıfını ThisDocument kullanın. Belge düzeyinde bir proje oluşturduğunuzda Visual Studio, Word ile özelleştirme kodunuz arasındaki iletişim bağlantısı görevi görecek sınıfı oluşturur ThisDocument . sınıfı, ThisDocument belge açıldığında veya kapatıldığında kod çalıştırma gibi özelleştirmenizdeki temel görevleri gerçekleştirmek için konak öğesinin üyelerine Document erişmenizi sağlar. Belgeye denetim eklemek için sınıfını da kullanabilirsiniz. Farklı denetim kümelerini birleştirerek ve kod yazarak, denetimleri verilere bağlayabilir, kullanıcıdan bilgi toplayabilir ve kullanıcı eylemlerine yanıt vekleyebilirsiniz. Daha fazla bilgi için bkz. Belge düzeyinde özelleştirmeleri programlama.

sınıfı, ThisDocument projenizde kod yazmaya başlayabileceğiniz bir konum sağlar. sınıfı, Word için birincil birlikte çalışma derlemesindeki nesneyle Document aynı özelliklerin, yöntemlerin ve olayların tümünü sağladığından, Word'ün nesne modeline erişmek için de kullanabilirsiniz ThisDocument . Daha fazla bilgi için bkz. Word nesne modeline genel bakış.

Belge düzeyi projelerindeki belge ana bilgisayar öğesinin sınırlamaları

Belge düzeyindeki bir proje yalnızca bir Document konak öğesi (yani ThisDocument sınıfı) içerebilir. Projenize tasarım zamanında yeni Document konak öğeleri ekleyemezsiniz ve belge düzeyinde özelleştirmeden çalışma zamanında yeni Document konak öğeleri oluşturamazsınız.

Çalışma zamanında yeni bir Word belgesi oluşturursanız, türünde olur Document. Bir konak öğesi olmadığından, herhangi bir konak denetimi veya Windows Forms denetimi içeremez. Ç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 projelerindeki belge konak öğelerini anlama

VSTO Eklenti projelerinde, Word'de açık olan herhangi bir belge için çalışma zamanında bir Document konak öğesi oluşturabilirsiniz. İlişkili Document belgeye denetimler eklemek veya nesnelerde Document bulunmayan olayları işlemek için konak öğesini kullanabilirsiniz.

Bir Document konak öğesi oluşturmak için yöntemini kullanın GetVstoObject . Daha fazla bilgi için bkz. Çalışma zamanında VSTO Eklentileri'nde Word belgelerini ve Excel çalışma kitaplarını genişletme.

Ayrıca bkz.