Cette documentation est archivée et n’est pas conservée.

AccessibleRole, énumération

Mise à jour : novembre 2007

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

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public enum AccessibleRole
public enum AccessibleRole
public enum AccessibleRole

Nom de membreDescription
DefaultRôle fourni par le système.
NoneAucun rôle.
TitleBarBarre de titre ou légende d'une fenêtre.
MenuBarBarre 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.
ScrollBarBarre de défilement verticale ou horizontale, qui peut faire partie de la zone cliente ou être utilisée dans un contrôle.
GripPointeur 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.
SoundSon système, qui est associé à différents événements système.
CursorPointeur de souris.
CaretSigne 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.
AlertAlerte 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'un message, un graphique, du texte ou du son.
WindowFrame 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.
ClientZone utilisateur d'une fenêtre.
MenuPopupMenu, 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.
MenuItemÉ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.
ToolTipInfo-bulle, qui est une petite fenêtre indépendante, affichant une brève description de la fonction d'un bouton.
ApplicationFenêtre principale d'une application.
DocumentFenê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.
PaneZone 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.
ChartImage graphique utilisée pour représenter des données.
DialogBoîte de dialogue ou message.
BorderBordure 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é.
GroupingObjets 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.
SeparatorEspace 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.
ToolBarBarre d'outils, qui est un regroupement de contrôles qui permettent d'accéder aisément à des fonctionnalités fréquemment utilisées.
StatusBarBarre 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.
TableTableau contenant des lignes et des colonnes de cellules et, éventuellement, des en-têtes de ligne et des en-têtes de colonne.
ColumnHeaderEn-tête de colonne, qui affiche une étiquette visuelle pour une colonne dans un tableau.
RowHeaderEn-tête de ligne, qui affiche une étiquette visuelle pour une ligne de tableau.
ColumnColonne de cellules dans un tableau.
RowLigne de cellules dans un tableau.
CellCellule dans un tableau.
LinkLien, 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.
HelpBalloonAide 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.
CharacterUn 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.
ListZone de liste, qui permet à l'utilisateur de sélectionner un ou plusieurs éléments.
ListItemÉ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.
OutlineStructure 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.
OutlineItemÉlément dans une structure ou une arborescence.
PageTabPage 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.
PropertyPagePage 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.
IndicatorIndicateur, tel qu'un pointeur graphique, qui pointe sur l'élément actif.
GraphicImage.
StaticTextTexte 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é.
TextTexte sélectionnable qui peut être modifiable ou en lecture seule.
PushButtonContrô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é.
CheckButtonContrôle Check Box, qui est une option qui peut être activée ou désactivée indépendamment des autres options.
RadioButtonBouton 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.
ComboBoxZone 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.
DropListZone 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.
ProgressBarBarre 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.
DialCadran ou bouton. Il peut également être en lecture seule, comme un compteur de vitesse, par exemple.
HotkeyFieldChamp 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.
SliderContrô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.
SpinButtonZone 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.
DiagramImage graphique utilisée pour représenter des données.
AnimationContrô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.
EquationÉquation mathématique.
ButtonDropDownBouton déroulant une liste d'éléments.
ButtonMenuBouton déroulant un menu.
ButtonDropDownGridBouton déroulant une grille.
WhiteSpaceEspace vide entre d'autres objets.
PageTabListConteneur des contrôles onglet d'une page.
ClockContrôle affichant l'heure.
SplitButtonBouton de barre d'outils à côté duquel apparaît une icône de liste déroulante.
IpAddressContrôle conçu pour entrer des adresses IP.
OutlineButtonContrôle qui navigue comme un élément de contour.

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 la rubrique « Microsoft Active Accessibility » dans MSDN Library (Microsoft Developer Network).

L'exemple de code suivant illustre la création d'un contrôle graphique prenant en charge l'accessibilité, en utilisant les classes AccessibleObject et Control.ControlAccessibleObject pour exposer des informations accessibles. Le contrôle trace deux courbes en plus d'une légende. La classe ChartControlAccessibleObject, qui dérive de ControlAccessibleObject, est utilisée dans la méthode CreateAccessibilityInstance pour fournir des informations accessibles personnalisées au contrôle graphique. Dans la mesure où la légende du graphique n'est pas un contrôle réel basé sur Control, et qu'elle est plutôt dessinée par le contrôle graphique, elle ne contient pas d'informations accessibles intégrées. De ce fait, la classe ChartControlAccessibleObject substitue la méthode GetChild pour retourner CurveLegendAccessibleObject, qui représente les informations accessibles pour chaque partie de la légende. Lorsqu'une application de type accessible utilise ce contrôle, le contrôle peut fournir les informations accessibles nécessaires.

Cet exemple illustre l'utilisation de l'énumération AccessibleRole avec la propriété Role. Consultez la vue d'ensemble de la classe AccessibleObject pour obtenir un exemple de code complet.

// 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 static class ChartControlAccessibleObject 
    extends ControlAccessibleObject
{
    private ChartControl chartControl;

    public ChartControlAccessibleObject(ChartControl ctrl)
    {
        super(ctrl);
        chartControl = ctrl;
    } //ChartControlAccessibleObject

    // Gets the role for the Chart. This is used by accessibility programs.
    /** @property 
     */
    public AccessibleRole get_Role()
    {
        return AccessibleRole.Chart;
    } //get_Role

    // Gets the state for the Chart. This is used by accessibility programs.
    /** @property 
     */
    public AccessibleStates get_State()
    {
        return AccessibleStates.ReadOnly;
    } //get_State

    // The CurveLegend objects are "child" controls in terms of  
    // accessibility so return the number of ChartLengend objects.
    public int GetChildCount()
    {
        return chartControl.get_Legends().get_Length();
    } //GetChildCount

    // Gets the Accessibility object of the child CurveLegend 
    // idetified by index.
    public AccessibleObject GetChild(int index)
    {
        if (index >= 0 && index < chartControl.get_Legends().get_Length()) {
            return chartControl.get_Legends()[index].
                get_AccessibilityObject();
        }
        return null;
    } //GetChild

    // 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)
    {
        if (navDir.Equals(AccessibleNavigation.Down) 
            || navDir.Equals(AccessibleNavigation.Next)) {
            return GetChild(child.get_ID() + 1);
        }
        else {
            if (navDir.Equals(AccessibleNavigation.Up) 
                || navDir.Equals(AccessibleNavigation.Previous)) {
                return GetChild(child.get_ID() - 1);
            }
        }
        return null;
    } //NavigateFromChild

    // 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.
    public void SelectChild(CurveLegend.CurveLegendAccessibleObject child, 
        AccessibleSelection selection)
    {
        int childID = child.get_ID();

        // Determine which selection action should occur, based on the
        // AccessibleSelection value.
        if (Convert.ToInt32(selection & AccessibleSelection.TakeSelection)
            != 0) {
            for (int i = 0; i < chartControl.get_Legends().get_Length(); 
                i++) {
                if (i == childID) {
                    ((CurveLegend)chartControl.get_Legends().get_Item(i)).
                        set_Selected(true);
                }
                else {
                    ((CurveLegend)chartControl.get_Legends().get_Item(i)).
                        set_Selected(false);
                }
            }

            // AccessibleSelection.AddSelection means that the CurveLegend 
            // will be selected.
            if (Convert.ToInt32(selection & AccessibleSelection.AddSelection)
                != 0) {
                ((CurveLegend)chartControl.get_Legends().get_Item(childID)).
                    set_Selected(true);
            }

            // AccessibleSelection.AddSelection means that the CurveLegend 
            // will be unselected.
            if (Convert.ToInt32(selection & 
                AccessibleSelection.RemoveSelection) != 0) {
                ((CurveLegend)chartControl.get_Legends().get_Item(childID)).
                    set_Selected(false);
            }
        }
    } //SelectChild
} //ChartControlAccessibleObject


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: