包 | spark.accessibility |
类 | public class DropDownListBaseAccImpl |
继承 | DropDownListBaseAccImpl ListBaseAccImpl AccImpl AccessibilityImplementation Object |
子类 | ComboBoxAccImpl |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
虽然 ComboBox 有自己的辅助功能实现子类,但 DropDownList 仅使用 DropDownListBase 的子类。因此,本说明的其余部分指的是常用的 DropDownList 组件,而不是 DropDownListBase 基类。
创建 Spark DropDownList 类之后,其 accessibilityImplementation
属性即设置为此类的实例。然后,Flash Player 将使用此类允许诸如屏幕阅读器之类的 MSAA 客户端查看和操作 DropDownList。有关辅助功能实现类和 MSAA 的背景信息,请参阅 mx.accessibility.AccImpl 和 flash.accessibility.AccessibilityImplementation 类。
子代
DropDownList 的 MSAA 子代为其列表项。子代数目是 dataProvider
中项的数目,而不只是可视呈示器的数目。
如下文所述,列表项的辅助功能由 DropDownList 管理;Flash Player 会忽略项呈示器的 accessibilityImplementation
和 accessibilityProperties
。
角色
DropDownList 的 MSAA 角色为 ROLE_SYSTEM_COMBOBOX。
每个列表项的角色是 ROLE_SYSTEM_LISTITEM。
名称
DropDownList 的默认 MSAA 名称为一个空字符串。该名称包装在 FormItem 元素中时,即为 FormItem 的标签。要覆盖此行为,请设置 DropDownList 的 accessibilityName
属性。
每个列表项的名称是由 DropDownList 的 itemToLabel()
方法确定的。
当更改 DropDownList 或其某个项的名称时,DropDownList 将为列表项调度具有正确 childID 的 MSAA 事件 EVENT_OBJECT_NAMECHANGE,或者为其本身调度 0。
描述
DropDownList 的 MSAA 描述默认为一个空字符串,但您可以设置 DropDownList 的 accessibilityDescription
属性。
每个列表项的描述都是一个空字符串。
状态
DropDownList 的 MSAA 状态是以下项的组合:
- STATE_SYSTEM_UNAVAILABLE(当启用状态为 false 时)
- STATE_SYSTEM_FOCUSABLE(当启用状态为 true 时)
- STATE_SYSTEM_FOCUSED(当启用状态为 true 且 DropDownList 具有焦点时)
- STATE_SYSTEM_EXPANDED(当该项打开时)
- STATE_SYSTEM_COLLAPSED(当该项关闭时)
列表项的状态是以下项的组合:
- STATE_SYSTEM_FOCUSABLE
- STATE_SYSTEM_FOCUSED(当该项具有焦点时)
- STATE_SYSTEM_SELECTABLE
- STATE_SYSTEM_SELECTED(当选择该项时)
当更改 DropDownList 或其某个列表项的状态时,DropDownList 将为该列表项调度具有正确 childID 的 MSAA 事件 EVENT_OBJECT_STATECHANGE,或者为其本身调度 0。
值
DropDownList 的 MSAA 值为当前所选列表项的 MSAA 名称。
每个列表项的值都是一个空字符串。
更改 DropDownList 的值时,它将调度 MSAA 事件 EVENT_OBJECT_VALUECHANGE。
位置
DropDownList 或列表项的 MSAA 位置是其边界矩形。
默认操作
DropDownList 没有 MSAA DefaultAction
列表项的 DefaultAction 是“双击”。
焦点
DropDownList 本身及其列表项都可以接收焦点,而无论 DropDownList 处于折叠状态还是展开状态。接收焦点时将引发 EVENT_OBJECT_FOCUS。
选择
DropDownList 允许选择单个项,此时将引发 EVENT_OBJECT_SELECTION 事件。
方法 | 由以下参数定义 | ||
---|---|---|---|
DropDownListBaseAccImpl(master:UIComponent)
构造函数。 | DropDownListBaseAccImpl | ||
一个 IAccessible 方法,执行与此 AccessibilityImplementation 表示的组件关联的默认操作,或执行该组件的子元素之一的默认操作。 | AccessibilityImplementation | ||
MSAA 方法,返回指定 AccessibilityImplementation 中子元素边框的 DisplayObject 或 Rectangle。 | AccessibilityImplementation | ||
IAccessible 方法,更改此 AccessibilityImplementation 所表示组件中的选定内容。 | AccessibilityImplementation | ||
[静态]
启用 DropDownListBase 类中的辅助功能。 | DropDownListBaseAccImpl | ||
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 |
DropDownListBaseAccImpl | () | 构造函数 |
public function DropDownListBaseAccImpl(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 |
启用 DropDownListBase 类中的辅助功能。
此方法将由 MXML 编译器自动生成的应用程序启动代码调用。之后,在初始化 DropDownListBase 实例时,会将这些实例的 accessibilityImplementation
属性设置为该类的实例。
Tue Jun 12 2018, 11:04 AM Z