AccessibleRole Énumération

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

AccessibleRoles.cs

Spécifie des valeurs représentant des rôles possibles pour un objet accessible.

public enum class AccessibleRole

public enum AccessibleRole

type AccessibleRole = 

Public Enum AccessibleRole

Héritage

Object

ValueType

Enum

AccessibleRole

Champs

Nom	Valeur	Description
Default	-1	Rôle fourni par le système.
None	0	Aucun rôle.
TitleBar	1	Barre de titre ou de légende d’une fenêtre.
MenuBar	2	Une barre de menus, généralement sous la barre de titre d’une fenêtre, à partir de laquelle les utilisateurs peuvent sélectionner des menus.
ScrollBar	3	Barre de défilement verticale ou horizontale, qui peut faire partie de la zone cliente ou utilisée dans un contrôle.
Grip	4	Pointeur de souris spécial, qui permet à un 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.
Sound	5	Un son système, associé à différents événements système.
Cursor	6	Pointeur de souris.
Caret	7	Point d’insertion, qui est une ligne clignotante, un bloc ou une bitmap qui marque l’emplacement du point d’insertion dans la zone cliente d’une fenêtre.
Alert	8	Alerte ou condition dont vous pouvez informer un utilisateur. Utilisez ce rôle 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 zone de message, un graphique, un texte ou un son.
Window	9	Cadre de fenêtre, qui contient généralement des objets enfants tels qu’une barre de titre, un client et d’autres objets généralement contenus dans une fenêtre.
Client	10	Zone utilisateur d’une fenêtre.
MenuPopup	11	Menu qui présente une liste d’options à partir de laquelle l’utilisateur peut effectuer une sélection pour effectuer une action. Tous les types de menus doivent avoir ce rôle, y compris les menus déroulants affichés par sélection à partir d’une barre de menus et les menus contextuels affichés lorsque le bouton droit de la souris est cliqué.
MenuItem	12	Élément de menu, qui est une entrée dans un menu qu’un utilisateur peut choisir d’exécuter une commande, de sélectionner une option ou d’afficher un autre menu. Fonctionnellement, un élément de menu peut être équivalent à un bouton push, une case d’option, une case à cocher ou un menu.
ToolTip	13	Une info-bulle, qui est une petite fenêtre contextuelle rectangulaire qui affiche une brève description de l’objectif d’un bouton.
Application	14	Fenêtre principale d’une application.
Document	15	Fenêtre de document, qui est toujours contenue dans une fenêtre d’application. Ce rôle s’applique uniquement aux fenêtres d’interface multidocument (MDI) et fait référence à un objet qui contient la barre de titre MDI.
Pane	16	Zone distincte d’un cadre, d’une fenêtre de document fractionnée ou d’une zone rectangulaire de la barre d’état qui peut être utilisée pour afficher des informations. Les utilisateurs peuvent naviguer entre les volets et dans le contenu du volet actif, mais ne peuvent pas naviguer entre les éléments dans différents volets. Par conséquent, les volets représentent un niveau de regroupement inférieur aux fenêtres ou documents frame, mais au-dessus des contrôles individuels. En règle générale, l’utilisateur navigue entre les volets en appuyant sur Tab, F6 ou Ctrl+Tab, en fonction du contexte.
Chart	17	Image graphique utilisée pour représenter des données.
Dialog	18	Boîte de dialogue ou boîte de message.
Border	19	Bordure d’une fenêtre. La bordure entière est représentée par un objet unique, plutôt que par des objets distincts pour chaque côté.
Grouping	20	Objets regroupés de manière logique. Il peut y avoir une relation parent-enfant entre l’objet de regroupement et les objets qu’il contient.
Separator	21	Espace divisé visuellement en deux régions, comme un élément de menu séparateur ou un séparateur divisant les volets fractionnés dans une fenêtre.
ToolBar	22	Barre d’outils, qui est un regroupement de contrôles qui fournissent un accès facile aux fonctionnalités fréquemment utilisées.
StatusBar	23	Barre d’état, qui est généralement située en bas d’une fenêtre d’application qui affiche des informations sur l’opération actuelle, l’état de l’application ou l’objet sélectionné. La barre d’état peut avoir plusieurs champs qui affichent différents types d’informations, comme une explication 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.
ColumnHeader	25	En-tête de colonne, qui fournit une étiquette visuelle pour une colonne d’une table.
RowHeader	26	En-tête de ligne, qui fournit une étiquette visuelle pour une ligne de table.
Column	27	Colonne de cellules dans un tableau.
Row	28	Ligne de cellules dans un tableau.
Cell	29	Cellule d’un tableau.
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 agit comme un bouton.
HelpBalloon	31	Affichage d’aide sous la forme d’une info-bulle ou d’une bulle d’aide, qui contient des boutons et des étiquettes que les utilisateurs peuvent cliquer pour ouvrir des rubriques d’aide personnalisées.
Character	32	Objet graphique de type dessin animé, tel que l’Assistant Microsoft Office, qui est généralement affiché pour fournir de l’aide aux utilisateurs d’une application.
List	33	Zone de liste, qui permet à l’utilisateur de sélectionner un ou plusieurs éléments.
ListItem	34	Élément d’une zone de liste ou de 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.
Outline	35	Structure hiérarchique ou arborescence, telle qu’un contrôle d’arborescence, qui affiche une liste hiérarchique et permet généralement à l’utilisateur de développer et de réduire les branches.
OutlineItem	36	Élément d’un plan ou d’une structure d’arborescence.
PageTab	37	Page de propriétés qui permet à un utilisateur d’afficher les attributs d’une page, comme le titre de la page, qu’il s’agisse d’une page d’accueil ou si la page 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.
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, comme un fichier ou une ressource. L’apparence d’une page de propriétés diffère selon son objectif.
Indicator	39	Indicateur, tel qu’un graphique de pointeur, qui pointe vers l’élément actif.
Graphic	40	Une image.
StaticText	41	Texte en lecture seule, tel que dans une étiquette, pour d’autres contrôles ou instructions dans une boîte de dialogue. Le texte statique ne peut pas être modifié ou sélectionné.
Text	42	Texte sélectionnable pouvant être modifiable ou en lecture seule.
PushButton	43	Un contrôle de bouton push, qui est un petit contrôle rectangulaire qu’un utilisateur peut activer ou désactiver. Un bouton push, également appelé bouton de commande, a une apparence levée dans son état désactivé par défaut et une apparence enfoncée lorsqu’elle est activée.
CheckButton	44	Contrôle de case à cocher, qui est une option qui peut être activée ou désactivée indépendamment d’autres options.
RadioButton	45	Un bouton d’option, également appelé case d’option. Tous les objets partageant un seul parent qui ont cet attribut sont supposés faire partie d’un groupe mutuellement exclusif. Vous pouvez utiliser des objets groupés pour diviser les boutons d’option en groupes distincts si nécessaire.
ComboBox	46	Zone de liste modifiable, qui est un contrôle d’édition avec une zone de liste associée qui fournit un ensemble de choix prédéfinis.
DropList	47	Zone de liste déroulante. Ce contrôle affiche un élément et permet à l’utilisateur d’afficher et de sélectionner un autre dans une liste de choix alternatifs.
ProgressBar	48	Barre de progression, qui indique la progression d’une longue opération en affichant des lignes colorées à l’intérieur d’un rectangle horizontal. La longueur des lignes par rapport à la longueur du rectangle correspond au pourcentage de l’opération terminée. Ce contrôle ne prend pas d’entrée utilisateur.
Dial	49	Un cadran ou un bouton. Il peut également s’agir d’un objet en lecture seule, comme un compteur de vitesse.
HotkeyField	50	Champ à clé chaude qui permet à l’utilisateur d’entrer une combinaison ou une séquence de séquences de frappes à utiliser comme clé chaude, ce qui permet aux utilisateurs d’effectuer une action rapidement. Un contrôle à touches chaudes affiche les séquences de touches entrées par l’utilisateur et garantit que l’utilisateur sélectionne une combinaison de touches valide.
Slider	51	Un contrôle, parfois appelé barre de suivi, qui permet à un utilisateur d’ajuster un paramètre dans des incréments donnés entre les 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 de curseur.
SpinButton	52	Une zone de rotation, également appelée contrôle haut vers le bas, qui contient une paire de boutons de flèche. Un utilisateur clique sur les boutons de flèche avec une souris pour incrémenter ou décrémenter une valeur. Un contrôle de bouton de rotation est le plus souvent utilisé avec un contrôle complémentaire, appelé fenêtre de pote, où la valeur actuelle est affichée.
Diagram	53	Image graphique utilisée pour diagrammer les données.
Animation	54	Contrôle d’animation, qui contient du contenu qui change au fil du temps, tel qu’un contrôle qui affiche une série de trames bitmap, comme un filmtrip. Les contrôles d’animation s’affichent généralement lorsque des fichiers sont copiés ou lorsque d’autres tâches fastidieuses sont effectuées.
Equation	55	Équation mathématique.
ButtonDropDown	56	Bouton qui supprime une liste d’éléments.
ButtonMenu	57	Bouton qui supprime un menu.
ButtonDropDownGrid	58	Bouton qui descend d’une grille.
WhiteSpace	59	Espace vide entre d’autres objets.
PageTabList	60	Conteneur de contrôles d’onglet de page.
Clock	61	Contrôle qui affiche l’heure.
SplitButton	62	Bouton de barre d’outils qui a une icône de liste déroulante directement adjacente au bouton.
IpAddress	63	Contrôle conçu pour entrer des adresses IP (Internet Protocol).
OutlineButton	64	Contrôle qui navigue comme un élément de plan.

Exemples

L’exemple de code suivant illustre la création d’un contrôle de graphique prenant en compte l’accessibilité, à l’aide des classes et Control.ControlAccessibleObject des 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 -based réel Control , mais qu’elle est dessinée par le contrôle de graphique, elle n’a pas d’informations accessibles intégrées. En raison de cela, la ChartControlAccessibleObject classe remplace la GetChild méthode pour retourner les CurveLegendAccessibleObject informations accessibles pour chaque partie de la légende. Lorsqu’une application prenant en charge l’accessibilité 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 AccessibleObject classe pour obtenir l’exemple 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).

Voir aussi

• AccessibleEvents
• AccessibleNavigation
• AccessibleObject
• AccessibleSelection
• AccessibleStates
• AccessibleRole