Freigeben über

AccessibleRole-Enumeration

  • Artikel

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Enumeration AccessibleRole
'Usage
Dim instance As AccessibleRole

public enum AccessibleRole

public enum class AccessibleRole

public enum AccessibleRole

public enum AccessibleRole

Member

  Membername Beschreibung
Alert 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 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 Das Hauptfenster für eine Anwendung. 
Border Ein Fensterrahmen. Der gesamte Rahmen wird von einem einzelnen Objekt dargestellt, nicht von separaten Objekten für die einzelnen Seiten. 
ButtonDropDown Eine Schaltfläche, die eine Liste von Elementen als Dropdown öffnet. 
ButtonDropDownGrid Eine Schaltfläche, die ein Raster als Dropdown öffnet. 
ButtonMenu Eine Schaltfläche, die ein Menü als Dropdown öffnet. 
Caret Eine Einfügemarke, die durch eine blinkende Linie, Fläche oder Bitmap dargestellt wird und die Position des Einfügepunkts im Clientbereich eines Fensters markiert. 
Cell Eine Zelle in einer Tabelle. 
Character Ein cartoonartiges grafisches Objekt, wie ein Microsoft Office-Assistent, das i. d. R. angezeigt wird, um Benutzern einer Anwendung Hilfe bereitzustellen. 
Chart Ein Bild, das zur grafischen Darstellung von Daten verwendet wird. 
CheckButton Ein Kontrollkästchen-Steuerelement, das eine Option darstellt, die unabhängig von anderen Optionen aktiviert und deaktiviert werden kann. 
Client Der Benutzerbereich eines Fensters. 
Clock Ein Steuerelement, das die Uhrzeit anzeigt. 
Column Eine Spalte von Zellen in einer Tabelle. 
ColumnHeader Ein Spaltenkopf, der eine sichtbare Bezeichnung für eine Spalte in einer Tabelle enthält. 
ComboBox Ein Kombinationsfeld, das ein Edit-Steuerelement mit einem zugeordneten Listenfeld darstellt und eine Reihe vordefinierter Optionen bereitstellt. 
Cursor Ein Mauszeiger. 
Default Eine vom System bereitgestellte Rolle. 
Diagram Ein Bild, das zur Darstellung von Daten als Diagramm verwendet wird. 
Dial Eine Skala oder ein Knopf. Dies kann auch ein schreibgeschütztes Objekt sein, z. B. ein Geschwindigkeitsmesser. 
Dialog Ein Dialogfeld oder ein Meldungsfeld. 
Document 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 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 Eine mathematische Gleichung. 
Graphic Ein Bild. 
Grip 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 Die auf logische Weise geordneten Objekte. Zwischen dem Gruppierungsobjekt und dem enthaltenen Objekt kann eine Parent-Child Beziehung bestehen. 
HelpBalloon 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 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 Ein Indikator, z. B. eine Zeigergrafik, die auf das aktuelle Element zeigt. 
IpAddress  
Link Eine Verknüpfung, die 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 Ein Listenfeld, das dem Benutzer die Auswahl eines oder mehrerer Elemente ermöglicht. 
ListItem Ein Element in einem Listenfeld oder der Listenteil eines Kombinationsfelds, Dropdown-Listenfelds oder eines Dropdown-Kombinationsfelds. 
MenuBar Eine Menüleiste, meist unterhalb der Titelleiste eines Fensters, aus dem Benutzer Menüs auswählen können. 
MenuItem 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 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 Keine Rolle. 
Outline Eine Gliederung oder Struktur, z. B. ein Strukturansicht-Steuerelement, in dem eine hierarchische Liste angezeigt wird und in dem Benutzer üblicherweise Teilstrukturen erweitern und reduzieren können. 
OutlineButton  
OutlineItem Ein Element in einer Gliederung oder einer Struktur. 
PageTab 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 Ein Container mit Registersteuerelementen. 
Pane 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 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 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 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 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 Eine Zeile von Zellen in einer Tabelle. 
RowHeader Ein Zeilenkopf, der eine sichtbare Bezeichnung für eine Tabellenzeile enthält. 
ScrollBar Eine vertikale oder horizontale Bildlaufleiste, die Teil eines Clientbereichs sein oder in einem Steuerelement verwendet werden kann. 
Separator Eine Trennung in zwei Bereiche, z. B. mithilfe eines Trennelements in einem Menü oder mit einem Trennzeichen, das Bereiche in einem Fenster trennt. 
Slider 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 Ein Systemsound, der verschiedenen Systemereignissen zugeordnet ist. 
SpinButton 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  
StaticText 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 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 Eine Tabelle, die Zeilen und Spalten von Zellen sowie optional Zeilen- und Spaltenköpfe enthält. 
Text Der auswählbare Text, der bearbeitet werden oder schreibgeschützt sein kann. 
TitleBar Eine Titelleiste für ein Fenster. 
ToolBar Eine Symbolleiste, die eine Gruppierung von Steuerelementen für den einfachen Zugriff auf häufig verwendete Features darstellt. 
ToolTip Eine QuickInfo, die aus einem kleinen rechteckigen Popupfenster besteht, in dem eine Kurzbeschreibung des Zweckes einer Schaltfläche angezeigt wird. 
WhiteSpace Ein Leerraum zwischen anderen Objekten. 
Window Ein Fensterrahmen, der i. d. R. untergeordnete Objekte wie eine Titelleiste, Client- und andere Objekte enthält, die normalerweise in einem Fenster enthalten sind. 

Hinweise

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

Diese Enumeration wird von AccessibleObject und Control.AccessibleRole verwendet.

Zusätzliche Informationen über Eingabehilfenprogramme finden Sie in der MSDN Library (Microsoft Developer Network Library) unter "Microsoft Active Accessibility".

Beispiel

Das folgende Codebeispiel veranschaulicht die Erstellung eines Chart-Steuerelements mit Eingabehilfenunterstützung unter Verwendung der AccessibleObject-Klasse und der Control.ControlAccessibleObject-Klasse zum Verfügbarmachen von Eingabehilfeninformationen. Das Steuerelement zeichnet zwei Kurven mit einer Legende. Die von ControlAccessibleObject abgeleitete ChartControlAccessibleObject-Klasse wird in der CreateAccessibilityInstance-Methode verwendet, um benutzerdefinierte Eingabehilfeninformationen für das Chart-Steuerelement bereitzustellen. Da die Diagrammlegende kein tatsächlich Control-basiertes Steuerelement darstellt, sondern vom Chart-Steuerelement gezeichnet wird, weist es keine integrierten Eingabehilfeninformationen auf. Aus diesem Grund überschreibt die ChartControlAccessibleObject-Klasse die GetChild-Methode, um das CurveLegendAccessibleObject zurückzugeben, das die Eingabehilfeninformationen für alle Teile der Legende darstellt. Wenn eine Anwendung mit Eingabehilfenunterstützung dieses Steuerelement verwendet, kann das Steuerelement die erforderlichen Eingabehilfeninformationen bereitstellen.

Dieser Code veranschaulicht die Verwendung der AccessibleRole-Enumeration mit der Role-Eigenschaft. Das vollständige Codebeispiel finden Sie in der Übersicht zur AccessibleObject-Klasse.

' 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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

System.Windows.Forms-Namespace
AccessibleEvents-Enumeration
AccessibleNavigation-Enumeration
AccessibleObject-Klasse
AccessibleSelection
AccessibleStates
AccessibleRole