User Guide

198 Chapter 6: Components Dictionary
Description
Property; the name of the field in dataProvider array objects to use as the label field. This is a
property of the List component that is available from a ComboBox component instance. For
more information, see
List.labelField.
The default value is
undefined.
Example
The following example sets the dataProvider property to an array of strings and sets the
labelField property to indicate that the name field should be used as the label for the
drop-down list:
myComboBox.dataProvider = [
{name:"Gary", gender:"male"},
{name:"Susan", gender:"female"} ];
myComboBox.labelField = "name";
See also
List.labelFunction
ComboBox.labelFunction
Availability
Flash Player 6 (6.0 79.0).
Edition
Flash MX 2004.
Usage
myComboBox.labelFunction
Description
Property; a function that computes the label of a data provider item. You must define the
function. The default value is
undefined.
Example
The following example creates a data provider and then defines a function to specify what to use
as the label in the drop-down list:
myComboBox.dataProvider = [
{firstName:"Nigel", lastName:"Pegg", age:"really young"},
{firstName:"Gary", lastName:"Grossman", age:"young"},
{firstName:"Chris", lastName:"Walcott", age:"old"},
{firstName:"Greg", lastName:"Yachuk", age:"really old"} ];
myComboBox.labelFunction = function(itemObj){
return (itemObj.lastName + ", " + itemObj.firstName);
}