Word Nesne Modeline Genel Bakış

Makale
06/10/2015

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 hedefi: Bu konudaki bilgiler, Word 2013 ve Word 2010 için belge düzeyi projeler ve uygulama düzeyi projelere yöneliktir. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.

Bu konu, Word nesne modeli kısa bir genel bakış sağlar.Burada, bulabilir tüm Word nesne modeli hakkında daha fazla bilgi kaynakları için bkz: kullanarak Word nesne modeli 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 biri, birçok yöntem ve işlemek ve nesnesiyle etkileşim için erişebileceği özellikleri 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 örtüşmesi için nesneler görüntülenir.Ö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 Ana Bilgisayar Öğelerine ve Denetimlerine 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

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 Document nesnesi oluşturursunuz.Odaktaki belgeye etkin belge denir.Application nesnesinin ActiveDocument özelliği ile temsil edilir.

Visual Studio Office geliştirme araçları Document türünü sağlayarak Document nesnesini genişletir.Bu tür, 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, Document üyelerine, projenizde yaratılan ThisDocument sınıfını kullanarak erişebilirsiniz.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 Document konak öğelerini yaratabilirsiniz.Denetimler ilişkili belge eklemek için oluşturulan ana öğesini kullanarak kaldırabilirsiniz.Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentilerindeki Word Belgelerini ve Excel Çalışma Kitaplarını Çalışma Zamanında Genişletme.

Seçim Nesnesi

Selection nesnesi geçerli olan seçili alanı temsil eder.Word kullanıcı arabiriminde kalın metin gibi bir işlem gerçekleştirdiğinizde, seçin veya metni vurgulayın ve sonra 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

ContentControl, Word belgelerindeki girişi ve metnin sunusunu ve içeriğin diğer türlerini denetlemeniz için bir yol sağlar.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 birleşik giriş kutusu.ContentControl'ü kullanıcıların, belgenin veya şablonun bölümlerini düzenlemesini engellemek için de kullanabilirsiniz.

Visual Studio, ContentControl nesnesini farklı konak kontrollerine genişletir.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, RichTextContentControl'ünü zengin metin denetimi oluşturmak için veya DatePickerContentControl'ü tarih seçici oluşturmak için kullanabilirsiniz.Bu konak kontrolleri yerel ContentControl gibi davranır, ama ek olaylar ve veri bağlama yeteneklerine sahiptirler.Daha fazla bilgi için bkz. İçerik Denetimleri.

Yer İşareti Nesnesi

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.Bookmark nesnesi ekleme noktası içerebilir veya tüm belge büyüklüğünde olabilir.Bookmark, onu Range nesnesinden ayıran aşağıdaki özelliklere sahiptir:

Yer işaretini tasarım zamanında adlandırabilirsiniz.
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, Bookmark nesnesini Bookmark konak kontrolü sağlayarak genişletir.Bookmark konak kontrolü, yerel 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'ün birincil birlikte çalışma derlemesi (PIA) başvuru ve Visual Basic for Applications (vba) nesne modeli başvurusu başvurabilirsiniz.

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 birincil birlikte çalışma derlemesi başvurusu.

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

vba nesne modeli başvurusu

vba kodunu gösterilen vba nesne modeli başvurusu Word nesne modeli belgelemektedir.Daha fazla bilgi için bkz: Word 2010 nesne modeli başvurusu.

Tüm nesneleri ve vba nesne modeli Başvurusu'ndaki üye türleri ve Word PIA üyeleri karşılık gelir.Örneğin, Document karşılık gelen nesne vba nesne modeli Başvurusu'nda Document Word PIA içindeki nesne.vba nesne modeli başvurusu kod örnekleri çoğu özelliklerini, yöntemlerini ve olaylarını sağlasa da, bu başvuruyu Visual Basic, vba kodu çevirmesi gerekir veya Visual C# Word kullanmak isterseniz, project Visual Studio kullanarak oluşturun.