F > FComboBox.addItemAt

FComboBox.addItemAt

Disponibilité

Flash Player 6.

Usage

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

Paramètres

index Un entier spécifiant la position à laquelle insérer l'élément.

étiquette Une chaîne identifiant l'élément de liste de la zone de liste.

données La valeur à associer à 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) à la liste déroulante, à la position d'index spécifiée. Le paramètre données peut être un objet Flash, une chaîne, une valeur booléenne, un entier, un objet ou un clip. La liste est mise à jour et la barre de défilement est redimensionnée à mesure que chaque élément est ajouté.

Le composant ComboBox 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 liste déroulante ou à plusieurs listes déroulantes.

Exemple

Le code suivant ajoute l'élément Justin avec une valeur associée de As comme cinquième élément de la liste de la liste déroulante Favoris.

Favoris.addItemAt(4, "Justin", As);

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

Voir aussi

FComboBox.getItemAt, FComboBox.removeItemAt, FComboBox.replaceItemAt, FComboBox.setDataProvider, FComboBox.sortItemsBy