AccessibleRole Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt Werte an, die mögliche Rollen für ein barrierefreies Objekt darstellen.
public enum class AccessibleRolepublic enum AccessibleRoletype AccessibleRole = Public Enum AccessibleRole- Vererbung
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. |
| Link | 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.
