AccessibleRole Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie des valeurs représentant les rôles possibles pour un objet accessible.
public enum class AccessibleRolepublic enum AccessibleRoletype AccessibleRole = Public Enum AccessibleRole- Héritage
Champs
| Alert | 8 | Alerte ou condition que vous pouvez notifier à l'utilisateur. Utilisez ce rôle uniquement pour les objets qui génèrent une alerte mais 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 | 54 | Contrôle d'animation, qui contient du contenu qui change au cours du temps, tel qu'un contrôle qui affiche une série de frames bitmap, une pellicule, par exemple. Les contrôles d'animation sont généralement affichés quand des fichiers sont copiés, ou quand une autre tâche de longue durée est exécutée. |
| Application | 14 | Fenêtre principale d'une application. |
| Border | 19 | Bordure d'une fenêtre. La bordure entière est représentée par un seul objet, plutôt que par des objets séparés pour chaque côté. |
| ButtonDropDown | 56 | Bouton déroulant une liste d'éléments. |
| ButtonDropDownGrid | 58 | Bouton déroulant une grille. |
| ButtonMenu | 57 | Bouton déroulant un menu. |
| Caret | 7 | Signe insertion, qui est un trait clignotant, bloc ou bitmap qui marque l'emplacement du point d'insertion dans la zone cliente d'une fenêtre. |
| Cell | 29 | Cellule dans un tableau. |
| Character | 32 | Un objet graphique de type animation, tel que l'assistant Microsoft Office, qui est généralement affiché pour fournir de l'aide aux utilisateurs d'une application. |
| Chart | 17 | Image graphique utilisée pour représenter des données. |
| CheckButton | 44 | Contrôle Check Box, qui est une option qui peut être activée ou désactivée indépendamment des autres options. |
| Client | 10 | Zone utilisateur d'une fenêtre. |
| Clock | 61 | Contrôle affichant l'heure. |
| Column | 27 | Colonne de cellules dans un tableau. |
| ColumnHeader | 25 | En-tête de colonne, qui affiche une étiquette visuelle pour une colonne dans un tableau. |
| ComboBox | 46 | Zone de liste déroulante, qui est un contrôle edit avec une zone de liste associée qui propose un ensemble de choix prédéfinis. |
| Cursor | 6 | Pointeur de souris. |
| Default | -1 | Rôle fourni par le système. |
| Diagram | 53 | Image graphique utilisée pour représenter des données. |
| Dial | 49 | Cadran ou bouton. Il peut également être en lecture seule, comme un compteur de vitesse, par exemple. |
| Dialog | 18 | Boîte de dialogue ou boîte de message. |
| Document | 15 | Fenêtre de document, qui est toujours contenue dans une fenêtre d'application. Ce rôle ne s'applique qu'aux fenêtres d'interface multidocument (MDI) et fait référence à un objet qui contient la barre de titre MDI. |
| DropList | 47 | Zone de liste déroulante modifiable. Ce contrôle affiche un seul élément et permet à l'utilisateur d'afficher et sélectionner un autre élément dans une liste de choix possibles. |
| Equation | 55 | Équation mathématique. |
| Graphic | 40 | Image. |
| Grip | 4 | Pointeur de souris spécial, qui permet à l'utilisateur de manipuler des éléments d'interface utilisateur, tels qu'une fenêtre. Par exemple, un utilisateur peut cliquer et faire glisser une poignée de dimensionnement dans le coin inférieur droit d'une fenêtre pour la redimensionner. |
| Grouping | 20 | Objets groupés de manière logique. Il peut y avoir une relation parent-enfant entre l'objet de regroupement et les objets qu'il contient. |
| HelpBalloon | 31 | Aide affichée sous la forme d'une info-bulle ou d'une bulle d'aide, qui contient des boutons et des étiquettes sur lesquelles l'utilisateur peut cliquer pour ouvrir des rubriques d'aide personnalisées. |
| HotkeyField | 50 | Champ de touche d'accès rapide permettant à l'utilisateur d'entrer une combinaison ou une séquence de touches à utiliser comme touche d'accès rapide, qui permet aux utilisateurs d'exécuter une action rapidement. Un contrôle de touche d'accès rapide affiche les touches entrées par l'utilisateur et vérifie que l'utilisateur sélectionne une combinaison de touches valide. |
| Indicator | 39 | Indicateur, tel qu'un pointeur graphique, qui pointe sur l'élément actif. |
| IpAddress | 63 | Contrôle conçu pour entrer des adresses IP. |
| Link | 30 | Lien, qui est une connexion entre un document source et un document de destination. Cet objet peut ressembler à du texte ou à un graphique, mais il se comporte comme un bouton. |
| List | 33 | Zone de liste, qui permet à l'utilisateur de sélectionner un ou plusieurs éléments. |
| ListItem | 34 | Élément dans une zone de liste ou partie de liste d'une zone de liste déroulante, zone de liste déroulante modifiable ou zone de liste déroulante fixe. |
| MenuBar | 2 | Barre de menus, généralement située au-dessous de la barre de titre d'une fenêtre, à partir de laquelle des utilisateurs peuvent sélectionner des menus. |
| MenuItem | 12 | Élément de menu, qui est une entrée dans un menu qu'un utilisateur peut sélectionner pour exécuter une commande, sélectionner une option ou afficher un autre menu. Du point de vue fonctionnel, un élément de menu peut être équivalent à un bouton de commande, une case d'option, une case à cocher ou un menu. |
| MenuPopup | 11 | Menu, qui présente une liste d'options dans laquelle l'utilisateur peut effectuer une sélection pour exécuter une action. Tous les types de menus doivent avoir ce rôle, y compris les menus déroulants qui sont affichés par sélection dans une barre de menus, et les menus contextuels qui sont affichés à la suite d'un clic avec le bouton droit de la souris. |
| None | 0 | Aucun rôle. |
| Outline | 35 | Structure ou arborescence, telle qu'un contrôle tree view, qui affiche une liste hiérarchique et permet généralement à l'utilisateur de développer et réduire des branchements. |
| OutlineButton | 64 | Contrôle qui navigue comme un élément de contour. |
| OutlineItem | 36 | Élément dans une structure ou une arborescence. |
| PageTab | 37 | Page de propriétés permettant à l'utilisateur d'afficher les attributs d'une page, tels que le titre de la page, si la page est une page d'accueil ou a été modifiée. Normalement, le seul enfant de ce contrôle est un objet groupé qui contient le contenu de la page associée. |
| PageTabList | 60 | Conteneur des contrôles onglet d'une page. |
| Pane | 16 | Zone séparée dans un frame, fenêtre de document fractionnée ou zone rectangulaire de la barre d'état qui peut être utilisée pour afficher des informations. 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. Par conséquent, les volets représentent un niveau de regroupement situé au-dessous des fenêtres frames ou documents, mais au-dessus des contrôles individuels. Généralement, l'utilisateur navigue entre des volets en appuyant sur TAB, F6 ou CTRL+TAB, suivant le contexte. |
| ProgressBar | 48 | Barre de progression, qui indique la progression d'une opération longue en affichant des lignes colorées dans un rectangle horizontal. La longueur des lignes ramenée à la longueur du rectangle correspond au pourcentage de l'opération effectué. Ce contrôle ne reçoit pas d'entrée d'utilisateur. |
| PropertyPage | 38 | Page de propriétés, qui est une boîte de dialogue qui contrôle l'apparence et le comportement d'un objet, tel qu'un fichier ou une ressource. L'apparence d'une page de propriétés est différente suivant sa fonction. |
| PushButton | 43 | Contrôle de bouton de commande, qui est un petit contrôle rectangulaire qu'un utilisateur peut activer ou désactiver. Un bouton de commande a une apparence en relief dans l'état désactivé par défaut et une apparence enfoncée quand il est activé. |
| RadioButton | 45 | Bouton d'option, également appelé case d'option. Tous les objets ayant le même parent qui ont cet attribut sont supposés faire partie d'un seul groupe mutuellement exclusif. Vous pouvez utiliser des objets groupés pour diviser les cases d'option en groupes séparés, si nécessaire. |
| Row | 28 | Ligne de cellules dans un tableau. |
| RowHeader | 26 | En-tête de ligne, qui affiche une étiquette visuelle pour une ligne de tableau. |
| ScrollBar | 3 | Barre de défilement verticale ou horizontale, qui peut faire partie de la zone cliente ou être utilisée dans un contrôle. |
| Separator | 21 | Espace divisé en deux régions, tel qu'un élément de menu séparateur ou un séparateur de fractionnement d'une fenêtre en volets. |
| Slider | 51 | Contrôle, parfois appelé barre de suivi, qui permet à un utilisateur d'ajuster un paramètre par incréments spécifiés entre des valeurs minimales et maximales en déplaçant un curseur. Les contrôles de volume dans le système d'exploitation Windows sont des contrôles Slider. |
| Sound | 5 | Son système, qui est associé à différents événements système. |
| SpinButton | 52 | Zone de sélection numérique, également appelée contrôle up-down, qui contient une paire de boutons fléchés. L'utilisateur clique sur les boutons fléchés avec la souris pour incrémenter ou décrémenter une valeur. Un contrôle Spin est fréquemment utilisé avec un contrôle compagnon, appelé fenêtre associée, dans lequel la valeur actuelle est affichée. |
| SplitButton | 62 | Bouton de barre d'outils à côté duquel apparaît une icône de liste déroulante. |
| StaticText | 41 | Texte en lecture seule, dans une étiquette, par exemple, 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 | 23 | Barre d'état, qui est une zone généralement en bas d'une fenêtre d'application, qui affiche des informations sur l'opération en cours, l'état de l'application ou l'objet sélectionné. La barre d'état peut comprendre plusieurs champs qui affichent différents types d'informations, telles qu'une description de la commande de menu actuellement sélectionnée dans la barre d'état. |
| Table | 24 | Tableau contenant des lignes et des colonnes de cellules et, éventuellement, des en-têtes de ligne et des en-têtes de colonne. |
| Text | 42 | Texte sélectionnable qui peut être modifiable ou en lecture seule. |
| TitleBar | 1 | Barre de titre ou légende d'une fenêtre. |
| ToolBar | 22 | Barre d'outils, qui est un regroupement de contrôles qui permettent d'accéder aisément à des fonctionnalités fréquemment utilisées. |
| ToolTip | 13 | Info-bulle, qui est une petite fenêtre indépendante, affichant une brève description de la fonction d'un bouton. |
| WhiteSpace | 59 | Espace vide entre d'autres objets. |
| Window | 9 | Frame de fenêtre, qui contient généralement des objets enfants tels qu'une barre de titre, un client et d'autres objets qu'une fenêtre contient généralement. |
Exemples
L’exemple de code suivant illustre la création d’un contrôle de graphique prenant en compte l’accessibilité, en utilisant les classes et Control.ControlAccessibleObject les AccessibleObject classes pour exposer des informations accessibles. Le contrôle trace deux courbes avec une légende. La ChartControlAccessibleObject classe, qui dérive de ControlAccessibleObject, est utilisée dans la CreateAccessibilityInstance méthode pour fournir des informations accessibles personnalisées pour le contrôle de graphique. Étant donné que la légende du graphique n’est pas un contrôle réel Control , mais qu’elle est dessinée par le contrôle de graphique, elle ne contient aucune information accessible intégrée. En raison de cela, la ChartControlAccessibleObject classe remplace la GetChild méthode pour renvoyer les CurveLegendAccessibleObject informations accessibles pour chaque partie de la légende. Lorsqu’une application prenant en charge l’accès utilise ce contrôle, le contrôle peut fournir les informations accessibles nécessaires.
Cet exemple montre comment utiliser l’énumération AccessibleRole avec la Role propriété. Consultez la vue d’ensemble de la classe pour l’exemple AccessibleObject de code complet.
// Inner class ChartControlAccessibleObject represents accessible information associated with the ChartControl.
// The ChartControlAccessibleObject is returned in the ChartControl::CreateAccessibilityInstance .
ref class ChartControlAccessibleObject: public ControlAccessibleObject
{
private:
ChartControl^ chartControl;
public:
ChartControlAccessibleObject( ChartControl^ ctrl )
: ControlAccessibleObject( ctrl )
{
chartControl = ctrl;
}
property System::Windows::Forms::AccessibleRole Role
{
// Gets the role for the Chart. This is used by accessibility programs.
virtual System::Windows::Forms::AccessibleRole get() override
{
return ::AccessibleRole::Chart;
}
}
property AccessibleStates State
{
// Gets the state for the Chart. This is used by accessibility programs.
virtual AccessibleStates get() override
{
return AccessibleStates::ReadOnly;
}
}
// The CurveLegend objects are "child" controls in terms of accessibility so
// return the number of ChartLengend objects.
virtual int GetChildCount() override
{
return chartControl->Legends->Length;
}
// Gets the Accessibility object of the child CurveLegend idetified by index.
virtual AccessibleObject^ GetChild( int index ) override
{
if ( index >= 0 && index < chartControl->Legends->Length )
{
return chartControl->Legends[ index ]->AccessibilityObject;
}
return nullptr;
}
internal:
// Helper function that is used by the CurveLegend's accessibility object
// to navigate between sibiling controls. Specifically, this function is used in
// the CurveLegend::CurveLegendAccessibleObject.Navigate function.
AccessibleObject^ NavigateFromChild( CurveLegend::CurveLegendAccessibleObject^ child, AccessibleNavigation navdir )
{
switch ( navdir )
{
case AccessibleNavigation::Down:
case AccessibleNavigation::Next:
return GetChild( child->ID + 1 );
case AccessibleNavigation::Up:
case AccessibleNavigation::Previous:
return GetChild( child->ID - 1 );
}
return nullptr;
}
// Helper function that is used by the CurveLegend's accessibility object
// to select a specific CurveLegend control. Specifically, this function is used
// in the CurveLegend::CurveLegendAccessibleObject.Select function.
void SelectChild( CurveLegend::CurveLegendAccessibleObject^ child, AccessibleSelection selection )
{
int childID = child->ID;
// Determine which selection action should occur, based on the
// AccessibleSelection value.
if ( (selection & AccessibleSelection::TakeSelection) != (AccessibleSelection)0 )
{
for ( int i = 0; i < chartControl->Legends->Length; i++ )
{
if ( i == childID )
{
chartControl->Legends[ i ]->Selected = true;
}
else
{
chartControl->Legends[ i ]->Selected = false;
}
}
// AccessibleSelection->AddSelection means that the CurveLegend will be selected.
if ( (selection & AccessibleSelection::AddSelection) != (AccessibleSelection)0 )
{
chartControl->Legends[ childID ]->Selected = true;
}
// AccessibleSelection->AddSelection means that the CurveLegend will be unselected.
if ( (selection & AccessibleSelection::RemoveSelection) != (AccessibleSelection)0 )
{
chartControl->Legends[ childID ]->Selected = false;
}
}
}
};
// class ChartControlAccessibleObject
// Inner class ChartControlAccessibleObject represents accessible information associated with the ChartControl.
// The ChartControlAccessibleObject is returned in the ChartControl.CreateAccessibilityInstance override.
public class ChartControlAccessibleObject : ControlAccessibleObject
{
ChartControl chartControl;
public ChartControlAccessibleObject(ChartControl ctrl) : base(ctrl)
{
chartControl = ctrl;
}
// Gets the role for the Chart. This is used by accessibility programs.
public override AccessibleRole Role
{
get {
return AccessibleRole.Chart;
}
}
// Gets the state for the Chart. This is used by accessibility programs.
public override AccessibleStates State
{
get {
return AccessibleStates.ReadOnly;
}
}
// The CurveLegend objects are "child" controls in terms of accessibility so
// return the number of ChartLengend objects.
public override int GetChildCount()
{
return chartControl.Legends.Length;
}
// Gets the Accessibility object of the child CurveLegend idetified by index.
public override AccessibleObject GetChild(int index)
{
if (index >= 0 && index < chartControl.Legends.Length) {
return chartControl.Legends[index].AccessibilityObject;
}
return null;
}
// Helper function that is used by the CurveLegend's accessibility object
// to navigate between sibiling controls. Specifically, this function is used in
// the CurveLegend.CurveLegendAccessibleObject.Navigate function.
internal AccessibleObject NavigateFromChild(CurveLegend.CurveLegendAccessibleObject child,
AccessibleNavigation navdir)
{
switch(navdir) {
case AccessibleNavigation.Down:
case AccessibleNavigation.Next:
return GetChild(child.ID + 1);
case AccessibleNavigation.Up:
case AccessibleNavigation.Previous:
return GetChild(child.ID - 1);
}
return null;
}
// Helper function that is used by the CurveLegend's accessibility object
// to select a specific CurveLegend control. Specifically, this function is used
// in the CurveLegend.CurveLegendAccessibleObject.Select function.
internal void SelectChild(CurveLegend.CurveLegendAccessibleObject child, AccessibleSelection selection)
{
int childID = child.ID;
// Determine which selection action should occur, based on the
// AccessibleSelection value.
if ((selection & AccessibleSelection.TakeSelection) != 0) {
for(int i = 0; i < chartControl.Legends.Length; i++) {
if (i == childID) {
chartControl.Legends[i].Selected = true;
} else {
chartControl.Legends[i].Selected = false;
}
}
// AccessibleSelection.AddSelection means that the CurveLegend will be selected.
if ((selection & AccessibleSelection.AddSelection) != 0) {
chartControl.Legends[childID].Selected = true;
}
// AccessibleSelection.AddSelection means that the CurveLegend will be unselected.
if ((selection & AccessibleSelection.RemoveSelection) != 0) {
chartControl.Legends[childID].Selected = false;
}
}
}
}
' Inner Class ChartControlAccessibleObject represents accessible information
' associated with the ChartControl.
' The ChartControlAccessibleObject is returned in the ' ChartControl.CreateAccessibilityInstance override.
Public Class ChartControlAccessibleObject
Inherits Control.ControlAccessibleObject
Private chartControl As ChartControl
Public Sub New(ctrl As ChartControl)
MyBase.New(ctrl)
chartControl = ctrl
End Sub
' Get the role for the Chart. This is used by accessibility programs.
Public Overrides ReadOnly Property Role() As AccessibleRole
Get
Return System.Windows.Forms.AccessibleRole.Chart
End Get
End Property
' Get the state for the Chart. This is used by accessibility programs.
Public Overrides ReadOnly Property State() As AccessibleStates
Get
Return AccessibleStates.ReadOnly
End Get
End Property
' The CurveLegend objects are "child" controls in terms of accessibility so
' return the number of ChartLengend objects.
Public Overrides Function GetChildCount() As Integer
Return chartControl.Legends.Length
End Function
' Get the Accessibility object of the child CurveLegend idetified by index.
Public Overrides Function GetChild(index As Integer) As AccessibleObject
If index >= 0 And index < chartControl.Legends.Length Then
Return chartControl.Legends(index).AccessibilityObject
End If
Return Nothing
End Function
' Helper function that is used by the CurveLegend's accessibility object
' to navigate between sibiling controls. Specifically, this function is used in
' the CurveLegend.CurveLegendAccessibleObject.Navigate function.
Friend Function NavigateFromChild(child As CurveLegend.CurveLegendAccessibleObject, _
navdir As AccessibleNavigation) As AccessibleObject
Select Case navdir
Case AccessibleNavigation.Down, AccessibleNavigation.Next
Return GetChild(child.ID + 1)
Case AccessibleNavigation.Up, AccessibleNavigation.Previous
Return GetChild(child.ID - 1)
End Select
Return Nothing
End Function
' Helper function that is used by the CurveLegend's accessibility object
' to select a specific CurveLegend control. Specifically, this function is used
' in the CurveLegend.CurveLegendAccessibleObject.Select function.
Friend Sub SelectChild(child As CurveLegend.CurveLegendAccessibleObject, selection As AccessibleSelection)
Dim childID As Integer = child.ID
' Determine which selection action should occur, based on the
' AccessibleSelection value.
If (selection And AccessibleSelection.TakeSelection) <> 0 Then
Dim i As Integer
For i = 0 To chartControl.Legends.Length - 1
If i = childID Then
chartControl.Legends(i).Selected = True
Else
chartControl.Legends(i).Selected = False
End If
Next i
' AccessibleSelection.AddSelection means that the CurveLegend will be selected.
If (selection And AccessibleSelection.AddSelection) <> 0 Then
chartControl.Legends(childID).Selected = True
End If
' AccessibleSelection.AddSelection means that the CurveLegend will be unselected.
If (selection And AccessibleSelection.RemoveSelection) <> 0 Then
chartControl.Legends(childID).Selected = False
End If
End If
End Sub
End Class
Remarques
Le rôle de l’objet décrit la fonction de l’objet et est utilisé par les applications d’accessibilité.
Cette énumération est utilisée par AccessibleObject et Control.AccessibleRole
Pour plus d’informations sur l’application d’accessibilité, recherchez « Microsoft Active Accessibility » dans la bibliothèque Microsoft Developer Network (MSDN).