F > FListBox.addItemAt

FListBox.addItemAt

Disponibilité

Flash Player 6.

Usage

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

Paramètres

index Un entier spécifiant la position d'index à laquelle ajouter l'élément.

étiquette Une chaîne de texte spécifiant l'étiquette de l'élément.

données Une valeur associée à l'élément de liste. Ce paramètre est facultatif.

Renvoie

Rien.

Description

Méthode ; ajoute un élément avec l'étiquette spécifiée et les données associées (facultatif) à l'index spécifié et met la zone de liste à jour. Le paramètre données peut être un objet Flash, une chaîne, une valeur booléenne, un entier, un objet ou un clip.

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

N'ajoutez pas plus de 400 éléments dans une seule image, et ce afin d'obtenir les meilleurs résultats de performance. Cela s'applique en fonction du fait que vous ajoutez les éléments à une seule zone de liste ou à plusieurs zones de liste.

Exemple

Le code suivant ajoute l'élément Dave avec une valeur associée de ami comme cinquième élément de la zone de liste listeDeGens.

listeDeGens.addItemAt(4, "Dave", ami);

Vous trouverez des exemples de chargement d'un grand nombre d'éléments sous FListBox.addItem.

Voir aussi

FListBox.getSelectedItem, FListBox.removeItemAt, FListBox.replaceItemAt, FListBox.sortItemsBy