Udostępnij za pośrednictwem


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:

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

Identyfikator właściwości Dostęp do właściwości
IsDockPatternAvailableProperty GetSupportedPatterns
IsExpandCollapsePatternAvailableProperty GetSupportedPatterns
IsGridItemPatternAvailableProperty GetSupportedPatterns
IsGridPatternAvailableProperty GetSupportedPatterns
IsInvokePatternAvailableProperty GetSupportedPatterns
IsMultipleViewPatternAvailableProperty GetSupportedPatterns
IsRangeValuePatternAvailableProperty GetSupportedPatterns
IsScrollItemPatternAvailableProperty GetSupportedPatterns
IsScrollPatternAvailableProperty GetSupportedPatterns
IsSelectionItemPatternAvailableProperty GetSupportedPatterns
IsSelectionPatternAvailableProperty GetSupportedPatterns
IsTableItemPatternAvailableProperty GetSupportedPatterns
IsTablePatternAvailableProperty GetSupportedPatterns
IsTextPatternAvailableProperty GetSupportedPatterns
IsTogglePatternAvailableProperty GetSupportedPatterns
IsTransformPatternAvailableProperty GetSupportedPatterns
IsValuePatternAvailableProperty GetSupportedPatterns
IsWindowPatternAvailableProperty GetSupportedPatterns

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ż