Sdílet prostřednictvím


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á 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
  • Běhoun
    • Tlačítko (2 nebo 4)
    • Palec (1)
    • Položka seznamu (0 nebo více)
  • Běhoun
    • Položka seznamu (0 nebo více)

 

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.

 

koncepční

Přehled typů ovládacích prvků automatizace uživatelského rozhraní

Přehled automatizace uživatelského rozhraní