包 | spark.accessibility |
类 | public class ButtonBarBaseAccImpl |
继承 | ButtonBarBaseAccImpl ListBaseAccImpl AccImpl AccessibilityImplementation Object |
子类 | TabBarAccImpl |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
虽然 TabBar 有自己的辅助功能实现子类,但 ButtonBar 仅使用 ButtonBarBase 的子类。因此,本说明的其余部分指的是常用的 ButtonBar 组件,而不是 ButtonBarBase 基类。
创建 Spark ButtonBar 之后,其 accessibilityImplementation
属性即设置为此类的实例。然后,Flash Player 将使用此类允许诸如屏幕阅读器之类的 MSAA 客户端查看和操作 ButtonBar。有关辅助功能实现类和 MSAA 的背景信息,请参阅 mx.accessibility.AccImpl 和 flash.accessibility.AccessibilityImplementation 类。
子代
ButtonBar 的 MSAA 子代是其按钮。如下文所述,这些 Button 的辅助功能由 ButtonBar 管理;Flash Player 会忽略这些按钮自身的 accessibilityImplementation
和 accessibilityProperties
。
角色
ButtonBar 的 MSAA 角色为 ROLE_SYSTEM_TOOLBAR。
ButtonBar 中每个 Button 的角色为 ROLE_SYSTEM_PUSHBUTTON。
名称
ButtonBar 的默认 MSAA 名称为一个空字符串。该名称包装在 FormItem 元素中时,即为 FormItem 的标签。要覆盖此行为,请设置 ButtonBar 的 accessibilityName
属性。
每个 Button 的名称由 ButtonBar 的 itemToLabel()
方法确定。
当更改 ButtonBar 或其某个 Button 的名称时,ButtonBar 将为该 Button 调度具有正确 childID 的 MSAA 事件 EVENT_OBJECT_NAMECHANGE,或者为其本身调度 0。
描述
ButtonBar 的 MSAA 描述默认为一个空字符串,但您可以设置 ButtonBar 的 accessibilityDescription
属性。
每个 Button 的描述都是一个空字符串。
状态
ButtonBar 的 MSAA 状态是以下项的组合:
- STATE_SYSTEM_UNAVAILABLE(当启用状态为 false 时)
- STATE_SYSTEM_FOCUSABLE(当启用状态为 true 时)
- STATE_SYSTEM_FOCUSED(当启用状态为 true 且 ButtonBar 具有焦点时)
ButtonBar 中 Button 的状态是以下项的组合:
- STATE_SYSTEM_FOCUSED(当该项具有焦点时)
- STATE_SYSTEM_PRESSED(当选择 ButtonBar 时)
当更改 ButtonBar 或其某个 Button 的状态时,ButtonBar 将为该按钮调度具有正确 childID 的 MSAA 事件 EVENT_OBJECT_STATECHANGE,或者为其本身调度 0。
值
ButtonBar 或其中的 Button 没有 MSAA 值。
位置
ButtonBar 或其中 Button 的 MSAA 位置为其边界矩形。
默认操作
ButtonBar 没有 MSAA DefaultAction。
ButtonBar 中 Button 的 DefaultAction 为“按下”。
焦点
ButtonBar 及其各个按钮接受焦点。接受焦点时,ButtonBar 将调度 MSAA 事件 EVENT_OBJECT_FOCUS。按钮通过箭头键导航获得焦点时,不会自动选择该按钮。要选择一个获得焦点的按钮,用户必须按空格键。
选择
MSAA 选择将按下与指定 childID 对应的按钮。一次只能按下一个按钮。
方法 | 由以下参数定义 | ||
---|---|---|---|
ButtonBarBaseAccImpl(master:UIComponent)
构造函数。 | ButtonBarBaseAccImpl | ||
一个 IAccessible 方法,执行与此 AccessibilityImplementation 表示的组件关联的默认操作,或执行该组件的子元素之一的默认操作。 | AccessibilityImplementation | ||
MSAA 方法,返回指定 AccessibilityImplementation 中子元素边框的 DisplayObject 或 Rectangle。 | AccessibilityImplementation | ||
IAccessible 方法,更改此 AccessibilityImplementation 所表示组件中的选定内容。 | AccessibilityImplementation | ||
[静态]
启用 ButtonBarBase 类中的辅助功能。 | ButtonBarBaseAccImpl | ||
MSAA 方法,返回此 AccessibilityImplementation 所表示组件的默认操作,或该组件的子元素之一的默认操作。 | AccessibilityImplementation | ||
MSAA 方法,返回在组件内具有子焦点的子元素(如果有)的无符号整数 ID。 | AccessibilityImplementation | ||
MSAA 方法,返回此 AccessibilityImplementation 所表示组件的名称或组件子元素之一的名称。 | AccessibilityImplementation | ||
MSAA 方法,返回此 AccessibilityImplementation 所表示组件的名称或组件子元素之一的系统角色。 | AccessibilityImplementation | ||
MSAA 方法,返回包含全部所选子元素的 ID 的数组。 | AccessibilityImplementation | ||
IAccessible 方法,返回此 AccessibilityImplementation 所表示组件的当前运行时状态,或该组件的子元素之一的当前运行时状态。 | AccessibilityImplementation | ||
MSAA 方法,返回此 AccessibilityImplementation 所表示组件的运行时值,或该组件的子元素之一的运行时值。 | AccessibilityImplementation | ||
AccessibilityImplementation | |||
AccessibilityImplementation | |||
返回一个数组,其中包含 AccessibilityImplementation 中所有子元素的无符号整数 ID。 | AccessibilityImplementation | ||
[静态]
用于支持表单辅助功能的方法。 | AccImpl | ||
表示对象是否已经定义了指定的属性。 | Object | ||
[静态]
如果组件的“已启用”设置为 false,则返回 true。 | AccImpl | ||
返回 true 或 false,以表示边框由 x、y、width 和 height 指定的文本对象是否应该视为 AccessibilityImplementation 表示的组件的标签。 | AccessibilityImplementation | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
设置循环操作动态属性的可用性。 | Object | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object |
ButtonBarBaseAccImpl | () | 构造函数 |
public function ButtonBarBaseAccImpl(master:UIComponent)
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
构造函数。
参数master:UIComponent — 此 AccImpl 实例使其具有辅助功能的 UIComponent 实例。
|
enableAccessibility | () | 方法 |
public static function enableAccessibility():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
启用 ButtonBarBase 类中的辅助功能。
此方法将由 MXML 编译器自动生成的应用程序启动代码调用。之后,在初始化 ButtonBarBase 实例时,会将这些实例的 accessibilityImplementation
属性设置为该类的实例。
Tue Jun 12 2018, 11:04 AM Z