Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu konu, ListItem denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlar.
Liste öğesi denetimleri, ListItem denetim türünü uygulayan bir denetim örneğidir.
Aşağıdaki bölümlerde ListItem 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 öğesi 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
- Gerekli Olayları
- Açıklamalar
- İlgili konular
Tipik Ağaç Yapısı
Aşağıdaki tabloda, öğe denetimlerini listelemeyle 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ü |
|---|---|
|
|
Ui Otomasyonu ağacının içerik görünümündeki bir liste öğesi denetiminin alt öğeleri her zaman sıfır alt öğe göstermelidir. Denetimin yapısı liste öğesinin altında başka öğeler de olacak şekildeyse, TreeItem denetim türü için UI Otomasyonu desteği gereksinimlerini karşılamalıdır.
İlgili Özellikler
Aşağıdaki tabloda, değeri veya tanımı özellikle ListItem 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. Öğenin kullanıcı arabiriminin farklı örnekleri arasında tutarlı olduğu biliniyorsa, bir liste öğesi için AutomationId özelliğini ayırın. Liste öğesi dinamik olarak doldurulmuşsa ve tahmin edilebilir değilse, AutomationId özelliğini boş bırakın. |
| UIA_BoundingRectanglePropertyId | Notlara bakın. | Bu özelliğin bu değeri, resim alanını ve liste öğesinin metin içeriğini içermelidir. |
| UIA_ClickablePointPropertyId | -Sına bağ -lıdır | 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. Liste denetimi tamamen alt liste öğeleri kapsamındaysa, istemcinin liste denetimindeki bir öğeden tıklanabilir bir nokta istemesi gerektiğini belirtmek için UIA_E_NOCLICKABLEPOINT hatasını döndürür. |
| UIA_ControlTypePropertyId | ListItem | Bu değer tüm ui çerçeveleri için aynıdır. |
| UIA_HelpTextPropertyId | Notlara bakın. | Liste denetimleri için Yardım metni, kullanıcıdan neden seçenek listesinden seçim yapmasının istendiği açıklanmalıdır. Bu, genellikle araç ipucu aracılığıyla sunulan bilgi türüyle aynıdır. Örneğin, "Monitörünüzün ekran çözünürlüğünü ayarlamak için bir öğe seçin". |
| 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. | Kapsayıcı klavye girişini kabul edebilirse, bu özellik değeri true olmalıdır. |
| UIA_IsOffscreenPropertyId | -Sına bağ -lıdır | Bu özellik, liste öğesinin şu anda Kaydırma denetim desenini uygulayan üst kapsayıcıda görünüme kaydırılıp kaydırılmadığına ilişkin bir değer döndürmelidir. |
| UIA_ItemStatusPropertyId | -Sına bağ -lıdır | Denetim dinamik olarak güncelleştirilen bir durum içeriyorsa, yardımcı bir teknolojinin öğenin durumu değiştiğinde güncelleştirmeleri alabilmesi için bu özelliğin desteklenmesi gerekir. |
| UIA_ItemTypePropertyId | -Sına bağ -lıdır | Bu özellik, temel alınan nesneyi temsil eden liste öğesi denetimleri için kullanıma sunulmalıdır. Bu liste öğesi denetimleri genellikle kullanıcıların temel alınan nesneyle ilişkilendirilen denetimle ilişkilendirilmiş bir simgeye sahiptir. |
| 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. | ListItem denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "liste öğesi"dir. |
| UIA_NamePropertyId | Notlara bakın. | Liste öğesi denetiminin ad özelliğinin değeri, öğenin metin etiketinden gelir. |
Gerekli Denetim Desenleri
Aşağıdaki tabloda, tüm liste öğesi 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 | Destek | Notlar |
|---|---|---|
| IExpandCollapseProvider | -Sına bağ -lıdır | Öğe bilgileri göstermek veya gizlemek için değiştirilebilirse, ExpandCollapse denetim düzeni uygulanmalıdır. |
| IGridItemProvider | -Sına bağ -lıdır | Liste kapsayıcısında öğeden öğeye uzamsal gezinti destekleniyorsa ve kapsayıcı satırlar ve sütunlar halinde düzenlenmişse, GridItem denetim düzeni uygulanmalıdır. |
| IInvokeProvider | -Sına bağ -lıdır | Öğenin üzerinde seçimden ayrı olarak gerçekleştirilebilecek bir komutu varsa, Invoke denetim düzeni uygulanmalıdır. Bu genellikle liste öğesi denetimine çift tıklamayla ilişkili bir eylemdir. Örnek olarak Windows Gezgini'nden bir belge başlatma veya Microsoft Windows Media Player'da bir müzik dosyası çalma verilebilir. |
| IScrollItemProvider | -Sına bağ -lıdır | Liste öğesi kaydırılabilir bir kapsayıcının içinde yer alıyorsa, ScrollItem denetim düzeni uygulanmalıdır. |
| ISelectionItemProvider | -Sına bağ -lıdır | Seçimi destekleyen bir liste öğesi denetimi, SelectionItem denetim desenini uygulamalıdır. Bu, liste öğeleri denetimlerinin seçildiklerinde iletmesine olanak tanır. |
| IToggleProvider | -Sına bağ -lıdır | Liste öğesi denetlenebilirse ve eylem seçim durumu değişikliği gerçekleştirmiyorsa Geçiş denetim düzeni uygulanmalıdır. |
| IValueProvider | -Sına bağ -lıdır | Öğe düzenlenebiliyorsa, Değer denetim düzeni uygulanmalıdır. Liste öğesi denetiminde yapılan değişiklikler, UIA_NamePropertyId ve UIA_ValueValuePropertyId özelliklerinin değerlerinde değişikliklere neden olur. |
Gerekli Olaylar
Aşağıdaki tabloda, desteklemek için gereken öğe denetimlerini listeleyen 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 desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| UIA_Invoke_InvokedEventId | Denetim Invoke denetim desenini 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. |
| UIA_ItemStatusPropertyId özelliği değiştirilmiş olay. | Denetim ItemStatus özelliğini destekliyorsa, bu olayı desteklemelidir. |
| özelliği değiştirilmiş olayı UIA_NamePropertyId. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Denetim SelectionItem denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Denetim SelectionItem denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| UIA_SelectionItem_ElementSelectedEventId | Denetim SelectionItem denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| UIA_StructureChangedEventId | |
| özelliği değiştirilmiş olayı UIA_ToggleToggleStatePropertyId. | Denetim Geçiş denetim desenini destekliyorsa bu olayı desteklemesi gerekir. |
| UIA_ValueValuePropertyId özelliği değiştirilmiş olay. | Denetim Değer denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
Açıklamalar
Bir kapsayıcı liste öğelerini barındırıyorsa, birincil gezinti araçları liste öğelerine gitmelidir. Liste gezintisi aracılığıyla odağı alt öğelere yerleştirmek, kullanıcılar ve erişilebilirlik araçları için kafa karıştırıcı olabilir. Kapsayıcı öğelerin dikey listesini barındırıyorsa, YUKARI OK ve AŞAĞI OK tuşlarına basmak öğeler arasında gezinmelidir, ancak SAĞ OK ve SOL OK tuşlarına basmak, liste sütunları veya UI alt öğeleri gibi odaklanmış öğenin alt öğelerine gidebilir.
İlgili konular