F > FListBox.replaceItemAt

FListBox.replaceItemAt

Disponibilité

Flash Player 6.

Usage

maListe.replaceItemAt(index, étiquette [,données])

Paramètres

index Un entier spécifiant la position de l'élément de liste.

étiquette Une chaîne spécifiant une nouvelle étiquette pour l'élément de liste.

données La nouvelle valeur à associer à l'élément de liste. Ce paramètre est facultatif. Si vous ne le spécifiez pas, les données associées à l'élément restent en place.

Renvoie

Rien.

Description

Méthode ; met à jour l'élément à l'index spécifié avec l'étiquette et les données spécifiées. Si l'élément à l'index spécifié est associé à une valeur de données et que vous ne spécifiez pas de valeur pour le paramètre Data, la valeur de données de l'élément n'est pas modifiée.

Le composant ListBox utilise un index basé sur 0, où l'élément à l'index 0 est affiché en haut de la liste.

Exemple

Le code suivant met le cinquième élément de la zone de liste Favoris à jour avec l'étiquette Lucky et la valeur Chat. Si la valeur de donnée Chat n'était pas spécifiée et si la donnée associée au cinquième élément de la liste était Chien, la valeur de donnée pour Lucky serait Chien (ce qui serait erroné puisqu'il s'agit d'un chat).

Favoris.replaceItemAt(4, "Lucky", "Chat");

Voir aussi

FListBox.addItemAt, FListBox.getItemAt