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 ne devez utiliser que les constantes de rôle répertoriées ici ; n’ajoutez pas de rôles ou de rôles personnalisés 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 d' inspection 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 :: obtenir _ 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 role. Les chaînes localisées pour les valeurs de rôle se trouvent dans le fichier oleaccrc.dll.

Constante Description
_alerte du système de rôle _
L’objet représente une alerte ou une condition pour laquelle un utilisateur doit être averti. Ce rôle est utilisé uniquement pour les objets qui génèrent 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 du son.
_animation du système de rôle _
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 de frames bitmap. Les contrôles d’animation sont affichés lorsque des fichiers sont copiés ou lorsqu’une autre tâche qui prend du temps est exécutée.
_application de système de rôle _
L’objet représente une fenêtre principale pour une application.
_bordure du système de rôle _
L’objet représente une bordure de fenêtre. La bordure entière est représentée par un objet unique plutôt que par des objets séparés pour chaque côté.
système de rôle _ _ BUTTONDROPDOWN
L’objet représente un bouton qui développe une liste d’éléments.
système de rôle _ _ BUTTONDROPDOWNGRID
L’objet représente un bouton qui développe une grille.
système de rôle _ _ BUTTONMENU
L’objet représente un bouton qui développe un menu.
_signe insertion du système de rôle _
L’objet représente le signe insertion système.
_cellule système de rôle _
L’objet représente une cellule dans une table.
_caractère système du rôle _
l’objet représente un objet graphique de type dessiné, tel que Microsoft Office Assistant, qui est affiché pour fournir de l’aide aux utilisateurs d’une application.
_graphique de système de rôle _
L’objet représente une image graphique utilisée pour représenter des données de graphique.
système de rôle _ _ CHECKBUTTON
L’objet représente un contrôle de case à cocher : option qui est sélectionnée ou décochée indépendamment des autres options.
_client du système de rôle _
L’objet représente la zone cliente d’une fenêtre. Microsoft Active Accessibility utilise ce rôle comme valeur par défaut en cas de question sur le rôle d’un élément d’interface utilisateur.
_horloge système du rôle _
L’objet représente un contrôle qui affiche l’heure.
_colonne système de rôle _
L’objet représente une colonne de cellules dans un tableau.
système de rôle _ _ COLUMNHEADER
L’objet représente un en-tête de colonne qui fournit une étiquette visuelle pour une colonne dans une table.
_ComboBox système de rôle _
L’objet représente une zone de liste déroulante : un contrôle d’édition avec une zone de liste associée qui fournit un ensemble de choix prédéfinis.
_curseur de système de rôle _
L’objet représente le pointeur de la souris du système.
_diagramme du système de rôle _
L’objet représente une image graphique utilisée pour représenter des données de diagramme.
_numérotation du système de rôle _
L’objet représente un cadran ou un bouton.
_boîte de dialogue système de rôle _
L’objet représente une boîte de dialogue ou une boîte de message.
_document système de rôle _
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.
déroulant système de rôle _ _
L’objet représente le contrôle Calendar, SysDateTimePick32. Le composant d’exécution de Microsoft Active Accessibility utilise ce rôle pour indiquer qu’un contrôle de date ou de calendrier a été trouvé.
_équation du système de rôle _
L’objet représente une équation mathématique.
_graphique du système de rôle _
L’objet représente une image.
_poignée du système de rôle _
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. Un exemple consiste à redimensionner une fenêtre en faisant glisser son coin inférieur droit.
_regroupement du système de rôle _
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.
système de rôle _ _ HELPBALLOON
L’objet affiche une rubrique d’aide sous la forme d’une info-bulle ou d’une info-bulle.
système de rôle _ _ 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.
_indicateur de système de rôle _
L’objet représente un indicateur, tel qu’un graphique de pointeur, qui pointe vers l’élément actuel.
_adresse IP du système de rôle _
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 pour une partie spécifique de l’adresse IP.
_lien système de rôle _
L’objet représente un lien vers autre chose. Cet objet peut ressembler à du texte ou à un graphique, mais il se comporte comme un bouton.
_liste des systèmes de rôles _
L’objet représente une zone de liste, ce qui permet à l’utilisateur de sélectionner un ou plusieurs éléments.
_ListItem du système de rôle _
L’objet représente un élément dans une zone de liste ou dans la partie liste d’une zone de liste déroulante, zone de liste déroulante ou zone de liste déroulante.
barre de menus du _ système de rôle _
L’objet représente la barre de menus (placée sous la barre de titre d’une fenêtre) à partir de laquelle les utilisateurs sélectionnent des menus.
système de rôle _ _ 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 est équivalent à un bouton de commande, une case d’option, une case à cocher ou un menu.
système de rôle _ _ MENUPOPUP
L’objet représente un menu : une liste d’options, chacune avec une action spécifique. Tous les types de menu 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 menus contextuels, qui s’affichent en cliquant sur le bouton droit de la souris.
_structure du système de rôle _
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 de développer et de réduire des branches.
système de rôle _ _ OUTLINEBUTTON
L’objet représente un élément qui navigue comme un élément de plan. Les touches de direction haut et bas permettent de naviguer dans le plan. Toutefois, au lieu de développer et de réduire quand la touche de direction gauche et droite est enfoncée, ces menus sont développés ou réduits lorsque la touche espace ou entrée est enfoncée et que l’élément a le focus.
système de rôle _ _ OUTLINEITEM
L’objet représente un élément dans une structure hiérarchique ou une arborescence.
système de rôle _ _ PAGETAB
L’objet représente un onglet de page. Le seul enfant d’un contrôle d’onglet de page est _ un _ objet de regroupement de système de rôle qui a le contenu de la page associée.
système de rôle _ _ PAGETABLIST
L’objet représente un conteneur de contrôles d’onglets de page.
_volet système de rôle _
L’objet représente un volet dans un frame 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 aux cadres ou aux fenêtres de document, mais sont plus élevés que les contrôles individuels. L’utilisateur navigue entre les volets en appuyant sur TAB, F6 ou Ctrl+Tab, en fonction du contexte.
_PROGRESSBAR du système de rôle _
L’objet représente une barre de progression qui indique de manière dynamique la proportion d’une opération en cours d’exécution. Ce contrôle n’accepte aucune entrée d’utilisateur.
système de rôle _ _ PROPERTYPAGE
L’objet représente une feuille de propriétés.
_PUSHBUTTON système de rôle _
L’objet représente un contrôle de bouton de commande.
RadioButton du système de rôle _ _
L’objet représente une case d’option (anciennement, une case d’option). Il s’agit d’un groupe d’options s’excluant mutuellement. Tous les objets qui partagent le même parent et qui ont cet attribut sont supposés faire partie d’un seul groupe mutuellement exclusif. Pour diviser ces objets en groupes distincts, utilisez les _ objets de regroupement de système de rôle _ .
_ligne du système de rôle _
L’objet représente une ligne de cellules dans un tableau.
système de rôle _ _ ROWHEADER
L’objet représente un en-tête de ligne, qui fournit une étiquette visuelle pour une ligne de tableau.
_ScrollBar système de rôle _
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.
_séparateur système de rôle _
L’objet est utilisé pour diviser visuellement un espace en deux régions. Voici quelques exemples d’objets Separator : un élément de menu séparateur et une barre qui divise les volets fractionnés dans une fenêtre.
_curseur système de rôle _
L’objet représente un curseur, qui permet à l’utilisateur d’ajuster un paramètre à des incréments particuliers entre les valeurs minimale et maximale.
_son du système de rôle _
L’objet représente un son système, qui est associé à divers événements système.
_SPINBUTTON du système de rôle _
L’objet représente une zone de sélection numérique, 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 « copain » distinct associé à la zone de sélection numérique.
système de rôle _ _ SPLITBUTTON
L’objet représente un bouton sur une barre d’outils dont l’icône de liste déroulante est directement adjacente au bouton.
système de rôle _ _ 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é.
_STATUSBAR du système de rôle _
L’objet représente une barre d’État, qui est une zone en bas d’une fenêtre et qui affiche des informations sur l’opération en cours, l’état de l’application ou l’objet sélectionné. La barre d’État comporte plusieurs champs qui affichent différents types d’informations.
_table système des rôles _
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 colonnes.
_texte du système de rôle _
L’objet représente du texte sélectionnable qui autorise les modifications ou est désigné comme étant en lecture seule.
_TITLEBAR système de rôle _
L’objet représente une barre de titre ou de légende pour une fenêtre.
_ _ barre d’outils système de rôle
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.
_ _ info-bulle du système de rôle
L’objet représente une info-bulle qui fournit des indications utiles.
_espace blanc du système de rôle _
L’objet représente un espace vide entre les autres objets.
_fenêtre système de rôle _
L’objet représente le cadre de la fenêtre, qui contient des objets enfants tels qu’une barre de titre, un client et d’autres objets d’une fenêtre.

Configuration requise

Condition requise Valeur
En-tête
Oleacc. h