Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku CheckBox

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku CheckBox. V automatizaci uživatelského rozhraní je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splnit, aby bylo možné vlastnost použít ControlTypeProperty . Podmínky zahrnují specifické pokyny pro strukturu stromu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní a vzory ovládacích prvků.

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, ať už windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků zaškrtávacího políčka, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní najdete v tématu Přehled stromu automatizace uživatelského rozhraní.

Zobrazení ovládacího prvku	Zobrazení obsahu
Zaškrtávací políčko	Zaškrtávací políčko

Poznámka:

Zaškrtávací políčka nikdy nemají podřízené prvky v rámci ovládacího nebo obsahového zobrazení. Pokud ovládací prvek potřebuje obsahovat podřízené prvky, znamená to, že by měl být použit jiný typ ovládacího prvku.

Požadované vlastnosti automatizace uživatelského rozhraní

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky zaškrtávacího políčka. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnost automatizace uživatelského rozhraní	Hodnota	Poznámky
AutomationIdProperty	Viz poznámky.	Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci.
BoundingRectangleProperty	Viz poznámky.	Vnější obdélník, který obsahuje celý ovládací prvek.
ClickablePointProperty	Viz poznámky.	Podporuje se, pokud existuje ohraničující obdélník. Pokud není každý bod uvnitř ohraničujícího obdélníku kliknutelný a provádíte specializované testování zásahů, můžete přepsat a poskytnout kliknutelný bod.
ControlTypeProperty	Zaškrtávací políčko	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
IsContentElementProperty	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í.
IsControlElementProperty	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í.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
LabeledByProperty	Null	Zaškrtávací políčka jsou ovládací prvky, které se samy označují.
LocalizedControlTypeProperty	"zaškrtávací políčko"	Lokalizovaný řetězec odpovídající typu ovládacího prvku CheckBox.
NameProperty	Viz poznámky.	Hodnota vlastnosti ovládacího prvku Name zaškrtávacího políčka je text, který se zobrazí vedle pole, které udržuje stav přepínače.

Požadované vzory ovládacích prvků automatizace uživatelského rozhraní

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ů naleznete v tématu Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Vzor ovládacího prvku	Podpora	Poznámky
IToggleProvider	Povinné	Umožňuje zaškrtávacímu políčku procházet cykly jeho interních stavů programově.

Požadované události automatizace uživatelského rozhraní

V následující tabulce jsou uvedeny události 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 událostech naleznete v tématu Přehled událostí automatizace uživatelského rozhraní.

Událost automatizace uživatelského rozhraní	Podpora	Poznámky
AutomationFocusChangedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné
ToggleStateProperty událost změny vlastnosti.	Povinné	Žádné

Výchozí akce

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) (Zapnuto/Vypnuto) rozhodnutí uživatele nebo terciární (Zapnuto, Vypnuto, Neurčeno). 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 stavu cykluje výchozí akce stavů možností zaškrtávacího políčka ve stejném pořadí, jako kdyby uživatel kliknul na ovládací prvek po sobě jdoucími kliknutími myší.

Viz také

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