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