Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Uwaga / Notatka
Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: Automatyzacja interfejsu użytkownika.
Powiadomienie o zdarzeniach automatyzacji interfejsu użytkownika firmy Microsoft to kluczowa funkcja dla technologii pomocniczych, takich jak czytniki ekranu i lupy ekranu. Ci klienci automatyzacji interfejsu użytkownika śledzą zdarzenia zgłaszane przez dostawców automatyzacji 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 poprawiana przez umożliwienie aplikacjom dostawcy selektywnego zgłaszania zdarzeń, w zależności od tego, czy jacyś klienci subskrybują te zdarzenia, lub całkowitego ich pominięcia, jeśli żaden klient nie nasłuchuje na żadne zdarzenia.
Typy zdarzeń
Zdarzenia automatyzacji interfejsu użytkownika należą do następujących kategorii.
| Zdarzenie | Opis |
|---|---|
| Zmiana własności | Zgłaszane, gdy zmienia się właściwość elementu automatyzacji 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 ToggleState. Gdy kontrolka pola wyboru jest zaznaczona lub odznaczona, dostawca zgłasza zdarzenie, a klient może działać zgodnie z potrzebami. |
| Akcja elementu | Występuje, gdy zmiana w interfejsie użytkownika jest wynikiem działań użytkownika końcowego lub programowych; na przykład, gdy przycisk zostanie kliknięty lub wywołany za pomocą InvokePattern. |
| Zmiana struktury | Podniesione, gdy zmienia się struktura drzewa automatyzacji 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łoszenie następuje, gdy dochodzi do działań istotnych dla klienta na poziomie globalnym, takich jak zmiana fokusu z jednego elementu na inny lub zamknięcie okna. |
Niektóre zdarzenia nie muszą oznaczać, że stan interfejsu użytkownika uległ zmianie. Na przykład, jeśli użytkownik przechodzi za pomocą klawisza Tab do pola wprowadzania tekstu, a następnie kliknie przycisk, aby zaktualizować pole, zdarzenie TextChangedEvent jest zgłaszane, nawet jeśli użytkownik faktycznie 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ń automatyzacji interfejsu użytkownika
Zdarzenia automatyzacji 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 to pola o identycznych nazwach, które pochodzą z różnych klas.
Argumenty zdarzeń automatyzacji 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ą wywoływane przez system automatyzacji 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 automatyzacji interfejsu użytkownika. |
| WindowClosedEventArgs | Zawiera informacje o zamykaniu okna. |
Wszystkie klasy argumentów zdarzeń zawierają członek EventId. Ten identyfikator jest zamknięty w tagu 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 oraz klas wzorców kontrolek, takich jak DockPattern.
Aby uzyskać listę identyfikatorów zdarzeń, zobacz Zdarzenia automatyzacji interfejsu użytkownika dla klientów.