AccessibleEvents Enumeration

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 Ereignisse an, die von barrierefreien Anwendungen gemeldet werden.

public enum class AccessibleEvents

public enum AccessibleEvents

type AccessibleEvents =

Public Enum AccessibleEvents

Vererbung: Object

ValueType

Enum
AccessibleEvents

Felder

AcceleratorChange	32786	Die KeyboardShortcut-Eigenschaft eines Objekts hat sich geändert. Serveranwendungen senden das Ereignis für ihre barrierefreien Objekte.
Create	32768	Es wurde ein Objekt erstellt. Das Betriebssystem sendet das Ereignis für die folgenden Benutzeroberflächenelemente: Einfügemarke, Headersteuerelement, Listenansicht-Steuerelement, Registersteuerelement, Symbolleisten-Steuerelement, Strukturansicht-Steuerelement und Fensterobjekt. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte. Server müssen dieses Ereignis für alle untergeordneten Objekte eines Objekts senden, bevor sie es für das übergeordnete Objekt senden. Server müssen gewährleisten, dass alle untergeordneten Objekte vollständig erstellt wurden und bereit sind, Aufrufe durch Clients anzunehmen, wenn das übergeordnete Objekt das Ereignis sendet.
DefaultActionChange	32785	Die DefaultAction-Eigenschaft eines Objekts hat sich geändert. Das System sendet dieses Ereignis für Dialogfelder. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte. Daher müssen Serveranwendungen dieses Ereignis nicht für die untergeordneten Objekte senden. Ausgeblendete Objekte weisen den Zustand Invisible auf, angezeigte Objekte dagegen nicht. Ereignisse vom Typ `AccessibleEvents.Hide` geben an, dass der Zustand Invisible festgelegt wurde. Somit müssen Server in diesem Fall das `AccessibleEvents.StateChange`-Ereignis nicht senden.
DescriptionChange	32781	Die Description-Eigenschaft eines Objekts hat sich geändert. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte.
Destroy	32769	Ein Objekt wurde zerstört. Das System sendet dieses Ereignis für die folgenden Benutzeroberflächenelemente: Einfügemarke, Headersteuerelement, Listenansicht-Steuerelement, Registersteuerelement, Symbolleisten-Steuerelement, Strukturansicht-Steuerelement und Fensterobjekt. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte. Dieses Ereignis kann für untergeordnete Objekte gesendet werden oder auch nicht. Clients können jedoch davon ausgehen, dass alle untergeordneten Elemente eines Objekts zerstört wurden, wenn das übergeordnete Objekt dieses Ereignis sendet.
Focus	32773	Ein Objekt hat den Tastaturfokus erhalten. Das System sendet dieses Ereignis für die folgenden Benutzeroberflächenelemente: Listenansicht-Steuerelement, Menüleiste, Kontextmenü, Switch-Fenster, Registersteuerelement, Strukturansicht-Steuerelement und Fensterobjekt. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte.
HelpChange	32784	Die Help-Eigenschaft eines Objekts hat sich geändert. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte.
Hide	32771	Ein Objekt ist ausgeblendet. Das System sendet das Ereignis für die folgenden Benutzeroberflächenelemente: Einfügemarke und Cursor. Serveranwendungen senden das Ereignis für ihre barrierefreien Objekte. Wenn das Ereignis für ein übergeordnetes Objekt generiert wird, sind alle untergeordneten Objekte bereits ausgeblendet. Daher müssen Serveranwendungen das Ereignis nicht für die untergeordneten Objekte senden. Das System sendet das Ereignis nicht auf einheitliche Weise.
LocationChange	32779	Position, Form oder Größe eines Objekts haben sich geändert. Das System sendet dieses Ereignis für die folgenden Benutzeroberflächenelemente: Einfügemarke und Fensterobjekt. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte. Dieses Ereignis wird als Reaktion auf die Änderung des Objekts der obersten Ebene der Objekthierarchie generiert, jedoch nicht für eventuell darin enthaltene untergeordnete Objekte. Wenn ein Benutzer z. B. die Größe eines Fensters ändert, sendet das System diese Benachrichtigung für das Fenster, jedoch nicht für die Menüleiste, Titelleiste, die Schiebeleisten oder sonstige geänderte Objekte. Das System sendet dieses Ereignis nicht für jedes verankerte untergeordnete Fenster, wenn das übergeordnete Fenster verschoben wird. Wenn eine Anwendung jedoch aufgrund einer Größenveränderung die Größe untergeordneter Fenster explizit ändert, sendet das System mehrere Ereignisse für die in der Größe geänderten untergeordneten Fenster. Wenn die State-Eigenschaft eines Objekts auf Floating festgelegt ist, müssen Server ein Positionsänderungsereignis senden, wenn die Position des Objekts geändert wird. Wenn ein Objekt nicht diesen Zustand aufweist, müssen Server dieses Ereignis auslösen, wenn das Objekt relativ zum übergeordneten Objekt verschoben wird.
NameChange	32780	Die Name-Eigenschaft eines Objekts hat sich geändert. Das System sendet dieses Ereignis für die folgenden Benutzeroberflächenelemente: Kontrollkästchen, Cursor, Listenansicht-Steuerelement, Schaltfläche, Optionsfeld, Statusanzeige-Steuerelement, Strukturansicht-Steuerelement und Fensterobjekt. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte.
ParentChange	32783	Ein Objekt verfügt über ein neues übergeordnetes Objekt. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte.
Reorder	32772	Ein Containerobjekt hat untergeordnete Objekte hinzugefügt, entfernt oder neu angeordnet. Das System sendet dieses Ereignis für die folgenden Benutzeroberflächenelemente: Headersteuerelement, Listenansicht-Steuerelement, Symbolleisten-Steuerelement und Fensterobjekt. Serveranwendungen senden dieses Ereignis entsprechend ihren barrierefreien Objekten. Dieses Ereignis wird auch von einem übergeordneten Fenster gesendet, wenn sich die z-Reihenfolge für die untergeordneten Fenster ändert.
Selection	32774	Es wurde ein barrierefreies Objekt in einem Containerobjekt ausgewählt. Dieses Ereignis signalisiert die Auswahl eines einzelnen Elements. Entweder wurde in einem Container, der zuvor keine ausgewählten untergeordneten Elemente enthielt, ein untergeordnetes Element ausgewählt, oder die Auswahl des untergeordneten Elements hat sich geändert.
SelectionAdd	32775	Der Auswahl wurde ein Element aus einem Containerobjekt hinzugefügt. Das System sendet dieses Ereignis für die folgenden Benutzeroberflächenelemente: Listenfeld, Listenansicht-Steuerelement und Strukturansicht-Steuerelement. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte. Dieses Ereignis signalisiert, dass einer vorhandenen Auswahl ein untergeordnetes Element hinzugefügt wurde.
SelectionRemove	32776	Aus der Auswahl wurde ein Element aus einem Containerobjekt entfernt. Das System sendet dieses Ereignis für die folgenden Benutzeroberflächenelemente: Listenfeld, Listenansicht-Steuerelement und Strukturansicht-Steuerelement. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte. Dieses Ereignis signalisiert, dass aus einer vorhandenen Auswahl ein untergeordnetes Element entfernt wurde.
SelectionWithin	32777	In einem Containerobjekt sind zahlreiche Änderungen der Auswahl erfolgt. Das System sendet dieses Ereignis für Listenfelder. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte. Dieses Ereignis kann gesendet werden, wenn die ausgewählten Elemente in einem Steuerelement erheblich geändert wurden. Das Ereignis benachrichtigt den Client, dass zahlreiche Änderungen der Auswahl erfolgt sind. Dies ist dem Senden mehrerer `SelectionAdd`-Ereignisse oder `SelectionRemove`-Ereignisse vorzuziehen.
Show	32770	Ein ausgeblendetes Objekt wird angezeigt. Das System sendet dieses Ereignis für die folgenden Benutzeroberflächenelemente: Einfügemarke, Cursor und Fensterobjekt. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte. Wenn dieses Ereignis von einem übergeordneten Objekt gesendet wird, schließen Clients daraus, dass bereits alle untergeordneten Objekte angezeigt wurden. Daher müssen Serveranwendungen dieses Ereignis nicht für die untergeordneten Objekte senden.
StateChange	32778	Der Zustand eines Objekts hat sich geändert. Das System sendet das Ereignis für die folgenden Benutzeroberflächenelemente: Kontrollkästchen, Kombinationsfeld, Headersteuerelement, Schaltfläche, Optionsfeld, Schiebeleiste, Symbolleisten-Steuerelement, Strukturansicht-Steuerelement, Auf-Ab-Steuerelement und Fensterobjekt. Serveranwendungen senden das Ereignis für ihre barrierefreien Objekte. Eine Zustandsänderung kann z. B. auftreten, wenn auf ein Schaltflächenobjekt geklickt bzw. wenn es wieder losgelassen wurde, oder wenn ein Objekt aktiviert oder deaktiviert wird. Das System sendet das Ereignis nicht auf einheitliche Weise.
SystemAlert	2	Es wurde eine Warnung generiert. Serveranwendungen senden dieses Ereignis bei jeder wichtigen Änderung der Benutzeroberfläche, über die ein Benutzer möglicherweise informiert werden muss. Das System sendet das Ereignis für Dialogfeldobjekte nicht auf einheitliche Weise.
SystemCaptureEnd	9	Ein Fenster hat die Mausauswahl verloren. Das System sendet das Ereignis. Server senden dieses Ereignis nie.
SystemCaptureStart	8	Ein Fenster wurde verschoben oder in seiner Größe geändert. Das System sendet das Ereignis. Server senden dieses Ereignis nie.
SystemContextHelpEnd	13	Ein Fenster hat den Modus der kontextbezogenen Hilfe beendet. Das System sendet das Ereignis nicht auf einheitliche Weise.
SystemContextHelpStart	12	Ein Fenster hat in den Modus der kontextbezogenen Hilfe gewechselt. Das System sendet das Ereignis nicht auf einheitliche Weise.
SystemDialogEnd	17	Ein Dialogfeld wurde geschlossen. Das System sendet das Ereignis nicht für Standarddialogfelder. Server senden dieses Ereignis für benutzerdefinierte Dialogfelder. Das System sendet das Ereignis nicht auf einheitliche Weise.
SystemDialogStart	16	Ein Dialogfeld wurde angezeigt. Das System sendet das Ereignis für Standarddialogfelder. Server senden dieses Ereignis für benutzerdefinierte Dialogfelder. Das System sendet das Ereignis nicht auf einheitliche Weise.
SystemDragDropEnd	15	Eine Anwendung wird gleich den Drag & Drop-Modus beenden. Anwendungen, die Drag & Drop-Vorgänge unterstützen, müssen dieses Ereignis senden, da es vom System nicht gesendet wird.
SystemDragDropStart	14	Eine Anwendung wird gleich in den Drag & Drop-Modus wechseln. Anwendungen, die Drag & Drop-Vorgänge unterstützen, müssen dieses Ereignis senden, da es vom System nicht gesendet wird.
SystemForeground	3	Das Vordergrundfenster hat sich geändert. Das System sendet dieses Ereignis auch dann, wenn das Vordergrundfenster in ein anderes Fenster in demselben Thread geändert wird. Serveranwendungen senden dieses Ereignis nie.
SystemMenuEnd	5	Ein Menü in der Menüleiste wurde geschlossen. Das System sendet dieses Ereignis für Standardmenüs. Server senden dieses Ereignis für benutzerdefinierte Menüs.
SystemMenuPopupEnd	7	Ein Kontextmenü wurde geschlossen. Das System sendet dieses Ereignis für Standardmenüs. Server senden dieses Ereignis für benutzerdefinierte Menüs. Wenn ein Kontextmenü geschlossen wird, empfängt der Client diese Meldung und fast unmittelbar danach das `SystemMenuEnd`-Ereignis. Das System sendet das Ereignis nicht auf einheitliche Weise. Für einen Aufruf von `TrackPopupMenu()` wird `EVENT_SYSTEM_MENUSTART` ein Client fast sofort angezeigt, bis `EVENT_SYSTEM_MENUPOPUPSTART` das Popup angezeigt wird.
SystemMenuPopupStart	6	Ein Kontextmenü wurde angezeigt. Das System sendet dieses Ereignis für Standardmenüs. Server senden dieses Ereignis für benutzerdefinierte Menüs. Das System sendet das Ereignis nicht auf einheitliche Weise. Für einen Aufruf von `TrackPopupMenu()` wird `EVENT_SYSTEM_MENUSTART` ein Client fast sofort angezeigt, bis `EVENT_SYSTEM_MENUPOPUPSTART` das Popup angezeigt wird.
SystemMenuStart	4	Ein Menüelement in der Menüleiste wurde ausgewählt. Das System sendet dieses Ereignis für Standardmenüs. Server senden dieses Ereignis für benutzerdefinierte Menüs. Das System kann mehrere `MenuStart`-Ereignisse auslösen, für die ein möglicherweise entsprechendes `MenuEnd`-Ereignis vorliegt.
SystemMinimizeEnd	23	Ein Fensterobjekt wurde minimiert oder maximiert. Das System sendet das Ereignis. Server senden dieses Ereignis nie.
SystemMinimizeStart	22	Ein Fensterobjekt wird gerade minimiert oder maximiert. Das System sendet das Ereignis. Server senden dieses Ereignis nie.
SystemMoveSizeEnd	11	Das Verschieben oder das Ändern der Größe eines Fensters ist beendet. Das System sendet das Ereignis. Server senden dieses Ereignis nie.
SystemMoveSizeStart	10	Ein Fenster wurde verschoben oder in seiner Größe geändert. Das System sendet das Ereignis. Server senden dieses Ereignis nie.
SystemScrollingEnd	19	Der Bildlauf einer Schiebeleiste wurde beendet. Das System sendet dieses Ereignis für an Fenster angefügte Schiebeleisten und für Standard-Schiebeleisten-Steuerelemente. Server senden dieses Ereignis für benutzerdefinierte Schiebeleisten.
SystemScrollingStart	18	Der Bildlauf einer Schiebeleiste wurde begonnen. Das System sendet das Ereignis für an Fenster angefügte Schiebeleisten und für Standard-Schiebeleisten-Steuerelemente. Server senden dieses Ereignis für benutzerdefinierte Schiebeleisten.
SystemSound	1	Es wurde ein Sound abgespielt. Das System sendet dieses Ereignis, wenn ein Systemsound, z. B. für Menüs, abgespielt wird, auch wenn dieser nicht zu hören ist. Dies kann aufgrund einer fehlenden Sounddatei oder Soundkarte der Fall sein. Server senden dieses Ereignis, wenn ein benutzerdefiniertes Benutzeroberflächenelement einen Sound generiert.
SystemSwitchEnd	21	Der Benutzer hat ALT+TAB losgelassen. Das System sendet das `SwitchEnd`-Ereignis. Server senden dieses Ereignis nie. Wenn nur eine Anwendung ausgeführt wird, während der Benutzer ALT+TAB drückt, sendet das System das `SwitchEnd`-Ereignis ohne das entsprechende `SwitchStart`-Ereignis.
SystemSwitchStart	20	Der Benutzer hat ALT+TAB gedrückt, wodurch das switch-Fenster aktiviert wird. Wenn nur eine Anwendung ausgeführt wird, während der Benutzer ALT+TAB drückt, löst das System das `SwitchEnd`-Ereignis ohne das entsprechende `SwitchStart`-Ereignis aus.
ValueChange	32782	Die Value-Eigenschaft eines Objekts hat sich geändert. Das System löst das `ValueChange`-Ereignis für die folgenden Benutzeroberflächenelemente aus: Bearbeitungssteuerelement, Headersteuerelement, Abkürzungstasten-Steuerelement, Statusanzeige-Steuerelement, Schiebeleiste, Schieberegler-Steuerelement und Auf-Ab-Steuerelement. Serveranwendungen senden dieses Ereignis für ihre barrierefreien Objekte.

Beispiele

Im folgenden Codebeispiel wird die Erstellung eines Barrierefreiheits-Diagrammsteuerelements mithilfe der AccessibleObject klassen Control.ControlAccessibleObject veranschaulicht, um barrierefreie Informationen verfügbar zu machen. Das Steuerelement zeichnet zwei Kurven zusammen mit einer Legende. Die ChartControlAccessibleObject Klasse, von ControlAccessibleObjectder abgeleitet wird, wird in der CreateAccessibilityInstance Methode verwendet, um benutzerdefinierte barrierefreie Informationen für das Diagrammsteuerelement bereitzustellen. Da es sich bei der Diagrammlegende nicht um ein tatsächlich Control basierendes Steuerelement handelt, sondern stattdessen vom Diagrammsteuerelement gezeichnet wird, werden keine integrierten barrierefreien Informationen verwendet. Aus diesem Grund überschreibt die ChartControlAccessibleObject Klasse die Methode, um die GetChild CurveLegendAccessibleObject barrierefreien Informationen für jeden Teil der Legende zurückzugeben. Wenn eine barrierefreie Anwendung dieses Steuerelements verwendet, kann das Steuerelement die erforderlichen barrierefreien Informationen bereitstellen.

In diesem Beispiel wird die Verwendung der Enumeration mit der AccessibleEvents AccessibilityNotifyClients Methode veranschaulicht. Weitere Informationen finden Sie in der AccessibleObject Klassenübersicht für das vollständige Codebeispiel.

   // Gets or sets the location for the curve legend.
   Point get()
   {
      return location;
   }

   void set( Point value )
   {
      location = value;
      chart->Invalidate();
      
      // Notifies the chart of the location change. This is used for
      // the accessibility information. AccessibleEvents::LocationChange
      // tells the chart the reason for the notification.
      chart->AccessibilityNotifyClients( AccessibleEvents::LocationChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
   }

}

property String^ Name 
{

   // Gets or sets the Name for the curve legend.
   String^ get()
   {
      return name;
   }

   void set( String^ value )
   {
      if ( name != value )
      {
         name = value;
         chart->Invalidate();
         
         // Notifies the chart of the name change. This is used for
         // the accessibility information. AccessibleEvents::NameChange
         // tells the chart the reason for the notification.
         chart->AccessibilityNotifyClients( AccessibleEvents::NameChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }

}

property bool Selected 
{

   // Gets or sets the Selected state for the curve legend.
   bool get()
   {
      return selected;
   }

   void set( bool value )
   {
      if ( selected != value )
      {
         selected = value;
         chart->Invalidate();
         
         // Notifies the chart of the selection value change. This is used for
         // the accessibility information. The AccessibleEvents value depends upon
         // if the selection is true (AccessibleEvents::SelectionAdd) or
         // false (AccessibleEvents::SelectionRemove).
         chart->AccessibilityNotifyClients( selected ? AccessibleEvents::SelectionAdd : AccessibleEvents::SelectionRemove, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }

    // Gets or sets the location for the curve legend.
    public Point Location
    {   
        get {
            return location;
        }
        set {
            location = value;
            chart.Invalidate();

            // Notifies the chart of the location change. This is used for
            // the accessibility information. AccessibleEvents.LocationChange
            // tells the chart the reason for the notification.

            chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange, 
                ((CurveLegendAccessibleObject)AccessibilityObject).ID);
        }
    }            

    // Gets or sets the Name for the curve legend.
    public string Name
    {   
        get {
            return name;
        }
        set {
            if (name != value) 
            {
                name = value;
                chart.Invalidate();

                // Notifies the chart of the name change. This is used for
                // the accessibility information. AccessibleEvents.NameChange
                // tells the chart the reason for the notification.

                chart.AccessibilityNotifyClients(AccessibleEvents.NameChange, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }

    // Gets or sets the Selected state for the curve legend.
    public bool Selected
    {   
        get {
            return selected;
        }
        set {
            if (selected != value) 
            {
                selected = value;
                chart.Invalidate();

                // Notifies the chart of the selection value change. This is used for
                // the accessibility information. The AccessibleEvents value depends upon
                // if the selection is true (AccessibleEvents.SelectionAdd) or 
                // false (AccessibleEvents.SelectionRemove).
                chart.AccessibilityNotifyClients(
                    selected ? AccessibleEvents.SelectionAdd : AccessibleEvents.SelectionRemove, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }

' Gets or sets the location for the curve legend.            
Public Property Location() As Point
    Get
        Return m_location
    End Get
    Set
        m_location = value
        chart.Invalidate()

        ' Notifies the chart of the location change. This is used for
        ' the accessibility information. AccessibleEvents.LocationChange
        ' tells the chart the reason for the notification.
        chart.ExposeAccessibilityNotifyClients(AccessibleEvents.LocationChange, _
                CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
    End Set
End Property

' Gets or sets the Name for the curve legend.            
Public Property Name() As String
    Get
        Return m_name
    End Get
    Set
        If m_name <> value Then
            m_name = value
            chart.Invalidate()

            ' Notifies the chart of the name change. This is used for
            ' the accessibility information. AccessibleEvents.NameChange
            ' tells the chart the reason for the notification. 
            chart.ExposeAccessibilityNotifyClients(AccessibleEvents.NameChange, _
                    CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
        End If
    End Set
End Property

' Gets or sets the Selected state for the curve legend.            
Public Property Selected() As Boolean
    Get
        Return m_selected
    End Get
    Set
        If m_selected <> value Then
            m_selected = value
            chart.Invalidate()

            ' Notifies the chart of the selection value change. This is used for
            ' the accessibility information. The AccessibleEvents value varies
            ' on whether the selection is true (AccessibleEvents.SelectionAdd) or 
            ' false (AccessibleEvents.SelectionRemove). 
            If m_selected Then
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionAdd, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            Else
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionRemove, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            End If
        End If
    End Set
End Property

Hinweise

Die Betriebssystem- und Barrierefreiheitsserveranwendungen generieren Barrierefreiheitsereignisse als Reaktion auf Änderungen auf der Benutzeroberfläche.

Diese Enumeration wird von AccessibleObject und Control.

Weitere Informationen finden Sie unter Microsoft Active Accessibility.

Gilt für

Teilen über