Typ kontrolki pokrętła
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla spinner typu sterowania.
Kontrolki pokrętła służą do wybierania z domeny elementów lub zakresu liczb.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla spinner typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek spinner, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców sterowania.
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óre odnoszą się do kontrolek pokrętła, gdy obsługują one RangeValue i Selection wzorce kontrolek i opisano, 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.
wzorzec kontrolki RangeValue
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
wzorzec kontrolki wybór
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Aby upewnić się, że dwa przyciski w poddrzewie widoku sterowania można odróżnić za pomocą narzędzi do testowania automatycznego, przypisz odpowiednio wartość ScrollAmount_SmallIncrement lub ScrollAmount_SmallDecrement do właściwości AutomationId. W przypadku niektórych implementacji skojarzona kontrolka edycji może być elementem równorzędnym kontrolki pokrętła.
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 pokrętła. 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 klikalny kontrolki pokrętła koncentruje się na edytowanej części kontrolki. |
| UIA_ControlTypePropertyId | pokrętła | Ta wartość jest taka sama dla wszystkich struktur. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka pokrętła musi zawsze być zawartością. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka pokrętła musi być zawsze kontrolką. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. Kontrolka spinner rzadko skupia się, ale gdy tak, fokus powinien pozostać na samej kontrolce pokrętła, a nie na przyciskach podrzędnych. Użytkownik powinien mieć możliwość wykonywania wszystkich akcji przewijania przy użyciu STRZAŁKA W GÓRĘ i STRZAŁKA W DÓŁ. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Kontrolki pokrętła mają statyczną etykietę tekstową. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający spinnerowi typu kontrolki. Wartość domyślna to "spinner" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Kontrolka pokrętła zwykle pobiera nazwę ze statycznej etykiety tekstowej. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki pokrętła. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec/wzorzec kontrolki, właściwość | Pomoc techniczna/wartość | Notatki |
|---|---|---|
| IRangeValueProvider | Zależy | Kontrolki pokrętła obejmujące zakres liczbowy mogą obsługiwać wzorzec sterowania RangeValue. |
| ISelectionProvider | Zależy | Kontrolki pokrętła z listą elementów do wybrania muszą obsługiwać wzorzec kontrolki Selection. |
| CanSelectMultiple | FAŁSZYWY | Kontrolki pokrętła są zawsze pojedynczymi kontenerami wyboru. |
| IValueProvider | Zależy | Kontrolki pokrętła obejmujące zestaw opcji lub liczb mogą obsługiwać wzorzec kontrolki Wartość. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek pokrętła. 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_RangeValueValuePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki RangeValue, musi obsługiwać to zdarzenie. |
| UIA_Selection_InvalidatedEventId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki Selection, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId | |
| UIA_ValueValuePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki Value, musi obsługiwać to zdarzenie. |
Tematy pokrewne