Word Nesne Modeline Genel Bakış

Makale
08/01/2011

Visual Studio'da Word çözümleri geliştirdiğinizde, Word nesne modeliyle etkileşime girersiniz. Bu nesne modeli, Microsoft.Office.Interop.Word isim uzayında tanımlanmış olup Word için sağlanan birincil birlikte çalışma derlemesinde sunulan sınıflardan ve arayüzlerden oluşur.

Uygulama alanı: Bu konudaki bilgiler Word 2007 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ü.

Bu konu, Word nesne modeli kısa bir genel bakış sağlar. Burada, öğrenin tüm Word nesne modeli hakkında daha fazla bilgi kaynakları için bkz: kullanarak Word nesne Model belgelerine.

Word nesne modelini kullanarak belli görevler gerçekleştirme konusunda daha fazla bilgi için, aşağıdaki konulara bakın:

Word Nesne Modelini Anlama

Word etkileşime girebileceğiniz yüzlerce nesne sağlar. Bu nesneler kullanıcı arayüzünü yakından takip eden bir hiyerarşi içinde düzenlenmiştir. Hiyerarşinin en üst noktası Application nesnesidir. Bu nesne Word'ün geçerli örneğini temsil eder. Application nesnesi, Document, Selection, Bookmark ve Range nesneleri içerir. Bu nesnelerin her birinin onlara erişip değiştirebileceğiniz ve onlarla etkileşime girebileçeğiniz birçok yöntemi ve özelliği vardır.

Aşağıdaki gösterimde, Word nesne modelinin hiyerarşisindeki bu nesnelerin bir görünümü gösterilir.

Word Nesne Modeli Özeti

Word Nesne Modeli grafiği

İlk bakışta, birçok örtüşme varmış gibi görünür. Örneğin, Document ve Selection nesnelerinin ikisi de, Application nesnesinin üyeleridir, ama Document nesnesi de Selection nesnesinin bir üyesidir. Document ve Selection nesnelerinin her ikisi de Bookmark ve Range nesneleri içerir. Aynı tür nesneye ulaşmanın birçok yolu olduğu için örtüşme vardır. Örneğin, Range nesnesine biçimlendirme uygularsınız; ama geçerli seçimin, belli paragrafın, bölümün veya tüm belgenin bir aralığına erişmek istersiniz.

Aşağıdaki bölümde, üst düzey nesneler ve bu nesnelerin birbirleriyle etkileşimi kısaca açıklanmaktadır. Bu öğeler aşağıdaki beşini kapsar:

Uygulama nesnesi
Belge nesnesi
Seçim nesnesi
Aralık nesnesi
Yer işareti nesnesi

Word nesne modeline ek olarak Visual Studio'daki Office Project, Word nesne modelindeki bazı nesneleri genişleten konak öğesi ve konak kontrolü'nü sağlar. Konak öğesi ve konak kontrolü genişlettikleri Word nesneleri gibi davranırlar fakat aynı zamanda veri bağlama becerileri ve fazladan olaylar gibi ek işlevlere sahiptirler. Daha fazla bilgi için, bkz. Genişletilmiş Nesneleri Kullanarak Word'ü Otomatikleştirme ve Konak Öğeleri ve Konak Kontrollerine Genel Bakış.

Uygulama Nesnesi

Application nesnesi Word uygulamasını temsil eder ve diğer tüm nesnelerin üstüdür. Üyeleri genellikle Word'e bir bütün olarak uygular. Onun özelliklerini ve yöntemlerini, Word ortamını denetlemek için kullanabilirsiniz.

Uygulama düzeyi eklentisi projelerinde, Application nesnesine ThisAddIn sınıfının Application alanını kullanarak erişebilirsiniz. Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentileri Programlama.

Belge düzeyi projelerinde, Application nesnesine ThisDocument sınıfının Application özelliğini kullanarak erişebilirsiniz.

Belge Nesnesi

Microsoft.Office.Interop.Word.Document nesnesi Word programlamasında esastır. Belgeyi onun tüm bileşenlerini temsil eder. Bir Word belgesi açtığınızda ya da yeni bir belge oluşturduğunuzda Application nesnesinin Documents koleksiyonuna eklenen yeni bir Microsoft.Office.Interop.Word.Document nesnesi oluşturursunuz. Odaktaki belgeye etkin belge denir. Application nesnesinin ActiveDocument özelliği ile temsil edilir.

Visual Studio Office geliştirme araçları Microsoft.Office.Tools.Word.Document türünü sağlayarak Microsoft.Office.Interop.Word.Document nesnesini genişletir. Bu tür, Microsoft.Office.Interop.Word.Document nesnesinin tüm özelliklerine erişmenizi sağlayan konak öğesi'dir ve ek olayları ve yönetilen denetimlerini eklemeniz için yetenek ekler.

Belge düzeyi projesi oluşturduğunuzda, Microsoft.Office.Tools.Word.Document üyelerine, projenizde yaratılan ThisDocument sınıfını kullanarak erişebilirsiniz. Microsoft.Office.Tools.Word.Document konak öğesinin üyelerine, ThisDocument sınıfındaki koddan Me veya this anahtar kelimelerini kullanarak veya ThisDocument sınıfının dışındaki koddan Globals.ThisDocument kullanarak erişebilirsiniz. Daha fazla bilgi için bkz. Belge Düzeyi Özelleştirmelerini Programlama. Örneğin, belgedeki ilk paragrafı seçmek için aşağıdaki kodu kullanın.

Me.Paragraphs(1).Range.Select()

this.Paragraphs[1].Range.Select();

Uygulama düzeyi projesinde, çalışma zamanında Microsoft.Office.Tools.Word.Document konak öğelerini yaratabilirsiniz. Yaratılan konak öğesini, denetimleri ve akıllı etiketleri ilgili belgeye eklemek için kullanabilirsiniz. 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.

Not

Excel 2010 ve Word 2010'de akıllı etiketlerin kullanımı terk edilmiştir. Daha fazla bilgi için bkz. Akıllı Etiketlere Genel Bakış.

Seçim Nesnesi

Selection nesnesi geçerli olan seçili alanı temsil eder. Word kullanıcı arayüzünde, metni kalınlaştırmak gibi bir işlem gerçekleştirdiğinizde, metni seçin veya vurguyalın ve ardından biçimlendirmeyi uygulayın. Selection nesnesi, her zaman bir belgede temsil edilir. Eğer hiçbir şey seçili değilse, o zaman ekleme noktasını temsil eder. Buna ek olarak, bir seçim ardışık olmayan çoklu metin bloklarını kapyasabilir.

Seri Nesnesi

Range nesnesi, belgedeki ardışık bir alanı temsil eder ve başlangıç karakterinin konumu ve bitiş karakterinin konumu tarafından tanımlanır. Tek bir Range nesnesiyle sınırlı değilsiniz. Aynı belgedeki çoklu Range nesneleri tanımlayabilirsiniz. Range nesnesi aşağıdaki özelliklere sahiptir:

Sadece ekleme noktasına, metin aralığına veya yüm belgeye sahip olabilir.
Boşluk, sekme karakterleri ve paragraf işaretleri gibi yazdırılamayan karakterler içerir.
Geçerli seçim tarafından temsil edilen alan olabilir veya geçerli seçimden farklı bir alanı temsil edebilir.
Belgede, her zaman görünenen seçim gibi görünür değildir.
Belgeyle kaydedilmez ve sadece kod çalışırken varolur.

Aralığın sonuna metin eklediğinizde, Word eklenen metni kapsamak için otomatik olarak aralığı genişletir.

İçerik Denetim Nesneleri

Microsoft.Office.Interop.Word.ContentControl, Word belgelerindeki girişi ve metnin sunusunu ve içeriğin diğer türlerini denetlemeniz için bir yol sağlar. Microsoft.Office.Interop.Word.ContentControl, Word belgelerinde kullanım için en iyileştirilmiş birçok farklı UI türlerini görüntüler, örn. zengin metin denetimi, tarih seçici veya açılan kutu. Microsoft.Office.Interop.Word.ContentControl'ü kullanıcıların, belgenin veya şablonun bölümlerini düzenlemesini engellemek için de kullanabilirsiniz.

Visual Studio, Microsoft.Office.Interop.Word.ContentControl nesnesini farklı konak kontrollerine genişletir. Microsoft.Office.Interop.Word.ContentControl nesnesi içerik denetimleri için kullanılabilir olan farklı UI türlerden harhangi birini görüntüyebilirken, Visual Studio her içerik denetimi için farklı bir tür sağlar. Örneğin, Microsoft.Office.Tools.Word.RichTextContentControl'ünü zengin metin denetimi oluşturmak için veya Microsoft.Office.Tools.Word.DatePickerContentControl'ü tarih seçici oluşturmak için kullanabilirsiniz. Bu konak kontrolleri yerel Microsoft.Office.Interop.Word.ContentControl gibi davranır, ama ek olaylar ve veri bağlama yeteneklerine sahiptirler. Daha fazla bilgi için bkz. İçerik Denetimleri.

Yer İşareti Nesnesi

Microsoft.Office.Interop.Word.Bookmark nesnesi, belgedeki ardışık bir alanı başlangıç karakterinin konumu ve bitiş karakterinin konumu ile temsil eder. Yer işaretlerini, belgede bir konumu işaretlemek için veya belgedeki metin için bir kapsayıcı olarak kullanabilirsiniz. Microsoft.Office.Interop.Word.Bookmark nesnesi ekleme noktası içerebilir veya tüm belge büyüklüğünde olabilir. Microsoft.Office.Interop.Word.Bookmark, onu Range nesnesinden ayıran aşağıdaki özelliklere sahiptir:

Yer işaretini tasarım zamanında adlandırabilirsiniz.
Microsoft.Office.Interop.Word.Bookmark nesneleri belge ile kaydedilir ve böylece kod çalışmadığında veya belge kapatıldığında silinmez.
Yer işaretleri, View nesnesinin ShowBookmarks özelliğini false veya true'ya ayarlayarak gizli veya görünür yapılabilir.

Visual Studio, Microsoft.Office.Interop.Word.Bookmark nesnesini Microsoft.Office.Tools.Word.Bookmark konak kontrolü sağlayarak genişletir. Microsoft.Office.Tools.Word.Bookmark konak kontrolü, yerel Microsoft.Office.Interop.Word.Bookmark gibi davranır ama ek olaylar ve veri bağlama yeteneklerine sahiptir. Windows Forms'da metin kutusu denetimine veri bağladığınız gibi belgedeki yer işareti denetimine veri bağlayabilirsiniz. Daha fazla bilgi için bkz. Yer İşareti Denetimi.

Word Nesne Model Belgelerini Kullanma

Word nesne modeli hakkında tam bilgi için Word birincil birlikte çalışma derlemesi (PIA) başvuru ve vba nesne modeli başvurusu başvuru yapabilirsiniz.

Birincil Birlikte Çalışma Başvuru Kaynağı

Word PIA başvuru belgelerini Word için birincil birlikte çalışma derlemesini türlerini açıklar. Bu belge aşağıdaki konumdan edinilebilir: Word 2010 Primary Interop Assembly başvuru.

Not

Word 2007 PIA şu anda açıklanmamıştır. Ancak, bu başvuru belgelerindeki bilgiler de Word 2007 için geçerlidir böylece Word 2007 PIA içindeki türleri de Word 2010 PIA eklenir.

PIA ve PIA içindeki olayları nasıl uygulandığını, sınıflar ve arabirimler arasında farklılıklar gibi Word PIA tasarımı hakkında daha fazla bilgi için bkz: sınıfları, genel bakış ve Office Primary Interop Assemblies Arabirimleri'nde.

vba nesne modeli başvurusu

Word nesne modeli'olarak Visual Basic for Applications (vba) kodunu kullanıma vba nesne modeli başvuru belgeleri. Word vba nesne modeli başvurusu aşağıdaki konumlardan edinilebilir:

Tüm nesneleri ve vba nesne modeli başvurusu üyelerinde türleri ve Word PIA üyeleri karşılık gelir. Örneğin, Document vba nesne modeli başvurusu nesnesinde karşılık geldiğini Microsoft.Office.Interop.Word.Document nesneyi Word'de PIA. vba nesne modeli başvurusu kod örnekleri çoğu özelliklerini, yöntemlerini ve olaylarını sağlasa da, bunları projesinde Visual Studio kullanarak oluşturduğunuz Word kullanmak istiyorsanız, bu Visual Basic veya Visual C# Başvurusu vba kodunda çevirmesi gerekir.