Typ ovládacího prvku CheckBox
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku CheckBox.
Zaškrtávací políčko je objekt sloužící k označení stavu, se kterým můžou uživatelé pracovat s cyklem v daném stavu. Zaškrtávací políčka buď představují binární (Ano/Ne), (Zapnuto/Vypnuto), nebo terciární možnost (Zapnuto, Vypnuto, Neurčito).
Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku CheckBox. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky zaškrtávacího políčka, 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í
- DefaultAction
- 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ů zaškrtávacích políček 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 typ ovládacího prvku CheckBox. 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. | Podporuje se, pokud existuje ohraničující obdélník. Pokud ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a prvek provádí specializované testování hitů, přepište a poskytněte kliknutelný bod. |
| UIA_ControlTypePropertyId | CheckBox | |
| UIA_IsContentElementPropertyId | PRAVDIVÝ | Hodnota této vlastnosti musí být vždy TRUE. To znamená, že ovládací prvek zaškrtávacího políčka musí být vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Hodnota této vlastnosti musí být vždy TRUE. To znamená, že ovládací prvek zaškrtávacího políčka musí být 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. |
| UIA_LabeledByPropertyId | Nula | Ovládací prvky zaškrtávacího políčka jsou samolepící. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku CheckBox. Výchozí hodnota je zaškrtávací políčko pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Hodnota vlastnosti ovládacího prvku zaškrtávacího políčka IUIAutomationElement::CurrentName (nebo CachedName) je text zobrazený vedle pole, které udržuje přepínací stav. |
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í být podporovány všemi ovládacími prvky zaškrtávacího políčka. 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 |
|---|---|---|
| IToggleProvider | Požadovaný | Zaškrtávací políčka podporují Přepnout vzor ovládacího prvku, aby bylo možné zaškrtávací políčko programově cyklicky procházet jeho interními stavy. |
Požadované události
Následující tabulka obsahuje seznam událostí automatizace uživatelského rozhraní, které jsou nutné k podpoře ovládacích prvků zaškrtávacího políčka. 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_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId událost změněnou vlastností. |
DefaultAction
Výchozí akcí zaškrtávacího políčka je, že přepínač se zaměří a přepnete jeho aktuální stav. Jak už bylo zmíněno dříve, zaškrtávací políčka buď představují binární (Ano/Ne, nebo Zapnuto/Vypnuto) rozhodnutí uživatele nebo terciární (Zapnuto, Vypnuto, Nedeterminate). Pokud je zaškrtávací políčko binární, výchozí akce způsobí, že se stav "zapnuto" stane "vypnuto" nebo "vypnuto". V terciárním zaškrtávacím políčku výchozí akce prochází stavy zaškrtávacího políčka ve stejném pořadí, jako kdyby uživatel odeslal po sobě jdoucí kliknutí myší na ovládací prvek.
Související témata