Structuurweergavebesturingselement (MSAA UI-elementreferentie)

Notitie

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

In een structuurweergavebesturingselement wordt een hiërarchische lijst met items weergegeven met behulp van regels om gerelateerde items in een hiërarchie te verbinden. Elk item bestaat uit een label en een optionele bitmap. In Windows Verkenner wordt een besturingselement voor structuurweergave gebruikt om mappen weer te geven.

De naam van de vensterklasse voor een structuurweergavebesturingselement is WC_TREEVIEW, die is gedefinieerd als 'SysTreeView' in Commctrl.h.

IAccessible-methoden

Een structuurweergavebesturingselement ondersteunt de volgende methoden IAccessible:

Methode	Opmerkingen
accDoDefaultAction-	Het structuurweergaveobject zelf heeft geen accDoDefaultAction-methode. Afhankelijk van de eigenschap State van een item in de structuurweergave, accDoDefaultAction het opgegeven item uitvouwt of samenvouwt.
accHitTest-
accLocation-
accNavigate-
accSelect-

IAccessible Properties

Een structuurweergavebesturingselement ondersteunt de volgende eigenschappen van IAccessible:

Eigenschap	Opmerkingen
get_accChild
get_accChildCount	De eigenschap ChildCount voor het object structuurweergave is het aantal items in de structuurweergave. De eigenschap ChildCount voor elk item in de structuurweergave is nul.
get_accDefaultAction	Het structuurweergaveobject zelf heeft geen eigenschap DefaultAction. Een item in de uitgevouwen structuurweergave heeft 'Samenvouwen' als de eigenschap DefaultAction en een item dat niet is uitgevouwen, heeft 'Uitvouwen' als de eigenschap DefaultAction.
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName	De eigenschap Name voor het structuurweergaveobject wordt verkregen uit de venstertekst van het besturingselement (of bijschrift). Deze tekst wordt niet weergegeven met het besturingselement voor de structuurweergave. Serverontwikkelaars moeten dus zinvolle tekst opgeven in de resourcedefinitie-instructie van het besturingselement om gebruikers van clienthulpprogramma's te helpen het besturingselement te identificeren. De eigenschap Naam voor een item in de structuurweergave is de tekst die wordt weergegeven in het structuurweergave-item.
get_accParent	De eigenschap Bovenliggende van het object structuurweergave is een venster (ROLE_SYSTEM_WINDOW) dat het besturingselement omringt en dezelfde naam eigenschap en vensterklassenaam heeft als het besturingselement. De eigenschap Bovenliggende van elk item in de structuurweergave is het structuurweergaveobject.
get_accRole	Het structuurweergaveobject heeft de eigenschap RoleROLE_SYSTEM_OUTLINE. Elk item in de structuurweergave heeft de eigenschap RoleROLE_SYSTEM_OUTLINEITEM.
get_accSelection
get_accState	De eigenschap State voor de structuurweergave is een combinatie van een of meer van de volgende waarden: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE Voor de items in de structuurweergave bevat de eigenschap State ofwel STATE_SYSTEM_EXPANDED of STATE_SYSTEM_COLLAPSED. Aanvullende mogelijke waarden voor de eigenschap State zijn: STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED
get_accValue	Het structuurweergaveobject heeft geen waarde. De eigenschap waarde voor elk structuurweergave-item is het inspringingsniveau van het item in de hiërarchie. In Windows Verkenner heeft het item 'Bureaublad' bijvoorbeeld een waarde eigenschap '0'; het item "Mijn computer", dat zich op het volgende niveau in de hiërarchie bevindt, heeft een waarde eigenschap "1"; en elk van de schijfstations, die zich op het volgende niveau in de hiërarchie bevinden, heeft een waarde eigenschap '2'.

Notities

De eigenschap accLocation van items in de structuurweergave retourneert alleen de locatie van de tekst in het item. De coördinaten die worden geretourneerd door accLocation voor items in de structuurweergave bevatten niet het pictogram links van de tekst.

Verwante onderwerpen

IAccessible Interface