Forums Développement Multimédia

Les formations Mediabox
Les formations Mediabox

Le contrôle CheckBox

Compatible Flex 3. Cliquer pour en savoir plus sur les compatibilités.Compatible ActionScript 3. Cliquer pour en savoir plus sur les compatibilités.Par tannoy (Antony Chauviré), le 13 mars 2010

Cet article est une traduction de l'aide Adobe Flex.

Adobe a donné son accord concernant la traduction de la documentation.

Introduction

Le contrôle CheckBox est un contrôle graphique couramment utilisé, contenant une marque de sélection ou non. Vous pouvez utiliser des contrôles CheckBox partout où vous devez récupérer un ensemble de valeurs vraies ou fausses qui ne sont pas mutuellement exclusives.

Vous pouvez ajouter une légende de texte au contrôle CheckBox et la placer à gauche, à droite, au dessus ou en dessous. Flex coupe la légende pour l'adapter aux limites du contrôle.

L'image suivante montre un contrôle CheckBox sélectionné:

Pour voir le code utilisé pour cet exemple, regardez l'exemple ci-dessous.

Quand un utilisateur clique sur un contrôle CheckBox ou sur sa légende, le contrôle CheckBox change son état de sélectionné à non sélectionné, ou de non sélectionné à sélectionné.

Un contrôle CheckBox peut avoir l'un des deux états désactivés, sélectionné ou non sélectionné. Par défaut, un contrôle CheckBox désactivé affiche un arrière-plan et une marque de sélection de couleur différente d'un contrôle CheckBox activé.

Création d'un contrôle CheckBox

Vous définissez un contrôle CheckBox en MXML en utilisant la balise <mx:CheckBox>, comme le montre l'exemple ci-dessous. Spécifiez une valeur à la propriété id si vous souhaitez utiliser votre contrôle ailleurs dans une balise MXML ou dans un bloc ActionScript.

<?xml version="1.0"?>
<!-- controls\checkbox\CBSimple.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:VBox>
        <mx:CheckBox width="100" label="Employee?"/> 
    </mx:VBox>
</mx:Application>

Le fichier SWF de l'exemple ci-dessus est affiché ci-dessous :

L"extension Adobe Flash Plugin est nécessaire pour afficher ce contenu.

Vous pouvez aussi utiliser la propriété selected pour générer une case à cocher qui est cochée par défaut:

<?xml version="1.0"?>
<!-- controls\checkbox\CBSelected.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:VBox>
        <mx:CheckBox width="100" label="Employee?" selected="true"/> 
    </mx:VBox>
</mx:Application>

Le fichier SWF de l'exemple ci-dessus est affiché ci-dessous :

L"extension Adobe Flash Plugin est nécessaire pour afficher ce contenu.

Interaction utilisateur du contrôle CheckBox

Quand un contrôle CheckBox est actif et que l'utilisateur clique dessus, le contrôle reçoit le focus et affiche son apparence coché et décoché en fonction de son état initial. La surface entière du contrôle CheckBox est la zone cliquable; si la légende du contrôle CheckBox est plus large que son icône, la région cliquable s'étend au dessus et en dessous de l'icône.

Si l'utilisateur déplace le pointeur de souris en dehors de la surface du contrôle CheckBox ou de sa légende tout en conservant le bouton de souris appuyé, l'apparence du contrôle CheckBox revient à son état initial et le contrôle conserve le focus. L'état du contrôle CheckBox ne change pas tant que l'utilisateur ne relâche pas le pointeur de souris au dessus du contrôle.

L'utilisateur ne peut pas interagir avec un contrôle CheckBox quand il est inactif.