Aracılığıyla paylaş

Grup Denetimi Türü

  • Makale

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

Grup denetimi, hiyerarşi içindeki bir düğümü temsil eder. Grubu denetim türü, UI Otomasyonu ağacında bir ayrım oluşturur, böylece birlikte gruplandırılmış öğelerin UI Otomasyonu ağacı içinde mantıksal bir bölüme sahip olması sağlanır.

Aşağıdaki bölümlerde, Grubu 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 grup denetimleri için geçerlidir.

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

Tipik Ağaç Yapısı

Aşağıdaki tabloda, grup 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ü
  • Grup
    • 0 veya çok sayıda denetim
  • Grup
    • 0 veya çok sayıda denetim

 

Grup denetimleri genellikle ListItem, TreeItemve DataItem denetim türleri dahil olmak üzere alt ağaçta bulunan denetim türleri için UI Otomasyonu desteğini içerir. Grup denetimi genel bir kapsayıcı olduğundan, herhangi bir denetim türünün ağaçtaki grup denetimi altında olması mümkündür.

İlgili Özellikler

Aşağıdaki tabloda, değeri veya tanımı özellikle grup denetimleriyle 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. Sınırlayıcı bir dikdörtgen varsa desteklenir. Sınırlayıcı dikdörtgenin içindeki her nokta tıklanabilir değilse ve öğesi özel isabet testi gerçekleştiriyorsa, geçersiz kılın ve tıklanabilir bir nokta sağlayın.
UIA_ControlTypePropertyId Grup
UIA_IsContentElementPropertyId true Grup denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir.
UIA_IsControlElementPropertyId true Grup 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. Grup denetimleri genellikle kendi kendine etiketlenir. Bu gibi durumlarda null döndürür. Grubun statik bir metin etiketi varsa etiketi labeledBy özelliğinin değeri olarak döndürebilirsiniz.
UIA_LocalizedControlTypePropertyId Notlara bakın. Grubu denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "group" değeridir.
UIA_NamePropertyId Notlara bakın. Grup denetimi genellikle adını denetimi etiketleyen metinden alır.

 

Gerekli Denetim Desenleri

Aşağıdaki tabloda, Grubu denetim türü için desteklenmesi gereken UI Otomasyonu denetim desenleri listelenmektedir. Denetim desenleri hakkında daha fazla bilgi için bkz. UI Otomasyonu Denetim Desenlerine Genel Bakış.

Denetim Deseni Destek Notlar
IExpandCollapseProvider -Sına bağ -lıdır Bilgileri göstermek veya gizlemek için kullanılabilecek grup denetimleri, ExpandCollapse denetim desenini desteklemelidir.

 

Gerekli Olaylar

Aşağıdaki tabloda, grup denetimlerinin desteklemesi gereken 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.
UIA_ExpandCollapseExpandCollapseStatePropertyId özelliği değiştirilmiş olay. Denetim ExpandCollapse denetim düzeni destekliyorsa, bu olayı desteklemesi gerekir.
ö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.
özelliği değiştirilmiş olayı UIA_ToggleToggleStatePropertyId. Denetim Geçiş denetim desenini destekliyorsa bu olayı desteklemesi gerekir.
UIA_StructureChangedEventId

 

kavramsal

UI Otomasyonu Denetim Türlerine Genel Bakış

UI Otomasyonuna Genel Bakış