关于 RadioButton 组件

使用 RadioButton 组件可以强制用户只能选择一组选项中的一项。RadioButton 组件必须用于至少有两个 RadioButton 实例的组。在任何给定的时刻,都只有一个组成员被选中。选择组中的一个单选按钮将取消选择组内当前选定的单选按钮。您可以设置 groupName 参数,以指明单选按钮属于哪个组。

可以启用或禁用单选按钮。用户按 Tab 键切换到单选按钮组时,只有选中的单选按钮会接收焦点。用户可以通过按箭头键来改变组内的焦点。在禁用状态下,单选按钮不接收鼠标或键盘输入。

如果您单击或按 Tab 键切换到 RadioButton 组件组,它就会接收焦点。当 RadioButton 组有焦点时,您可以使用下列按键来控制它:

按键

描述

向上箭头键/向右箭头键

所选项会移至单选按钮组内的前一个单选按钮。

向下箭头键/向左箭头键

选择将移到单选按钮组的下一个单选按钮。

Tab 键

将焦点从单选按钮组移动到下一个组件。

有关控制焦点的详细信息,请参阅创建自定义焦点导航FocusManager 类

每个 RadioButton 实例在舞台上的实时预览会反映在创作过程中对属性检查器或“组件检查器”面板中的参数所做的更改。但是,实时预览中不会显示互斥的所选项。如果将同组的两个单选按钮的 selected 参数设置为 true,它们都会显示为选中状态,尽管在运行时将只显示最后创建的实例。有关详细信息,请参阅RadioButton 参数

将 RadioButton 组件添加到应用程序时,您可以使用“辅助功能”面板,以便让屏幕读取器能够访问到该组件。 首先,您必须添加以下代码行来启用辅助功能:

mx.accessibility.RadioButtonAccImpl.enableAccessibility();

不管一个组件有多少实例,都只对其启用一次辅助功能。有关详细信息,请参阅创建辅助内容