AccessibleRole Enumeration

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Gibt Werte an, die mögliche Rollen für ein barrierefreies Objekt darstellen.

public enum class AccessibleRole
public enum AccessibleRole
type AccessibleRole = 
Public Enum AccessibleRole
Vererbung
Object
ValueType
Enum
AccessibleRole

Felder

Alert 8

Eine Warnung oder Bedingung, die Sie einem Benutzer mitteilen können. Verwenden Sie diese Rolle nur für Objekte, die eine Warnung darstellen, jedoch nicht einem anderen Benutzeroberflächenelement zugeordnet sind, wie etwa für ein Meldungsfeld, eine Grafik, Text oder Sound.
Animation 54

Ein Animationssteuerelement mit veränderlichem Inhalt, z. B. ein Steuerelement, in dem eine Reihe von Bitmapbildern wie eine Filmsequenz angezeigt wird. Animationsteuerelemente werden gewöhnlich beim Kopieren von Dateien oder beim Ausführen anderer zeitintensiver Aufgaben angezeigt.
Application 14

Das Hauptfenster für eine Anwendung.
Border 19

Ein Fensterrahmen. Der gesamte Rahmen wird von einem einzelnen Objekt dargestellt, nicht von separaten Objekten für die einzelnen Seiten.
ButtonDropDown 56

Eine Schaltfläche, die eine Liste von Elementen als Dropdown öffnet.
ButtonDropDownGrid 58

Eine Schaltfläche, die ein Raster als Dropdown öffnet.
ButtonMenu 57

Eine Schaltfläche, die ein Menü als Dropdown öffnet.
Caret 7

Eine Einfügemarke, die durch eine blinkende Linie, Fläche oder Bitmap dargestellt wird und die Position der Einfügemarke im Clientbereich eines Fensters markiert.
Cell 29

Eine Zelle in einer Tabelle.
Character 32

Ein cartoonartiges grafisches Objekt, wie ein Microsoft Office-Assistent, das i. d. R. angezeigt wird, um Benutzern einer Anwendung Hilfe bereitzustellen.
Chart 17

Ein Bild, das zur grafischen Darstellung von Daten verwendet wird.
CheckButton 44

Ein Kontrollkästchen-Steuerelement, das eine Option darstellt, die unabhängig von anderen Optionen aktiviert und deaktiviert werden kann.
Client 10

Der Benutzerbereich eines Fensters.
Clock 61

Ein Steuerelement, das die Uhrzeit anzeigt.
Column 27

Eine Spalte von Zellen in einer Tabelle.
ColumnHeader 25

Ein Spaltenkopf, der eine sichtbare Bezeichnung für eine Spalte in einer Tabelle enthält.
ComboBox 46

Ein Kombinationsfeld, das ein Bearbeitungssteuerelement mit einem zugeordneten Listenfeld darstellt und eine Reihe vordefinierter Optionen bereitstellt.
Cursor 6

Ein Mauszeiger.
Default -1

Eine vom System bereitgestellte Rolle.
Diagram 53

Ein Bild, das zur Darstellung von Daten als Diagramm verwendet wird.
Dial 49

Eine Skala oder ein Knopf. Dies kann auch ein schreibgeschütztes Objekt sein, z. B. ein Geschwindigkeitsmesser.
Dialog 18

Ein Dialogfeld oder ein Meldungsfeld.
Document 15

Ein Dokumentfenster, das sich immer in einem Anwendungsfenster befindet. Diese Rolle wirkt sich nur auf MDI-Fenster (Multiple-Document Interface) aus und verweist auf ein Objekt, das die MDI-Titelleiste enthält.
DropList 47

Ein Dropdown-Listenfeld. In diesem Steuerelement wird ein Element angezeigt, wobei der Benutzer ein weiteres anzeigen lassen und dieses aus eine Liste auswählen kann.
Equation 55

Eine mathematische Gleichung.
Graphic 40

Ein Bild.
Grip 4

Ein spezieller Mauszeiger, der es Benutzern ermöglicht, Elemente der Benutzeroberfläche, z. B. ein Fenster, zu verändern. Der Benutzer kann z. B. auf einen Größenziehpunkt in der rechten unteren Ecke eines Fensters klicken und diesen ziehen, um die Größe des Fensters zu ändern.
Grouping 20

Die auf logische Weise geordneten Objekte. Zwischen dem Gruppierungsobjekt und dem enthaltenen Objekt kann eine Parent-Child Beziehung bestehen.
HelpBalloon 31

Eine Hilfeanzeige in Form einer QuickInfo oder Hilfe-Sprechblase, die Schaltflächen und Bezeichnungen enthält, auf die Benutzer zum Öffnen benutzerdefinierter Hilfethemen klicken können.
HotkeyField 50

Ein Zugriffstastenfeld, das es Benutzern ermöglicht, eine Kombination oder Folge von Tasten zu drücken, die als Zugriffstaste verwendet wird und über die eine Aktion schnell ausgeführt werden kann. Im Zugriffstastensteuerelement wird die Tastatureingabe des Benutzers angezeigt und sichergestellt, dass eine gültige Tastenkombination gewählt wurde.
Indicator 39

Ein Indikator, z. B. eine Zeigergrafik, die auf das aktuelle Element zeigt.
IpAddress 63

Ein Steuerelement, das zum Eingeben von IP-Adressen (Internetprotokolladressen) vorgesehen ist.
30

Ein Link, der eine Verbindung zwischen einem Quelldokument und einem Zieldokument darstellt. Dieses Objekt kann wie ein Text oder eine Grafik aussehen, funktioniert jedoch wie eine Schaltfläche.
List 33

Ein Listenfeld, das dem Benutzer die Auswahl eines oder mehrerer Elemente ermöglicht.
ListItem 34

Ein Element in einem Listenfeld oder der Listenteil eines Kombinationsfelds, Dropdown-Listenfelds oder eines Dropdown-Kombinationsfelds.
MenuBar 2

Eine Menüleiste, meist unterhalb der Titelleiste eines Fensters, aus dem Benutzer Menüs auswählen können.
MenuItem 12

Ein Menüelement, das ein Eintrag in einem Menü ist und mit dessen Hilfe Benutzer einen Befehl ausführen, eine Option auswählen oder ein weiteres Menü anzeigen lassen können. Die Funktion eines Menüelements kann der einer Schaltfläche, eines Optionsfelds, eines Kontrollkästchens oder eines Menüs entsprechen.
MenuPopup 11

Ein Menü, das eine Liste von Optionen enthält, aus der der Benutzer eine Auswahl treffen kann, um eine Aktion auszuführen. Sämtliche Menütypen müssen über diese Rolle verfügen. Dies gilt auch für Dropdownmenüs, die bei Auswahl in einer Menüleiste angezeigt werden, und für Kontextmenüs, die beim Klicken mit der rechten Maustaste angezeigt werden.
None 0

Keine Rolle.
Outline 35

Eine Gliederung oder Struktur, z. B. ein Strukturansicht-Steuerelement, in dem eine hierarchische Liste angezeigt wird und in dem Benutzer üblicherweise Verzweigungen erweitern und reduzieren können.
OutlineButton 64

Ein Steuerelement, in dem wie in einem Gliederungselement navigiert werden kann.
OutlineItem 36

Ein Element in einer Gliederung oder einer Struktur.
PageTab 37

Eine Eigenschaftenseite, die es dem Benutzer ermöglicht, die Attribute für eine Seite anzuzeigen, z. B. den Titel der Seite, oder Angaben, ob es sich um eine Startseite handelt oder ob die Seite geändert wurde. Normalerweise verfügt dieses Steuerelement über ein einziges untergeordnetes Element, ein gruppiertes Objekt mit dem Inhalt der zugeordneten Seite.
PageTabList 60

Ein Container mit Registersteuerelementen.
Pane 16

Ein getrennter Bereich in einem Rahmen, ein geteiltes Dokumentfenster oder ein rechteckiger Bereich der Statusleiste für die Anzeige von Informationen. Benutzer können zwischen Bereichen und innerhalb des Inhalts des aktuellen Bereichs navigieren, jedoch nicht zwischen Elementen in unterschiedlichen Bereichen. Daher stellen Bereiche eine Gruppierungsebene dar, die sich unterhalb von Fenstern oder Dokumenten, jedoch oberhalb einzelner Steuerelemente befindet. Je nach Kontext können Benutzer i. d. R. mit TAB, F6 oder STRG+TAB zwischen Bereichen navigieren.
ProgressBar 48

Eine Statusanzeige, die den Fortschritt einer zeitintensiven Operation durch Anzeige farbiger Linien in einem horizontalen Rechteck angibt. Die Länge der Linien im Verhältnis zur Länge des Rechtecks entspricht dem bereits ausgeführten Prozentsatz der Operation. In diesem Steuerelement können keine Benutzereingaben vorgenommen werden.
PropertyPage 38

Eine Eigenschaftenseite, die ein Dialogfeld darstellt, mit dem die Darstellung und das Verhalten eines Objekts, z. B. einer Datei oder einer Ressource, gesteuert werden. Die Darstellung einer Eigenschaftenseite ist von ihrer jeweiligen Verwendung abhängig.
PushButton 43

Ein Schaltflächen-Steuerelement, das ein kleines, rechteckiges Steuerelement darstellt, das vom Benutzer aktiviert oder deaktiviert werden kann. Eine Schaltfläche, auch als Befehlsschaltfläche bezeichnet, wird im deaktivierten Zustand (Standard) angehoben und im aktivierten Zustand abgesenkt dargestellt.
RadioButton 45

Ein Optionsfeld. Sämtliche Objekte, die einem einzigen übergeordneten Objekt untergeordnet sind und über dieses Attribut verfügen, werden als Teil einer Gruppe sich gegenseitig ausschließender Optionen behandelt. Sie können gruppierte Objekte verwenden, um Optionsfelder bei Bedarf in getrennte Gruppen zu teilen.
Row 28

Eine Zeile von Zellen in einer Tabelle.
RowHeader 26

Ein Zeilenkopf, der eine sichtbare Bezeichnung für eine Tabellenzeile enthält.
ScrollBar 3

Eine vertikale oder horizontale Schiebeleiste, die Teil eines Clientbereichs sein oder in einem Steuerelement verwendet werden kann.
Separator 21

Eine Trennung in zwei Bereiche, z. B. mithilfe eines Trennelements in einem Menü oder mit einem Trennzeichen, das Bereiche in einem Fenster trennt.
Slider 51

Ein Steuerelement, manchmal als Trackleiste bezeichnet, das das Anpassen einer Einstellung in angegebenen inkrementellen Werten zwischen einem minimalen und einem maximalen Wert durch Bewegen eines Schiebereglers ermöglicht. Unter dem Betriebssystem Windows werden Schieberegler-Steuerelemente zum Einstellen der Lautstärke verwendet.
Sound 5

Ein Systemsound, der verschiedenen Systemereignissen zugeordnet ist.
SpinButton 52

Ein Drehfeld, auch als Auf-Ab-Steuerelement bezeichnet, das ein Paar von Pfeilschaltflächen enthält. Durch Klicken mit der Maus auf die Pfeilschaltflächen wird ein Wert inkrementiert oder dekrementiert. Ein Drehfeld-Steuerelement wird meist mit einem begleitenden, als Buddy-Fenster bezeichneten Steuerelement verwendet, in dem der aktuelle Wert angezeigt wird.
SplitButton 62

Eine Symbolleisten-Schaltfläche, bei der direkt neben der Schaltfläche ein Dropdownlistensymbol angezeigt wird.
StaticText 41

Der schreibgeschützte Text, z. B. in einer Bezeichnung, für andere Steuerelemente oder Anweisungen in einem Dialogfeld. Statischer Text kann nicht geändert oder ausgewählt werden.
StatusBar 23

Eine Statusleiste, die einen Bereich darstellt, der sich i. d. R. am unteren Rand eines Anwendungsfensters befindet und Informationen über die aktuelle Operation sowie den Zustand der Anwendung oder des ausgewählten Objekts enthält. Die Statusleiste kann mehrere Felder enthalten, in denen verschiedene Arten von Informationen angezeigt werden, z. B. eine Erklärung des derzeit auf der Statusleiste ausgewählten Menübefehls.
Table 24

Eine Tabelle, die Zeilen und Spalten von Zellen sowie optional Zeilen- und Spaltenköpfe enthält.
Text 42

Der auswählbare Text, der bearbeitet werden oder schreibgeschützt sein kann.
TitleBar 1

Eine Titelleiste für ein Fenster.
ToolBar 22

Eine Symbolleiste, die eine Gruppierung von Steuerelementen für den einfachen Zugriff auf häufig verwendete Features darstellt.
ToolTip 13

Eine QuickInfo, die aus einem kleinen rechteckigen Popupfenster besteht, in dem eine Kurzbeschreibung des Zweckes einer Schaltfläche angezeigt wird.
WhiteSpace 59

Ein Leerraum zwischen anderen Objekten.
Window 9

Ein Fensterrahmen, der i. d. R. untergeordnete Objekte wie eine Titelleiste, Client- und andere Objekte enthält, die normalerweise in einem Fenster enthalten sind.

Beispiele

Im folgenden Codebeispiel wird die Erstellung eines barrierefreiheitsfähigen Diagrammsteuerelements veranschaulicht, das die AccessibleObject Klassen und Control.ControlAccessibleObject verwendet, um barrierefreie Informationen verfügbar zu machen. Das Steuerelement zeichnet zwei Kurven zusammen mit einer Legende. Die ChartControlAccessibleObject -Klasse, die von ControlAccessibleObjectabgeleitet wird, wird in der CreateAccessibilityInstance -Methode verwendet, um benutzerdefinierte, zugängliche Informationen für das Diagrammsteuerelement bereitzustellen. Da die Diagrammlegende kein tatsächlich Control basiertes Steuerelement ist, sondern vom Diagrammsteuerelement gezeichnet wird, enthält sie keine integrierten, zugänglichen Informationen. Aus diesem Grund überschreibt die ChartControlAccessibleObject -Klasse die -Methode, um die GetChild zurückzugeben, die CurveLegendAccessibleObject zugängliche Informationen für jeden Teil der Legende darstellt. Wenn eine barrierefreie Anwendung dieses Steuerelement verwendet, kann das Steuerelement die erforderlichen barrierefreien Informationen bereitstellen.

In diesem Beispiel wird die Verwendung der AccessibleRole -Enumeration mit der Role -Eigenschaft veranschaulicht. Das vollständige Codebeispiel finden Sie in der AccessibleObject Klassenübersicht.

// 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

Hinweise

Die Rolle des Objekts beschreibt die Funktion des Objekts und wird von Barrierefreiheitsanwendungen verwendet.

Diese Enumeration wird von AccessibleObject und verwendet. Control.AccessibleRole

Weitere Informationen zur Barrierefreiheitsanwendung finden Sie, wenn Sie in der MSDN-Bibliothek (Microsoft Developer Network) nach "Microsoft Active Accessibility" suchen.

Gilt für:

Weitere Informationen