Héritage MovieClip > Classe UIObject > Classe UIComponent > Classe SimpleButton > Button

Nom de classe ActionScript mx.controls.Button

Les propriétés de la classe Button permettent d'effectuer les opérations suivantes au moment de l'exécution : ajouter une icône à un bouton, créer une étiquette de texte et indiquer si le bouton doit se comporter comme un bouton bascule ou un bouton-poussoir.

La définition d'une propriété de la classe Button avec ActionScript annule le paramètre du même nom défini dans l'inspecteur Propriétés ou des composants.

Le composant Button utilise le gestionnaire de focus pour remplacer le rectangle de focus par défaut de Flash Player et tracer un rectangle de focus personnalisé aux coins arrondis.
Pour plus d'informations, consultez Création de la navigation personnalisée du focus dans Utilisation des composants ActionScript 2.0.

Toutes les classes de composants ont une propriété version qui correspond à une propriété de classe. Les propriétés de classe ne sont disponibles que pour la classe elle-même. La propriété version renvoie une chaîne qui indique la version du composant. Pour accéder à cette propriété, utilisez le code suivant :

trace(mx.controls.Button.version);

REMARQUE

Le code trace(myButtonInstance.version); renvoie undefined.

La classe du composant Button diffère de l'objet Button ActionScript intégré.

Méthodes de la classe Button

La classe Button ne présente pas de méthodes exclusives.

Méthodes héritées de la classe UIObject

Le tableau suivant énumère les méthodes de la classe Button héritées de la classe UIObject. Lors de l'appel à ces méthodes depuis l'objet Button, utilisez le formulaire buttonInstance.methodName.

Méthode	Description
UIObject.createClassObject()	Crée un objet dans la classe spécifiée.
UIObject.createObject()	Crée un sous-objet dans un objet.
UIObject.destroyObject()	Détruit une occurrence de composant.
UIObject.doLater()	Appelle une fonction lorsque les paramètres ont été définis dans les inspecteurs des propriétés et des composants.
UIObject.getStyle()	Obtient la propriété de style de l'objet ou de la déclaration de style.
UIObject.invalidate()	Marque l'objet de sorte qu'il soit redessiné dans le prochain intervalle d'image.
UIObject.move()	Déplace l'objet jusqu'à l'emplacement demandé.
UIObject.redraw()	Force la validation de l'objet pour qu'il soit dessiné dans l'image actuelle.
UIObject.setSize()	Redimensionne l'objet à la taille demandée.
UIObject.setSkin()	Définit une enveloppe dans l'objet.
UIObject.setStyle()	Définit la propriété de style sur l'objet ou la déclaration de style.

Méthodes héritées de la classe UIComponent

Le tableau suivant énumère les méthodes de la classe Button héritées de la classe UIComponent. Lors de l'appel à ces méthodes depuis l'objet Button, utilisez le formulaire buttonInstance.methodName.

Méthode	Description
UIComponent.getFocus()	Renvoie une référence à l'objet ayant le focus.
UIComponent.setFocus()	Attribue le focus à l'occurrence de composant.

Propriétés de la classe Button

Le tableau suivant présente les propriétés de la classe Button.

Propriété	Description
Button.icon	Spécifie une icône pour une occurrence de bouton.
Button.label	Spécifie le texte qui apparaît dans un bouton.
Button.labelPlacement	Spécifie l'orientation du texte de l'étiquette par rapport à une icône.

Propriétés héritées de la classe SimpleButton

Le tableau suivant énumère les propriétés de la classe Button héritées de la classe SimpleButton. Lorsque vous accédez à ces propriétés, utilisez le formulaire buttonInstance.propertyName.

Propriété	Description
SimpleButton.emphasized	Indique si un bouton a l'aspect d'un bouton-poussoir par défaut.
SimpleButton.emphasizedStyleDeclaration	Déclaration de style lorsque la propriété emphasized est définie sur true.
SimpleButton.selected	Valeur booléenne indiquant si le bouton est sélectionné (true) ou non (false). La valeur par défaut est false.
SimpleButton.toggle	Valeur booléenne indiquant si le comportement du bouton est celui d'un bouton bascule (true) ou non (false). La valeur par défaut est false.

Propriétés héritées de la classe UIObject

Le tableau suivant énumère les propriétés de la classe Button héritées de la classe UIObject. Lors de l'appel à ces propriétés depuis l'objet Button, utilisez le formulaire buttonInstance.propertyName.

Propriété	Description
UIObject.bottom	Lecture seule ; position du bord inférieur de l'objet par rapport au bord inférieur de son parent.
UIObject.height	Lecture seule ; hauteur de l'objet, en pixels.
UIObject.left	Lecture seule ; bord gauche de l'objet, en pixels.
UIObject.right	Lecture seule ; position du bord droit de l'objet par rapport au bord droit de son parent.
UIObject.scaleX	Nombre indiquant le facteur de redimensionnement dans la direction x de l'objet par rapport à son parent.
UIObject.scaleY	Nombre indiquant le facteur de redimensionnement dans la direction y de l'objet par rapport à son parent.
UIObject.top	Lecture seule ; renvoie la position du bord supérieur de l'objet par rapport à son parent.
UIObject.visible	Valeur booléenne indiquant si l'objet est visible (true) ou non (false).
UIObject.width	Lecture seule ; largeur de l'objet, en pixels.
UIObject.x	Lecture seule ; bord gauche de l'objet, en pixels.
UIObject.y	Lecture seule ; bord supérieur de l'objet, en pixels.

Propriétés héritées de la classe UIComponent

Le tableau suivant énumère les propriétés de la classe Button héritées de la classe UIComponent. Lors de l'appel à ces propriétés depuis l'objet Button, utilisez le formulaire buttonInstance.propertyName.

Propriété	Description
UIComponent.enabled	Indique si le composant peut recevoir le focus et la saisie.
UIComponent.tabIndex	Nombre indiquant l'ordre de tabulation pour un composant dans un document.

Evénements de la classe Button

La classe Button ne présente pas d'événements exclusifs.

Evénements hérités de la classe SimpleButton

Le tableau suivant énumère les événements de la classe Button hérités de la classe SimpleButton.

Propriété	Description
SimpleButton.click	Diffusé lorsque l'utilisateur clique sur un bouton.

Evénements hérités de la classe UIObject

Le tableau suivant énumère les événements de la classe Button hérités de la classe UIObject.

Evénement	Description
UIObject.draw	Diffusé lorsqu'un objet est sur le point de dessiner ses graphiques.
UIObject.hide	Diffusé lorsqu'un objet passe de l'état visible à l'état invisible.
UIObject.load	Diffusé lorsque des sous-objets sont créés.
UIObject.move	Diffusé lorsque l'objet a été déplacé.
UIObject.resize	Diffusé lorsqu'un objet a été redimensionné.
UIObject.reveal	Diffusé lorsqu'un objet passe de l'état invisible à l'état visible.
UIObject.unload	Diffusé lorsque les sous-objets sont purgés.

Evénements hérités de la classe UIComponent

Le tableau suivant énumère les événements de la classe Button hérités de la classe UIComponent.

Evénement	Description
UIComponent.focusIn	Diffusé lorsqu'un objet reçoit le focus.
UIComponent.focusOut	Diffusé lorsqu'un objet perd le focus.
UIComponent.keyDown	Diffusé lorsqu'une touche est enfoncée.
UIComponent.keyUp	Diffusé lorsqu'une touche est relâchée.