List-View Denetimi (MSAA UI Öğesi Başvurusu)
Not
Bu konuda, MSAA UI Öğesi Başvurusu amacıyla List-View Denetimi nesneleri açıklanmaktadır. Çeşitli UI çerçevelerinde List-View Denetimi nesnelerinin nasıl oluşturulacağı burada açıklanmamektedir. Kullanmakta olduğunuz UI çerçevesi için API başvuru belgelerine bakın.
Liste görünümü denetimi, her biri bir simge ve etiket içeren bir öğe koleksiyonu görüntüler ve öğeleri görüntülemek ve düzenlemek için çeşitli yollar sağlar. Örneğin, simgenin ve etiketin sağındaki sütunlarda her öğeyle ilgili ek bilgiler görüntülenir. Windows Gezgini, dosyaları görüntülemek için bir liste görünümü denetimi kullanır.
Liste görünümü denetiminin pencere sınıfı adı, Commctrl.h dosyasında "SysListView" olarak tanımlanan WC_LISTVIEW.
IAccessible Yöntemleri
Liste görünümü denetimi aşağıdaki IAccessible yöntemlerini destekler:
| Yöntem | Yorum |
|---|---|
| accDoDefaultAction | Liste görünümü nesnesinin kendisi bir DefaultAction özelliğine sahip değil; ancak accDoDefaultAction yöntemi, liste görünümü öğelerine çift tıklar. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible Özellikleri
Liste görünümü denetimi aşağıdaki IAccessible özelliklerini destekler:
| Mülk | Yorum |
|---|---|
| get_accChild | |
| get_accChildCount | ChildCount özelliği listedeki öğelerin sayısıdır. |
| get_accDefaultAction | Liste görünümü nesnesinin kendisi bir DefaultAction özelliğine sahip değil; ancak, her liste görünümü öğesinin DefaultAction özelliği "Çift Tıklama"dır. |
| get_accDescription | Liste görünümü nesnesinin kendisi Description özelliğini desteklemez; ancak, her liste görünümü öğesinin Description özelliği, öğenin ikinci ve sonraki sütunlarında yer alan metindir. Her sütunun metni arasına virgül eklenir. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Liste görünümleri nesnelerinin klavye kısayolları yoktur. Ancak, liste görünümü denetiminin pencere metni bir ve işareti (&) karakteri içeriyorsa, Microsoft Etkin Erişilebilirlik KeyboardShortcut özelliği olarak Null olmayan bir dize döndürür. |
| get_accName | Liste görünümü nesnesinin Adı, denetimin pencere metninden (veya resim yazısından) elde edilir. Bu metin liste görünümü denetimiyle görüntülenmez, bu nedenle istemci yardımcı programlarının kullanıcılarının denetimi tanımlamasına yardımcı olmak için sunucu geliştiricilerinin denetimin kaynak tanımı deyiminde anlamlı metinler sağlaması gerekir. Liste görünümü öğeleri için Name özelliği liste öğesinin metnidir. |
| get_accParent | Liste görünümü nesnesinin Üst, denetimi çevreleyen ve denetimle aynı Name özelliğine ve pencere sınıfı adına sahip bir penceredir ( ROLE_SYSTEM_WINDOW). List-view öğelerinin Parent özelliği list-view nesnesidir. |
| get_accRole | ROLE_SYSTEM_LISTRolü ve liste görünümü denetimindeki her öğenin ROLE_SYSTEM_LISTITEMRol özelliği vardır. |
| get_accSelection | |
| get_accState | Liste görünümü nesnesinin State özelliği, aşağıdakideğerlerinden birinin veya daha fazlasının birleşimidir: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN Liste görünümü öğelerinin State özelliği, aşağıdaki değerlerden birinin veya daha fazlasının birleşimidir: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN | STATE_SYSTEM_NORMAL Ayrıca, onay kutusu liste görünümü öğelerinin durumu da STATE_SYSTEM_CHECKED. |
Notlar
- Microsoft Etkin Erişilebilirlik, öğeye metin eklemek için geri çağırma işlevi kullanan uygulamalarda liste görünümü öğe metnini kullanıma sunmaz.
- Kırpılan liste görünümü öğelerinin ayarlanmış STATE_SYSTEM_INVISIBLE yoktur. Bir liste öğesinin kırpılıp kırpılamadığını belirlemek için istemciler, accLocation tarafından döndürülen öğenin koordinatlarını pencerenin kırpma bölgesiyle karşılaştırabilir.
- Microsoft Etkin Erişilebilirlik, Ayrıntılar görünümündeki bir liste görünümü denetiminde üst bilgi denetimine gitmek için accNavigate yönteminin kullanılmasını desteklemez. Ancak, istemciler üst bilgi denetimine ulaşmak için AccessibleObjectFromPoint işlevini kullanır.
- Ayrıntılar görünümünde liste görünümü öğeleri gibi dikdörtgen olmayan nesneler için, accLocation tarafından alınan öğenin sınırlayıcı dikdörtgeninin koordinatları, accHitTest ile test edildiğinde başarısız olur çünkü accHitTest nesnenin sınırlarını piksel piksel temelinde belirler.