Aracılığıyla paylaş


Belge konak öğesi

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 projelerinde 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 aynı özelliklerin, yöntemlerin ve olayların Document 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 projelerinde belge konak öğesinin sınırlamaları

Belge düzeyi projesi 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. 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üzeyindeki projelerde belge konak öğelerini anlama

VSTO Eklenti projelerinde, Word'de açık olan tüm belgeler için çalışma zamanında bir Document konak öğesi oluşturabilirsiniz. İlişkili Document belgeye denetim eklemek veya nesnelerde Document kullanılamayan olayları işlemek için konak öğesini kullanabilirsiniz.

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