Typ kontrolki Suwak
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla suwaka typu kontrolki.
Kontrolka suwaka to kontrolka złożona z przyciskami, które umożliwiają użytkownikowi ustawianie zakresu liczbowego lub wybieranie z zestawu elementów.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Slider. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek suwaka, 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 suwaka 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 |
|---|---|
|
|
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 suwaka. 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. | Większość kontrolek suwaka musi zwrócić błąd UIA_E_NOCLICKABLEPOINT, ponieważ cały prostokąt ograniczenia kontrolki suwaka jest zajmowany przez kontrolki podrzędne. |
| UIA_ControlTypePropertyId | suwaka | Ta wartość jest taka sama dla wszystkich struktur. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka suwaka jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka suwaka 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ść. Elementy podrzędne (przyciski i kciuk) kontrolki suwaka nigdy nie powinny mieć fokusu. Fokus powinien zawsze pozostać na samym kontrolce suwaka. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa skojarzona z kontrolką, ta właściwość musi uwidocznić odwołanie do tej kontrolki. Jeśli kontrolka tekstu jest podskładem innej kontrolki, nie będzie miała ustawionej właściwości LabeledBy. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki suwaka . Wartość domyślna to "slider" dla en-US lub angielskiego (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Nazwa kontrolki suwaka jest zwykle generowana na podstawie statycznej etykiety tekstowej. Jeśli nie ma statycznej etykiety tekstowej, wartość właściwości Name musi zostać przypisana przez dewelopera aplikacji. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki suwaka. 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 | Suwak powinien obsługiwać wzorzec kontrolki RangeValue, jeśli zawartość może być ustawiona na wartość w zakresie liczbowym. |
| ISelectionProvider | Zależy | Suwak powinien obsługiwać wzorzec kontrolki wybór, jeśli zawartość reprezentuje jedną wartość między dyskretnym zestawem opcji. Gdy wzorzec kontrolki Wybór jest obsługiwany, odpowiednie zaznaczenie musi być uwidocznione jako co najmniej jeden podrzędny element listy suwaka. |
| IValueProvider | Zależy | Suwak powinien obsługiwać wzorzec kontrolki Wartość, jeśli zawartość reprezentuje jedną wartość między dyskretnym zestawem opcji. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek suwaka. 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 | 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