Adobe Extending Flash Professional CS4 - Manual (Page 541)

519 EXTENDING FLASH CS4 PROFESSIONAL
XMLUI object
elementItem A JavaScript object with a string property named label and an optional string property named value .
If the value property does not exist, then it is created and assigned the same value as label .
Returns
Nothing.
Description
Method; sets the label and value of the currently selected line in the ListBox or ComboBox control specified by
controlPropertyName.
Example
The following example sets the label and value for the current item of the control property named
PhoneNumber :
var elem = new Object();
elem.label = "Fax";
elem.value = "707-555-5555";
fl.xmlui.setControlItemElement("PhoneNumber",elem);
See also
fl.xmlui , document.xmlPanel() , xmlui.getControlItemElement() , xmlui.set() ,
xmlui.setControlItemElements()
xmlui.setControlItemElements()
Availability
Flash 8.
Usage
xmlui.setControlItemElements(controlID, elementItemArray)
Parameters
controlID A string that specifies the ID attribute of the control you want to set.
elementItemArray An array of JavaScript objects, where each object has a string property named label and an
optional string property named value . If the value property does not exist, then it is created and assigned the same
value as label .
Returns
Nothing.
Description
Method; clears the values of the ListBox or ComboBox control specified by controlID and replaces the list or menu
items with the
label , value pairs specified by elementItemArray.
Example
The following example sets the label and value of items in the control with the ID attribute
myControlID to the label ,
value pairs specified: