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

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 Microsoft Active Accessibility Server ne doivent pas utiliser cette propriété. Si des informations supplémentaires sont nécessaires pour l’accessibilité et les scénarios d’automatisation, utilisez les propriétés prises en charge par les éléments UI Automation 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 contexte plus grand pour les utilisateurs malvoyants ou aveugles, mais elle est également utilisée pour la recherche de contexte 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 :: _ 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 lorsqu’elle n’est pas redondante en fonction des propriétés Name, role, Stateet value de l’objet. Par exemple, un bouton intitulé « OK » n’a pas besoin d’informations supplémentaires, alors qu’un bouton qui affiche une image d’un cactus. Le nom, le rôle et les propriétés d' aide d’un tel bouton décrivent son rôle, 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 d’UI Automation en utilisant 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 qui gèrent le message WM _ GETOBJECT .

Utilisation de l’annotation directe

Interface IAccessibleEx