AccessibleEvents Wyliczenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa zdarzenia zgłaszane przez aplikacje dostępne.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Dziedziczenie
Pola
| AcceleratorChange | 32786 | Właściwość obiektu została zmieniona KeyboardShortcut . Aplikacje serwera wysyłają zdarzenie dla ich dostępnych obiektów. |
| Create | 32768 | Obiekt został utworzony. System operacyjny wysyła zdarzenie dla następujących elementów interfejsu użytkownika: daszek, kontrolka nagłówka, kontrolka widoku listy, kontrolka tabulatora, kontrolka paska narzędzi, kontrolka widoku drzewa i obiekt okna. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. Serwery muszą wysłać to zdarzenie dla wszystkich obiektów podrzędnych obiektu przed wysłaniem zdarzenia dla obiektu nadrzędnego. Serwery muszą upewnić się, że wszystkie obiekty podrzędne są w pełni tworzone i gotowe do akceptowania wywołań od klientów, gdy obiekt nadrzędny wysyła zdarzenie. |
| DefaultActionChange | 32785 | Właściwość obiektu została zmieniona DefaultAction . System wysyła to zdarzenie dla okien dialogowych. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. W związku z tym aplikacje serwerowe nie muszą wysyłać tego zdarzenia dla obiektów podrzędnych. Ukryte obiekty mają stan Invisible, a pokazane obiekty nie. Zdarzenia typu |
| DescriptionChange | 32781 | Właściwość obiektu została zmieniona Description . Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. |
| Destroy | 32769 | Obiekt został zniszczony. System wysyła to zdarzenie dla następujących elementów interfejsu użytkownika: daszek, kontrolka nagłówka, kontrolka widoku listy, kontrolka tabulatora, kontrolka paska narzędzi, kontrolka widoku drzewa i obiekt okna. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. To zdarzenie może lub nie może być wysyłane dla obiektów podrzędnych. Klienci mogą jednak stwierdzić, że wszystkie elementy podrzędne obiektu zostały zniszczone, gdy obiekt nadrzędny wysyła to zdarzenie. |
| Focus | 32773 | Obiekt otrzymał fokus klawiatury. System wysyła to zdarzenie dla następujących elementów interfejsu użytkownika: kontrolka widoku listy, pasek menu, menu skrótów, okno przełącznika, kontrolka tabulacji, kontrolka widoku drzewa i obiekt okna. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. |
| HelpChange | 32784 | Właściwość obiektu została zmieniona Help . Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. |
| Hide | 32771 | Obiekt jest ukryty. System wysyła zdarzenie dla następujących elementów interfejsu użytkownika: karetki i kursora. Aplikacje serwera wysyłają zdarzenie dla ich dostępnych obiektów. Po wygenerowaniu zdarzenia dla obiektu nadrzędnego wszystkie obiekty podrzędne zostały już ukryte. W związku z tym aplikacje serwerowe nie muszą wysyłać zdarzenia dla obiektów podrzędnych. System nie wysyła zdarzenia spójnie. |
| LocationChange | 32779 | Obiekt zmienił lokalizację, kształt lub rozmiar. System wysyła to zdarzenie dla następujących elementów interfejsu użytkownika: daszek i obiekt okna. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. To zdarzenie jest generowane w odpowiedzi na obiekt najwyższego poziomu w hierarchii obiektów, który uległ zmianie, a nie dla żadnych elementów podrzędnych, które może zawierać. Jeśli na przykład użytkownik zmieni rozmiar okna, system wyśle to powiadomienie dla okna, ale nie dla paska menu, paska tytułu, pasków przewijania lub innych obiektów, które również uległy zmianie. System nie wysyła tego zdarzenia dla każdego nieprzecinkowego okna podrzędnego, gdy obiekt nadrzędny zostanie przeniesiony. Jeśli jednak aplikacja jawnie zmienia rozmiar okien podrzędnych w wyniku zmiany rozmiaru, system wysyła wiele zdarzeń dla zmienionych elementów podrzędnych. Jeśli właściwość obiektu jest ustawiona State na Floating, serwery powinny wysyłać zdarzenie zmiany lokalizacji za każdym razem, gdy obiekt zmienia lokalizację. Jeśli obiekt nie ma tego stanu, serwery powinny zgłosić to zdarzenie, gdy obiekt zostanie przeniesiony względem jego obiektu nadrzędnego. |
| NameChange | 32780 | Właściwość obiektu została zmieniona Name . System wysyła to zdarzenie dla następujących elementów interfejsu użytkownika: pole wyboru, kursor, kontrolka widoku listy, przycisk radiowy, kontrolka paska stanu, kontrolka widoku drzewa i obiekt okna. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. |
| ParentChange | 32783 | Obiekt ma nowy obiekt nadrzędny. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. |
| Reorder | 32772 | Obiekt kontenera dodał, usunął lub zmienił kolejność elementów podrzędnych. System wysyła to zdarzenie dla następujących elementów interfejsu użytkownika: kontrolka nagłówka, kontrolka widoku listy, kontrolka paska narzędzi i obiekt okna. Aplikacje serwera wysyłają to zdarzenie zgodnie z potrzebami ich obiektów dostępnych. To zdarzenie jest również wysyłane przez okno nadrzędne, gdy zmieni się kolejność z dla okien podrzędnych. |
| Selection | 32774 | Zaznaczono dostępny obiekt w obiekcie kontenera. To zdarzenie sygnalizuje pojedynczy wybór. Element podrzędny został wybrany w kontenerze, który wcześniej nie zawierał żadnych wybranych elementów podrzędnych, lub zaznaczenie zostało zmienione z jednego elementu podrzędnego na inne. |
| SelectionAdd | 32775 | Element w obiekcie kontenera został dodany do zaznaczenia. System wysyła to zdarzenie dla następujących elementów interfejsu użytkownika: pole listy, kontrolka widoku listy i kontrolka widoku drzewa. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. To zdarzenie sygnalizuje, że element podrzędny został dodany do istniejącego zaznaczenia. |
| SelectionRemove | 32776 | Element w obiekcie kontenera został usunięty z zaznaczenia. System wysyła to zdarzenie dla następujących elementów interfejsu użytkownika: pole listy, kontrolka widoku listy i kontrolka widoku drzewa. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. To zdarzenie sygnalizuje, że element podrzędny został usunięty z istniejącego zaznaczenia. |
| SelectionWithin | 32777 | W obiekcie kontenera wystąpiły liczne zmiany wyboru. System wysyła to zdarzenie dla pól listy. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. To zdarzenie można wysłać, gdy wybrane elementy w kontrolce uległy znacznej zmianie. To zdarzenie informuje klienta, że wystąpiło wiele zmian wyboru. Jest to preferowane do wysyłania kilku |
| Show | 32770 | Wyświetlany jest ukryty obiekt. System wysyła to zdarzenie dla następujących elementów interfejsu użytkownika: daszek, kursor i obiekt okna. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów. Klienci mogą stwierdzić, że gdy to zdarzenie jest wysyłane przez obiekt nadrzędny, wszystkie obiekty podrzędne zostały już wyświetlone. W związku z tym aplikacje serwerowe nie muszą wysyłać tego zdarzenia dla obiektów podrzędnych. |
| StateChange | 32778 | Stan obiektu uległ zmianie. System wysyła zdarzenie dla następujących elementów interfejsu użytkownika: pole wyboru, pole kombi, kontrolka nagłówka, przycisk radiowy, pasek przewijania, kontrolka paska narzędzi, kontrolka widoku drzewa, kontrolka w górę i obiekt okna. Aplikacje serwera wysyłają zdarzenie dla ich dostępnych obiektów. Na przykład zmiana stanu może wystąpić, gdy obiekt przycisku został naciśnięty lub zwolniony albo gdy obiekt jest włączony lub wyłączony. System nie wysyła zdarzenia spójnie. |
| SystemAlert | 2 | Wygenerowano alert. Aplikacje serwera wysyłają to zdarzenie za każdym razem, gdy wystąpiła ważna zmiana interfejsu użytkownika, o których użytkownik może wiedzieć. System nie wysyła zdarzenia spójnie dla obiektów okna dialogowego. |
| SystemCaptureEnd | 9 | Okno straciło przechwytywanie myszy. System wysyła zdarzenie; serwery nigdy nie wysyłają tego zdarzenia. |
| SystemCaptureStart | 8 | Okno jest przenoszone lub zmieniane. System wysyła zdarzenie; serwery nigdy nie wysyłają tego zdarzenia. |
| SystemContextHelpEnd | 13 | Okno zakończyło kontekstowy tryb pomocy. System nie wysyła zdarzenia spójnie. |
| SystemContextHelpStart | 12 | Okno wprowadziło tryb pomocy kontekstowej. System nie wysyła zdarzenia spójnie. |
| SystemDialogEnd | 17 | Okno dialogowe zostało zamknięte. System nie wysyła zdarzenia dla standardowych okien dialogowych. Serwery wysyłają to zdarzenie dla niestandardowych okien dialogowych. System nie wysyła zdarzenia spójnie. |
| SystemDialogStart | 16 | Zostało wyświetlone okno dialogowe. System wysyła zdarzenie dla standardowych okien dialogowych. Serwery wysyłają to zdarzenie dla niestandardowych okien dialogowych. System nie wysyła zdarzenia spójnie. |
| SystemDragDropEnd | 15 | Aplikacja ma zakończyć tryb przeciągania i upuszczania. Aplikacje obsługujące operacje przeciągania i upuszczania muszą wysyłać to zdarzenie; system nie. |
| SystemDragDropStart | 14 | Aplikacja zostanie wprowadzona w tryb przeciągania i upuszczania. Aplikacje obsługujące operacje przeciągania i upuszczania muszą wysyłać to zdarzenie; system nie. |
| SystemForeground | 3 | Zmieniono okno pierwszego planu. System wysyła to zdarzenie, nawet jeśli okno pierwszego planu zostanie zmienione na inne okno w tym samym wątku. Aplikacje serwera nigdy nie wysyłają tego zdarzenia. |
| SystemMenuEnd | 5 | Menu z paska menu zostało zamknięte. System wysyła to zdarzenie dla standardowych menu. Serwery wysyłają to zdarzenie dla menu niestandardowych. |
| SystemMenuPopupEnd | 7 | Menu skrótów zostało zamknięte. System wysyła to zdarzenie dla standardowych menu. Serwery wysyłają to zdarzenie dla menu niestandardowych. Po zamknięciu menu skrótów klient otrzymuje ten komunikat niemal natychmiast po zdarzeniu Aby wywołać metodę |
| SystemMenuPopupStart | 6 | Zostało wyświetlone menu skrótów. System wysyła to zdarzenie dla standardowych menu. Serwery wysyłają to zdarzenie dla menu niestandardowych. System nie wysyła zdarzenia spójnie. Aby wywołać metodę |
| SystemMenuStart | 4 | Wybrano element menu na pasku menu. System wysyła to zdarzenie dla standardowych menu. Serwery wysyłają to zdarzenie dla menu niestandardowych. System może zgłosić więcej niż jedno |
| SystemMinimizeEnd | 23 | Obiekt okna został zminimalizowany lub zmaksymalizowany. System wysyła zdarzenie; serwery nigdy nie wysyłają tego zdarzenia. |
| SystemMinimizeStart | 22 | Obiekt okna ma zostać zminimalizowany lub zmaksymalizowany. System wysyła zdarzenie; serwery nigdy nie wysyłają tego zdarzenia. |
| SystemMoveSizeEnd | 11 | Zakończono przenoszenie lub zmienianie rozmiaru okna. System wysyła zdarzenie; serwery nigdy nie wysyłają tego zdarzenia. |
| SystemMoveSizeStart | 10 | Okno jest przenoszone lub zmieniane. System wysyła zdarzenie; serwery nigdy nie wysyłają tego zdarzenia. |
| SystemScrollingEnd | 19 | Przewijanie zostało zakończone na pasku przewijania. System wysyła to zdarzenie dla pasków przewijania dołączonych do okna i standardowych kontrolek paska przewijania. Serwery wysyłają to zdarzenie dla niestandardowych pasków przewijania. |
| SystemScrollingStart | 18 | Przewijanie zostało rozpoczęte na pasku przewijania. System wysyła zdarzenie pasków przewijania dołączonych do okna i standardowych kontrolek paska przewijania. Serwery wysyłają to zdarzenie dla niestandardowych pasków przewijania. |
| SystemSound | 1 | Odtwarzany był dźwięk. System wysyła to zdarzenie, gdy dźwięk systemowy, taki jak menu, jest odtwarzany, nawet jeśli dźwięk nie jest słyszalny. Może to być spowodowane brakiem pliku dźwiękowego lub karty dźwiękowej. Serwery wysyłają to zdarzenie, jeśli niestandardowy element interfejsu użytkownika generuje dźwięk. |
| SystemSwitchEnd | 21 | Użytkownik zwolnił ALT+TAB. System wysyła |
| SystemSwitchStart | 20 | Użytkownik nacisnął klawisz ALT+TAB, który aktywuje okno przełącznika. Jeśli tylko jedna aplikacja jest uruchomiona, gdy użytkownik naciśnie klawisze ALT+TAB, system zgłasza |
| ValueChange | 32782 | Właściwość obiektu została zmieniona Value . System zgłasza |
Przykłady
W poniższym przykładzie kodu pokazano tworzenie kontrolki wykresu obsługującego ułatwienia dostępu przy użyciu AccessibleObject klas i Control.ControlAccessibleObject w celu uwidocznienia dostępnych informacji. Kontrolka wykreśli dwie krzywe wraz z legendą. Klasa ChartControlAccessibleObject , która pochodzi z ControlAccessibleObjectklasy , jest używana w metodzie CreateAccessibilityInstance w celu zapewnienia niestandardowych informacji dostępnych dla kontrolki wykresu. Ponieważ legenda wykresu nie jest rzeczywistą Control kontrolką opartą na wykresie, ale zamiast tego jest rysowana przez kontrolkę wykresu, nie zawiera żadnych wbudowanych informacji dostępnych. W związku z tym ChartControlAccessibleObject klasa zastępuje metodę GetChild , aby zwrócić CurveLegendAccessibleObject element reprezentujący dostępne informacje dla każdej części legendy. Gdy ta kontrolka jest używana przez aplikację z ułatwieniami dostępu, kontrolka może dostarczać niezbędne dostępne informacje.
W tym przykładzie AccessibleEvents pokazano użycie wyliczenia z AccessibilityNotifyClients metodą . Zobacz omówienie klasy, AccessibleObject aby zapoznać się z kompletnym przykładem kodu.
// 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
Uwagi
Aplikacje systemu operacyjnego i serwera ułatwień dostępu generują zdarzenia ułatwień dostępu w odpowiedzi na zmiany w interfejsie użytkownika.
To wyliczenie jest używane przez AccessibleObject i Control.
Aby uzyskać więcej informacji, zobacz Microsoft Active Accessibility (Ułatwienia dostępu w usłudze Microsoft Active).