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

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 automatizace uživatelského rozhraní pro typ ovládacího prvku RadioButton. 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ů.

Přepínač se skládá z kruhového tlačítka a textu definovaného aplikací (popisek), ikony nebo rastrového obrázku, který označuje volbu, kterou může uživatel provést výběrem tlačítka. Aplikace obvykle používá přepínače ve skupinovém rámečku, aby si uživatel vybral ze sady souvisejících, ale vzájemně se vylučující možnosti. Aplikace může například prezentovat skupinu přepínačů, ze kterých může uživatel vybrat předvolbu formátu pro text vybraný v klientské oblasti. Uživatel může vybrat formát zarovnaný doleva, doprava nebo na střed výběrem odpovídajícího přepínače. Uživatel obvykle může vybrat pouze jednu možnost najednou ze sady přepínačů.

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 RadioButton. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky seznamu, 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ů přepínačů, 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
Rádiové tlačítko	Rádiové tlačítko

V zobrazení ovládacího prvku ani v zobrazení obsahu nejsou žádné podřízené položky.

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

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice je zvláště relevantní pro typ ovládacího prvku RadioButton. 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.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
NameProperty	Viz poznámky.	Název ovládacího prvku rádiového tlačítka je text zobrazený vedle tlačítka, které udržuje aktuální stav výběru.
ClickablePointProperty	Viz poznámky.	Klikatelný bod ovládacího prvku přepínače musí být bodem, který nastaví výběr na přepínači, pokud na něj kliknete ukazatelem myši.
LabeledByProperty	Null	Rádiová tlačítka jsou samopopisné ovládací prvky.
ControlTypeProperty	Rádiové tlačítko	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
LocalizedControlTypeProperty	rádiové tlačítko	Lokalizovaný řetězec odpovídající typu ovládacího prvku RadioButton.
IsContentElementProperty	Pravdivé	Ovládací prvek přepínačů je vždy součástí zobrazení obsahu stromu automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Ovládací prvek přepínačů je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní.

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 přepínačů. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Vzor ovládacího prvku / Vlastnost vzoru ovládacího prvku	Podpora/hodnota	Poznámky
ISelectionItemProvider	Ano	Všechny ovládací prvky přepínačů musí podporovat vzor Položky výběru, aby bylo možné vybrat.
SelectionContainer	Viz poznámky.	SelectionContainerProperty musí být vždy dokončeno, aby klient automatizace uživatelského rozhraní mohl určit, které další přepínače v určitém kontextu spolu vzájemně souvisejí. Pro verzi Win32 přepínače nebude tato vlastnost podporována, protože není možné získat tyto informace z této starší architektury.
IToggleProvider	Nikdy	Přepínač nemůže po nastavení procházet jeho stavem. Tento vzorec nesmí být nikdy podporován na rádiovém tlačítku.

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

Následující tabulka uvádí události automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky přepínačů. 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í	Podpora	Poznámky
ElementRemovedFromSelectionEvent	Povinné	Žádné
ElementSelectedEvent	Povinné	Žádné
ToggleStateProperty událost změny vlastnosti.	Nikdy	Žá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é
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Viz také

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