Properties (17)

attachoffset

<attribute name="attachoffset" type="number" value="-1" />

public var attachoffset : Number;

The vertical offset of the floatinglist attached to this combobox.

autoscrollbar

<attribute name="autoscrollbar" value="true" />

public var autoscrollbar;

Whether a scrollbar should automatically show up when there are more items than shownitems.

bordersize

<attribute name="bordersize" value="1" />

public var bordersize;

The border size ( in pixels ) of the popup list.

dataoption

<attribute name="dataoption" type="string" value="none" />

public var dataoption : String;

One of "lazy", "resize", "pooling", "none".

defaultselection

<attribute name="defaultselection" type="number" value="null" />

public var defaultselection : Number;

The number of the item that is initially selected. This overrides the value defined in the defaulttext attribute

defaulttext

<attribute name="defaulttext" type="string" value="" />

public var defaulttext : String;

The text that appears in the text field when no item is selected.

editable

<attribute name="editable" value="true" />

public var editable;

Make the text field of this combobox editable.

isopen

<attribute name="isopen" value="false" />

public var isopen;

Indicates whether or not the popup list is showing.

itemclassname

<attribute name="itemclassname" type="string" value="" />

public var itemclassname : String;

The class that is used to create an item in the list when itemdatapath is assigned.

min_width

<attribute name="min_width" type="number" value="50" />

public var min_width : Number;

The minimum width this component is allowed to be. Defaults to 50 pixels.

selected

<attribute name="selected" value="null" />

public var selected;

The initial selected item.

shownitems

<attribute name="shownitems" value="-1" />

public var shownitems;

Sets the height of the combobox to show 'n' items.

spacing

<attribute name="spacing" value="0" />

public var spacing;

The spacing size ( in pixels ) between items in the pop-up list.

text_width

<attribute name="text_width" type="number" value="${this.width - 19}" />

public var text_width : Number;

the width the text. default: combowidth - 19

text_x

<attribute name="text_x" type="number" value="2" />

public var text_x : Number;

the x position of the text. default: 2

text_y

<attribute name="text_y" type="number" value="2" />

public var text_y : Number;

the y position of the text. default: 2

value

<attribute name="value" value="${cblist.value}" />

public var value;

The value of the combobox.

Methods (18)

addItem()

<method name="addItem" args="txt, val" />

public function addItem(txt : String, val : Object);

Add the specified item to list to the end of the list.

clearSelection()

<method name="clearSelection" />

public function clearSelection();

Clear the current selection in the list and sets the displayed text to an empty string

getItem()

<method name="getItem" args="value" />

public function getItem(value : Object) : Object;

Find a particular item by value. This method is not available with dataoption="lazy" or dataoption="resize" (use data APIs instead).

getItemAt()

<method name="getItemAt" args="index" />

public function getItemAt(index : Number) : Object;

Find a particular item by its index. This method not available with dataoption="lazy" or dataoption="resize" (use data APIs instead).

getSelection()

<method name="getSelection" />

public function getSelection() : Object;

Returns current selection.

getText()

<method name="getText" />

public function getText() : String;

Get the displayed text.

getValue()

<method name="getValue" />

public function getValue() : Object;

Get the value for the combobox.

removeItem()

<method name="removeItem" args="value" />

public function removeItem(value : Object);

Find the first item with the specified value and remove it from the list.

removeItemAt()

<method name="removeItemAt" args="index" />

public function removeItemAt(index : Number);

Remove an item by index (0 based count). This method is not available with dataoption="lazy" or dataoption="resize" (use data APIs instead).

select()

<method name="select" args="item" />

public function select(item : Object);

Selects a specific item in the list.

selectItem()

<method name="selectItem" args="value" />

public function selectItem(value : Object);

Select an item by value. This method is not available with dataoption="lazy" or dataoption="resize".

selectItemAt()

<method name="selectItemAt" args="index" />

public function selectItemAt(index : Number);

Select an item by index (0 based count).

setDefaultSelection()

<method name="setDefaultSelection" args="ds" />

public function setDefaultSelection(ds : Number);

Sets the number of the item that is initially selected. This overrides the value defined in the defaulttext attribute.

setItemclassname()

<method name="setItemclassname" args="icn" />

public function setItemclassname(icn : String);

Sets the type of list items which will be created in floatinglist when necessary.

setOpen()

<method name="setOpen" args="open, withkey" />

public function setOpen(open : Boolean, withkey : Boolean);

Sets the open/close state of the popup list.

setText()

<method name="setText" args="t" />

public function setText(t : String);

Sets the displayed text.

setWidth()

<method name="setWidth" args="w" />

public function setWidth(w);

toggle()

<method name="toggle" args="withkey" />

public function toggle(withkey : Boolean);

Toggles the open/close state of the popup list.

Events (2)

ondefaultselection

<attribute name="ondefaultselection" />

public event ondefaultselection;

This event is sent when the default selection is set.

onselect

<attribute name="onselect" />

public event onselect;

This event is triggered whenever the user makes a selection. It may be used as a script in the combobox tag or as an event method.