List-View Control (MSAA UI-elementreferens)
Not
I det här avsnittet beskrivs List-View Control-objekt för MSAA UI-elementreferens. Hur du skapar List-View Control-objekt i olika gränssnittsramverk beskrivs inte här. Se API-referensdokumentationen för det användargränssnittsramverk som du använder.
En listvykontroll visar en samling objekt, som var och en består av en ikon och en etikett, och innehåller flera sätt att visa och ordna objekten. Ytterligare information om varje objekt visas till exempel i kolumner till höger om ikonen och etiketten. Utforskaren använder en listvykontroll för att visa filer.
Fönstrets klassnamn för en listvykontroll är WC_LISTVIEW, som definieras som "SysListView" i Commctrl.h.
IAccessible-metoder
En listvykontroll stöder följande IAccessible- metoder:
| Metod | Kommentarer |
|---|---|
| accDoDefaultAction | Själva listvyobjektet har inte en egenskapen DefaultAction. Men accDoDefaultAction metod dubbelklickar på listvyobjekt. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible-egenskaper
En listvykontroll stöder följande egenskaper för IAccessible:
| Egenskap | Kommentarer |
|---|---|
| get_accChild | |
| get_accChildCount | Egenskapen ChildCount är antalet objekt i listan. |
| get_accDefaultAction | Själva listvyobjektet har inte en egenskapen DefaultAction. Egenskapen DefaultAction för varje listvyobjekt är dock "Dubbelklicka". |
| get_accDescription | Själva listvyobjektet stöder inte egenskapen Description. Men egenskapen Description för varje listvyobjekt är texten i objektets andra och efterföljande kolumner. Ett kommatecken infogas mellan texten för varje kolumn. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Listvyobjekt har inga kortkommandon. Men om fönstertexten för listvisningskontrollen innehåller ett et-tecken (&) returnerar Microsoft Active Accessibility en icke-Null-sträng som egenskapen KeyboardShortcut. |
| get_accName | Namn för listvyobjektet hämtas från kontrollens fönstertext (eller bildtext). Den här texten visas inte med listvisningskontrollen, så serverutvecklare måste tillhandahålla meningsfull text i kontrollens resursdefinitionsuttryck för att hjälpa användare av klientverktyg att identifiera kontrollen. För listvyobjekten är egenskapen Name texten i listobjektet. |
| get_accParent | Det överordnade för listvyobjektet är ett fönster ( ROLE_SYSTEM_WINDOW ) som omger kontrollen och har samma Namn egenskap och fönsterklassnamn som kontrollen. Egenskapen Överordnad för listvyobjekten är listvyobjektet. |
| get_accRole | Role för ROLE_SYSTEM_LIST, och varje objekt i listvisningskontrollen har egenskapen Role för ROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | Egenskapen State för listvyobjektet är en kombination av ett eller flera av följande värden: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN Egenskapen State för listvyobjekten är en kombination av ett eller flera av följande värden: 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 Dessutom har kryssrutan listvyobjekt även tillståndet STATE_SYSTEM_CHECKED. |
Anteckningar
- Microsoft Active Accessibility exponerar inte listvyobjekttext i program som använder en återanropsfunktion för att lägga till texten i objektet.
- Listvyobjekt som är klippta har inte STATE_SYSTEM_INVISIBLE angivna. För att avgöra om ett listobjekt klipps bort kan klienter jämföra objektets koordinater som returneras av accLocation med fönstrets urklippsregion.
- Microsoft Active Accessibility stöder inte användning av metoden accNavigate för att navigera till rubrikkontrollen i en listvykontroll som finns i informationsvyn. Klienter använder dock funktionen AccessibleObjectFromPoint för att komma till rubrikkontrollen.
- För icke-rektangulära objekt, till exempel listvyobjekt i vyn Information, misslyckas koordinaterna för objektets rektangel som hämtats av accLocation om de testas med accHitTest eftersom accHitTest bestämmer objektets gränser per pixel.