Przegląd zdarzeń automatyzacji interfejsu użytkownika
Uwaga
Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacja interfejsu użytkownika zdefiniowanych w System.Windows.Automation przestrzeni nazw. Aby uzyskać najnowsze informacje na temat automatyzacja interfejsu użytkownika, zobacz Interfejs API usługi Windows Automation: automatyzacja interfejsu użytkownika.
Powiadomienie o zdarzeniach automatyzacja interfejsu użytkownika firmy Microsoft jest kluczową funkcją dla technologii pomocniczych, takich jak czytniki ekranu i lupy ekranu. Te automatyzacja interfejsu użytkownika klienci śledzą zdarzenia zgłaszane przez dostawców automatyzacja interfejsu użytkownika, gdy coś się dzieje w interfejsie użytkownika i używają informacji w celu powiadamiania użytkowników końcowych.
Wydajność jest ulepszana przez umożliwienie aplikacjom dostawcy selektywnego zgłaszania zdarzeń, w zależności od tego, czy wszyscy klienci są subskrybowani tymi zdarzeniami, czy w ogóle nie, jeśli żaden klient nie nasłuchuje żadnych zdarzeń.
Typy zdarzeń
automatyzacja interfejsu użytkownika zdarzenia należą do następujących kategorii.
| Wydarzenie | opis |
|---|---|
| Zmiana właściwości | Zgłaszane, gdy zmienia się właściwość elementu automatyzacja interfejsu użytkownika lub wzorca kontrolki. Jeśli na przykład klient musi monitorować kontrolkę pola wyboru aplikacji, może zarejestrować się w celu nasłuchiwania zdarzenia zmiany właściwości we ToggleState właściwości. Gdy kontrolka pola wyboru jest zaznaczona lub niezaznaczone, dostawca zgłasza zdarzenie, a klient może działać zgodnie z potrzebami. |
| Akcja elementu | Zgłaszane, gdy zmiana interfejsu użytkownika wynika z działania użytkownika końcowego lub programowego; na przykład po kliknięciu lub wywołaniu przycisku za pomocą polecenia InvokePattern. |
| Zmiana struktury | Podniesione, gdy zmienia się struktura drzewa automatyzacja interfejsu użytkownika. Struktura zmienia się, gdy nowe elementy interfejsu użytkownika staną się widoczne, ukryte lub usunięte na pulpicie. |
| Zmiana pulpitu globalnego | Zgłaszane, gdy wystąpią akcje globalnego zainteresowania klienta, takie jak przesunięcie fokusu z jednego elementu na inny lub zamknięcie okna. |
Niektóre zdarzenia nie muszą oznaczać, że stan interfejsu użytkownika uległ zmianie. Jeśli na przykład użytkownik kartuje pole wprowadzania tekstu, a następnie klika przycisk w celu zaktualizowania pola, zostanie TextChangedEvent zgłoszony nawet wtedy, gdy użytkownik nie zmienił tekstu. Podczas przetwarzania zdarzenia może być konieczne, aby aplikacja kliencka mogła sprawdzić, czy wszystko zostało rzeczywiście zmienione przed podjęciem akcji.
Następujące zdarzenia mogą być wywoływane nawet wtedy, gdy stan interfejsu użytkownika nie uległ zmianie.
AutomationPropertyChangedEvent(w zależności od właściwości, która uległa zmianie)ElementSelectedEventInvalidatedEventTextChangedEvent
identyfikatory zdarzeń automatyzacja interfejsu użytkownika
Zdarzenia automatyzacja interfejsu użytkownika firmy Microsoft są identyfikowane przez AutomationEvent obiekty. Właściwość Id zawiera wartość, która jednoznacznie identyfikuje rodzaj zdarzenia.
Możliwe wartości Id są podane w poniższej tabeli wraz z typem używanym dla argumentów zdarzeń. Należy pamiętać, że identyfikatory używane przez klientów i dostawców są identycznie nazwane pola z różnych klas.
argumenty zdarzeń automatyzacja interfejsu użytkownika
Następujące klasy hermetyzują argumenty zdarzeń.
| Klasa | opis |
|---|---|
| AsyncContentLoadedEventArgs | Zawiera informacje dotyczące asynchronicznego ładowania zawartości, w tym procent ukończonego ładowania. |
| AutomationEventArgs | Zawiera informacje o prostym zdarzeniu, które nie wymaga dodatkowych danych. |
| AutomationFocusChangedEventArgs | Zawiera informacje o zmianie fokusu wejściowego z jednego elementu na inny. Zdarzenia tego typu są zgłaszane przez system automatyzacja interfejsu użytkownika, a nie przez dostawców. |
| AutomationPropertyChangedEventArgs | Zawiera informacje o zmianie wartości właściwości elementu lub wzorca kontrolki. |
| StructureChangedEventArgs | Zawiera informacje o zmianie drzewa automatyzacja interfejsu użytkownika. |
| WindowClosedEventArgs | Zawiera informacje o zamykaniu okna. |
Wszystkie klasy argumentów zdarzeń zawierają element członkowski EventId . Ten identyfikator jest hermetyzowany w obiekcie AutomationEvent.
Obiekty używane do identyfikowania AutomationEvent zdarzeń są uzyskiwane przez dostawców z pól w AutomationElementIdentifiers klasach identyfikatorów wzorców kontrolek, takich jak DockPatternIdentifiers. Równoważne pola są uzyskiwane przez aplikacje klienckie z pól w AutomationElement klasach wzorców kontrolek, takich jak DockPattern.
Aby uzyskać listę identyfikatorów zdarzeń, zobacz automatyzacja interfejsu użytkownika Zdarzenia dla klientów.