AccessibleEvents Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt Ereignisse an, die von barrierefreien Anwendungen gemeldet werden.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Vererbung
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 |
| 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 |
| 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 Für einen Aufruf von |
| 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 |
| 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 |
| 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 |
| 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 |
| ValueChange | 32782 | Die Value-Eigenschaft eines Objekts hat sich geändert. Das System löst das |
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.