Omówienie właściwości automatyzacji interfejsu użytkownika
Dostawcy automatyzacji interfejsu użytkownika firmy Microsoft uwidaczniają właściwości elementów automatyzacji interfejsu użytkownika. Właściwości umożliwiają aplikacjom klienckim pobieranie informacji o kontrolkach.
Automatyzacja interfejsu użytkownika uwidacznia dwa różne rodzaje właściwości: właściwości elementu automatyzacjii właściwości wzorca sterowania. Właściwości elementu automatyzacji składają się z wspólnego zestawu właściwości, takich jak Name, AcceleratorKey i ClassName, które są udostępniane przez wszystkie elementy automatyzacji interfejsu użytkownika, niezależnie od typu kontrolki. Większość właściwości elementu automatyzacji to wartości statyczne.
Właściwości wzorca kontrolki to te, które są udostępniane przez kontrolkę, która obsługuje określony wzorzec kontrolki. Każdy wzorzec kontrolki ma odpowiedni zestaw właściwości wzorca kontrolki, które kontrolka musi uwidocznić. Na przykład kontrolka obsługująca wzorzec kontrolki Grid uwidacznia właściwości ColumnCount i RowCount. Większość właściwości wzorca kontrolki to wartości dynamiczne.
Ten temat zawiera następujące sekcje.
- identyfikatory właściwości
- Wartości Właściwości
- właściwości i zdarzenia
- Tematy pokrewne
Identyfikatory właściwości
Każda właściwość jest identyfikowana przez PROPERTYID wartość liczbową nazywaną identyfikatorem właściwości (ID). Dostawcy i klienci używają identyfikatorów liczbowych w wywołaniach metod, takich jak IRawElementProviderAdviseEvents::AdviseEventAdded oraz IUIAutomationElement::GetCachedPropertyValue, aby identyfikować żądania właściwości. Aby uzyskać szczegółowy opis każdego identyfikatora właściwości automatyzacji interfejsu użytkownika, w tym typ danych i wartość domyślną każdej właściwości, zobacz Identyfikatory właściwości.
Wartości właściwości
Wszystkie właściwości są tylko do odczytu, chociaż niektóre można zmienić przy użyciu metod działających na kontrolce, takich jak IDockProvider::SetDockPosition (dostawca) lub IUIAutomationDockPattern::SetDockPosition (klient).
Aby uzyskać informacje na temat pobierania wartości właściwości, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
Właściwości i zdarzenia
Związane ściśle z właściwościami w automatyzacji interfejsu użytkownika jest pojęcie zdarzeń zmiany 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. Klienci mogą rejestrować się, aby nasłuchiwać zmian właściwości dla dowolnej właściwości.
Dostawcy zgłaszają zdarzenia, gdy coś się zmieni w interfejsie użytkownika. Jeśli na przykład pole wyboru jest zaznaczone lub czyszczone, zdarzenie zmiany właściwości jest wywoływane przez implementację dostawcy Przełącz wzorzec kontrolki. Dostawcy mogą selektywnie zgłaszać zdarzenia, w zależności od tego, czy klienci monitorują zdarzenia ogólne, czy określone zdarzenia.
Nie wszystkie zmiany właściwości powodują wywołanie zdarzeń; zależy to całkowicie od implementacji dostawcy automatyzacji interfejsu użytkownika dla danego elementu. Na przykład standardowe dostawcy serwera proxy dla pól listy nie zgłaszają zdarzenia zmiany właściwości, gdy właściwość wybierania ulega zmianie. W takim przypadku aplikacja musi nasłuchiwać zdarzenia zgłoszonego podczas zmiany wyboru (UIA_SelectionItem_ElementSelectedEventId).
Klienci nasłuchują zdarzeń, subskrybując je zgodnie z opisem w subskrybowanie zdarzeń automatyzacji interfejsu użytkownika. W przypadku zdarzeń zmiany właściwości klienci muszą zaimplementować IUIAutomationPropertyChangedEventHandler i przekazać interfejs do IUIAutomation::AddPropertyChangedEventHandler lub IUIAutomation::AddPropertyChangedEventHandlerNativeArray.
Tematy pokrewne
-
referencyjne
-
Koncepcyjny
-
Omówienie wzorców kontrolek automatyzacji interfejsu użytkownika
-
typy kontrolek automatyzacji interfejsu użytkownika — omówienie