F > FComboBox.replaceItemAt |  |

FComboBox.replaceItemAt

FComboBox, FComboBox.replaceItemAt, replaceItemAt

Availability

Flash Player 6.

Usage

    myComboBox.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 specified for 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 ComboBox 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 combo box `Favorites` with the label `Nigel` and data value `7439`. If no data was specified for the list item, `Nigel` assumes the data value of the existing list item.

    Favorites.replaceItemAt(4, "Nigel", "7439");

See also

`FComboBox.addItemAt`, `FComboBox.getItemAt`, `FComboBox.setDataProvider`, `FComboBox.sortItemsBy`