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