Roleigenschap

De eigenschap Role beschrijft het gebruikersinterface-element van een object. Alle objecten ondersteunen de eigenschap Role.

In veel gevallen is de rol van het object duidelijk. Vensters hebben bijvoorbeeld de ROLE_SYSTEM_WINDOW rol en drukknoppen de ROLE_SYSTEM_PUSHBUTTON rol.

De eigenschap Role wordt opgehaald door IAccessible::get_accRoleaan te roepen.

De rol van een object identificeren

Microsoft Active Accessibility biedt rolconstanten, gedefinieerd in oleacc.h, waarmee algemene objectrollen worden geïdentificeerd. Het wordt aanbevolen dat serverontwikkelaars deze vooraf gedefinieerde rolwaarden gebruiken. Als een vooraf gedefinieerde rolconstante wordt geretourneerd, gebruiken clients de functie GetRoleText om een gelokaliseerde tekenreeks op te halen die de rol beschrijft.

Gebruik ROLE_SYSTEM_ANIMATIONvoor animatiebesturingselementen, zoals het animatiebesturingselement dat wordt weergegeven bij het kopiëren van bestanden. Afbeeldingen die af en toe worden geanimeerd, worden beschreven als ROLE_SYSTEM_GRAPHIC met de eigenschap State ingesteld op STATE_SYSTEM_ANIMATED.

Houd er rekening mee dat sommige rollen niet gemakkelijk te beschrijven zijn. De weergave met grote pictogrammen van een map maakt bijvoorbeeld willekeurige rangschikking van pictogrammen mogelijk, zodat de rol ervan kan worden beschreven als ROLE_SYSTEM_GROUPING. Of een besturingselement dat items in vaste rijen en kolommen levert, kan de ROLE_SYSTEM_TABLE rol hebben. Aangezien een rol wordt gebruikt om het gebruiksmodel aan een eindgebruiker te communiceren, is het belangrijk om de juiste rol te gebruiken. Als uw besturingselement bijvoorbeeld als een knop fungeert, gebruikt u ROLE_SYSTEM_PUSHBUTTON.