Description, propriété (fonctionnalités d’accessibilité Windows)
Note
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 de serveurs Microsoft Active Accessibility ne doivent pas utiliser cette propriété. Si d’autres informations sont nécessaires pour les scénarios d’accessibilité et d’automatisation, utilisez les propriétés prises en charge par les éléments et les modèles de contrôle UI Automation.
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 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 ::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 lorsqu’elle n’est pas redondante en fonction de l'Nom de l’objet, rôle, d’état et propriétés Value. Par exemple, un bouton intitulé « OK » n’aurait pas besoin d’informations supplémentaires, tandis qu’un bouton montrant une image d’un cactus. Le nom , rôleet les propriétés d’aide pour ce bouton décrivent son objectif, mais la propriété Description transmet des informations moins tangibles ; par exemple, « Ce bouton montre une image d’un cactus ».
Un serveur Microsoft Active Accessibility peut ajouter la prise en charge d’UI Automation à l’aide de d’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.
Rubriques connexes
-
à l’aide d’une d’annotation directe