ComboBox 类

继承 UIObject > UIComponent > ComboBase > ComboBox

动作脚本类命名空间 mx.controls.ComboBox

ComboBox 组件结合了三个单独的子组件:Button、TextInput 和 List。从 ComboBox 组件中可以直接使用每个子组件的大多数 API,ComboBox 类的方法、属性和事件表中列出了这些 API。

所提供的组合框中的下拉列表是作为 Array 或者作为 DataProvider 对象。如果您使用 DataProvider 对象,列表会在运行时更改。通过切换到一个新的 Array 或 DataProvider 对象,可以动态改变 ComboBox 的数据源。

组合框列表中的项目是按位置从数字 0 开始编排索引的。一个项目可以是以下内容之一:

如果该项目是原始数据类型而不是字符串,则会转换为字符串。如果某个项目是一个对象,则其 label 属性必须是字符串,而 data 属性可以是任何动作脚本值。

您向其提供项目的 ComboBox 组件方法有两个参数:label 和 data,它们指的是上述属性。返回一个项目的方法会将该项目作为一个“对象”返回。

每个组件类都有一个 version 属性,该属性是一个类属性。类属性只能用于该类本身。version 属性会返回一个字符串,该字符串指明组件的版本。要访问 version 属性,请使用以下代码:

trace(mx.controls.ComboBox.version);

注意:下面的代码返回未定义的:trace(myComboBoxInstance.version);

ComboBox 类的方法摘要

属性

描述

ComboBox.addItem()

向列表的结尾添加项目。

ComboBox.addItemAt()

向列表的结尾在指定的索引处添加项目。

ComboBox.close()

关闭下拉列表。

ComboBox.getItemAt()

返回指定索引处的项目。

ComboBox.open()

打开下拉列表。

ComboBox.removeAll()

删除列表中的所有项目。

ComboBox.removeItemAt()

删除位于列表中指定位置的项目。

ComboBox.replaceItemAt()

用其他指定项目替换列表中的某个项目。

继承 UIObject 类UIComponent 类中的所有方法。

ComboBox 类的属性摘要

属性

描述

ComboBox.dataProvider

列表中项目的数据模型。

ComboBox.dropdown

返回一个对组合框所包含的 List 组件的引用。

ComboBox.dropdownWidth

下拉列表的宽度(以像素为单位)。

ComboBox.editable

指明组合框是否可以编辑。

ComboBox.labelField

指明使用哪个数据字段作为下拉列表的标签。

ComboBox.labelFunction

指定一个用于计算下拉列表标签字段的函数。

ComboBox.length

只读。下拉列表的长度。

ComboBox.rowCount

列表一次可以显示的最大项目数。

ComboBox.selectedIndex

下拉列表中所选项目的索引。

ComboBox.selectedItem

下拉列表中所选项目的值。

ComboBox.text

文本框中文本的字符串。

ComboBox.textField

对组合框中 TextInput 组件的引用。

ComboBox.value

文本框(可编辑)或下拉列表(静态)的值。

继承 UIObject 类UIComponent 类的所有属性。

ComboBox 类的事件摘要

事件

描述

ComboBox.change

当组合框的值因用户交互操作而改变时广播。

ComboBox.close

当下拉列表开始关闭时广播。

ComboBox.enter

当按下 Enter 键时广播。

ComboBox.itemRollOut

当指针滑离一个下拉列表项时广播。

ComboBox.itemRollOver

当滑过下拉列表的一个项目时广播。

ComboBox.open

当下拉列表开始打开时广播。

ComboBox.scroll

当滚动下拉列表时广播。

继承 UIObject 类UIComponent 类的所有事件。