org.aswing.JComboBox

	Property	Defined by
		cacheAsBitmap : Boolean	AWSprite
		container : Container	Component
		filters : Array	AWSprite
		height : Number	Component
		mask : DisplayObject	AWSprite
		numChildren : int	AWSprite
		visible : Boolean	Component
		width : Number	Component
		x : Number	Component
		y : Number	Component

	Property	Defined by
		bounds : IntRectangle	Component
		d_numChildren : int	AWSprite
		drawTransparentTrigger : Boolean = true	Component
		d_visible : Boolean Returns the `DisplayObject.visible` directly.	Component
		d_x : Number Returns `DisplayObject.x` directly.	Component
		d_y : Number Returns `DisplayObject.y` directly.	Component
		readyToPaint : Boolean	Component
		ui : ComponentUI	Component
		valid : Boolean	Component

Public Methods

	Method		Defined 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
		addChild(dis:DisplayObject):DisplayObject Adds a child DisplayObject instance to this DisplayObjectContainer instance.	AWSprite
		addChildAt(child:DisplayObject, index:int):DisplayObject	AWSprite
		addDragAcceptableInitiator(com:Component):void 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
		bringToBottom(child:DisplayObject):void Brings a child to bottom.	AWSprite
		bringToTop(child:DisplayObject):void Brings a child to top.	AWSprite
		componentToGlobal(p:IntPoint):IntPoint	Component
		containsChild(child:DisplayObject):Boolean Returns whether child is directly child of this sprite, true only if getChildIndex(child) >= 0.	AWSprite
		fireFocusKeyDownEvent(e:KeyboardEvent):void	Component
		fireFocusKeyUpEvent(e:KeyboardEvent):void	Component
		getAlignmentX():Number Returns the alignment along the x axis.	Component
		getAlignmentY():Number Returns the alignment along the y axis.	Component
		getAlpha():Number Returns the alpha of this component.	Component
		getAwmlID():String Returns ID used to identify components created from AWML.	Component
		getAwmlIndex():Number Returns position index of the component inside its AWML container.	Component
		getAwmlNamespace():String Returns namespace name used to identify components created from AWML.	Component
		getBackground():ASColor Gets the background color of this component.	Component
		getBackgroundDecorator():GroundDecorator Returns the background decorator of this component.	Component
		getBorder():Border Returns the border.	Component
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Same to DisplayObject.getBounds(), just add a explaination here that if you want to get the component bounds, see {	Component
		getChildAt(index:int):DisplayObject	AWSprite
		getChildByName(name:String):DisplayObject	AWSprite
		getChildIndex(child:DisplayObject):int	AWSprite
		getClientProperty(key:): Returns the value of the property with the specified key.	Component
		getClipBounds():IntRectangle Returns the clip bounds.	Component
		getComboBoxUI():ComboBoxUI Returns the ui for this combobox with `ComboBoxUI` instance	JComboBox
		getComBounds(rv:IntRectangle = null):IntRectangle Stores the bounds value of this component into "return value" rv and returns rv.	Component
		getConstraints():Object Gets cpmponent's constraints.	Component
		getDefaultBasicUIClass():Class	JComboBox
		getEditor():ComboBoxEditor Returns the editor used to paint and edit the selected item in the `JComboBox` field.	JComboBox
		getFocusManager():FocusManager Returns the focus manager for this component's stage, or null if this component is not on stage.	Component
		getFont():ASFont Gets the font of this component.	Component
		getForeground():ASColor Gets the foreground color of this component.	Component
		getForegroundDecorator():GroundDecorator Returns the foreground decorator of this component.	Component
		getGlobalLocation(rv:IntPoint = null):IntPoint Stores the global location value of this component into "return value" p and returns p.	Component
		getHeight():int Returns the current height of this component	Component
		getHighestIndexUnderForeground():int Returns the current top index for a new child(none forground child).	AWSprite
		getInsets():Insets 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
		getItemCount():int Returns the number of items in the list.	JComboBox
		getKeyboardManager():KeyboardManager Returns the keyboard manager of this component's `JRootPane` ancestor.	Component
		getListCellFactory():ListCellFactory	JComboBox
		getLocation(rv:IntPoint = null):IntPoint Stores the location value of this component into "return value" rv and returns rv.	Component
		getLowestIndexAboveBackground():int Returns the current bottom index for none background child.	AWSprite
		getMaximumHeight():int Returns `getMaximumSize().height`	Component
		getMaximumRowCount():int Returns the maximum number of items the combo box can display without a scrollbar	JComboBox
		getMaximumSize():IntDimension	Component
		getMaximumWidth():int Returns `getMaximumSize().width`	Component
		getMinimumHeight():int Returns `getMinimumSize().height`	Component
		getMinimumSize():IntDimension	Component
		getMinimumWidth():int Returns `getMinimumSize().width`	Component
		getModel():ListModel	JComboBox
		getMousePosition():IntPoint Returns the coordinate of the mouse position, in pixels, in the component scope.	Component
		getName():String Returns the name of the component	Component
		getPaintBounds():IntRectangle Returns the bounds that component should paint in.	Component
		getParent():Container Returns the `Container` parent, if it parent is not a `Container`, null will be returned.	Component
		getPopupList():JList Returns the popup list that display the items.	JComboBox
		getPreferredHeight():int Returns `getPreferredSize().height`	Component
		getPreferredSize():IntDimension	Component
		getPreferredWidth():int Returns `getPreferredSize().width`	Component
		getRootPaneAncestor():JRootPane Returns the first `JRootPane` ancestor of this component.	Component
		getSelectedIndex():int Returns the first item in the list that matches the given item.	JComboBox
		getSelectedItem():* Returns the current selected item.	JComboBox
		getSize(rv:IntDimension = null):IntDimension Stores the size value of this component into "return value" rv and returns rv.	Component
		getToolTipText():String Returns the tooltip string that has been set with setToolTipText.	Component
		getUI():ComponentUI	Component
		getUIClassID():String	JComboBox
		getWidth():int Returns the current width of this component	Component
		getX():int Returns the current x coordinate of the components.	Component
		getY():int Returns the current y coordinate of the components.	Component
		globalToComponent(p:IntPoint):IntPoint	Component
		hidePopup():void Causes the combo box to close its popup window.	JComboBox
		hitTestMouse():Boolean Returns whether the component hit the mouse.	Component
		hitTestObject(obj:DisplayObject):Boolean	AWSprite
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean	AWSprite
		invalidate():void Invalidates this component.	Component
		invalidatePreferSizeCaches():void Clears this component and all parents above it's preferred size caches.	Component
		isCachePreferSizes():Boolean Returns whether or not the preferred size, minimum size and max size cache is turned on.	Component
		isClipMasked():Boolean Returns whether the component clip should be masked by its bounds.	AWSprite
		isDragAcceptableInitiator(com:Component):Boolean Returns whether the component is acceptable drag initiator for this component.	Component
		isDragEnabled():Boolean Returns whether this component can fire ON_DRAG_RECOGNIZED event.	Component
		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
		isEnabled():Boolean Returns whether the component is enabled.	Component
		isFocusable():Boolean Returns whether this Component can be focused.	Component
		isFocusableSet():Boolean Returns whether or not the opaque property is set by user.	Component
		isFocusOwner():Boolean Returns `true` if this `Component` is the focus owner.	Component
		isFontValidated():Boolean Returns whether the new font are applied and taked effect.	Component
		isOnStage():Boolean Determines whether or not this component is on stage(on the display list).	Component
		isOpaque():Boolean Returns true if this component is completely opaque.	Component
		isOpaqueSet():Boolean Returns whether or not the opaque property is set by user.	Component
		isPopupVisible():Boolean Determines the visibility of the popup.	JComboBox
		isShowing():Boolean Determines whether this component is showing on screen.	Component
		isUIElement():Boolean Returns true if this component is just a ui element component, false means this component is a regular use created component.	Component
		isValid():Boolean Determines whether this component is valid.	Component
		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
		isVisible():Boolean	Component
		makeFocus():void Makes this component's internal focus object to be the stage focus directly, without any judgement.	Component
		pack():void Causes this component to be sized to fit the preferred size.	Component
		paintFocusRect(force:Boolean = false):void Paints the focus rect if need.	Component
		paintImmediately():void Redraw the component UI face immediately if it is visible and ready to paint.	Component
		parentReAppendChildren():void Calls parent reAppendChildren if parent is a container.	Component
		putClientProperty(key:, value:):void Adds an arbitrary key/value "client property" to this component.	Component
		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
		removeChild(child:DisplayObject):DisplayObject	AWSprite
		removeChildAt(index:int):DisplayObject	AWSprite
		removeDragAcceptableInitiator(com:Component):void Removes a component to be the acceptable drag initiator to this component.	Component
		removeFromContainer():void 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
		repaint():void Redraws the component face next RENDER event.This method can be called often, so it needs to execute quickly.	Component
		repaintAndRevalidate():void	Component
		requestFocus():Boolean Requests that this Component get the input focus, and that this Component's top-level ancestor become the focused Window.	Component
		revalidate():void Supports deferred automatic layout.	Component
		revalidateIfNecessary():void	Component
		setAlignmentX(ax:Number):void	Component
		setAlignmentY(ay:Number):void	Component
		setAlpha(alpha:Number):void Indicates the alpha transparency value of the component.	Component
		setAwmlID(id:String):void Sets ID used to identify components created from AWML.	Component
		setAwmlIndex(index:Number):void Sets ID used to identify components created from AWML.	Component
		setAwmlNamespace(theNamespace:String):void Sets namespace used to identify components created from AWML.	Component
		setBackground(c:ASColor):void Apply a new background to combobox and its editor and its popup list.	JComboBox
		setBackgroundDecorator(bg:GroundDecorator):void Sets a decorator to be the component background, it will represent the component background with a `DisplayObject`.	Component
		setBorder(b:Border):void Sets the border for the component, null to remove border.	Component
		setBounds(b:IntRectangle):void This method will call setComBounds()	Component
		setCachePreferSizes(b:Boolean):void Sets whether or not turn on the preferred size, minimum size and max size cache.	Component
		setChildIndex(child:DisplayObject, index:int):void	AWSprite
		setClipBounds(b:IntRectangle):void Sets the clip bounds, a rectangle mask to make specified bounds visible.	Component
		setClipMasked(m:Boolean):void Sets whether the component clip should be masked by its bounds.	AWSprite
		setClipSize(size:IntDimension):void Sets the clip size, a rectangle mask to make specified bounds visible.	Component
		setComBounds(b:IntRectangle):void Moves and resizes this component.	Component
		setComBoundsXYWH(x:int, y:int, w:int, h:int):void Moves and resizes this component.	Component
		setConstraints(constraints:Object):void Sets component's constraints.	Component
		setDragAcceptableInitiatorAppraiser(func:Function):void Sets a function to judge whether a component is acceptable drag initiator.	Component
		setDragEnabled(b:Boolean):void Sets whether this component can fire ON_DRAG_RECOGNIZED event.	Component
		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
		setFocusable(b:Boolean):void Sets the focusable state of this Component to the specified value.	Component
		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
		setFontValidated(b:Boolean):void Sets whether the new font are applied and taked effect.	Component
		setForeground(c:ASColor):void Apply a new foreground to combobox and its editor and its popup list.	JComboBox
		setForegroundDecorator(fg:GroundDecorator):void 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
		setGlobalLocation(gp:IntPoint):void Set the component's location in global coordinate.	Component
		setGlobalLocationXY(x:int, y:int):void Set the component's location in global coordinate.	Component
		setHeight(height:Number):void Sets the component's height.	Component
		setListCellFactory(newFactory:ListCellFactory):void 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
		setLocation(newPos:IntPoint):void Set the component's location, if it is diffs from old location, invalidate it to wait validate.	Component
		setLocationXY(x:int, y:int):void	Component
		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
		setMaximumSize(maximumSize:IntDimension):void setMaximumSize(d:IntDimension) setMaximumSize(width:Number, height:Number) Set the maximumSize, then the component's maximumSize is specified.	Component
		setMaximumWidth(maximumWidth:int):void Sets maximum width, -1 means auto count.	Component
		setMinimumHeight(minimumHeight:int):void Sets minimum height, -1 means auto count.	Component
		setMinimumSize(minimumSize:IntDimension):void setMinimumSize(d:IntDimension) setMinimumSize(width:Number, height:Number) Set the minimumSize, then the component's minimumSize is specified.	Component
		setMinimumWidth(minimumWidth:int):void Sets minimum width, -1 means auto count.	Component
		setModel(m:ListModel):void Set the list mode to provide the data to JList.	JComboBox
		setName(name:String):void Sets the name of this component	Component
		setOpaque(b:Boolean):void If true the component paints every pixel within its bounds.	Component
		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
		setPreferredHeight(preferredHeight:int):void Sets preferred width, -1 means auto count.	Component
		setPreferredSize(preferredSize:IntDimension):void setPreferredSize(d:IntDimension) setPreferredSize(width:Number, height:Number) Set the preferredSize, then the component's preferredSize is specified.	Component
		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
		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
		setSizeWH(w:int, h:int):void	Component
		setToolTipText(t:String):void Registers the text to display in a tool tip.	Component
		setUI(newUI:ComponentUI):void Sets the ui.	JComboBox
		setUIElement(b:Boolean):void Sets the component is a ui element or not.	Component
		setVisible(v:Boolean):void Set a component to be hide or shown.	Component
		setWidth(width:int):void Sets the component's width.	Component
		setX(x:int):void Sets the x coordinate of the components.	Component
		setY(y:int):void Sets the y coordinate of the components.	Component
		showPopup():void Causes the combo box to display its popup window.	JComboBox
		swapChildren(child1:DisplayObject, child2:DisplayObject):void	AWSprite
		swapChildrenAt(index1:int, index2:int):void	AWSprite
		toString():String	Component
		transferFocus():Boolean Transfers the focus to the next component, as though this Component were the focus owner.	Component
		transferFocusBackward():Boolean Transfers the focus to the previous component, as though this Component were the focus owner.	Component
		updateUI():void	JComboBox
		validate():void Ensures that this component has a valid layout.	Component

	Method	Defined by
		clearPreferSizeCaches():void	Component
		countMaximumSize():IntDimension get the maximumSize from ui, if ui is null then return a big dimension;	Component
		countMinimumSize():IntDimension get the minimumSize from ui, if ui is null then Returns getInsets().roundsSize(new IntDimension(0, 0)).	Component
		countPreferredSize():IntDimension get the preferredSize from ui, if ui is null then just return the current size	Component
		d_addChild(child:DisplayObject):DisplayObject	AWSprite
		d_addChildAt(child:DisplayObject, index:int):DisplayObject	AWSprite
		d_getChildAt(index:int):DisplayObject	AWSprite
		d_getChildByName(name:String):DisplayObject	AWSprite
		d_getChildIndex(child:DisplayObject):int	AWSprite
		d_removeChild(child:DisplayObject):DisplayObject	AWSprite
		d_removeChildAt(index:int):DisplayObject	AWSprite
		d_setChildIndex(child:DisplayObject, index:int):void	AWSprite
		d_swapChildren(child1:DisplayObject, child2:DisplayObject):void	AWSprite
		d_swapChildrenAt(index1:int, index2:int):void	AWSprite
		getBackgroundChild():DisplayObject Returns the background child.	AWSprite
		getFocusTransmit():Component Override this to return another component that the focus should be transmit to.	Component
		getForegroundChild():DisplayObject Returns the foreground child.	AWSprite
		invalidateTree():void Makes this component and all parents above it are marked as needing to be laid out.	Component
		isChild(child:DisplayObject):Boolean Returns whether or not the child is this sprite's direct child.	AWSprite
		locate():void Locate the component to the current location.	Component
		paint(b:IntRectangle):void draw the component interface in specified bounds.	Component
		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
		setClipMaskRect(b:IntRectangle):void	AWSprite
		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
		size():void Do the process when size changed.	Component

Summary	Defined by
act	Dispatched when the combobox act, when value set or selection changed.	JComboBox
clickCount	Dispatched when the component is clicked continuesly.	Component
dragDrop	Dispatched when a drag is drop on this component.	Component
dragEnter	Dispatched when a drag is enter this component area.	Component
dragExit	Dispatched when a drag is exit this component area.	Component
dragRecongnized	Dispatched when the component is recongnized that it can be drag start.	Component
focusGained	Dispatched when the component gained the focus from it is not the focus owner	Component
focusKeyDown	Dispatched when the key down and the component is the focus owner.	Component
focusKeyUp	Dispatched when the key up and the component is the focus owner.	Component
focusLost	Dispatched when the component lost the focus from it was the focus owner.	Component
hidden	Dispatched when the component visible is set to false from true.	Component
moved	Dispatched when the component is moved.	Component
paint	Dispatched when the component is painted.	Component
release	Dispatched when the mouse released or released out side.	AWSprite
releaseOutSide	Dispatched only when the mouse released out side.	AWSprite
resized	Dispatched when the component is resized.	Component
selectionChanged	Dispatched when the combobox's selection changed.	JComboBox
shown	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

setSelectedItem()

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

setPopupVisible()

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

setMode()
org.aswing.ListModel

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

org.aswing.ListModel

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

setPopupVisible()

updateUI

()

method

public override function updateUI():void

Event detail

act

event

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:

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	The 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`.
`target`	The 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.

selectionChanged

event

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:

Property	Value
`bubbles`	false
`cancelable`	false
`isProgrammatic()`	True means this event is fired by the programmatic reason, false means user mouse/keyboard interaction reason.
`currentTarget`	The 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`.
`target`	The 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.

AsWing A3 API	All Packages \| All Classes \| Index \| Frames No Frames
Class JComboBox	Properties \| Methods \| Events

Package	org.aswing
Class	public class JComboBox
Inheritance	JComboBox Component AWSprite flash.display.Sprite
Implements	EditableComponent