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 model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.
Toto téma obsahuje informace o podpoře microsoft model UI Automation pro typ ovládacího prvku CheckBox. V model UI Automation je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splňovat, aby bylo možné vlastnost použítControlTypeProperty. Podmínky zahrnují specifické pokyny pro strukturu stromové struktury model UI Automation, model UI Automation hodnoty vlastností 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 model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku CheckBox. Požadavky na model UI Automation platí pro všechny ovládací prvky zaškrtávacího políčka, ať už windows Presentation Foundation (WPF), Win32 nebo model Windows Forms.
Požadovaná struktura stromu model UI Automation
Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu model UI Automation, 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 model UI Automation naleznete v tématu model UI Automation Strom přehledu.
| 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 ovládacím prvku nebo zobrazení obsahu. 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 model UI Automation
Následující tabulka uvádí model UI Automation vlastnosti, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky zaškrtávacího políčka. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| 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 ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a provést specializované testování hitů, pak 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 | True | 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 model UI Automation stromu. |
| IsControlElementProperty | True | 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í ovládacího prvku strom model UI Automation. |
| 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 samoznačky. |
| 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ů model UI Automation
Následující tabulka uvádí model UI Automation vzory ovládacích prvků, 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 model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| IToggleProvider | Požaduje se | Umožňuje, aby se zaškrtávací políčko cyklicky prošel jeho interními stavy prostřednictvím kódu programu. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi ovládacími prvky zaškrtávacího políčka. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| AutomationFocusChangedEvent | Požaduje se | Nic |
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |
| ToggleStateProperty událost změněná vlastností. | Požaduje se | Nic |
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, 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 stavu se výchozí akce prochází stavy zaškrtávacího políčka ve stejném pořadí, jako kdyby uživatel posílal na ovládací prvek po sobě jdoucí kliknutí myší.