F > FRadioButton.setChangeHandler

FRadioButton.setChangeHandler

Disponibilité

Flash Player 6.

Usage

monBoutonRadio.setChangeHandler(nomDeFonction, [emplacement])
monGroupeDeBoutonsRadio.setChangeHandler(nomDeFonction, [emplacement])

Paramètres

nomDeFonction Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque la valeur d'un bouton radio 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 à 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 de changement à appeler lorsque la sélection du bouton radio 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.

Usage 1. Spécifie la fonction à appeler si l'occurrence de bouton radio monBoutonRadio est sélectionnée ou désélectionnée.

Usage 2. Spécifie la fonction à appeler si le bouton radio sélectionné dans le groupe GroupeDeBoutonsRadio change. La spécification d'une fonction pour un groupe de boutons radio revient à spécifier la même fonction individuellement pour tous les boutons radio de ce groupe avec monBoutonRadio.setChangeHandler.

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

Usage 1. Le code suivant spécifie monGestionnaire comme fonction appelée lorsque radio1 est sélectionné.

radio1.setChangeHandler("monGestionnaire");

Usage 2. Le code suivant spécifie onChange comme fonction appelée lorsqu'un bouton radio du groupe groupeBoutonsRadio1 est sélectionné.

groupeBoutonsRadio1.setChangeHandler("onChange");

Le code suivant spécifie onChange comme fonction appelée lorsque l'utilisateur sélectionne un bouton radio de groupeBoutonsRadio1. Le paramètre emplacement n'étant pas spécifié, onChange doit se trouver dans le scénario que l'occurrence de composant. Le paramètre composant de onChange est automatiquement rempli avec le composant (le composant qui a changé en résultat de la saisie utilisateur et qui spécifie onChange en tant que son gestionnaire de changement), dans ce cas, un bouton radio d'un groupe. Les actions définies dans onChange spécifient que, lorsque l'utilisateur sélectionne un bouton radio, le nom d'occurrence est affiché dans la fenêtre Sortie.

groupeBoutonsRadio1.setChangeHandler("onChange"); 
function onChange(composant){ 
trace(composant._name); 
} 

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

groupeBoutonsRadio1.setChangeHandler("onChange", _parent._parent._parent);

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

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