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 push 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 constantes de rôle, définies dans oleacc.h, qui identifient les rôles d’objet courants. Il est recommandé que les développeurs serveur utilisent 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 qui sont 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, la vue grand-icône d’un dossier permet une disposition arbitraire des icônes, afin que son rôle puisse être décrit comme ROLE_SYSTEM_GROUPING. Ou 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.