Role, propriété

La propriété Role décrit l’élément d’interface utilisateur d’un objet. Tous les objets prennent en charge la propriété Role .

Dans de nombreux cas, le rôle de l’objet est évident. Par exemple, les fenêtres ont le rôle ROLE_SYSTEM_WINDOW et les boutons-poussoirs ont le rôle ROLE_SYSTEM_PUSHBUTTON .

La propriété Role est récupérée en appelant IAccessible::get_accRole.

Identification du rôle d’un objet

Microsoft Active Accessibility fournit des constantes de rôle, définies dans oleacc.h, qui identifient les rôles d’objet courants. Il est recommandé aux développeurs de serveurs d’utiliser ces valeurs de rôle prédéfinies. Si une constante de rôle prédéfinie est retournée, les clients utilisent la fonction GetRoleText pour récupérer une chaîne localisée qui décrit le rôle.

Pour les contrôles d’animation, tels que le contrôle d’animation affiché lors de la copie de fichiers, utilisez ROLE_SYSTEM_ANIMATION. Les graphiques parfois animés sont décrits comme ROLE_SYSTEM_GRAPHIC avec la propriété State définie sur STATE_SYSTEM_ANIMATED.

Notez que certains rôles ne sont pas faciles à décrire. Par exemple, l’affichage en grandes icônes d’un dossier permet une disposition arbitraire des icônes, de sorte que son rôle peut être décrit comme ROLE_SYSTEM_GROUPING. Ou bien, un contrôle qui fournit des éléments dans des lignes et des colonnes fixes peut avoir le rôle ROLE_SYSTEM_TABLE . Étant donné qu’un rôle est utilisé pour communiquer le modèle d’utilisation à un utilisateur final, il est important d’utiliser le rôle approprié. Par exemple, si votre contrôle agit comme un bouton, utilisez ROLE_SYSTEM_PUSHBUTTON.