AccessibleEvents Enumeration

  • Referenz

Definition

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

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

Siehe auch