![]() ![]()  | |
继承 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 类的所有事件。
![]() ![]()  | |