List.iconFunction

Availability

Flash Player 6 (6.0.79.0).

Edition

Flash MX 2004.

Usage

listInstance.iconFunction

Description

Property; specifies a function that determines which icon each row uses to display its item. This function receives a parameter, item, which is the item being rendered, and must return a string representing the icon's symbol identifier.

Example

The following example adds icons that indicate whether a file is an image or a text document. If the data.fileExtension field contains a value of "jpg" or "gif", the icon used is "pictureIcon", and so on.

my_list.iconFunction = function(item:Object):String {
    var type:String = item.data.fileExtension;
    if (type == "jpg" || type == "gif") {
        return "pictureIcon";
    } else if (type == "doc" || type == "txt") {
        return "docIcon";
    }
}

The following example sets the iconField property to the icon property of each item. To try this code, drag a List component to the Stage, give it the instance name my_list, and create three symbols with the instance names flash, dreamweaver, and cf respectively. Add the following code to Frame 1 in the timeline:

/**
 Requires:
  - List component on Stage (instance name: my_list)
  - MovieClip/Graphic symbol in the Library with Linkage ID of "flashIcon"
*/

var my_list:mx.controls.List;

my_list.setSize(200, 100);

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

my_list.iconFunction = function(item:Object):String {
    if (item.data == "flash") {
        // Put icon next to list item with the data "flash".
        return "flashIcon";
    }
};
my_list.iconField = "icon";