List-View Control (MSAA UI Element Reference)

Notitie

In dit onderwerp wordt beschreven List-View Control-objecten voor MSAA UI-elementreferenties. Het maken van List-View Control-objecten in verschillende UI-frameworks wordt hier niet beschreven. Raadpleeg de API-referentiedocumentatie voor het UI-framework dat u gebruikt.

Een besturingselement voor lijstweergave geeft een verzameling items weer, die elk bestaan uit een pictogram en een label, en biedt verschillende manieren om de items weer te geven en te rangschikken. Aanvullende informatie over elk item wordt bijvoorbeeld weergegeven in kolommen rechts van het pictogram en label. Windows Verkenner maakt gebruik van een besturingselement voor lijstweergave om bestanden weer te geven.

De naam van de vensterklasse voor een besturingselement voor lijstweergave is WC_LISTVIEW, die is gedefinieerd als SysListView in Commctrl.h.

IAccessible-methoden

Een besturingselement voor lijstweergave ondersteunt de volgende IAccessible methoden:

Methode	Opmerkingen
accDoDefaultAction-	Het object list-view zelf heeft geen eigenschap DefaultAction; De methode accDoDefaultAction dubbelklikt echter op items in de lijstweergave.
accHitTest-
accLocation-
accNavigate-
accSelect-

IAccessible Properties

Een besturingselement voor lijstweergave ondersteunt de volgende eigenschappen IAccessible:

Eigenschap	Opmerkingen
get_accChild
get_accChildCount	De eigenschap ChildCount is het aantal items in de lijst.
get_accDefaultAction	Het object list-view zelf heeft geen eigenschap DefaultAction; De eigenschap DefaultAction voor elk item in de lijstweergave is echter 'Dubbelklikken'.
get_accDescription	Het object list-view zelf biedt geen ondersteuning voor de eigenschap Description; De eigenschap Description voor elk item in de lijstweergave is echter de tekst in de tweede en volgende kolommen van het item. Er wordt een komma ingevoegd tussen de tekst voor elke kolom.
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut	Lijstweergaveobjecten hebben geen sneltoetsen. Als de venstertekst voor het besturingselement lijstweergave echter een ampersand (&) bevat, retourneert Microsoft Active Accessibility een niet-Null-tekenreeks als de eigenschap KeyboardShortcut.
get_accName	De Naam voor het lijstweergaveobject wordt verkregen uit de venstertekst van het besturingselement (of bijschrift). Deze tekst wordt niet weergegeven met het besturingselement lijstweergave, dus serverontwikkelaars moeten zinvolle tekst in de resourcedefinitie-instructie van het besturingselement opgeven om gebruikers van clienthulpprogramma's te helpen het besturingselement te identificeren. Voor de lijstweergave-items is de eigenschap Naam de tekst van het lijstitem.
get_accParent	De Bovenliggende van het object lijstweergave is een venster (ROLE_SYSTEM_WINDOW) dat het besturingselement omringt en dezelfde eigenschap naam eigenschap en vensterklassenaam heeft als het besturingselement. De eigenschap Bovenliggende van de items in de lijstweergave is het object lijstweergave.
get_accRole	De rol van ROLE_SYSTEM_LISTen elk item in het besturingselement lijstweergave heeft de eigenschap Role van ROLE_SYSTEM_LISTITEM.
get_accSelection
get_accState	De eigenschap State van het lijstweergaveobject is een combinatie van een of meer van de volgende waarden: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN De eigenschap State van de lijstweergave-items is een combinatie van een of meer van de volgende waarden: 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 Bovendien hebben items in de lijstweergave van selectievakjes ook de status STATE_SYSTEM_CHECKED.

Notities

• In Microsoft Active Accessibility wordt geen tekst voor lijstweergave-items weergegeven in toepassingen die een callback-functie gebruiken om de tekst aan het item toe te voegen.
• Items in de lijstweergave die zijn geknipt, hebben geen STATE_SYSTEM_INVISIBLE ingesteld. Om te bepalen of een lijstitem is geknipt, kunnen clients de coördinaten van het item vergelijken die worden geretourneerd door accLocation met de knipregio van het venster.
• Microsoft Active Accessibility biedt geen ondersteuning voor het gebruik van de methode accNavigate om naar het besturingselement voor de koptekst te navigeren in een besturingselement voor lijstweergave dat zich in de detailweergave bevindt. Clients gebruiken echter de functie AccessibleObjectFromPoint om het headerbesturingselement te openen.
• Voor niet-rechthoekige objecten, zoals items in de lijstweergave in de detailweergave, mislukken de coördinaten van de begrenzingsrechthoek van het item die is opgehaald door accLocation als ze zijn getest met accHitTest- omdat accHitTest- de grenzen van het object op pixel-by-pixelbasis bepaalt.

Verwante onderwerpen

IAccessible Interface