F > FListBox.setDataProvider

FListBox.setDataProvider

Disponibilité

Flash Player 6.

Usage

maListe.setDataProvider(fournisseurDeDonnées)

Paramètres

fournisseurDeDonnées Un tableau de chaînes de texte contenant les éléments à ajouter, une occurrence de l'objet Array spécifiant les éléments à ajouter, ou une occurrence de la classe DataProvider.

Renvoie

Rien.

Description

Méthode ; enregistre un objet externe (fournisseurDeDonnées) comme source de données pour le composant de zone de liste. Si fournisseurDeDonnées est une occurrence de l'objet Array, l'objet peut spécifier label, data, ou les deux, puisque les propriétés de l'objet et le contenu du tableau peuvent être copiés dans la zone de liste comme étiquettes, données, ou les deux. Si fournisseurDeDonnées est une occurrence de la classe DataProvider, elle doit implémenter l'API DataProvider définie dans le symbole DataProvider du dossier FlashUIComponents/CoreAssets/ClassTree de la bibliothèque. L'API DataProvider est destinée aux utilisateurs confirmés, les autres devant utiliser un tableau ou un objet Array.

Exemple

Le code suivant spécifie l'objet Array listeDeRédacteurs comme fournisseur de données pour listBox1.

listBox1.setDataProvider(listeDeRédacteurs);

Le code suivant crée le tableau listeDeRédacteurs pour afficher les étiquettes des éléments affichés dans fillesGéniales.

listeDeRédacteurs = new Array();
listeDeRédacteurs[0] = "Jody";
listeDeRédacteurs[1] = "Mary";
listeDeRédacteurs[2] = "Marcelle"; 
listeDeRédacteurs[3] = "Dale";
listeDeRédacteurs[4] = "Stephanie"; 
listeDeRédacteurs[5] = "Barbara"; 

Le code suivant crée le tableau listeDéléments1, qui spécifie l'étiquette et les données des éléments de la liste. Cet objet Array pourrait être utilisé comme autre fournisseur de données pour listBox1.

listeDéléments1 = new Array();
for (i=0; i<10; i++) {

// créer un élément
  var monElément = new Object();
  monElément.label = "Elément" + i;
  monElément.data = 75;

// le placer dans le tableau
listeDéléments1[i] = monElément;
}

Le code suivant spécifie listeDesEditeurs, une occurrence de la classe DataProvider, comme fournisseur de données pour listBox1.

listBox1.setDataProvider(listeDesEditeurs);

Le code suivant crée une occurrence de la classe DataProvider et ajoute ensuite les étiquettes des éléments à l'aide de la méthode addItem de DataProvider.

Remarque   La méthode addItem n'est qu'une des méthodes de la classe DataProvider. Les programmeurs intéressés par l'utilisation de la classe DataProvider pourront consulter le symbole DataProvider dans le dossier FlashUIComponents/CoreAssets/ClassTree de la bibliothèque avant d'essayer d'utiliser ces méthodes.

listeDesEditeurs = new DataProviderClass();
listeDesEditeurs.addItem("Anne");
listeDesEditeurs.addItem("Rosana");
listeDesEditeurs.addItem("Lisa");
listeDesEditeurs.addItem("Rebecca");

Voir aussi

FListBox.addItem, FListBox.replaceItemAt, FListBox.sortItemsBy