XMLNodes Denetimi

Makale
08/01/2011

Önemli Microsoft Word ile ilgili, bu konudaki ayarlanan bilgileri yararı ve kullanımı, kişi ve kuruluşların kim ABD ve kendi bölgeleri dışında bulunan veya kimin kullanarak veya Ocak 2010, Microsoft Microsoft Word'den özel XML ilişkili belirli işlevler uygulaması ne zaman kaldırıldı önce Microsoft tarafından lisanslı Microsoft Word ürünleri üzerinde çalışan programlar geliştirmek için özel olarak sunulur. Bu bilgiler Microsoft Word ile ilgili değil okunamaz veya Bireylere veya kuruluşlara ABD veya kullanma veya Microsoft tarafından 10 Ocak 2010'dan sonra lisanslı Microsoft Word'ün ürünleri hakkında çalışan programlar geliştirmek, bölgeler tarafından kullanılan; Bu ürünleri bu tarihten önce lisanslı veya satın alınan ve ABD dışında kullanmak için lisanslı ürünleri ile aynı davranmaz.

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

XMLNodes denetimi, olaylar ortaya çıkaran eşlenmiş bir XML düğümü derlemidir. XMLNodes denetimi, sadece tekrarlanan bir şema öğesi Microsoft Office Word belgesine eşlendiğinde oluşturulur. Eğer tekrarlanan öğe alt öğeleri de içeriyorsa, alt öğelerin her biri de bir XMLNodes denetimi olarak oluşturulur.

Visual Studio XML düğümü derlemi oluşturduktan sonra, Word nesne modeline çapraz geçiş yapmak zorunda kalmadan bu denetime dayalı programlama yapabilirsiniz. Word'de XMLNodes denetimi belgeden sadece öğe eşlemesi kaldırılarak silinebilir.

Not

Eğer XMLNodes denetiminin alt öğesine Item özelliği aracılığıyla erişirseniz, bir Microsoft.Office.Tools.Word.XMLNode denetimi yerine bir Microsoft.Office.Interop.Word.XMLNode nesnesi döndürülür. Daha fazla bilgi için bkz. Ana Bilgisayar Öğelerinin ve Ana Bilgisayar Denetimlerinin Programsal Sınırlamaları.

Denetimlere Veri Bağlama

XMLNodes denetimi veri bağlamasını desteklemez. Çünkü, XMLNodes denetimi karmaşık veri bağlama yeteneğine sahip değildir ve basit veri bağlama tekrarlayan verileri temsil edemez.

Biçimlendirme

Belgede metinlere uygulanabilen her biçimlendirme XMLNodes denetimine uygulanabilir.

Olaylar

XMLNodes denetimi için kullanılabilir olan olaylar:

Olayları Karşılaştırma

Kullanıcı imlecini belirli bir XMLNodes denetiminin bağlamının içine hareket ettirdiği zaman bir olay yakalayabilirsiniz. Örneğin, Customer adındaki bir XMLNodes denetiminizin Company adında bir XMLNodes denetimi olan bir çocuğu olabilir ve Company'nin aşağıdaki gibi CompanyName ve CompanyRegion adlarında iki XMLNodes denetimi olabilir:

<Customer>
    <Company>
        <CompanyName>
        <CompanyRegion>

İmleç Company düğümünün içine hareket ettirildiğinde eylemler bölmesinde bir denetim göstermek istiyorsanız imlecin CompanyName'in veya CompanyRegion'ın üzerinde olmuş olması farketmez; çünkü her ikisi de Company'in bağlamındadır. Bu durumda kodunuzu sadece Company'nin ContextEnter olayında yazabilirsiniz.

Çoğu durumda, imleç XMLNodes denetimine girdiği zaman Select ve ContextEnter olaylarının ikisi de başlatılır. Aşağıdaki tabloda bu iki olay arasındaki farklar verilmektedir.

Select (Seçme) olayı	ContextEnter (Bağlama Girme) olayı
İmleç XMLNodes derleminin düğümlerinden birinin içerisine yerleştirildiğinde gerçekleşir.	İmleç bir XMLNodes derleminin ardıllarının içine düğümün bağlamının dışındaki bir alandan yerleştirildiğinde meydana gelir. Başka bir deyişle, sadece bağlam değiştiğinde çıkarılır ve birden çok iç içe geçmiş XMLNodes denetimi için çıkarılabilir.

Örneğin, imleci Customer'in dışından CompanyName'e hareket ettirirseniz, Customer,Company ve CompanyName için ContextEnter olayları başlatılır. Ardından imleci CompanyName'den CompanyRegion'a hareket ettirirseniz, sadece CompanyRegion için ContextEnter olayı başlatılır çünkü Company ve Customer'ın bağlamları aynıdır. Belgenizde birden çok Company nesnesi olabilir. İmleci Company'nin CompanyName düğümünden başka bir Company'nin CompanyName düğümüne taşırsanız bağlam aynıdır, bu nedenle sadece Select olayı çıkarılır.

Aynı farklar ContextLeave ve Deselect olayları arasında da vardır.