Typ kontrolki ScrollBar
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla ScrollBar typu kontrolki.
Kontrolki paska przewijania umożliwiają użytkownikowi przewijanie zawartości w kontenerze okna lub elementu. Kontrolka składa się z zestawu przycisków i kontrolki kciuka.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki ScrollBar. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek paska przewijania, 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 odnoszącego się do kontrolek paska przewijania 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.
| Widok kontrolki | Widok zawartości |
|---|---|
|
Nie dotyczy. (Kontrolka paska przewijania nie ma zawartości). |
Kontrolka paska przewijania może mieć od zera do pięciu elementów podrzędnych. Ponieważ poddrzewo ma więcej niż jedną kontrolkę przycisku, element musi ustawić konkretną wartość UIA_AutomationIdPropertyId dla każdego elementu, aby umożliwić ich odnajdywanie w przypadku narzędzi do testowania automatycznego.
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 istotne dla kontrolek paska przewijania. Należy pamiętać, że kontrolka paska przewijania nigdy nie ma zawartości; jego funkcjonalność jest widoczna za pośrednictwem wzorca kontrolki przewijania przewijania, który jest obsługiwany w przewijanym kontenerze.
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 | Nan | Kontrolka paska przewijania nie ma punktów, które można klikać. |
| UIA_ControlTypePropertyId | pasek przewijania | Ta wartość jest taka sama dla wszystkich struktur. Paski przewijania, które działają jako suwaki, muszą używać suwaka typu kontrolki. |
| UIA_IsContentElementPropertyId | FAŁSZYWY | Kontrolka paska przewijania nigdy nie jest elementem zawartości. Jeśli pasek przewijania jest autonomiczną kontrolką, musi spełniać typ kontrolki suwaka i zwracać UIA_SliderControlTypeIddla właściwości IUIAutomationElement::CurrentControlType (lub CachedControlType). |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka paska przewijania 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 paska przewijania rzadko zajmuje fokus, ale gdy tak, fokus powinien pozostać na samej kontrolce paska przewijania, a nie na przyciskach podrzędnych lub kciuk. Użytkownik powinien mieć możliwość wykonywania wszystkich akcji przewijania przy użyciu STRZAŁKA W GÓRĘ i STRZAŁKA W DÓŁ (lub STRZAŁKA W PRAWO i STRZAŁKA W LEWO) albo PAGE UP i PAGE DOWN. |
| UIA_LabeledByPropertyId | ZERO | Paski przewijania nie mają etykiet. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki ScrollBar. Wartość domyślna to "pasek przewijania" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | ZERO | Kontrolka paska przewijania nie ma elementów zawartości, a właściwość UIA_NamePropertyId nie jest wymagana do ustawienia. |
| UIA_OrientationPropertyId | Zobacz uwagi. | Kontrolka paska przewijania musi zawsze uwidaczniać orientację poziomą lub pionową. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki paska przewijania. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
Nuta
Gdy pasek przewijania jest używany jako kontrolka tylko do manipulowania myszą, nie obsługuje wzorców sterowania. Jeśli jest on używany jako kontrolka suwaka w aplikacji, musi mieć suwaka typ kontrolki.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IRangeValueProvider | Zależy | Wzorzec kontrolki RangeValue jest wymagany do obsługi tylko wtedy, gdy wzorzec kontrolki przewijania nie jest obsługiwany na kontenerze zawierającym pasek przewijania. |
| IScrollProvider | Nigdy | Wzorzec sterowania przewijania nigdy nie jest bezpośrednio obsługiwany na pasku przewijania. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek paska przewijania. 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 | |
| UIA_RangeValueValuePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki RangeValue, musi obsługiwać to zdarzenie. |
Tematy pokrewne