F > FListBox.setChangeHandler

FListBox.setChangeHandler

Disponibilité

Flash Player 6.

Usage

maListe.setChangeHandler(nomDeFonction, [emplacement])

Paramètres

nomDeFonction Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque la sélection de la liste change. Si le paramètre emplacement n'est pas spécifié, cette fonction doit se trouver dans le même scénario que l'occurrence de composant.

emplacement Une référence de chemin à un objet de données, un clip ou scénario contenant la fonction spécifiée. Ce paramètre est facultatif et prend par défaut le scénario parent du composant.

Renvoie

Rien.

Description

Méthode ; spécifie un gestionnaire de changement à appeler lorsque la sélection de la zone de liste change. Vous pouvez spécifier la même fonction de gestionnaire de changement pour plusieurs composants, la fonction acceptant toujours l'occurrence du composant changé comme paramètre. L'appel de cette méthode annule la valeur du paramètre de gestionnaire de changement spécifiée au cours de la programmation.

Pour plus d'informations, consultez la section Rédaction de fonctions de gestionnaire de changement pour les composants du chapitre Utilisation des composants de Utilisation de Flash.

Exemple

Le code suivant spécifie monGestionnaire comme fonction appelée lorsque la valeur de listBox1 change. Le paramètre emplacement n'étant pas spécifié, monGestionnaire doit se trouver dans le scénario que l'occurrence de composant.

Le paramètre composant de monGestionnaire est automatiquement rempli avec l'occurrence d'un composant (le composant qui a changé en résultat de la saisie utilisateur et qui spécifie monGestionnaire en tant que son gestionnaire de changement). Les actions définies dans monGestionnaire spécifient que, lorsque l'utilisateur sélectionne un élément de la liste, l'étiquette de cet élément est affichée dans la fenêtre Sortie.

listBox1.setChangeHandler("monGestionnaire");
function monGestionnaire(composant){
   trace(listBox1.getSelectedItem().label); 
} 

Si, dans l'exemple précédent, monGestionnaire est une fonction située dans le scénario arrière-grand-parent du scénario du composant, la première ligne de code serait la suivante :

listBox1.setChangeHandler("monGestionnaire", _parent._parent._parent);

Le code suivant crée la fonction monGestionnaire dans une occurrence de monObjet (de classe Object), puis spécifie monGestionnaire comme fonction pour listBox1.

monObjet = new Object();
monObjet.monGestionnaire = function(composant){
trace(listBox1.getSelectedItem().label);
}
listBox1.setChangeHandler("monGestionnaire", monObjet);