Udostępnij za pośrednictwem


AccessibleEvents Wyliczenie

Definicja

Określa zdarzenia zgłaszane przez aplikacje dostępne.

public enum class AccessibleEvents
public enum AccessibleEvents
type AccessibleEvents = 
Public Enum AccessibleEvents
Dziedziczenie
AccessibleEvents

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 AccessibleEvents.Hide wskazują, że ustawiono stan Invisible . W związku z tym serwery nie muszą wysyłać AccessibleEvents.StateChange zdarzenia w tym przypadku.

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 SelectionAdd lub SelectionRemove zdarzeń.

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 SystemMenuEnd . System nie wysyła zdarzenia spójnie.

Aby wywołać metodę TrackPopupMenu(), klient zobaczy, co następuje EVENT_SYSTEM_MENUSTART niemal natychmiast EVENT_SYSTEM_MENUPOPUPSTART po wyświetlonym oknie podręcznym.

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ę TrackPopupMenu(), klient zobaczy, co następuje EVENT_SYSTEM_MENUSTART niemal natychmiast EVENT_SYSTEM_MENUPOPUPSTART po wyświetlonym oknie podręcznym.

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 MenuStart zdarzenie, które może lub nie ma odpowiedniego MenuEnd zdarzenia.

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 SwitchEnd zdarzenie; serwery nigdy nie wysyłają tego zdarzenia. Jeśli tylko jedna aplikacja jest uruchomiona, gdy użytkownik naciska klawisze ALT+TAB, system wysyła SwitchEnd zdarzenie bez odpowiedniego SwitchStart zdarzenia.

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 SwitchEnd zdarzenie bez odpowiedniego SwitchStart zdarzenia.

ValueChange 32782

Właściwość obiektu została zmieniona Value . System zgłasza ValueChange zdarzenie dla następujących elementów interfejsu użytkownika: kontrolka edycji, kontrolka nagłówka, kontrolka klawisza dostępu, kontrolka paska postępu, pasek przewijania, kontrolka suwaka i kontrolka w górę. Aplikacje serwera wysyłają to zdarzenie dla ich dostępnych obiektów.

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

Dotyczy

Zobacz też