Typ ovládacího prvku Posuvník
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku Slider.
Posuvník je složený ovládací prvek s tlačítky, která uživateli umožňují nastavit číselnou oblast nebo vybrat ze sady položek.
Následující části definují požadovanou stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Slider. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky posuvníku, ve kterých architektura uživatelského rozhraní nebo platforma integruje podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků posuvníku a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
|
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky posuvníku. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | Viz poznámky. | Většina ovládacích prvků posuvníku musí vrátit chybu UIA_E_NOCLICKABLEPOINT, protože celý ohraničující obdélník ovládacího prvku posuvníku je obsazen podřízenými ovládacími prvky. |
| UIA_ControlTypePropertyId | posuvníku | Tato hodnota je stejná pro všechny architektury. |
| UIA_IsContentElementPropertyId | PRAVDIVÝ | Ovládací prvek posuvníku je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Posuvník je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. Děti (tlačítka a palec) ovládacího prvku posuvníku by nikdy neměly zabírat fokus. Fokus by měl vždy zůstat na samotném ovládacím prvku posuvníku. |
| UIA_LabeledByPropertyId | Viz poznámky. | Pokud je k ovládacímu prvku přidružený statický textový popisek, musí tato vlastnost vystavit odkaz na tento ovládací prvek. Pokud je textový ovládací prvek dílčí součástí jiného ovládacího prvku, nebude mít nastavenou vlastnost LabeledBy. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku Slider. Výchozí hodnota je posuvník pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Název ovládacího prvku posuvníku se obvykle generuje ze statického textového popisku. Pokud není popisek statického textu, musí vývojář aplikace přiřadit hodnotu vlastnosti Název. |
Požadované vzory ovládacích prvků
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky posuvníku. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vlastnost vzoru ovládacího prvku nebo vzoru | Podpora/hodnota | Poznámky |
|---|---|---|
| IRangeValueProvider | Závisí | Posuvník by měl podporovat RangeValue vzor ovládacího prvku, pokud lze obsah nastavit na hodnotu v číselném rozsahu. |
| ISelectionProvider | Závisí | Posuvník by měl podporovat Výběr řídicí vzor, pokud obsah představuje jednu hodnotu mezi diskrétní sadou možností. Pokud je podporován vzor ovládacího prvku Výběr, musí být odpovídající výběr vystaven jako jedna nebo více podřízených položek seznamu posuvníku. |
| IValueProvider | Závisí | Posuvník by měl podporovat Hodnotu řídicí vzor, pokud obsah představuje jednu hodnotu mezi diskrétní sadou možností. |
Požadované události
V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které ovládací prvky posuvníku vyžadují pro podporu. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.
| Událost automatizace uživatelského rozhraní | Poznámky |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_RangeValueValuePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje RangeValue vzor ovládacího prvku, musí tuto událost podporovat. |
| UIA_Selection_InvalidatedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Výběr, musí tuto událost podporovat. |
| UIA_StructureChangedEventId | |
| UIA_ValueValuePropertyId událost změny vlastnosti. | Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota, musí tuto událost podporovat. |
Související témata