Disponibilité

Flash Player 6 (6.0.79.0).

Edition

Flash MX 2004.

Utilisation

radioButtonInstance.groupName
radioButtonGroup.groupName

Description

Propriété : définit le nom du groupe d'une occurrence de bouton radio ou d'un groupe de boutons radio. Vous pouvez utiliser cette propriété afin d'obtenir ou de définir un nom de groupe pour une occurrence de bouton radio ou pour un groupe de boutons radio. L'appel de cette méthode annule la valeur du paramètre groupName définie lors de la programmation. La valeur par défaut est « radioGroup ».

Exemple

L'exemple suivant définit le nom d'un groupe de trois boutons radio sur myrbGroup.
Il positionne les boutons puis crée un écouteur pour un événement click sur le groupe de boutons radio. Lorsque l'utilisateur clique sur un bouton radio, l'exemple affiche la propriété groupName pour le bouton sur lequel vous avez cliqué.

Vous devez d'abord faire glisser un composant RadioButton depuis le panneau Composants jusqu'à la bibliothèque du document actif, puis ajouter le code suivant à l'image 1 du scénario principal :

/**
 Requiert :
  - Composant RadioButton dans la bibliothèque
*/

import mx.controls.RadioButton;

this.createClassObject(RadioButton, "first_rb", 10, {label:"first", groupName:"myrbGroup"});
this.createClassObject(RadioButton, "second_rb", 20, {label:"second", groupName:"myrbGroup"});
this.createClassObject(RadioButton, "third_rb", 30, {label:"third", groupName:"myrbGroup"});

// Positionnement des boutons radio sur la scène.
second_rb.move(0, first_rb.y + first_rb.height);
third_rb.move(0, second_rb.y + second_rb.height);

// Création d'un objet écouteur.
var rbListener:Object = new Object(); 
rbListener.click = function(evt_obj:Object){
   trace("The selected radio button group name is " + evt_obj.target.groupName);
} 
// Ajout de l'écouteur.
myrbGroup.addEventListener("click", rbListener);