AccessibleRole AccessibleRole AccessibleRole AccessibleRole Enum

Definition

Gibt Werte an, die mögliche Rollen für ein barrierefreies Objekt darstellen.Specifies values representing possible roles for an accessible object.

public enum class AccessibleRole
public enum AccessibleRole
type AccessibleRole = 
Public Enum AccessibleRole
Vererbung
AccessibleRoleAccessibleRoleAccessibleRoleAccessibleRole

Felder

Alert Alert Alert Alert 8

Eine Warnung oder Bedingung, die Sie einem Benutzer mitteilen können.An alert or condition that you can notify a user about. 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.Use this role only for objects that embody an alert but are not associated with another user interface element, such as a message box, graphic, text, or sound.

Animation Animation Animation Animation 54

Ein Animationssteuerelement mit veränderlichem Inhalt, z. B. ein Steuerelement, in dem eine Reihe von Bitmapbildern wie eine Filmsequenz angezeigt wird.An animation control, which contains content that is changing over time, such as a control that displays a series of bitmap frames, like a filmstrip. Animationsteuerelemente werden gewöhnlich beim Kopieren von Dateien oder beim Ausführen anderer zeitintensiver Aufgaben angezeigt.Animation controls are usually displayed when files are being copied, or when some other time-consuming task is being performed.

Application Application Application Application 14

Das Hauptfenster für eine Anwendung.The main window for an application.

Border Border Border Border 19

Ein Fensterrahmen.A window border. Der gesamte Rahmen wird von einem einzelnen Objekt dargestellt, nicht von separaten Objekten für die einzelnen Seiten.The entire border is represented by a single object, rather than by separate objects for each side.

ButtonDropDown ButtonDropDown ButtonDropDown ButtonDropDown 56

Eine Schaltfläche, die eine Liste von Elementen als Dropdown öffnet.A button that drops down a list of items.

ButtonDropDownGrid ButtonDropDownGrid ButtonDropDownGrid ButtonDropDownGrid 58

Eine Schaltfläche, die ein Raster als Dropdown öffnet.A button that drops down a grid.

ButtonMenu ButtonMenu ButtonMenu ButtonMenu 57

Eine Schaltfläche, die ein Menü als Dropdown öffnet.A button that drops down a menu.

Caret Caret Caret 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.A caret, which is a flashing line, block, or bitmap that marks the location of the insertion point in a window's client area.

Cell Cell Cell Cell 29

Eine Zelle in einer Tabelle.A cell within a table.

Character Character Character Character 32

Ein cartoonartiges grafisches Objekt, wie ein Microsoft Office-Assistent, das i. d. R. angezeigt wird, um Benutzern einer Anwendung Hilfe bereitzustellen.A cartoon-like graphic object, such as Microsoft Office Assistant, which is typically displayed to provide help to users of an application.

Chart Chart Chart Chart 17

Ein Bild, das zur grafischen Darstellung von Daten verwendet wird.A graphical image used to represent data.

CheckButton CheckButton CheckButton CheckButton 44

Ein Kontrollkästchen-Steuerelement, das eine Option darstellt, die unabhängig von anderen Optionen aktiviert und deaktiviert werden kann.A check box control, which is an option that can be turned on or off independent of other options.

Client Client Client Client 10

Der Benutzerbereich eines Fensters.A window's user area.

Clock Clock Clock Clock 61

Ein Steuerelement, das die Uhrzeit anzeigt.A control that displays the time.

Column Column Column Column 27

Eine Spalte von Zellen in einer Tabelle.A column of cells within a table.

ColumnHeader ColumnHeader ColumnHeader ColumnHeader 25

Ein Spaltenkopf, der eine sichtbare Bezeichnung für eine Spalte in einer Tabelle enthält.A column header, which provides a visual label for a column in a table.

ComboBox ComboBox ComboBox ComboBox 46

Ein Kombinationsfeld, das ein Bearbeitungssteuerelement mit einem zugeordneten Listenfeld darstellt und eine Reihe vordefinierter Optionen bereitstellt.A combo box, which is an edit control with an associated list box that provides a set of predefined choices.

Cursor Cursor Cursor Cursor 6

Ein Mauszeiger.A mouse pointer.

Default Default Default Default -1

Eine vom System bereitgestellte Rolle.A system-provided role.

Diagram Diagram Diagram Diagram 53

Ein Bild, das zur Darstellung von Daten als Diagramm verwendet wird.A graphical image used to diagram data.

Dial Dial Dial Dial 49

Eine Skala oder ein Knopf.A dial or knob. Dies kann auch ein schreibgeschütztes Objekt sein, z. B. ein Geschwindigkeitsmesser.This can also be a read-only object, like a speedometer.

Dialog Dialog Dialog Dialog 18

Ein Dialogfeld oder ein Meldungsfeld.A dialog box or message box.

Document Document Document Document 15

Ein Dokumentfenster, das sich immer in einem Anwendungsfenster befindet.A document window, which is always contained within an application window. Diese Rolle wirkt sich nur auf MDI-Fenster (Multiple-Document Interface) aus und verweist auf ein Objekt, das die MDI-Titelleiste enthält.This role applies only to multiple-document interface (MDI) windows and refers to an object that contains the MDI title bar.

DropList DropList DropList DropList 47

Ein Dropdown-Listenfeld.A drop-down list box. In diesem Steuerelement wird ein Element angezeigt, wobei der Benutzer ein weiteres anzeigen lassen und dieses aus eine Liste auswählen kann.This control shows one item and allows the user to display and select another from a list of alternative choices.

Equation Equation Equation Equation 55

Eine mathematische Gleichung.A mathematical equation.

Graphic Graphic Graphic Graphic 40

Ein Bild.A picture.

Grip Grip Grip Grip 4

Ein spezieller Mauszeiger, der es Benutzern ermöglicht, Elemente der Benutzeroberfläche, z. B. ein Fenster, zu verändern.A special mouse pointer, which allows a user to manipulate user interface elements such as a window. 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.For example, a user can click and drag a sizing grip in the lower-right corner of a window to resize it.

Grouping Grouping Grouping Grouping 20

Die auf logische Weise geordneten Objekte.The objects grouped in a logical manner. Zwischen dem Gruppierungsobjekt und dem enthaltenen Objekt kann eine Parent-Child Beziehung bestehen.There can be a parent-child relationship between the grouping object and the objects it contains.

HelpBalloon HelpBalloon HelpBalloon 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.A Help display in the form of a ToolTip or Help balloon, which contains buttons and labels that users can click to open custom Help topics.

HotkeyField HotkeyField HotkeyField 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.A hot-key field that allows the user to enter a combination or sequence of keystrokes to be used as a hot key, which enables users to perform an action quickly. Im Zugriffstastensteuerelement wird die Tastatureingabe des Benutzers angezeigt und sichergestellt, dass eine gültige Tastenkombination gewählt wurde.A hot-key control displays the keystrokes entered by the user and ensures that the user selects a valid key combination.

Indicator Indicator Indicator Indicator 39

Ein Indikator, z. B. eine Zeigergrafik, die auf das aktuelle Element zeigt.An indicator, such as a pointer graphic, that points to the current item.

IpAddress IpAddress IpAddress IpAddress 63

Ein Steuerelement, das zum Eingeben von IP-Adressen (Internetprotokolladressen) vorgesehen ist.A control designed for entering Internet Protocol (IP) addresses.

30

Ein Link, der eine Verbindung zwischen einem Quelldokument und einem Zieldokument darstellt.A link, which is a connection between a source document and a destination document. Dieses Objekt kann wie ein Text oder eine Grafik aussehen, funktioniert jedoch wie eine Schaltfläche.This object might look like text or a graphic, but it acts like a button.

List List List List 33

Ein Listenfeld, das dem Benutzer die Auswahl eines oder mehrerer Elemente ermöglicht.A list box, which allows the user to select one or more items.

ListItem ListItem ListItem ListItem 34

Ein Element in einem Listenfeld oder der Listenteil eines Kombinationsfelds, Dropdown-Listenfelds oder eines Dropdown-Kombinationsfelds.An item in a list box or the list portion of a combo box, drop-down list box, or drop-down combo box.

MenuBar MenuBar MenuBar MenuBar 2

Eine Menüleiste, meist unterhalb der Titelleiste eines Fensters, aus dem Benutzer Menüs auswählen können.A menu bar, usually beneath the title bar of a window, from which users can select menus.

MenuItem MenuItem MenuItem 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.A menu item, which is an entry in a menu that a user can choose to carry out a command, select an option, or display another menu. Die Funktion eines Menüelements kann der einer Schaltfläche, eines Optionsfelds, eines Kontrollkästchens oder eines Menüs entsprechen.Functionally, a menu item can be equivalent to a push button, radio button, check box, or menu.

MenuPopup MenuPopup MenuPopup MenuPopup 11

Ein Menü, das eine Liste von Optionen enthält, aus der der Benutzer eine Auswahl treffen kann, um eine Aktion auszuführen.A menu, which presents a list of options from which the user can make a selection to perform an action. 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.All menu types must have this role, including drop-down menus that are displayed by selection from a menu bar, and shortcut menus that are displayed when the right mouse button is clicked.

None None None None 0

Keine Rolle.No role.

Outline Outline Outline 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.An outline or tree structure, such as a tree view control, which displays a hierarchical list and usually allows the user to expand and collapse branches.

OutlineButton OutlineButton OutlineButton OutlineButton 64

Ein Steuerelement, in dem wie in einem Gliederungselement navigiert werden kann.A control that navigates like an outline item.

OutlineItem OutlineItem OutlineItem OutlineItem 36

Ein Element in einer Gliederung oder einer Struktur.An item in an outline or tree structure.

PageTab PageTab PageTab 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.A property page that allows a user to view the attributes for a page, such as the page's title, whether it is a home page, or whether the page has been modified. Normalerweise verfügt dieses Steuerelement über ein einziges untergeordnetes Element, ein gruppiertes Objekt mit dem Inhalt der zugeordneten Seite.Normally, the only child of this control is a grouped object that contains the contents of the associated page.

PageTabList PageTabList PageTabList PageTabList 60

Ein Container mit Registersteuerelementen.A container of page tab controls.

Pane Pane Pane Pane 16

Ein getrennter Bereich in einem Rahmen, ein geteiltes Dokumentfenster oder ein rechteckiger Bereich der Statusleiste für die Anzeige von Informationen.A separate area in a frame, a split document window, or a rectangular area of the status bar that can be used to display information. Benutzer können zwischen Bereichen und innerhalb des Inhalts des aktuellen Bereichs navigieren, jedoch nicht zwischen Elementen in unterschiedlichen Bereichen.Users can navigate between panes and within the contents of the current pane, but cannot navigate between items in different panes. Daher stellen Bereiche eine Gruppierungsebene dar, die sich unterhalb von Fenstern oder Dokumenten, jedoch oberhalb einzelner Steuerelemente befindet.Thus, panes represent a level of grouping lower than frame windows or documents, but above individual controls. Je nach Kontext können Benutzer i. d. R. mit TAB, F6 oder STRG+TAB zwischen Bereichen navigieren.Typically, the user navigates between panes by pressing TAB, F6, or CTRL+TAB, depending on the context.

ProgressBar ProgressBar ProgressBar ProgressBar 48

Eine Statusanzeige, die den Fortschritt einer zeitintensiven Operation durch Anzeige farbiger Linien in einem horizontalen Rechteck angibt.A progress bar, which indicates the progress of a lengthy operation by displaying colored lines inside a horizontal rectangle. Die Länge der Linien im Verhältnis zur Länge des Rechtecks entspricht dem bereits ausgeführten Prozentsatz der Operation.The length of the lines in relation to the length of the rectangle corresponds to the percentage of the operation that is complete. In diesem Steuerelement können keine Benutzereingaben vorgenommen werden.This control does not take user input.

PropertyPage PropertyPage PropertyPage 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.A property page, which is a dialog box that controls the appearance and the behavior of an object, such as a file or resource. Die Darstellung einer Eigenschaftenseite ist von ihrer jeweiligen Verwendung abhängig.A property page's appearance differs according to its purpose.

PushButton PushButton PushButton PushButton 43

Ein Schaltflächen-Steuerelement, das ein kleines, rechteckiges Steuerelement darstellt, das vom Benutzer aktiviert oder deaktiviert werden kann.A push button control, which is a small rectangular control that a user can turn on or off. Eine Schaltfläche, auch als Befehlsschaltfläche bezeichnet, wird im deaktivierten Zustand (Standard) angehoben und im aktivierten Zustand abgesenkt dargestellt.A push button, also known as a command button, has a raised appearance in its default off state and a sunken appearance when it is turned on.

RadioButton RadioButton RadioButton RadioButton 45

Ein Optionsfeld.An option button, also known as a radio button. 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.All objects sharing a single parent that have this attribute are assumed to be part of a single mutually exclusive group. Sie können gruppierte Objekte verwenden, um Optionsfelder bei Bedarf in getrennte Gruppen zu teilen.You can use grouped objects to divide option buttons into separate groups when necessary.

Row Row Row Row 28

Eine Zeile von Zellen in einer Tabelle.A row of cells within a table.

RowHeader RowHeader RowHeader RowHeader 26

Ein Zeilenkopf, der eine sichtbare Bezeichnung für eine Tabellenzeile enthält.A row header, which provides a visual label for a table row.

ScrollBar ScrollBar ScrollBar ScrollBar 3

Eine vertikale oder horizontale Schiebeleiste, die Teil eines Clientbereichs sein oder in einem Steuerelement verwendet werden kann.A vertical or horizontal scroll bar, which can be either part of the client area or used in a control.

Separator Separator Separator 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.A space divided visually into two regions, such as a separator menu item or a separator dividing split panes within a window.

Slider Slider Slider 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.A control, sometimes called a trackbar, that enables a user to adjust a setting in given increments between minimum and maximum values by moving a slider. Unter dem Betriebssystem Windows werden Schieberegler-Steuerelemente zum Einstellen der Lautstärke verwendet.The volume controls in the Windows operating system are slider controls.

Sound Sound Sound Sound 5

Ein Systemsound, der verschiedenen Systemereignissen zugeordnet ist.A system sound, which is associated with various system events.

SpinButton SpinButton SpinButton SpinButton 52

Ein Drehfeld, auch als Auf-Ab-Steuerelement bezeichnet, das ein Paar von Pfeilschaltflächen enthält.A spin box, also known as an up-down control, which contains a pair of arrow buttons. Durch Klicken mit der Maus auf die Pfeilschaltflächen wird ein Wert inkrementiert oder dekrementiert.A user clicks the arrow buttons with a mouse to increment or decrement a value. Ein Drehfeld-Steuerelement wird meist mit einem begleitenden, als Buddy-Fenster bezeichneten Steuerelement verwendet, in dem der aktuelle Wert angezeigt wird.A spin button control is most often used with a companion control, called a buddy window, where the current value is displayed.

SplitButton SplitButton SplitButton SplitButton 62

Eine Symbolleisten-Schaltfläche, bei der direkt neben der Schaltfläche ein Dropdownlistensymbol angezeigt wird.A toolbar button that has a drop-down list icon directly adjacent to the button.

StaticText StaticText StaticText StaticText 41

Der schreibgeschützte Text, z. B. in einer Bezeichnung, für andere Steuerelemente oder Anweisungen in einem Dialogfeld.The read-only text, such as in a label, for other controls or instructions in a dialog box. Statischer Text kann nicht geändert oder ausgewählt werden.Static text cannot be modified or selected.

StatusBar StatusBar StatusBar 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.A status bar, which is an area typically at the bottom of an application window that displays information about the current operation, state of the application, or selected object. 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.The status bar can have multiple fields that display different kinds of information, such as an explanation of the currently selected menu command in the status bar.

Table Table Table Table 24

Eine Tabelle, die Zeilen und Spalten von Zellen sowie optional Zeilen- und Spaltenköpfe enthält.A table containing rows and columns of cells and, optionally, row headers and column headers.

Text Text Text Text 42

Der auswählbare Text, der bearbeitet werden oder schreibgeschützt sein kann.The selectable text that can be editable or read-only.

TitleBar TitleBar TitleBar TitleBar 1

Eine Titelleiste für ein Fenster.A title or caption bar for a window.

ToolBar ToolBar ToolBar ToolBar 22

Eine Symbolleiste, die eine Gruppierung von Steuerelementen für den einfachen Zugriff auf häufig verwendete Features darstellt.A toolbar, which is a grouping of controls that provide easy access to frequently used features.

ToolTip ToolTip ToolTip ToolTip 13

Eine QuickInfo, die aus einem kleinen rechteckigen Popupfenster besteht, in dem eine Kurzbeschreibung des Zweckes einer Schaltfläche angezeigt wird.A tool tip, which is a small rectangular pop-up window that displays a brief description of the purpose of a button.

WhiteSpace WhiteSpace WhiteSpace WhiteSpace 59

Ein Leerraum zwischen anderen Objekten.A blank space between other objects.

Window Window Window 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.A window frame, which usually contains child objects such as a title bar, client, and other objects typically contained in a window.

Beispiele

Das folgende Codebeispiel veranschaulicht die Erstellung eines Diagramms Eingabehilfen-fähigen steuern, mit der AccessibleObject und Control.ControlAccessibleObject Klassen zugegriffen werden kann Informationen verfügbar machen.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. Das Steuerelement zeichnet zwei Kurven geteilt. zusammen mit einer Legende an.The control plots two curves along with a legend. Die ChartControlAccessibleObject -Klasse, die abgeleitet ControlAccessibleObject, werden in der CreateAccessibilityInstance Methode, um benutzerdefinierte zugegriffen werden Informationen für das Diagrammsteuerelement bereitzustellen.The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Da die Legende des Flächendiagramms nicht tatsächlich Control --basiertes Steuerelement, sondern gezeichnet wird vom Diagrammsteuerelement, die es weist keine Informationen für integrierte zugegriffen werden kann.Because the chart legend is not an actual Control -based control, but instead is drawn by the chart control, it does not any built-in accessible information. Aus diesem Grund die ChartControlAccessibleObject -Klasse überschreibt die GetChild -Methode zur Rückgabe der CurveLegendAccessibleObject , zugegriffen werden Informationen für jeden Teil der Legende darstellt.Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. Wenn eine zugänglich-fähige Anwendung dieses Steuerelement verwendet wird, bieten das Steuerelement die erforderlichen Informationen für die zugegriffen werden kann.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Dieses Beispiel veranschaulicht die Verwendung der AccessibleRole Enumeration mit den Role Eigenschaft.This example demonstrates using the AccessibleRole enumeration with the Role property. Finden Sie unter den AccessibleObject Übersicht über die Klasse für das gesamte Codebeispiel dargestellt.See the AccessibleObject class overview for the complete code example.

// 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 'New
    
    ' 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 'SelectChild
End Class 'ChartControlAccessibleObject

Hinweise

Die Rolle des Objekts beschreibt die Funktion des Objekts und wird von barrierefreiheitsanwendungen verwendet.The role of the object describes the function of the object and is used by accessibility applications.

Diese Enumeration wird verwendet, indem AccessibleObject und Control.AccessibleRoleThis enumeration is used by AccessibleObject and Control.AccessibleRole

Weitere Informationen über die Barrierefreiheit-Anwendung suchen Sie nach "Microsoft Active Accessibility" in der Microsoft Developer Network (MSDN)-Bibliothek.For additional information about the accessibility application, search for "Microsoft Active Accessibility" in the Microsoft Developer Network (MSDN) library.

Gilt für:

Siehe auch