Beschrijvingseigenschap (Windows-toegankelijkheidsfuncties)

Notitie

De eigenschap Description wordt vaak onjuist gebruikt en wordt niet ondersteund door Microsoft UI Automation. Ontwikkelaars van Microsoft Active Accessibility Server mogen deze eigenschap niet gebruiken. Als er meer informatie nodig is voor toegankelijkheids- en automatiseringsscenario's, gebruikt u de eigenschappen die worden ondersteund door elementen van UI Automation en beheerpatronen.

 

De eigenschap Description van een object biedt een tekstuele beschrijving over het uiterlijk van een object. De beschrijving wordt voornamelijk gebruikt om meer context te bieden voor slechtziende of blinde gebruikers, maar wordt ook gebruikt voor het zoeken naar context of andere toepassingen. Deze eigenschap kan gebruikers helpen bij het begrijpen van een pictogram of het algehele uiterlijk van de visual.

De eigenschap Description wordt opgehaald door IAccessible::get_accDescriptionaan te roepen.

Wanneer moet de beschrijvingseigenschap worden ondersteund

Servers ondersteunen de eigenschap Description als de beschrijving niet duidelijk is, of wanneer deze niet redundant is op basis van de eigenschappen naamvan het object, rol, statusen waarde. Een knop met het label 'OK' heeft bijvoorbeeld geen aanvullende informatie nodig, terwijl een knop die een afbeelding van een cactus weergeeft. De naam, rolen Help-eigenschappen voor een dergelijke knop beschrijven het doel ervan, maar de eigenschap Beschrijving geeft informatie over die minder tastbaar is; 'Deze knop toont bijvoorbeeld een afbeelding van een cactus'.

Een Microsoft Active Accessibility-server kan ondersteuning voor UI Automation toevoegen met behulp van Direct Annotation, met behulp van de interface IAccessibleEx of door Microsoft Active Accessibility en UI Automation naast beide implementaties te implementeren die het WM_GETOBJECT bericht verwerken.

Verwante onderwerpen

Directe aantekening gebruiken

de IAccessibleEx-interface