Typ kontrolki kciuka
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki Thumb.
Kontrolki kciuka zapewniają funkcjonalność umożliwiającą przenoszenie kontrolki (lub przeciąganie), takie jak przycisk paska przewijania lub zmiana rozmiaru, na przykład widżet zmiany rozmiaru okna. Należy pamiętać, że kontrolka kciuka nie zapewnia funkcji przeciągania i upuszczania. Kontrolki kciuka mogą odbierać fokus myszy, ale nie fokus klawiatury. Deweloper kontrolki musi zaimplementować kontrolkę, aby działał odpowiednio (można przeciągnąć lub zmienić jej rozmiar).
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce sterowania i zdarzenia dla typu kontrolki Thumb. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek kciuka, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek
- wymagane zdarzenia
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika, który odnosi się do kontrolek kciuka i opisuje, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
|
(Nie dotyczy) |
Kontrolki kciuka nigdy nie są wyświetlane w widoku zawartości, ponieważ istnieją tylko do manipulowania myszą. Są one widoczne, choć inny wzorzec kontrolki, taki jak wzorzec kontrolki przewijania, Transform, lub wzorzec kontrolki RangeValue obsługiwany w kontenerze kontrolki kciuka.
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek kciuka. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_AutomationIdPropertyId | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa wśród wszystkich elementów równorzędnych w nieprzetworzonym widoku drzewa automatyzacji interfejsu użytkownika. |
| UIA_BoundingRectanglePropertyId | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Punkt w widocznym obszarze klienta kontrolki kciuka. |
| UIA_ControlTypePropertyId | thumb | |
| UIA_IsContentElementPropertyId | FAŁSZYWY | Kontrolka kciuka nigdy nie jest uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka kciuka jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. Kontrolka kciuka może odbierać fokus, jeśli jest on używany jako obiekt "uchwytu" do określania rozmiaru okna lub okienka. Kontrolka kciuka na suwaku lub pasku przewijania nigdy nie powinna otrzymywać fokusu. |
| UIA_LabeledByPropertyId | ZERO | Kontrolki kciuka nigdy nie mają etykiety. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Thumb. Wartość domyślna to "thumb" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | ZERO | Ponieważ kontrolka kciuka nie jest dostępna w widoku zawartości drzewa automatyzacji interfejsu użytkownika, nie wymaga nazwy. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki kciuka. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| ITransformProvider | Wymagane | Umożliwia przeniesienie kontrolki kciuka na ekranie. Ponieważ kontrolka kciuka zwykle nie może być zmieniana ani obracana, wzorzec sterowania Transform obsługuje przede wszystkim funkcję Move. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek kciuka. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId |
Tematy pokrewne