Description, propriété (fonctionnalités d’accessibilité Windows)

  • Article

Notes

La propriété Description est souvent utilisée de manière incorrecte et n’est pas prise en charge par Microsoft UI Automation. Les développeurs du serveur Microsoft Active Accessibility ne doivent pas utiliser cette propriété. Si des informations supplémentaires sont nécessaires pour les scénarios d’accessibilité et d’automatisation, utilisez les propriétés prises en charge par UI Automation éléments et les modèles de contrôle.

 

La propriété Description d’un objet fournit une description textuelle de l’apparence visuelle d’un objet. La description est principalement utilisée pour fournir un plus grand contexte aux utilisateurs malvoyants ou aveugles, mais elle est également utilisée pour la recherche contextuelle ou d’autres applications. Cette propriété peut aider les utilisateurs à comprendre une icône ou l’apparence visuelle globale.

La propriété Description est récupérée en appelant IAccessible::get_accDescription.

Quand prendre en charge la propriété Description

Les serveurs prennent en charge la propriété Description si la description n’est pas évidente ou si elle n’est pas redondante en fonction des propriétés Name, Role, State et Value de l’objet. Par exemple, un bouton intitulé « OK » n’aurait pas besoin d’informations supplémentaires, contrairement à un bouton qui affiche une image d’un cactus. Les propriétés Name, Role et Help d’un tel bouton décrivent son objectif, mais la propriété Description transmet des informations moins tangibles ; par exemple, « Ce bouton affiche une image d’un cactus ».

Un serveur Microsoft Active Accessibility peut ajouter la prise en charge des UI Automation à l’aide de l’annotation directe, à l’aide de l’interface IAccessibleEx ou en implémentant Microsoft Active Accessibility et UI Automation côte à côte avec les deux implémentations gérant le message WM_GETOBJECT.

Utilisation de l’annotation directe

The IAccessibleEx Interface