Aracılığıyla paylaş


Belge Denetim Türü

Bu konu, Belge denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlar.

Belge denetimleri, kullanıcının birden çok metin sayfasını görüntülemesine ve işlemesine olanak tanır. Yalnızca basit bir biçimlendirilmemiş metin satırını destekleyen düzenleme denetimlerinden farklı olarak, belge denetimleri zengin stile sahip ve biçimlendirilmiş metin barındırabilir

Aşağıdaki bölümlerde belge denetim türü için gerekli UI Otomasyonu ağaç yapısı, özellikleri, denetim desenleri ve olayları tanımlanmıştır. UI Otomasyonu gereksinimleri, UI çerçevesinin/platformunun denetim türleri ve denetim desenleri için UI Otomasyonu desteğini tümleştirdiği tüm belge denetimleri için geçerlidir.

Bu konu aşağıdaki bölümleri içerir.

Tipik Ağaç Yapısı

Aşağıdaki tabloda, belge denetimleriyle ilgili ui Otomasyonu ağacının tipik bir denetimi ve içerik görünümü gösterilir ve her görünümde nelerin içerilebileceğini açıklar. UI Otomasyonu ağacı hakkında daha fazla bilgi için bkz. UI Otomasyon Ağacına Genel Bakış.

Denetim Görünümü İçerik Görünümü
  • Belge
    • Değişir
  • Belge
    • Değişir

 

İlgili Özellikler

Aşağıdaki tabloda, değeri veya tanımı belge denetimleriyle özellikle ilgili olan UI Otomasyonu özellikleri listeleniyor. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. UI Automation Öğelerinden Özellikleri Alma.

UI Otomasyonu Özelliği Değer Notlar
UIA_AutomationIdPropertyId Notlara bakın. Bu özelliğin değeri, UI Otomasyonu ağacının ham görünümündeki tüm eş öğeler arasında benzersiz olmalıdır.
UIA_BoundingRectanglePropertyId Notlara bakın. Denetimin tamamını içeren en dıştaki dikdörtgen.
UIA_ClickablePointPropertyId Notlara bakın. Belge, belge kapsayıcısında kendi öğelerinden birinin belgesinde odağın olmasına neden olacak tıklanabilir bir noktaya sahiptir.
UIA_ControlTypePropertyId belge
UIA_IsContentElementPropertyId DOĞRU Belge denetimi her zaman UI Otomasyon ağacının içerik görünümüne eklenir.
UIA_IsControlElementPropertyId DOĞRU Belge denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir.
UIA_IsKeyboardFocusablePropertyId Notlara bakın. Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir.
UIA_LabeledByPropertyId Notlara bakın. Bu özelliğin değeri belge denetiminin etiketi olmalıdır. Genellikle, belgenin başlığı kullanılır.
UIA_LocalizedControlTypePropertyId Notlara bakın. Belge denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "belge"dir.
UIA_NamePropertyId Notlara bakın. Belge denetimi genellikle adını yüklendiği dosya adından alır. Bu genellikle içeren bir pencere veya çerçeve başlığında görüntülenir.

 

Gerekli Denetim Desenleri

Aşağıdaki tabloda, belge denetimleri tarafından desteklenmesi için gereken UI Otomasyonu denetim desenleri listelenmektedir. Denetim desenleri hakkında daha fazla bilgi için bkz. UI Otomasyonu Denetim Desenlerine Genel Bakış.

Denetim Deseni/Desen Özelliği Destek/Değer Notlar
IScrollProvider -Sına bağ -lıdır Belge denetimi, görünüm penceresine ait olandan daha büyük bir kapsama yayılabilir. İçerik kaydırılabilirse denetim Kaydırma denetim desenini desteklemelidir.
ITextProvider Gerekli Tüm belge denetimleri Metin denetim düzenini desteklemelidir.
IValueProvider -Sına bağ -lıdır UI Otomasyonu istemcileri bir belge hakkındaki metin bilgilerini almak için IUIAutomationTextPatternkullanabilir, ancak iç değeri ayarlamak için Değer denetim desenine ihtiyaçları vardır. Basit metin girişi yalnızca Değer denetimi deseni aracılığıyla mümkündür.

 

Gerekli Olaylar

Aşağıdaki tabloda, belge denetimlerinin desteklemek için gerekli olduğu UI Otomasyonu olayları listelenir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylarına Genel Bakış.

UI Otomasyonu Olayı Notlar
UIA_AutomationFocusChangedEventId
özelliği değiştirilmiş olayı UIA_BoundingRectanglePropertyId.
özelliği değiştirilmiş olayı UIA_IsEnabledPropertyId. Denetim IsEnabledözelliğini destekliyorsa bu olayı desteklemesi gerekir.
özelliği değiştirilmiş olayı UIA_IsOffscreenPropertyId. Denetim IsOffscreen özelliğini destekliyorsa, bu olayı desteklemesi gerekir.
UIA_StructureChangedEventId
özelliği değiştirilmiş olayı UIA_ScrollHorizontallyScrollablePropertyId. Denetim, Kaydırma denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
özelliği değiştirilmiş olayı UIA_ScrollHorizontalScrollPercentPropertyId. Denetim, Kaydırma denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
özelliği değiştirilmiş olayı UIA_ScrollHorizontalViewSizePropertyId. Denetim, Kaydırma denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
özelliği değiştirilmiş olayı UIA_ScrollVerticallyScrollablePropertyId. Denetim, Kaydırma denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
Özellik değiştirme olayını UIA_ScrollVerticalScrollPercentPropertyId. Denetim, Kaydırma denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
UIA_ScrollVerticalViewSizePropertyId özelliği değiştirilmiş olay. Denetim, Kaydırma denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
UIA_Selection_InvalidatedEventId Denetim, Seçimi denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
UIA_Text_TextSelectionChangedEventId
UIA_Text_TextChangedEventId
UIA_ValueValuePropertyId özelliği değiştirilmiş olay. Denetim Değer denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.

 

kavramsal

UI Otomasyonu Denetim Türlerine Genel Bakış

UI Otomasyonuna Genel Bakış