F > FComboBox.setDataProvider

FComboBox.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 liste déroulante. 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 liste déroulante 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/Core Assets/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 listeDeGens1 comme fournisseur de données pour comboBox1.

comboBox1.setDataProvider(listeDeGens1);

Le code suivant crée le tableau listeDeGens pour afficher les étiquettes des éléments affichés dans comboBox1.

listeDeGens = new Array();
listeDeGens[0] = "BHall";
listeDeGens[1] = "CMoock";
listeDeGens[2] = "MWobensmith"; 
listeDeGens[3] = "MShepherd"; 

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 comboBox1.

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 donnéesDeListe, une occurrence de la classe DataProvider, comme fournisseur de données pour comboBox1.

comboBox1.setDataProvider(donnéesDeListe);

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.

donnéesDeListe = new DataProviderClass();

donnéesDeListe.addItem("Devra");
donnéesDeListe.addItem("Delia");
donnéesDeListe.addItem("Vashti");
donnéesDeListe.addItem("Alicia");

Voir aussi

FComboBox.addItem, FComboBox.replaceItemAt, FComboBox.sortItemsBy