List.selectedItem

Availability

Flash Player 6 (6.0.79.0).

Edition

Flash MX 2004.

Usage

listInstance.selectedItem

Description

Property (read-only); an item object in a single-selection list. (In a multiple-selection list with multiple items selected, selectedItem returns the item that was most recently selected.) If there is no selection, the value is undefined.

Example

The following example displays the selected label:

trace(my_list.selectedItem.label);

The following example displays the contents of a selected whenever the user selects a new item from the list:

my_list.multipleSelection = true;

my_list.addItem({data:"flash", label:"Flash"});
my_list.addItem({data:"dreamweaver", label:"Dreamweaver"});
my_list.addItem({data:"coldfusion", label:"ColdFusion"});

//Create listener object.
var listListener:Object = new Object();
listListener.change = function(evt_obj:Object) {
    // Display each property of the object.
    var tempStr:String = "[object";
    for (var i:String in evt_obj.target.selectedItem) {
        tempStr += " " + i + ":'" + evt_obj.target.selectedItem[i]+"'";
    }
    tempStr += "]";
    trace(tempStr);
};
// Add listener.
my_list.addEventListener("change", listListener);

See also

List.selectedIndex, List.selectedIndices, List.selectedItems