关于 CheckBox 组件

复选框是一个可以选中或取消选中的方框。当它被选中后,框中会出现一个复选标记。您可以为复选框添加一个文本标签,并可以将它放在左侧、右侧、顶部或底部。

可以在应用程序中启用或者禁用复选框。如果复选框已启用,并且用户单击它或者它的标签,复选框会接收输入焦点并显示为按下状态。如果用户在按下鼠标按钮时将指针移到复选框或其标签的边界区域之外,则组件的外观会返回到其最初状态,并保持输入焦点。在组件上释放鼠标之前,复选框的状态不会发生变化。另外,复选框有两种禁用状态:选中和取消选中,这两种状态不允许鼠标或键盘的交互操作。

如果复选框被禁用,它会显示其禁用状态,而不管用户的交互操作。在禁用状态下,按钮不接收鼠标或键盘输入。

如果用户单击 CheckBox 实例或者用 Tab 按键切换到它时,CheckBox 实例将接收焦点。当一个 CheckBox 实例有焦点时,您可以使用下列按键来控制它:

按键

描述

Shift + Tab

将焦点移到前一个元素。

空格键

选中或者取消选中组件并触发 click 事件。

Tab 键

将焦点移到下一个元素。

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

每个 CheckBox 实例的实时预览反映在创作过程中对属性检查器或组件检查器面板中的参数所做的更改。

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

mx.accessibility.CheckBoxAccImpl.enableAccessibility();

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