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 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 model UI Automation podporu pro typ ovládacího prvku RadioButton. 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ů.
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 model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku RadioButton. Požadavky na model UI Automation platí pro všechny ovládací prvky seznamu, 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ů přepínačů, a popisuje, co může být obsaženo v každém zobrazení. Další informace o stromu model UI Automation naleznete v tématu model UI Automation Strom přehledu.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| RadioButton | RadioButton |
V zobrazení ovládacího prvku ani v zobrazení obsahu nejsou žádné podřízené položky.
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 typ ovládacího prvku RadioButton. 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. |
| 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 přepínač je text zobrazený vedle tlačítka, který udržuje stav výběru. |
| ClickablePointProperty | Viz poznámky. | Ovládací prvek přepínače musí být kliknutelným bodem bod, který nastaví výběr na přepínači, pokud kliknete ukazatelem myši. |
| LabeledByProperty | Null |
Přepínače jsou ovládací prvky samoznačky. |
| ControlTypeProperty | RadioButton | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "přepínač" | Lokalizovaný řetězec odpovídající typu ovládacího prvku RadioButton. |
| IsContentElementProperty | True | Ovládací prvek přepínač je vždy součástí zobrazení obsahu model UI Automation stromu. |
| IsControlElementProperty | True | Ovládací prvek přepínačů je vždy součástí ovládacího prvku zobrazení model UI Automation stromu. |
Požadované vzory ovládacích prvků model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation, 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 model UI Automation Přehled vzorů ovládacích prvků.
| Vlastnost vzoru ovládacího prvku nebo vzoru ovládacího prvku | Podpora/hodnota | Notes |
|---|---|---|
| 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. | Musí SelectionContainerProperty být vždy dokončeno, aby klient model UI Automation mohl určit, jaké další přepínače v určitém kontextu 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 vzor nesmí být nikdy podporován na přepínači. |
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 přepínačů. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| ElementRemovedFromSelectionEvent | Požaduje se | Nic |
| ElementSelectedEvent | Požaduje se | Nic |
| ToggleStateProperty událost změněná vlastností. | Nikdy | 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 |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |