继承 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.labelFunction
或 ComboBox.labelField
属性来确定 label
属性。
如果该项目是原始数据类型而不是字符串,则会转换为字符串。如果某个项目是一个对象,则其 label
属性必须是字符串,而 data
属性可以是任何动作脚本值。
您向其提供项目的 ComboBox 组件方法有两个参数:label 和 data,它们指的是上述属性。返回一个项目的方法会将该项目作为一个“对象”返回。
每个组件类都有一个 version
属性,该属性是一个类属性。类属性只能用于该类本身。version
属性会返回一个字符串,该字符串指明组件的版本。要访问 version
属性,请使用以下代码:
trace(mx.controls.ComboBox.version);
注意:下面的代码返回未定义的:trace(myComboBoxInstance.version);
。
属性 |
描述 |
---|---|
ComboBox.addItem()
|
向列表的结尾添加项目。 |
ComboBox.addItemAt()
|
向列表的结尾在指定的索引处添加项目。 |
ComboBox.close()
|
关闭下拉列表。 |
ComboBox.getItemAt()
|
返回指定索引处的项目。 |
ComboBox.open()
|
打开下拉列表。 |
ComboBox.removeAll()
|
删除列表中的所有项目。 |
ComboBox.removeItemAt()
|
删除位于列表中指定位置的项目。 |
ComboBox.replaceItemAt()
|
用其他指定项目替换列表中的某个项目。 |
继承 UIObject 类和 UIComponent 类中的所有方法。
属性 |
描述 |
---|---|
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.change
|
当组合框的值因用户交互操作而改变时广播。 |
ComboBox.close
|
当下拉列表开始关闭时广播。 |
ComboBox.enter
|
当按下 Enter 键时广播。 |
ComboBox.itemRollOut
|
当指针滑离一个下拉列表项时广播。 |
ComboBox.itemRollOver
|
当滑过下拉列表的一个项目时广播。 |
ComboBox.open
|
当下拉列表开始打开时广播。 |
ComboBox.scroll
|
当滚动下拉列表时广播。 |
继承 UIObject 类和 UIComponent 类的所有事件。