List 组件是一个可滚动的单选或多选列表框。列表也可以显示图形,其中包含其他组件。您在单击标签或数据参数字段时,会出现“值”对话框,您可以使用该对话框来添加显示在 List 中的项目。您也可以使用 List.addItem()
和 List.addItemAt()
方法来将项目添加到列表。
List 组件使用基于零的索引,其中索引为 0 的项目就是显示在顶端的项目。当使用 List 类的方法和属性添加、删除或替换列表项时,您可能需要指定该列表项的索引。
在单击列表或按 Tab 键切换到列表时,列表获得焦点,您然后可使用以下键控制它:
按键 |
描述 |
---|---|
字母或数字键 |
跳转到标签中以 Key.getAscii() 作为首字符的下一项。 |
Ctrl 键 |
切换键。允许多个不临近的选择和取消选择。 |
向下箭头 |
选区会向下移动一项。 |
Home 键 |
选区会移动到列表顶端。 |
Page Down 键 |
选区会向下移动一页。 |
Page Up 键 |
选区会向上移动一页。 |
Shift 键 |
连续选择键。允许进行连续选择。 |
向上箭头 |
选区会向上移动一项。 |
注意:Page Up 键和 Page Down 键使用的页的大小比可以显示的项数少一项。例如,在一个十行的下拉列表中向下翻页,将会依次显示第 0-9 项、第 9-18 项、第 18-27 项,等等,每页都会有一个重叠项。
有关控制焦点的详细信息,请参阅创建自定义焦点导航或FocusManager 类。
舞台上的每个 List 实例的实时预览反映了创作时在属性检查器或“组件检查器”面板中的对参数所做的更改。
当您将 List 组件添加到应用程序后,就可以使用“辅助功能”面板,使其可由屏幕读取器访问。首先,您必须添加以下代码行来启用辅助功能:
mx.accessibility.ListAccImpl.enableAccessibility();
不管一个组件有多少实例,都只对其启用一次辅助功能。有关详细信息,请参阅创建辅助内容。