Megosztás a következőn keresztül:


List-View vezérlőelem (MSAA felhasználói felületi elemre vonatkozó referencia)

Jegyzet

Ez a témakör List-View Vezérlő objektumokat ismerteti az MSAA felhasználói felületi elemekkel kapcsolatos referencia céljából. Itt nem ismertetjük, hogyan hozhat létre List-View Control objektumokat a különböző felhasználói felületi keretrendszerekben. Tekintse meg a használt felhasználói felületi keretrendszer API-referenciadokumentációját.

A listanézet-vezérlők egy ikonból és egy címkéből álló elemek gyűjteményét jelenítik meg, és többféle módon is megjeleníthetők és rendezhetők az elemek. Az egyes elemekre vonatkozó további információk például az ikon és a címke jobb oldalán lévő oszlopokban jelennek meg. A Windows Intéző listanézet-vezérlővel jeleníti meg a fájlokat.

A listanézet-vezérlő ablakosztályának neve WC_LISTVIEW, amely a Commctrl.h-ban "SysListView" néven van definiálva.

IAccessible metódusok

A listanézet-vezérlők az alábbi IAccessible metódusokat támogatják:

Módszer Megjegyzések
accDoDefaultAction Maga a listanézeti objektum nem rendelkezik DefaultAction tulajdonságmal; az accDoDefaultAction metódus azonban duplán kattint a listanézet elemeire.
accHitTest
accLocation
accNavigate
accSelect

IAccessible-tulajdonságok

A listanézet-vezérlők az alábbi IAccessible tulajdonságokat támogatják:

Ingatlan Megjegyzések
get_accChild
get_accChildCount A ChildCount tulajdonság a lista elemeinek száma.
get_accDefaultAction Maga a listanézeti objektum nem rendelkezik DefaultAction tulajdonságmal; az egyes listanézet-elemek DefaultAction tulajdonsága azonban "Dupla kattintás".
get_accDescription Maga a listanézeti objektum nem támogatja a Description tulajdonságot; az egyes listanézeti elemek Description tulajdonsága azonban az elem második és az azt követő oszlopában található szöveg. Az egyes oszlopok szövege között vessző van beszúrva.
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut A listanézetek objektumai nem rendelkeznek billentyűparancsokkal. Ha azonban a listanézet vezérlőelem ablakszövege egy ampersand (&) karaktert tartalmaz, a Microsoft Active Accessibility egy nem null sztringet ad vissza a KeyboardShortcut tulajdonságként.
get_accName A listanézet objektum név a vezérlő ablakszövegéből (vagy feliratából) származik. Ez a szöveg nem jelenik meg a listanézet-vezérlővel, ezért a kiszolgálófejlesztőknek értelmes szöveget kell megadniuk a vezérlő erőforrásdefiníciós utasításában, hogy segítsenek az ügyfél-segédprogramok felhasználóinak a vezérlő azonosításában. A listanézet elemeinél a Név tulajdonság a listaelem szövege.
get_accParent A listanézet objektum szülő egy ablak (ROLE_SYSTEM_WINDOW), amely körülveszi a vezérlőt, és ugyanazzal a Name tulajdonságmal és ablakosztálynévvel rendelkezik, mint a vezérlőelem. A listanézetelemek Szülő tulajdonsága a listanézet objektum.
get_accRole A ROLE_SYSTEM_LISTszerepkör és a listanézet vezérlőelem minden eleme rendelkezik ROLE_SYSTEM_LISTITEMSzerepkör tulajdonságával.
get_accSelection
get_accState A listanézet objektum Állapot tulajdonsága az alábbi értékek egy vagy több kombinációjából áll,: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN
A listanézet elemeinek Állapot tulajdonsága az alábbi értékek egy vagy több kombinációjából áll:
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
Emellett a jelölőnégyzet listanézeti elemeinek állapota is STATE_SYSTEM_CHECKED.

Notes

  • A Microsoft Active Accessibility nem teszi elérhetővé a listanézeti elem szövegét azokban az alkalmazásokban, amelyek visszahívási függvényt használnak a szöveg elemhez való hozzáadásához.
  • A kivágott listanézetelemek nem rendelkeznek STATE_SYSTEM_INVISIBLE beállítással. Annak megállapításához, hogy egy listaelem ki van-e vágva, az ügyfelek összehasonlíthatják az accLocation által visszaadott elemet az ablak kivágási régiójával.
  • A Microsoft Active Accessibility nem támogatja az accNavigate metódus használatát a Részletek nézetben található listanézet vezérlőelem fejlécvezérlőjéhez való navigáláshoz. Az ügyfelek azonban az AccessibleObjectFromPoint függvénnyel jutnak el a fejlécvezérlőhöz.
  • A nem téglalap alakú objektumok, például a Részletek nézetben lévő listanézeti elemek esetében az elem határolókeretének koordinátái, amelyeket accLocation lekért, ha accHitTest tesztelik, mert accHitTest képpontonként határozzák meg az objektum határait.

IAccessible Interface