Typ ovládacího prvku RadioButton

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní společnosti Microsoft pro typ ovládacího prvku RadioButton.

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čů.

Poznámka

Další generalizace ovládacích prvků pro tlačítka, kde lze vybrat pouze jeden ve skupině, je obsah přepínacího tlačítka. Některé architektury uživatelského rozhraní považují přepínač za specializované přepínací tlačítko.

 

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 tlačítek, 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á 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ů 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í naleznete v tématu přehled stromu automatizace uživatelského rozhraní.

Zobrazení ovládacího prvku Zobrazení obsahu
  • Přepínač
  • Přepínač

 

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

Relevantní vlastnosti

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky, které implementují typ ovládacího prvku RadioButton (například ovládací prvky tlačítka). 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. Kliknutím na bod musí být bod, který po kliknutí vybere přepínač.
UIA_ControlTypePropertyId RadioButton
UIA_IsContentElementPropertyId PRAVDIVÝ Ovládací prvek přepínačů je vždy součástí zobrazení obsahu stromu automatizace uživatelského rozhraní.
UIA_IsControlElementPropertyId PRAVDIVÝ Ovládací prvek přepínačů je 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 přepínačů jsou označené svým obsahem.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající RadioButton typ ovládacího prvku. Výchozí hodnota je přepínač pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId 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.

 

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 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í.

Vlastnost vzoru ovládacího prvku nebo vzoru Podpora/hodnota Poznámky
ISelectionItemProvider Požadovaný Všechny ovládací prvky přepínačů musí podporovat SelectionItem řídicí vzor, aby bylo možné vybrat.
SelectionContainer Viz poznámky. Vlastnost SelectionContainer musí být vždy dokončena, aby klient automatizace uživatelského rozhraní mohl určit, jaké další přepínače v určitém kontextu spolu souvisejí. Pro verzi přepínače Microsoft Win32 není 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. Ovládací vzor ovládacích prvků přepínač nesmí být nikdy podporován na přepínači.

 

Požadované události

Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky tlačítek vyžadují pro podporu. 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_IsEnabledPropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat.
UIA_IsOffscreenPropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Pokud ovládací prvek podporuje vzor ovládacího prvku SelectionItem, musí tuto událost podporovat.
UIA_SelectionItem_ElementSelectedEventId Pokud ovládací prvek podporuje vzor ovládacího prvku SelectionItem, musí tuto událost podporovat.
UIA_StructureChangedEventId

 

Poznámky

Přepínač představuje jednu možnost výběru mezi skupinou partnerských přepínačů. V ideálním případě by přepínače měly mít seskupovací prvek, který objasňuje hranice partnerských přepínačů. Hranice je však často odvozena strukturou prvků uživatelského rozhraní. Například nabídka může obsahovat sadu po sobě jdoucích přepínačů místo položek nabídky nebo sadu přepínačů, které se vyskytují po popisku skupiny, ale před prvkem umožňujícím akci, jako je například tlačítko.

koncepční

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

Přehled automatizace uživatelského rozhraní

 

 

  • Last updated on