F > FPushButton.setClickHandler

FPushButton.setClickHandler

Disponibilité

Flash Player 6.

Usage

monBoutonPoussoir.setClickHandler(nomDeFonction, [emplacement])

Paramètres

nomDeFonction Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque l'utilisateur relâche le bouton-poussoir. 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 une fonction de gestionnaire à appeler lorsque l'utilisateur relâche le bouton-poussoir. 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 clic 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 onClick comme fonction appelée lorsque la valeur de bouton1 change. Le paramètre emplacement n'étant pas spécifié, onClick doit se trouver dans le scénario que l'occurrence de composant. Le paramètre composant de onClick 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 onClick en tant que son gestionnaire de changement). Les actions définies dans onClick spécifient que, lorsque l'utilisateur relâche un bouton, l'étiquette du bouton est affichée dans la fenêtre Sortie.

bouton1.setClickHandler("onClick");
function onClick(composant){ 
trace(composant._name); 
} 

Si, dans l'exemple précédent, onClick 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 :

bouton1.setChangeHandler("onClick", _parent._parent._parent);

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

monObjet = new Object();
monObjet.onClick = function(composant){
trace(composant._name); 
}
bouton1.setChangeHandler("onClick", monObjet);