Przegląd właściwości 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.
automatyzacja interfejsu użytkownika dostawcy uwidaczniają właściwości elementów automatyzacja interfejsu użytkownika firmy Microsoft. Te właściwości umożliwiają automatyzacja interfejsu użytkownika aplikacjom klienckim odnajdywanie informacji na temat elementów interfejsu użytkownika, zwłaszcza kontrolek, w tym danych statycznych i dynamicznych.
Ta sekcja zawiera szerokie omówienie właściwości usługi Microsoft automatyzacja interfejsu użytkownika. Bardziej szczegółowe informacje podano w następujących tematach:
Właściwości automatyzacji interfejsu użytkownika dla klientów
Implementacja dostawcy automatyzacji interfejsu użytkownika po stronie serwera
Identyfikatory właściwości
Każda właściwość jest identyfikowana przez liczbę i nazwę. Nazwy właściwości są używane tylko do debugowania i diagnostyki. Dostawcy używają identyfikatorów liczbowych do identyfikowania przychodzących żądań właściwości. Aplikacje klienckie używają jednak tylko metody AutomationProperty, która hermetyzuje liczbę i nazwę, aby zidentyfikować właściwości, które mają zostać pobrane.
AutomationProperty obiekty reprezentujące określone właściwości są dostępne jako pola w różnych klasach. Ze względów bezpieczeństwa dostawcy automatyzacja interfejsu użytkownika uzyskują te obiekty z oddzielnego zestawu klas zawartych w Uiautomationtypes.dll.
Poniższa tabela kategoryzuje właściwości według klas zawierających AutomationPropertyidentyfikatory.
| Rodzaje właściwości | Klienci uzyskują identyfikatory z | Dostawcy uzyskują identyfikatory z |
|---|---|---|
| Właściwości wspólne dla wszystkich elementów (zobacz poniższe tabele) | AutomationElement | AutomationElementIdentifiers |
| Położenie okna dokowania | DockPattern | DockPatternIdentifiers |
| Stan elementu, który może rozwinąć i zwinąć | ExpandCollapsePattern | ExpandCollapsePatternIdentifiers |
| Właściwości elementu w siatce | GridItemPattern | GridItemPatternIdentifiers |
| Właściwości siatki | GridPattern | GridPatternIdentifiers |
| Bieżący i obsługiwany widok elementu, który ma wiele widoków | MultipleViewPattern | MultipleViewPatternIdentifiers |
| Właściwości elementu, który przenosi się na zakres wartości, na przykład suwak | RangeValuePattern | RangeValuePatternIdentifiers |
| Właściwości okna przewijania | ScrollPattern | ScrollPatternIdentifiers |
| Stan i kontener elementu, który można wybrać, jak na liście | SelectionItemPattern | SelectionItemPatternIdentifiers |
| Właściwości kontrolki zawierającej elementy wyboru | SelectionPattern | SelectionPatternIdentifiers |
| Nagłówki kolumn i wierszy elementu w tabeli | TableItemPattern | TableItemPatternIdentifiers |
| Nagłówki kolumn i wierszy oraz orientacja tabeli | TablePattern | TablePatternIdentifiers |
| Stan kontrolki przełącznika | TogglePattern | TogglePatternIdentifiers |
| Możliwości elementu, który można przenosić, obracać lub zmieniać rozmiar | TransformPattern | TransformPatternIdentifiers |
| Możliwości odczytu/zapisu i wartości elementu, który ma wartość | ValuePattern | ValuePatternIdentifiers |
| Możliwości i stan okna | WindowPattern | WindowPatternIdentifiers |
Właściwości według kategorii
Poniższe tabele kategoryzują właściwości, których identyfikatory znajdują się w elementach AutomationElement i AutomationElementIdentifiers. Te właściwości są wspólne dla wszystkich kontrolek. Wszystkie, ale kilka z nich może być statyczne w okresie istnienia aplikacji dostawcy; większość właściwości dynamicznych jest skojarzona ze wzorcami kontrolek.
Kolumna Dostęp do właściwości zawiera listę innych metod dostępu dla każdej właściwości, oprócz GetCurrentPropertyValue i GetCachedPropertyValue. Aby uzyskać więcej informacji na temat pobierania właściwości w aplikacji klienckiej, zobacz automatyzacja interfejsu użytkownika Właściwości dla klientów.
Uwaga
Aby uzyskać szczegółowe informacje o każdej właściwości, postępuj zgodnie z linkiem w kolumnie Dostęp do właściwości.
Właściwości wyświetlania
| Identyfikator właściwości | Dostęp do właściwości |
|---|---|
| BoundingRectangleProperty | BoundingRectangle |
| CultureProperty | nie dotyczy |
| HelpTextProperty | HelpText |
| IsOffscreenProperty | IsOffscreen |
| OrientationProperty | Orientation |
Typ elementu
| Identyfikator właściwości | Dostęp do właściwości |
|---|---|
| ControlTypeProperty | ControlType |
| IsContentElementProperty | IsContentElement |
| IsControlElementProperty | IsControlElement |
| ItemTypeProperty | ItemType |
| LocalizedControlTypeProperty | LocalizedControlType |
Identyfikator
| Identyfikator właściwości | Dostęp do właściwości |
|---|---|
| AutomationIdProperty | AutomationId |
| ClassNameProperty | ClassName |
| FrameworkIdProperty | FrameworkId |
| LabeledByProperty | LabeledBy |
| NameProperty | Name |
| ProcessIdProperty | ProcessId |
| RuntimeIdProperty | GetRuntimeId |
| NativeWindowHandleProperty | NativeWindowHandle |
Interakcja
| Identyfikator właściwości | Dostęp do właściwości |
|---|---|
| AcceleratorKeyProperty | AcceleratorKey |
| AccessKeyProperty | AccessKey |
| ClickablePointProperty | GetClickablePoint |
| HasKeyboardFocusProperty | HasKeyboardFocus |
| IsEnabledProperty | IsEnabled |
| IsKeyboardFocusableProperty | IsKeyboardFocusable |
Obsługa wzorców
Różne
| Identyfikator właściwości | Dostęp do właściwości |
|---|---|
| IsRequiredForFormProperty | IsRequiredForForm |
| IsPasswordProperty | IsPassword |
| ItemStatusProperty | ItemStatus |
Lokalizacja
automatyzacja interfejsu użytkownika dostawcy powinni przedstawić następujące właściwości w języku systemu operacyjnego:
Właściwości i zdarzenia
Ściśle powiązane z właściwościami w automatyzacja interfejsu użytkownika jest pojęcie zdarzeń zmienionych właściwości. W przypadku właściwości dynamicznych aplikacja kliencka musi wiedzieć, że wartość właściwości uległa zmianie, aby mogła zaktualizować pamięć podręczną informacji lub zareagować na nowe informacje w inny sposób.
Dostawcy zgłaszają zdarzenia, gdy coś się zmieni w interfejsie użytkownika. Jeśli na przykład pole wyboru jest zaznaczone lub wyczyszczone, zdarzenie zmiany właściwości jest wywoływane przez implementację wzorca przełącznika dostawcy. Dostawcy mogą selektywnie zgłaszać zdarzenia, w zależności od tego, czy klienci nasłuchują zdarzeń, czy nasłuchują określonych zdarzeń.
Nie wszystkie zmiany właściwości wywołują zdarzenia; jest to całkowicie do wdrożenia dostawcy automatyzacja interfejsu użytkownika dla elementu. Na przykład standardowi dostawcy serwera proxy dla pól listy nie zgłaszają zdarzenia podczas SelectionProperty wprowadzania zmian. W takim przypadku aplikacja musi nasłuchiwać elementu ElementSelectedEvent.
Klienci nasłuchują zdarzeń, subskrybując je. Subskrybowanie zdarzeń oznacza utworzenie metod delegowanych, które mogą obsługiwać zdarzenia, a następnie przekazanie metod do automatyzacja interfejsu użytkownika wraz z określonymi zdarzeniami, które będą traktowane w tych metodach. W przypadku zdarzeń zmienionych właściwości w szczególności klienci muszą zaimplementować program AutomationPropertyChangedEventHandler.
Zobacz też
- Buforowanie w klientach automatyzacji interfejsu użytkownika
- Właściwości automatyzacji interfejsu użytkownika dla klientów
- Implementacja dostawcy automatyzacji interfejsu użytkownika po stronie serwera
- Znajdź element automatyzacji interfejsu użytkownika na podstawie warunku właściwości
- Zwracanie właściwości od dostawcy automatyzacji interfejsu użytkownika
- Wywoływanie zdarzeń od dostawcy automatyzacji interfejsu użytkownika