Liste Denetim Türü
Bu konu başlığında, Listesi denetim türü için Microsoft UI Automation desteği hakkında bilgi sağlanır.
Listesi denetim türü, düz bir grup veya öğe grubunu düzenlemenin bir yolunu sağlar ve kullanıcının bu öğelerden birini veya daha fazlasını seçmesine olanak tanır. Listesi denetim türü, içerebileceği alt öğe türleri üzerinde gevşek bir kısıtlamaya sahiptir. Bu, UI Otomasyonu sağlayıcılarının seçim kapsayıcıları için iyi bilinen bir öğeyi desteklemesini sağlar.
Aşağıdaki bölümlerde, Listesi 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 liste denetimleri için geçerlidir.
Bu konu aşağıdaki bölümleri içerir.
- Tipik Ağaç Yapısı
- İlgili Özellikler
- Gerekli Denetim Desenlerini ve Özelliklerini
- Gerekli Olayları
- İlgili konular
Tipik Ağaç Yapısı
Aşağıdaki tabloda, liste 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ği açıklanır. 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ü |
|---|---|
| Denetimlere karşılık gelen öğeleri içerir. | Yardımcı teknolojilerin son kullanıcı için anlamlı olan en küçük bilgi kümesiyle çalışması için ağaçtan yedekli bilgileri kaldırır. |
|
|
Liste denetim türünü (liste denetimi gibi) uygulayan bir denetimin denetim görünümü şunlardan oluşur:
- Liste denetimindeki sıfır veya daha fazla öğe (öğeler ListItem veya DataItem denetim türlerini temel alabilir)
- Liste denetimi içinde sıfır veya daha fazla grup denetimi
- Sıfır, bir veya iki kaydırma çubuğu denetimi
Liste denetim türünü (liste denetimi gibi) uygulayan bir denetimin içerik görünümü şunlardan oluşur:
- Liste denetimindeki sıfır veya daha fazla öğe (öğeler ListItem veya DataItem denetim türlerini temel alabilir)
- Liste denetiminde sıfır veya daha fazla grup
Liste denetiminin, birlikte gruplandırılmak dışında hiyerarşik ilişkisi olan öğeleri olmamalıdır. Öğelerin UI Otomasyonu ağacında alt öğeleri varsa, liste kapsayıcısı Ağacı denetim türünü temel almalıdır.
Liste denetimindeki seçilebilir öğeler, liste denetiminin UI Otomasyonu ağacındaki alt öğelerden kullanılabilir. Liste denetimindeki tüm öğeler aynı seçim grubuna ait olmalıdır. Listedeki seçilebilir öğeler ListItem (DataItem yerine) denetim türleri olarak gösterilmelidir.
İlgili Özellikler
Aşağıdaki tabloda, değeri veya tanımı özellikle Listesi denetim türüyle 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. | Liste denetiminin tıklanabilir bir noktası varsa (listenin odaklanmasına neden olmak için tıklanabilen bir nokta), bu nokta bu özellik aracılığıyla gösterilmelidir. UIA_IsOffscreenPropertyId özelliğinin değeri TRUE ise, bu özelliği almaya çalışmak UIA_E_NOCLICKABLEPOINT hatasıyla sonuçlanır. |
| UIA_ControlTypePropertyId | Listesi | |
| UIA_HelpTextPropertyId | Notlara bakın. | Liste denetimleri için Yardım metni, kullanıcıdan neden seçenek listesinden seçim yapmasının istenmesini açıklamalıdır. Örneğin, "Bu listeden bir öğeyi seçin, monitörünüzün görüntü çözünürlüğünü ayarlar." |
| UIA_IsContentElementPropertyId | true | Liste denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| UIA_IsControlElementPropertyId | true | Liste 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. | Statik bir metin etiketi varsa, bu özelliğin bu denetime bir başvuru kullanıma sunması gerekir. |
| UIA_LocalizedControlTypePropertyId | Notlara bakın. | Listesi denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "list" değeridir. |
| UIA_NamePropertyId | Notlara bakın. | Liste denetiminin Name özelliğinin değeri, kullanıcıdan seçim yapmasının istenildiği seçenek kategorisini iletmelidir. Bu özellik genellikle adını statik bir metin etiketinden alır. Statik metin etiketi yoksa uygulama geliştiricisinin Adı özelliği için bir değer kullanıma sunması gerekir. Bu özelliğin liste denetimleri için gerekli olmadığı tek zaman, denetimin başka bir denetimin alt ağacı içinde kullanılmasıdır. |
Gerekli Denetim Desenleri ve Özellikleri
Aşağıdaki tabloda, tüm liste 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 |
|---|---|---|
| IGridProvider | -Sına bağ -lıdır | Öğe temelinde bir öğede kılavuz gezintisinin kullanılabilir olması gerektiğinde Kılavuz denetim desenini uygulayın. |
| IMultipleViewProvider | -Sına bağ -lıdır | Denetim kapsayıcıdaki öğelerin birden çok görünümünü destekleyebilirse, MultipleView denetim desenini uygulayın. |
| IScrollProvider | -Sına bağ -lıdır | Kapsayıcıdaki öğeler kaydırılabilirse Kaydırma denetim desenini uygulayın. |
| ISelectionProvider | -Sına bağ -lıdır | Denetim, seçimi destekleyen Liste denetim türünü destekliyorsa, denetimde bulunan öğeler arasında bir seçim durumu korunduğunda Seçim denetim desenini uygulamalıdır. Denetimdeki öğeler seçilemezse, Grup denetim türü kullanılabilir. |
| CanSelectMultiple | -Sına bağ -lıdır | Liste denetimleri tek veya çoklu seçim kapsayıcıları olabilir. |
| IsSelectionRequired | -Sına bağ -lıdır | Liste denetimleri her zaman bir öğenin seçilmesini gerektirmez. |
| ITableProvider | Hiç | Tablo denetim düzeni, Listesi denetim türü için hiçbir zaman desteklenmez. Denetimin bu denetim düzenini desteklemesi gerekiyorsa, denetim DataGrid denetim türünü temel almalıdır. |
Gerekli Olaylar
Aşağıdaki tabloda, denetimlerin destek 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_LayoutInvalidatedEventId | Alt öğelerin düzeni değiştirilebilirse, denetimin bu olayı desteklemesi gerekir. |
| UIA_MultipleViewCurrentViewPropertyId özelliği değiştirilmiş olay. | Denetim, MultipleView denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| ö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. |
| Özellik değiştirme olayını UIA_ScrollVerticalScrollPercentPropertyId. | 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. |
| 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_StructureChangedEventId |