F > FListBox.replaceItemAt |  |

FListBox.replaceItemAt

FListBox, FListBox.replaceItemAt, replaceItemAt

Availability

Flash Player 6.

Usage

    myListBox.replaceItemAt(index, label [,data])

Parameters

`index` An integer specifying the position of a list item.

`label` A string specifying a new label for the list item.

`data` The new value to associate with the list item. This parameter is optional; if you don't specify it, any data currently associated with the item remains in place.

Returns

Nothing.

Description

Method; updates the item at the specified index with the specified label and data. If the item at the specified index has an associated data value and you do not specify a value for the Data parameter, the data value of the list item is not changed.

The List Box component uses a zero-based index, where the item at index 0 is displayed at the top of the list.

Example

The following code updates the fifth item in the list box `Favorites` with the new label `Lucky` and new value `Cat`. If the data value `Cat` were not specified, and the data associated with the fifth list item were `Dog`, then the data value for `Lucky` would be `Dog` (which would be wrong because she is a cat).

    Favorites.replaceItemAt(4, "Lucky", "Cat");

See also

`FListBox.addItemAt`, `FListBox.getItemAt`