Rôles d’objet

Cette rubrique décrit les valeurs constantes utilisées pour décrire les rôles de différents objets d’interface utilisateur dans une application. Les constantes de rôle sont définies dans le fichier Oleacc.h.

Vous devez utiliser uniquement les constantes de rôle répertoriées ici ; n’ajoutez pas de rôles personnalisés ou de rôles qui ne sont pas prédéfinis.

Avant d’utiliser ces rôles d’objet, les développeurs d’applications clientes doivent utiliser l’outil Inspecter pour vérifier que les rôles d’objet sont utilisés par les éléments d’interface utilisateur.

Pour récupérer le rôle d’un objet, les clients appellent la méthode IAccessible::get_accRole , qui doit retourner l’une des valeurs décrites dans le tableau. Pour récupérer une chaîne localisée qui décrit le rôle de l’objet, les clients appellent la fonction GetRoleText avec la valeur de rôle. Les chaînes localisées pour les valeurs de rôle se trouvent dans le fichier oleaccrc.dll.

Constante	Description
ROLE_SYSTEM_ALERT	L’objet représente une alerte ou une condition dont un utilisateur doit être averti. Ce rôle est utilisé uniquement pour les objets qui incarnent une alerte, mais qui ne sont pas associés à un autre élément d’interface utilisateur, tel qu’une boîte de message, un graphique, du texte ou un son.
ROLE_SYSTEM_ANIMATION	L’objet représente un contrôle d’animation dont le contenu change au fil du temps, tel qu’un contrôle qui affiche une série d’images bitmap. Les contrôles d’animation s’affichent lorsque des fichiers sont copiés ou lorsqu’une autre tâche fastidieuse est effectuée.
ROLE_SYSTEM_APPLICATION	L’objet représente une fenêtre main pour une application.
ROLE_SYSTEM_BORDER	L’objet représente une bordure de fenêtre. La bordure entière est représentée par un seul objet plutôt que par des objets distincts pour chaque côté.
ROLE_SYSTEM_BUTTONDROPDOWN	L’objet représente un bouton qui développe une liste d’éléments.
ROLE_SYSTEM_BUTTONDROPDOWNGRID	L’objet représente un bouton qui développe une grille.
ROLE_SYSTEM_BUTTONMENU	L’objet représente un bouton qui développe un menu.
ROLE_SYSTEM_CARET	L’objet représente l’insertion système.
ROLE_SYSTEM_CELL	L’objet représente une cellule dans un tableau.
ROLE_SYSTEM_CHARACTER	L’objet représente un objet graphique de type dessin animé, tel que l’Assistant Microsoft Office, qui s’affiche pour fournir de l’aide aux utilisateurs d’une application.
ROLE_SYSTEM_CHART	L’objet représente une image graphique utilisée pour graphiquer des données.
ROLE_SYSTEM_CHECKBUTTON	L’objet représente un contrôle de zone case activée : option sélectionnée ou désactivée indépendamment des autres options.
ROLE_SYSTEM_CLIENT	L’objet représente la zone cliente d’une fenêtre. Microsoft Active Accessibility utilise ce rôle comme rôle par défaut en cas de question sur le rôle d’un élément d’interface utilisateur.
ROLE_SYSTEM_CLOCK	L’objet représente un contrôle qui affiche l’heure.
ROLE_SYSTEM_COLUMN	L’objet représente une colonne de cellules dans un tableau.
ROLE_SYSTEM_COLUMNHEADER	L’objet représente un en-tête de colonne, fournissant une étiquette visuelle pour une colonne dans une table.
ROLE_SYSTEM_COMBOBOX	L’objet représente une zone de liste modifiable : un contrôle d’édition avec une zone de liste associée qui fournit un ensemble de choix prédéfinis.
ROLE_SYSTEM_CURSOR	L’objet représente le pointeur de la souris du système.
ROLE_SYSTEM_DIAGRAM	L’objet représente une image graphique utilisée pour diagrammer les données.
ROLE_SYSTEM_DIAL	L’objet représente un cadran ou un bouton.
ROLE_SYSTEM_DIALOG	L’objet représente une boîte de dialogue ou une boîte de message.
ROLE_SYSTEM_DOCUMENT	L’objet représente une fenêtre de document. Une fenêtre de document est toujours contenue dans une fenêtre d’application. Ce rôle s’applique uniquement aux fenêtres MDI et fait référence à l’objet qui contient la barre de titre MDI.
ROLE_SYSTEM_DROPLIST	L’objet représente le contrôle de calendrier SysDateTimePick32. Le composant runtime Microsoft Active Accessibility utilise ce rôle pour indiquer qu’un contrôle de date ou de calendrier a été trouvé.
ROLE_SYSTEM_EQUATION	L’objet représente une équation mathématique.
ROLE_SYSTEM_GRAPHIC	L’objet représente une image.
ROLE_SYSTEM_GRIP	L’objet représente un pointeur de souris spécial qui permet à un utilisateur de manipuler des éléments d’interface utilisateur tels que windows. Par exemple, vous pouvez redimensionner une fenêtre en faisant glisser son coin inférieur droit.
ROLE_SYSTEM_GROUPING	L’objet regroupe logiquement d’autres objets. Il n’existe pas toujours de relation parent-enfant entre l’objet de regroupement et les objets qu’il contient.
ROLE_SYSTEM_HELPBALLOON	L’objet affiche une rubrique d’aide sous la forme d’une info-bulle ou d’une bulle d’aide.
ROLE_SYSTEM_HOTKEYFIELD	L’objet représente un champ de raccourci clavier qui permet à l’utilisateur d’entrer une combinaison ou une séquence de séquences de touches.
ROLE_SYSTEM_INDICATOR	L’objet représente un indicateur, tel qu’un graphique de pointeur, qui pointe vers l’élément actif.
ROLE_SYSTEM_IPADDRESS	L’objet représente un contrôle d’édition conçu pour une adresse IP. Le contrôle d’édition est divisé en sections, chacune correspondant à une partie spécifique de l’adresse IP.
ROLE_SYSTEM_LINK	L’objet représente un lien vers un autre élément. Cet objet peut ressembler à du texte ou à un graphique, mais il se comporte comme un bouton.
ROLE_SYSTEM_LIST	L’objet représente une zone de liste, permettant à l’utilisateur de sélectionner un ou plusieurs éléments.
ROLE_SYSTEM_LISTITEM	L’objet représente un élément dans une zone de liste ou dans la partie liste d’une zone de liste déroulante, d’une zone de liste déroulante ou d’une zone de liste déroulante.
ROLE_SYSTEM_MENUBAR	L’objet représente la barre de menus (située sous la barre de titre d’une fenêtre) à partir de laquelle les utilisateurs sélectionnent des menus.
ROLE_SYSTEM_MENUITEM	L’objet représente un élément de menu : une entrée de menu que l’utilisateur peut choisir pour exécuter une commande, sélectionner une option ou afficher un autre menu. Fonctionnellement, un élément de menu équivaut à un bouton pousseur, une case d’option, une zone de case activée ou un menu.
ROLE_SYSTEM_MENUPOPUP	L’objet représente un menu : une liste d’options, chacune avec une action spécifique. Tous les types de menus doivent avoir un rôle, y compris les menus déroulants qui s’affichent lorsqu’ils sont sélectionnés dans une barre de menus ; et les menus contextuels, qui s’affichent en cliquant sur le bouton droit de la souris.
ROLE_SYSTEM_OUTLINE	L’objet représente un plan ou une arborescence, tel qu’un contrôle d’arborescence, qui affiche une liste hiérarchique et permet à l’utilisateur d’étendre et de réduire des branches.
ROLE_SYSTEM_OUTLINEBUTTON	L’objet représente un élément qui navigue comme un élément de plan. Les touches de direction Haut et Bas sont utilisées pour naviguer dans le plan. Toutefois, au lieu de se développer et de s’effondrer lorsque les touches FLÈCHE GAUCHE et DROITE sont enfoncées, ces menus se développent ou se réduisent lorsque la touche ESPACEBAR ou ENTRÉE est enfoncée et que l’élément a le focus.
ROLE_SYSTEM_OUTLINEITEM	L’objet représente un élément dans un plan ou une arborescence.
ROLE_SYSTEM_PAGETAB	L’objet représente un onglet de page. Le seul enfant d’un contrôle d’onglet de page est un objet ROLE_SYSTEM_GROUPING qui a le contenu de la page associée.
ROLE_SYSTEM_PAGETABLIST	L’objet représente un conteneur de contrôles d’onglet de page.
ROLE_SYSTEM_PANE	L’objet représente un volet dans un cadre ou une fenêtre de document. Les utilisateurs peuvent naviguer entre des volets et dans le contenu du volet actif, mais ne peuvent pas naviguer entre des éléments situés dans des volets différents. Ainsi, les volets représentent un niveau de regroupement inférieur à celui des cadres ou des fenêtres de document, mais supérieur aux contrôles individuels. L’utilisateur navigue entre les volets en appuyant sur TAB, F6 ou Ctrl+Tab, en fonction du contexte.
ROLE_SYSTEM_PROGRESSBAR	L’objet représente une barre de progression, qui indique dynamiquement la quantité d’une opération en cours terminée. Ce contrôle ne prend aucune entrée utilisateur.
ROLE_SYSTEM_PROPERTYPAGE	L’objet représente une feuille de propriétés.
ROLE_SYSTEM_PUSHBUTTON	L’objet représente un contrôle push-button.
ROLE_SYSTEM_RADIOBUTTON	L’objet représente un bouton d’option (anciennement, case d’option). Il fait partie d’un groupe d’options mutuellement exclusives. Tous les objets qui partagent le même parent et qui ont cet attribut sont supposés faire partie d’un groupe mutuellement exclusif. Pour diviser ces objets en groupes distincts, utilisez ROLE_SYSTEM_GROUPING objets.
ROLE_SYSTEM_ROW	L’objet représente une ligne de cellules dans une table.
ROLE_SYSTEM_ROWHEADER	L’objet représente un en-tête de ligne, qui fournit une étiquette visuelle pour une ligne de tableau.
ROLE_SYSTEM_SCROLLBAR	L’objet représente une barre de défilement verticale ou horizontale, qui fait partie de la zone cliente ou est utilisée dans un contrôle.
ROLE_SYSTEM_SEPARATOR	L’objet est utilisé pour diviser visuellement un espace en deux régions. Parmi les exemples d’objets séparateurs, citons un élément de menu séparateur et une barre qui divise les volets fractionnés au sein d’une fenêtre.
ROLE_SYSTEM_SLIDER	L’objet représente un curseur, qui permet à l’utilisateur d’ajuster un paramètre par incréments particuliers entre les valeurs minimales et maximales.
ROLE_SYSTEM_SOUND	L’objet représente un son système, qui est associé à divers événements système.
ROLE_SYSTEM_SPINBUTTON	L’objet représente une zone de rotation, qui est un contrôle qui permet à l’utilisateur d’incrémenter ou de décrémenter la valeur affichée dans un contrôle « buddy » distinct associé à la zone de rotation.
ROLE_SYSTEM_SPLITBUTTON	L’objet représente un bouton dans une barre d’outils avec une icône de liste déroulante directement adjacente au bouton.
ROLE_SYSTEM_STATICTEXT	L’objet représente du texte en lecture seule, comme des étiquettes pour d’autres contrôles ou instructions dans une boîte de dialogue. Le texte statique ne peut pas être modifié ou sélectionné.
ROLE_SYSTEM_STATUSBAR	L’objet représente une barre de status, qui est une zone située en bas d’une fenêtre et qui affiche des informations sur l’opération actuelle, l’état de l’application ou l’objet sélectionné. La barre de status comporte plusieurs champs, qui affichent différents types d’informations.
ROLE_SYSTEM_TABLE	L’objet représente une table qui contient des lignes et des colonnes de cellules et, éventuellement, des en-têtes de ligne et des en-têtes de colonne.
ROLE_SYSTEM_TEXT	L’objet représente le texte sélectionnable qui autorise les modifications ou est désigné comme en lecture seule.
ROLE_SYSTEM_TITLEBAR	L’objet représente un titre ou légende barre d’une fenêtre.
ROLE_SYSTEM_TOOLBAR	L’objet représente une barre d’outils, qui est un regroupement de contrôles qui fournit un accès facile aux fonctionnalités fréquemment utilisées.
ROLE_SYSTEM_TOOLTIP	L’objet représente une info-bulle qui fournit des conseils utiles.
ROLE_SYSTEM_WHITESPACE	L’objet représente un espace vide entre d’autres objets.
ROLE_SYSTEM_WINDOW	L’objet représente le cadre de fenêtre, qui contient des objets enfants tels qu’une barre de titre, un client et d’autres objets d’une fenêtre.

Spécifications

Condition requise	Valeur
En-tête	Oleacc.h