Packageorg.aswing
Classpublic class JComboBox
InheritanceJComboBox Inheritance Component Inheritance AWSprite Inheritance flash.display.Sprite
ImplementsEditableComponent

A component that combines a button or editable field and a drop-down list. The user can select a value from the drop-down list, which appears at the user's request. If you make the combo box editable, then the combo box includes an editable field into which the user can type a value.

JComboBox use a JList to be the drop-down list, so of course you can operate list to do some thing.

By default JComboBox can't count its preffered width accurately like default JList, you have to set its preffered size if you want. Or you make a not shared cell factory to it. see ListCellFactory and JList for details.

See also

JList
ComboBoxEditor
DefaultComboBoxEditor


Public Properties
 PropertyDefined by
 InheritedcacheAsBitmap : Boolean
AWSprite
 Inheritedcontainer : Container
Component
 Inheritedfilters : Array
AWSprite
 Inheritedheight : Number
Component
 Inheritedmask : DisplayObject
AWSprite
 InheritednumChildren : int
AWSprite
 Inheritedvisible : Boolean
Component
 Inheritedwidth : Number
Component
 Inheritedx : Number
Component
 Inheritedy : Number
Component
Protected Properties
 PropertyDefined by
 Inheritedbounds : IntRectangle
Component
 Inheritedd_numChildren : int
AWSprite
 InheriteddrawTransparentTrigger : Boolean = true
Component
 Inheritedd_visible : Boolean
Returns the DisplayObject.visible directly.
Component
 Inheritedd_x : Number
Returns DisplayObject.x directly.
Component
 Inheritedd_y : Number
Returns DisplayObject.y directly.
Component
 InheritedreadyToPaint : Boolean
Component
 Inheritedui : ComponentUI
Component
 Inheritedvalid : Boolean
Component
Public Methods
 MethodDefined by
  
JComboBox(listData:* = null)
Create a combobox with specified data.
JComboBox
  
addActionListener(listener:Function, priority:int = 0, useWeakReference:Boolean = false):void
The ActionListener will receive an ActionEvent when a selection has been made.
JComboBox
 Inherited
addChild(dis:DisplayObject):DisplayObject
Adds a child DisplayObject instance to this DisplayObjectContainer instance.
AWSprite
 Inherited
addChildAt(child:DisplayObject, index:int):DisplayObject
AWSprite
 Inherited
Adds a component to be the acceptable drag initiator to this component.
Component
  
addSelectionListener(listener:Function, priority:int = 0, useWeakReference:Boolean = false):void
Add a listener to listen the combobox's selection change event.
JComboBox
 Inherited
bringToBottom(child:DisplayObject):void
Brings a child to bottom.
AWSprite
 Inherited
bringToTop(child:DisplayObject):void
Brings a child to top.
AWSprite
 Inherited
Component
 Inherited
containsChild(child:DisplayObject):Boolean
Returns whether child is directly child of this sprite, true only if getChildIndex(child) >= 0.
AWSprite
 Inherited
fireFocusKeyDownEvent(e:KeyboardEvent):void
Component
 Inherited
fireFocusKeyUpEvent(e:KeyboardEvent):void
Component
 Inherited
getAlignmentX():Number
Returns the alignment along the x axis.
Component
 Inherited
getAlignmentY():Number
Returns the alignment along the y axis.
Component
 Inherited
getAlpha():Number
Returns the alpha of this component.
Component
 Inherited
getAwmlID():String
Returns ID used to identify components created from AWML.
Component
 Inherited
getAwmlIndex():Number
Returns position index of the component inside its AWML container.
Component
 Inherited
Returns namespace name used to identify components created from AWML.
Component
 Inherited
Gets the background color of this component.
Component
 Inherited
Returns the background decorator of this component.
Component
 Inherited
Returns the border.
Component
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Same to DisplayObject.getBounds(), just add a explaination here that if you want to get the component bounds, see {
Component
 Inherited
getChildAt(index:int):DisplayObject
AWSprite
 Inherited
getChildByName(name:String):DisplayObject
AWSprite
 Inherited
getChildIndex(child:DisplayObject):int
AWSprite
 Inherited
Returns the value of the property with the specified key.
Component
 Inherited
Returns the clip bounds.
Component
  
Returns the ui for this combobox with ComboBoxUI instance
JComboBox
 Inherited

Stores the bounds value of this component into "return value" rv and returns rv.

Component
 Inherited
getConstraints():Object
Gets cpmponent's constraints.
Component
  
JComboBox
  
Returns the editor used to paint and edit the selected item in the JComboBox field.
JComboBox
 Inherited
Returns the focus manager for this component's stage, or null if this component is not on stage.
Component
 Inherited
Gets the font of this component.
Component
 Inherited
Gets the foreground color of this component.
Component
 Inherited
Returns the foreground decorator of this component.
Component
 Inherited
Stores the global location value of this component into "return value" p and returns p.
Component
 Inherited
getHeight():int
Returns the current height of this component
Component
 Inherited
Returns the current top index for a new child(none forground child).
AWSprite
 Inherited
If a border has been set on this component, returns the border's insets; otherwise returns an empty insets.
Component
  
getInternalFocusObject():InteractiveObject
Returns the editor component internal focus object.
JComboBox
  
getItemAt(index:int):*
Returns the list item at the specified index.
JComboBox
  
Returns the number of items in the list.
JComboBox
 Inherited
Returns the keyboard manager of this component's JRootPane ancestor.
Component
  
JComboBox
 Inherited
Stores the location value of this component into "return value" rv and returns rv.
Component
 Inherited
Returns the current bottom index for none background child.
AWSprite
 Inherited
Returns getMaximumSize().height
Component
  
Returns the maximum number of items the combo box can display without a scrollbar
JComboBox
 Inherited
Component
 Inherited
Returns getMaximumSize().width
Component
 Inherited
Returns getMinimumSize().height
Component
 Inherited
Component
 Inherited
Returns getMinimumSize().width
Component
  
JComboBox
 Inherited
Returns the coordinate of the mouse position, in pixels, in the component scope.
Component
 Inherited
getName():String
Returns the name of the component
Component
 Inherited
Returns the bounds that component should paint in.
Component
 Inherited
Returns the Container parent, if it parent is not a Container, null will be returned.
Component
  
Returns the popup list that display the items.
JComboBox
 Inherited
Returns getPreferredSize().height
Component
 Inherited
Component
 Inherited
Returns getPreferredSize().width
Component
 Inherited
Returns the first JRootPane ancestor of this component.
Component
  
Returns the first item in the list that matches the given item.
JComboBox
  
Returns the current selected item.
JComboBox
 Inherited
Stores the size value of this component into "return value" rv and returns rv.
Component
 Inherited
getToolTipText():String
Returns the tooltip string that has been set with setToolTipText.
Component
 Inherited
Component
  
getUIClassID():String
JComboBox
 Inherited
getWidth():int
Returns the current width of this component
Component
 Inherited
getX():int
Returns the current x coordinate of the components.
Component
 Inherited
getY():int
Returns the current y coordinate of the components.
Component
 Inherited
Component
  
hidePopup():void
Causes the combo box to close its popup window.
JComboBox
 Inherited
hitTestMouse():Boolean
Returns whether the component hit the mouse.
Component
 Inherited
hitTestObject(obj:DisplayObject):Boolean
AWSprite
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
AWSprite
 Inherited
invalidate():void
Invalidates this component.
Component
 Inherited
Clears this component and all parents above it's preferred size caches.
Component
 Inherited
Returns whether or not the preferred size, minimum size and max size cache is turned on.
Component
 Inherited
isClipMasked():Boolean
Returns whether the component clip should be masked by its bounds.
AWSprite
 Inherited
Returns whether the component is acceptable drag initiator for this component.
Component
 Inherited
isDragEnabled():Boolean
Returns whether this component can fire ON_DRAG_RECOGNIZED event.
Component
 Inherited
isDropTrigger():Boolean
Returns whether this component can trigger dragging component to fire drag events when dragging over to this component.(Default value is false)
Component
  
isEditable():Boolean
Returns true if the JComboBox is editable.
JComboBox
 Inherited
isEnabled():Boolean
Returns whether the component is enabled.
Component
 Inherited
isFocusable():Boolean
Returns whether this Component can be focused.
Component
 Inherited
isFocusableSet():Boolean
Returns whether or not the opaque property is set by user.
Component
 Inherited
isFocusOwner():Boolean
Returns true if this Component is the focus owner.
Component
 Inherited
isFontValidated():Boolean
Returns whether the new font are applied and taked effect.
Component
 Inherited
isOnStage():Boolean
Determines whether or not this component is on stage(on the display list).
Component
 Inherited
isOpaque():Boolean
Returns true if this component is completely opaque.
Component
 Inherited
isOpaqueSet():Boolean
Returns whether or not the opaque property is set by user.
Component
  
isPopupVisible():Boolean
Determines the visibility of the popup.
JComboBox
 Inherited
isShowing():Boolean
Determines whether this component is showing on screen.
Component
 Inherited
isUIElement():Boolean
Returns true if this component is just a ui element component, false means this component is a regular use created component.
Component
 Inherited
isValid():Boolean
Determines whether this component is valid.
Component
 Inherited
isValidateRoot():Boolean
If this method returns true, revalidate calls by descendants of this component will cause the entire tree beginning with this root to be validated.
Component
 Inherited
isVisible():Boolean
Component
 Inherited
makeFocus():void
Makes this component's internal focus object to be the stage focus directly, without any judgement.
Component
 Inherited
pack():void
Causes this component to be sized to fit the preferred size.
Component
 Inherited
paintFocusRect(force:Boolean = false):void
Paints the focus rect if need.
Component
 Inherited
Redraw the component UI face immediately if it is visible and ready to paint.
Component
 Inherited
Calls parent reAppendChildren if parent is a container.
Component
 Inherited
putClientProperty(key:*, value:*):void
Adds an arbitrary key/value "client property" to this component.
Component
 Inherited
reAppendToParent(constraints:Object = null):void
Removes this component from its parent and then append it with specified constraints.
Component
  
removeActionListener(listener:Function):void
Removes a action listener.
JComboBox
 Inherited
removeChild(child:DisplayObject):DisplayObject
AWSprite
 Inherited
removeChildAt(index:int):DisplayObject
AWSprite
 Inherited
Removes a component to be the acceptable drag initiator to this component.
Component
 Inherited
Removes this component from its parent, whatever it is as a component child or only a display object child, or it's parent is just a display object container.
Component
  
removeSelectionListener(listener:Function):void
Removes a selection listener.
JComboBox
 Inherited
repaint():void
Redraws the component face next RENDER event.This method can be called often, so it needs to execute quickly.
Component
 Inherited
Component
 Inherited
requestFocus():Boolean
Requests that this Component get the input focus, and that this Component's top-level ancestor become the focused Window.
Component
 Inherited
revalidate():void
Supports deferred automatic layout.
Component
 Inherited
Component
 Inherited
setAlignmentX(ax:Number):void
Component
 Inherited
setAlignmentY(ay:Number):void
Component
 Inherited
setAlpha(alpha:Number):void
Indicates the alpha transparency value of the component.
Component
 Inherited
setAwmlID(id:String):void
Sets ID used to identify components created from AWML.
Component
 Inherited
setAwmlIndex(index:Number):void
Sets ID used to identify components created from AWML.
Component
 Inherited
setAwmlNamespace(theNamespace:String):void
Sets namespace used to identify components created from AWML.
Component
  
Apply a new background to combobox and its editor and its popup list.
JComboBox
 Inherited
Sets a decorator to be the component background, it will represent the component background with a DisplayObject.
Component
 Inherited
setBorder(b:Border):void
Sets the border for the component, null to remove border.
Component
 Inherited
This method will call setComBounds()
Component
 Inherited
setCachePreferSizes(b:Boolean):void
Sets whether or not turn on the preferred size, minimum size and max size cache.
Component
 Inherited
setChildIndex(child:DisplayObject, index:int):void
AWSprite
 Inherited
Sets the clip bounds, a rectangle mask to make specified bounds visible.
Component
 Inherited
setClipMasked(m:Boolean):void
Sets whether the component clip should be masked by its bounds.
AWSprite
 Inherited
Sets the clip size, a rectangle mask to make specified bounds visible.
Component
 Inherited
Moves and resizes this component.
Component
 Inherited
setComBoundsXYWH(x:int, y:int, w:int, h:int):void
Moves and resizes this component.
Component
 Inherited
setConstraints(constraints:Object):void
Sets component's constraints.
Component
 Inherited
Sets a function to judge whether a component is acceptable drag initiator.
Component
 Inherited
setDragEnabled(b:Boolean):void
Sets whether this component can fire ON_DRAG_RECOGNIZED event.
Component
 Inherited
setDropTrigger(b:Boolean):void
Sets whether this component can trigger dragging component to fire drag events when dragging over to this component.
Component
  
setEditable(b:Boolean):void
Determines whether the JComboBox field is editable.
JComboBox
  
setEditor(anEditor:ComboBoxEditor):void
Sets the editor used to paint and edit the selected item in the JComboBox field.
JComboBox
  
setEnabled(b:Boolean):void
Enables the combo box so that items can be selected.
JComboBox
 Inherited
setFocusable(b:Boolean):void
Sets the focusable state of this Component to the specified value.
Component
 Inherited
setFocusableSet(b:Boolean):void
Indicate that the focusable property is set by user or not.
Component
  
setFont(newFont:ASFont):void
Apply a new font to combobox and its editor and its popup list.
JComboBox
 Inherited
setFontValidated(b:Boolean):void
Sets whether the new font are applied and taked effect.
Component
  
Apply a new foreground to combobox and its editor and its popup list.
JComboBox
 Inherited
Sets a decorator to be the component foreground, it will represent the component foreground with a DisplayObject on top of other children of this component.
Component
 Inherited
Set the component's location in global coordinate.
Component
 Inherited
setGlobalLocationXY(x:int, y:int):void
Set the component's location in global coordinate.
Component
 Inherited
setHeight(height:Number):void
Sets the component's height.
Component
  
This will cause all cells recreating by new factory.
JComboBox
  
setListData(ld:Array):void
set a array to be the list data, but array is not a List Mode.
JComboBox
 Inherited
setLocation(newPos:IntPoint):void
Set the component's location, if it is diffs from old location, invalidate it to wait validate.
Component
 Inherited
setLocationXY(x:int, y:int):void
Component
 Inherited
setMaximumHeight(maximumHeight:int):void
Sets maximum height, -1 means auto count.
Component
  
setMaximumRowCount(count:int):void
Sets the maximum number of rows the JComboBox displays.
JComboBox
 Inherited
setMaximumSize(maximumSize:IntDimension):void
setMaximumSize(d:IntDimension)
setMaximumSize(width:Number, height:Number)

Set the maximumSize, then the component's maximumSize is specified.

Component
 Inherited
setMaximumWidth(maximumWidth:int):void
Sets maximum width, -1 means auto count.
Component
 Inherited
setMinimumHeight(minimumHeight:int):void
Sets minimum height, -1 means auto count.
Component
 Inherited
setMinimumSize(minimumSize:IntDimension):void
setMinimumSize(d:IntDimension)
setMinimumSize(width:Number, height:Number)

Set the minimumSize, then the component's minimumSize is specified.

Component
 Inherited
setMinimumWidth(minimumWidth:int):void
Sets minimum width, -1 means auto count.
Component
  
Set the list mode to provide the data to JList.
JComboBox
 Inherited
setName(name:String):void
Sets the name of this component
Component
 Inherited
setOpaque(b:Boolean):void
If true the component paints every pixel within its bounds.
Component
 Inherited
setOpaqueSet(b:Boolean):void
This method will be called to set true when you set the opaque by setOpaque().
Component
  
setPopupVisible(v:Boolean):void
Sets the visibility of the popup, open or close.
JComboBox
 Inherited
setPreferredHeight(preferredHeight:int):void
Sets preferred width, -1 means auto count.
Component
 Inherited
setPreferredSize(preferredSize:IntDimension):void
setPreferredSize(d:IntDimension)
setPreferredSize(width:Number, height:Number)

Set the preferredSize, then the component's preferredSize is specified.

Component
 Inherited
setPreferredWidth(preferredWidth:int):void
Sets preferred width, -1 means auto count.
Component
  
setSelectedIndex(anIndex:int, programmatic:Boolean = true):void
Selects the item at index anIndex.
JComboBox
  
setSelectedItem(item:*, programmatic:Boolean = true):void
Sets the selected item in the combo box display area to the object in the argument.
JComboBox
 Inherited
setSize(newSize:IntDimension):void
Set the component's size, the width and height all will be setted to not less than zero, then set the size.
Component
 Inherited
setSizeWH(w:int, h:int):void
Component
 Inherited
setToolTipText(t:String):void
Registers the text to display in a tool tip.
Component
  
setUI(newUI:ComponentUI):void
Sets the ui.
JComboBox
 Inherited
setUIElement(b:Boolean):void
Sets the component is a ui element or not.
Component
 Inherited
setVisible(v:Boolean):void
Set a component to be hide or shown.
Component
 Inherited
setWidth(width:int):void
Sets the component's width.
Component
 Inherited
setX(x:int):void
Sets the x coordinate of the components.
Component
 Inherited
setY(y:int):void
Sets the y coordinate of the components.
Component
  
showPopup():void
Causes the combo box to display its popup window.
JComboBox
 Inherited
swapChildren(child1:DisplayObject, child2:DisplayObject):void
AWSprite
 Inherited
swapChildrenAt(index1:int, index2:int):void
AWSprite
 Inherited
toString():String
Component
 Inherited
transferFocus():Boolean
Transfers the focus to the next component, as though this Component were the focus owner.
Component
 Inherited
Transfers the focus to the previous component, as though this Component were the focus owner.
Component
  
updateUI():void
JComboBox
 Inherited
validate():void
Ensures that this component has a valid layout.
Component
Protected Methods
 MethodDefined by
 Inherited
Component
 Inherited
get the maximumSize from ui, if ui is null then return a big dimension;
Component
 Inherited
get the minimumSize from ui, if ui is null then Returns getInsets().roundsSize(new IntDimension(0, 0)).
Component
 Inherited
get the preferredSize from ui, if ui is null then just return the current size
Component
 Inherited
d_addChild(child:DisplayObject):DisplayObject
AWSprite
 Inherited
d_addChildAt(child:DisplayObject, index:int):DisplayObject
AWSprite
 Inherited
d_getChildAt(index:int):DisplayObject
AWSprite
 Inherited
d_getChildByName(name:String):DisplayObject
AWSprite
 Inherited
d_getChildIndex(child:DisplayObject):int
AWSprite
 Inherited
d_removeChild(child:DisplayObject):DisplayObject
AWSprite
 Inherited
d_removeChildAt(index:int):DisplayObject
AWSprite
 Inherited
d_setChildIndex(child:DisplayObject, index:int):void
AWSprite
 Inherited
d_swapChildren(child1:DisplayObject, child2:DisplayObject):void
AWSprite
 Inherited
d_swapChildrenAt(index1:int, index2:int):void
AWSprite
 Inherited
getBackgroundChild():DisplayObject
Returns the background child.
AWSprite
 Inherited
Override this to return another component that the focus should be transmit to.
Component
 Inherited
getForegroundChild():DisplayObject
Returns the foreground child.
AWSprite
 Inherited
Makes this component and all parents above it are marked as needing to be laid out.
Component
 Inherited
isChild(child:DisplayObject):Boolean
Returns whether or not the child is this sprite's direct child.
AWSprite
 Inherited
locate():void
Locate the component to the current location.
Component
 Inherited
draw the component interface in specified bounds.
Component
 Inherited
setBackgroundChild(child:DisplayObject = null):void
Sets the child to be the component background, it will be add to the bottom of all other children.
AWSprite
 Inherited
AWSprite
 Inherited
setForegroundChild(child:DisplayObject = null):void
Sets the child to be the component foreground, it will be add to the top of all other children.
AWSprite
 Inherited
size():void
Do the process when size changed.
Component
Events
 EventSummaryDefined by
  
act
Dispatched when the combobox act, when value set or selection changed.JComboBox
 Inherited Dispatched when the component is clicked continuesly.Component
 Inherited Dispatched when a drag is drop on this component.Component
 Inherited Dispatched when a drag is enter this component area.Component
 Inherited Dispatched when a drag is exit this component area.Component
 Inherited Dispatched when the component is recongnized that it can be drag start.Component
 Inherited Dispatched when the component gained the focus from it is not the focus owner Component
 Inherited Dispatched when the key down and the component is the focus owner.Component
 Inherited Dispatched when the key up and the component is the focus owner.Component
 Inherited Dispatched when the component lost the focus from it was the focus owner.Component
 Inherited Dispatched when the component visible is set to false from true.Component
 Inherited Dispatched when the component is moved.Component
 Inherited Dispatched when the component is painted.Component
 Inherited Dispatched when the mouse released or released out side.AWSprite
 Inherited Dispatched only when the mouse released out side.AWSprite
 Inherited Dispatched when the component is resized.Component
   Dispatched when the combobox's selection changed.JComboBox
 Inherited Dispatched when the component visible is set to true from false.Component
Constructor detail
JComboBox()constructor
public function JComboBox(listData:* = null)

Create a combobox with specified data.

Parameters
listData:* (default = null)
Method detail
addActionListener()method
public function addActionListener(listener:Function, priority:int = 0, useWeakReference:Boolean = false):void

The ActionListener will receive an ActionEvent when a selection has been made. If the combo box is editable, then an ActionEvent will be fired when editing has stopped.

Parameters
listener:Function — the listener
 
priority:int (default = 0) — the priority
 
useWeakReference:Boolean (default = false) — Determines whether the reference to the listener is strong or weak.

See also

org.aswing.event.AWEvent.ACT
addSelectionListener()method 
public function addSelectionListener(listener:Function, priority:int = 0, useWeakReference:Boolean = false):void

Add a listener to listen the combobox's selection change event. When the combobox's selection changed or a different value inputed or set programmiclly.

Parameters
listener:Function — the listener
 
priority:int (default = 0) — the priority
 
useWeakReference:Boolean (default = false) — Determines whether the reference to the listener is strong or weak.

See also

org.aswing.event.InteractiveEvent.SELECTION_CHANGED
getComboBoxUI()method 
public function getComboBoxUI():ComboBoxUI

Returns the ui for this combobox with ComboBoxUI instance

Returns
ComboBoxUI — the combobox ui.
getDefaultBasicUIClass()method 
public override function getDefaultBasicUIClass():Class

Returns
Class
getEditor()method 
public function getEditor():ComboBoxEditor

Returns the editor used to paint and edit the selected item in the JComboBox field.

Returns
ComboBoxEditor — the ComboBoxEditor that displays the selected item
getInternalFocusObject()method 
public override function getInternalFocusObject():InteractiveObject

Returns the editor component internal focus object.

Returns
InteractiveObject
getItemAt()method 
public function getItemAt(index:int):*

Returns the list item at the specified index. If index is out of range (less than zero or greater than or equal to size) it will return undefined.

Parameters
index:int — an integer indicating the list position, where the first item starts at zero

Returns
* — the Object at that list position; or undefined if out of range
getItemCount()method 
public function getItemCount():int

Returns the number of items in the list.

Returns
int — an integer equal to the number of items in the list
getListCellFactory()method 
public function getListCellFactory():ListCellFactory

Returns
ListCellFactory — the cellFactory for the popup List
getMaximumRowCount()method 
public function getMaximumRowCount():int

Returns the maximum number of items the combo box can display without a scrollbar

Returns
int — an integer specifying the maximum number of items that are displayed in the list before using a scrollbar
getModel()method 
public function getModel():ListModel

Returns
ListModel — the model of this List
getPopupList()method 
public function getPopupList():JList

Returns the popup list that display the items.

Returns
JList
getSelectedIndex()method 
public function getSelectedIndex():int

Returns the first item in the list that matches the given item. The result is not always defined if the JComboBox allows selected items that are not in the list. Returns -1 if there is no selected item or if the user specified an item which is not in the list.

Returns
int — an integer specifying the currently selected list item, where 0 specifies the first item in the list; or -1 if no item is selected or if the currently selected item is not in the list
getSelectedItem()method 
public function getSelectedItem():*

Returns the current selected item.

If the combo box is editable, then this value may not have been in the list model.

Returns
* — the current selected item

See also

getUIClassID()method 
public override function getUIClassID():String

Returns
String
hidePopup()method 
public function hidePopup():void

Causes the combo box to close its popup window.

See also

isEditable()method 
public function isEditable():Boolean

Returns true if the JComboBox is editable. By default, a combo box is not editable.

Returns
Boolean — true if the JComboBox is editable, else false
isPopupVisible()method 
public function isPopupVisible():Boolean

Determines the visibility of the popup.

Returns
Boolean — true if the popup is visible, otherwise returns false
removeActionListener()method 
public function removeActionListener(listener:Function):void

Removes a action listener.

Parameters
listener:Function — the listener to be removed.

See also

org.aswing.event.AWEvent.ACT
removeSelectionListener()method 
public function removeSelectionListener(listener:Function):void

Removes a selection listener.

Parameters
listener:Function — the listener to be removed.

See also

org.aswing.event.InteractiveEvent.SELECTION_CHANGED
setBackground()method 
public override function setBackground(c:ASColor):void

Apply a new background to combobox and its editor and its popup list.

Parameters
c:ASColor
setEditable()method 
public function setEditable(b:Boolean):void

Determines whether the JComboBox field is editable. An editable JComboBox allows the user to type into the field or selected an item from the list to initialize the field, after which it can be edited. (The editing affects only the field, the list item remains intact.) A non editable JComboBox displays the selected item in the field, but the selection cannot be modified.

Parameters
b:Boolean — a boolean value, where true indicates that the field is editable
setEditor()method 
public function setEditor(anEditor:ComboBoxEditor):void

Sets the editor used to paint and edit the selected item in the JComboBox field. The editor is used both if the receiving JComboBox is editable and not editable.

Parameters
anEditor:ComboBoxEditor — the ComboBoxEditor that displays the selected item
setEnabled()method 
public override function setEnabled(b:Boolean):void

Enables the combo box so that items can be selected. When the combo box is disabled, items cannot be selected and values cannot be typed into its field (if it is editable).

Parameters
b:Boolean — a boolean value, where true enables the component and false disables it
setFont()method 
public override function setFont(newFont:ASFont):void

Apply a new font to combobox and its editor and its popup list.

Parameters
newFont:ASFont
setForeground()method 
public override function setForeground(c:ASColor):void

Apply a new foreground to combobox and its editor and its popup list.

Parameters
c:ASColor
setListCellFactory()method 
public function setListCellFactory(newFactory:ListCellFactory):void

This will cause all cells recreating by new factory.

Parameters
newFactory:ListCellFactory — the new cell factory for the popup List
setListData()method 
public function setListData(ld:Array):void

set a array to be the list data, but array is not a List Mode. So when the array content was changed, you should call updateListView to update the JList(the list for combo box).But this is not a good way, its slow. So suggest you to create a ListMode eg. VectorListMode, When you modify ListMode, it will automatic update JList.

Parameters
ld:Array

See also

setMaximumRowCount()method 
public function setMaximumRowCount(count:int):void

Sets the maximum number of rows the JComboBox displays. If the number of objects in the model is greater than count, the combo box uses a scrollbar.

Parameters
count:int — an integer specifying the maximum number of items to display in the list before using a scrollbar
setModel()method 
public function setModel(m:ListModel):void

Set the list mode to provide the data to JList.

Parameters
m:ListModel

See also

setPopupVisible()method 
public function setPopupVisible(v:Boolean):void

Sets the visibility of the popup, open or close.

Parameters
v:Boolean
setSelectedIndex()method 
public function setSelectedIndex(anIndex:int, programmatic:Boolean = true):void

Selects the item at index anIndex.

ON_ACT (addActionListener())events added to the combo box will be notified when this method is called. Parameters

anIndex:int — an integer specifying the list item to select, where 0 specifies the first item in the list and -1 or greater than max index indicates empty selection.
 
programmatic:Boolean (default = true) — indicate if this is a programmatic change.
setSelectedItem()method 
public function setSelectedItem(item:*, programmatic:Boolean = true):void

Sets the selected item in the combo box display area to the object in the argument. If item is in the list, the display area shows item selected.

If item is not in the list and the combo box is uneditable, it will not change the current selection. For editable combo boxes, the selection will change to item.

AWEvent.ACT (addActionListener())events added to the combo box will be notified when this method is called.
InteractiveEvent.SELECTION_CHANGED (addSelectionListener())events added to the combo box will be notified when this method is called only when the item is different from current selected item, it means that only when the selected item changed. Parameters
item:* — the list item to select; use null to clear the selection.
 
programmatic:Boolean (default = true) — indicate if this is a programmatic change.
setUI()method 
public override function setUI(newUI:ComponentUI):void

Sets the ui.

JComboBox ui should implemented ComboBoxUI interface!

Parameters
newUI:ComponentUI — the newUI

Throws
— when the newUI is not an ComboBoxUI instance.
showPopup()method 
public function showPopup():void

Causes the combo box to display its popup window.

See also

updateUI()method 
public override function updateUI():void
Event detail
actevent 
Event object type: org.aswing.event.AWEvent
AWEvent.type property = org.aswing.event.AWEvent.ACT

Dispatched when the combobox act, when value set or selection changed.

The AWEvent.ACT constant defines the value of the type property of the event object for a act event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe Object that defines the event listener that handles the event. For example, if you use comp.addEventListener() to register an event listener, comp is the value of the currentTarget.
targetThe Object that dispatched the event; it is not always the Object listening for the event. Use the currentTarget property to always access the Object listening for the event.

See also

selectionChangedevent  
Event object type: org.aswing.event.InteractiveEvent
InteractiveEvent.type property = org.aswing.event.InteractiveEvent.SELECTION_CHANGED

Dispatched when the combobox's selection changed.

The InteractiveEvent.SELECTION_CHANGED constant defines the value of the type property of the event object for a selectionChanged event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
isProgrammatic()True means this event is fired by the programmatic reason, false means user mouse/keyboard interaction reason.
currentTargetThe Object that defines the event listener that handles the event. For example, if you use comp.addEventListener() to register an event listener, comp is the value of the currentTarget.
targetThe Object that dispatched the event; it is not always the Object listening for the event. Use the currentTarget property to always access the Object listening for the event.