Packagefl.controls
Classepublic class Button
HéritageButton Inheritance LabelButton Inheritance BaseButton Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implémente IFocusManagerComponent

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Le composant Button est un bouton rectangulaire couramment utilisé. Les composants Button affichent une étiquette de texte, une icône ou les deux.

Les composants Button sont généralement associés à une méthode de gestionnaire d'événement qui écoute les événements click et, une fois l'événement click distribué, exécutent la tâche spécifiée. Lorsque l'utilisateur clique sur un bouton activé, ce dernier diffuse les événements click et buttonDown. S'il n'est pas activé, le bouton diffuse d'autres événements tels que mouseMove, mouseOver, mouseOut, rollOver, rollOut, mouseDown et mouseUp.

Vous pouvez modifier l'aspect du bouton en associant une enveloppe aux différents états de bouton. Il est également possible de définir un composant Button en tant que bouton poussoir ou bouton bascule.

Consulter les exemples



Propriétés publiques
 PropriétéDéfini par
 InheritedaccessibilityProperties : AccessibilityProperties
Options d'accessibilité actuelles de l'objet d'affichage.
DisplayObject
 Inheritedalpha : Number
Indique la valeur de transparence alpha de l'objet spécifié.
DisplayObject
 InheritedautoRepeat : Boolean
Récupère ou définit une valeur booléenne qui indique si l'événement buttonDown est distribué plusieurs fois lorsque l'utilisateur maintient le bouton de la souris enfoncé sur le composant.
BaseButton
 InheritedblendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser.
DisplayObject
 InheritedblendShader : Shader
[lecture seule] Définit un shader utilisé pour le fondu de l'arrière-plan et du premier plan.
DisplayObject
 InheritedbuttonMode : Boolean
Spécifie le mode de bouton du sprite.
Sprite
 InheritedcacheAsBitmap : Boolean
Si true est défini, Flash Player ou Adobe AIR place en mémoire cache une version bitmap interne de l’objet d'affichage.
DisplayObject
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 InheritedcontextMenu : NativeMenu
Spécifie le menu contextuel associé à l'objet.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Spécifie si l'objet reçoit les événements doubleClick.
InteractiveObject
 InheriteddropTarget : DisplayObject
[lecture seule] Spécifie l'objet d'affichage sur lequel le sprite est glissé ou sur lequel il a été déposé.
Sprite
  emphasized : Boolean
Lit ou définit une valeur booléenne qui indique si une bordure doit être tracée autour du composant Button lorsque l'état du bouton est relevé.
Button
 Inheritedenabled : Boolean
[override] Lit ou définit une valeur qui indique si le composant peut accepter une entrée de l'utilisateur.
BaseButton
 Inheritedfilters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l'objet d'affichage.
DisplayObject
 InheritedfocusEnabled : Boolean
Récupère ou définit une valeur booléenne indiquant si le composant peut recevoir le focus après un clic de l'utilisateur sur son entrée.
UIComponent
 InheritedfocusManager : IFocusManager
Récupère ou définit le FocusManager qui contrôle le focus pour ce composant et ses homologues.
UIComponent
 InheritedfocusRect : Object
Spécifie si l'objet affiche un rectangle de focus.
InteractiveObject
 Inheritedgraphics : Graphics
[lecture seule] Spécifie l'objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel.
Sprite
 Inheritedheight : Number
[override] Récupère ou définit la hauteur du composant, en pixels.
UIComponent
 InheritedhitArea : Sprite
Désigne un autre sprite qui fera office de zone active d'un sprite.
Sprite
 Inheritedlabel : String
Récupère ou définit l'étiquette de texte du composant.
LabelButton
 InheritedlabelPlacement : String
Position de l'étiquette par rapport à une icône spécifique.
LabelButton
 InheritedloaderInfo : LoaderInfo
[lecture seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d'affichage.
DisplayObject
 Inheritedmask : DisplayObject
L'objet d'affichage appelant est masqué par l'objet mask spécifié.
DisplayObject
 InheritedmouseChildren : Boolean
Détermine si les enfants de l'objet prennent ou non en charge la souris.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Spécifie si l'objet reçoit les messages souris.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Récupère ou définit une valeur indiquant si le composant peut recevoir le focus après un clic de l'utilisateur sur son entrée.
UIComponent
 InheritedmouseX : Number
[lecture seule] Indique la coordonnée x de la position de la souris, en pixels.
DisplayObject
 InheritedmouseY : Number
[lecture seule] Indique la coordonnée y de la position de la souris, en pixels.
DisplayObject
 Inheritedname : String
Indique le nom d'occurrence de DisplayObject.
DisplayObject
 InheritednumChildren : int
[lecture seule] Renvoie le nombre d'enfants de l'objet.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Indique si l'objet d'affichage est opaque avec une couleur d'arrière-plan spécifique.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[lecture seule] Indique l'objet DisplayObjectContainer qui contient l'objet d'affichage.
DisplayObject
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
 Inheritedroot : DisplayObject
[lecture seule] Pour un objet d'affichage résidant dans un fichier SWF chargé, la propriété root correspond à l'objet d'affichage de premier niveau dans la partie de la structure arborescente de la liste d'affichage représentée par ce fichier.
DisplayObject
 Inheritedrotation : Number
Indique la rotation de l'occurrence de DisplayObject, en degrés, à partir de son orientation d'origine.
DisplayObject
 InheritedrotationX : Number
Indique la rotation de l'axe des x de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.
DisplayObject
 InheritedrotationY : Number
Indique la rotation de l'axe des y de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.
DisplayObject
 InheritedrotationZ : Number
Indique la rotation de l'axe des z de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.
DisplayObject
 Inheritedscale9Grid : Rectangle
Grille de mise à l'échelle en vigueur.
DisplayObject
 InheritedscaleX : Number
[override] Multiplie la largeur actuelle du composant par un facteur de redimensionnement.
UIComponent
 InheritedscaleY : Number
[override] Multiplie la hauteur actuelle du composant par un facteur de redimensionnement.
UIComponent
 InheritedscaleZ : Number
Indique l'échelle de profondeur (pourcentage) de l'objet tel qu'elle est appliquée à partir du point d'alignement.
DisplayObject
 InheritedscrollRect : Rectangle
Cadre de délimitation du défilement de l'objet d'affichage.
DisplayObject
 Inheritedselected : Boolean
[override] Lit ou définit une valeur booléenne qui indique si un bouton de basculement est en position activée ou désactivée.
LabelButton
 InheritedsoundTransform : SoundTransform
Contrôle le son à l'intérieur du sprite.
Sprite
 Inheritedstage : Stage
[lecture seule] Scène de l'objet d'affichage.
DisplayObject
 InheritedtabChildren : Boolean
Détermine si les enfants de l'objet prennent ou non en charge la tabulation.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Indique si cet objet est spécifié dans l'ordre de tabulation.
InteractiveObject
 InheritedtabIndex : int
Spécifie l'ordre de tabulation des objets dans un fichier SWF.
InteractiveObject
 InheritedtextField : TextField
Une référence au champ de texte interne du composant.
LabelButton
 InheritedtextSnapshot : TextSnapshot
[lecture seule] Renvoie un objet TextSnapshot pour l'occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtoggle : Boolean
Lit ou définit une valeur booléenne qui indique si un bouton peut être activé ou désactivé.
LabelButton
 Inheritedtransform : Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d'un objet d'affichage.
DisplayObject
 InheriteduseHandCursor : Boolean
Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque la souris survole un sprite dont la propriété buttonMode est réglée sur true.
Sprite
 Inheritedversion : String = "3.0.0.16"
Numéro de version des composants.
UIComponent
 Inheritedvisible : Boolean
[override] Récupère ou définit une valeur indiquant si l'occurrence du composant actif est visible.
UIComponent
 Inheritedwidth : Number
[override] Récupère ou définit la largeur du composant, en pixels.
UIComponent
 Inheritedx : Number
[override] Récupère ou définit la coordonnée x représentant la position du composant le long de l'axe x au sein de son conteneur parent.
UIComponent
 Inheritedy : Number
[override] Récupère ou définit la coordonnée y représentant la position du composant le long de l'axe y au sein de son conteneur parent.
UIComponent
 Inheritedz : Number
Indique la position de coordonnée z le long de l'axe des z de l'occurrence DisplayObject par rapport au conteneur 3D parent.
DisplayObject
Méthodes publiques
 MéthodeDéfini par
  
Crée une nouvelle occurrence du composant Button.
Button
 Inherited
Ajoute une occurrence enfant de DisplayObject à cette occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Ajoute une occurrence enfant de DisplayObject à cette occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
 Inherited
Indique si les restrictions de sécurité entraîneraient l'omission des objets d'affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié.
DisplayObjectContainer
 Inherited
Définit une propriété de style depuis cette occurrence de composant.
UIComponent
 Inherited
Détermine si l'objet d'affichage spécifié est un enfant de l'occurrence de DisplayObjectContainer ou l'occurrence en tant que telle.
DisplayObjectContainer
 Inherited
Distribue un événement dans le flux d'événements.
EventDispatcher
 Inherited
Affiche ou masque l'indicateur de focus dans ce composant.
UIComponent
 Inherited
Déclenche une opération de dessin immédiate, sans tout annuler comme le fait invalidateNow.
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Renvoie un rectangle qui définit la zone de l'objet d'affichage relativement au système de coordonnées de l'objet targetCoordinateSpace.
DisplayObject
 Inherited
Renvoie l'occurrence enfant de l'objet d'affichage associée à l'index spécifié.
DisplayObjectContainer
 Inherited
Renvoie l'objet d'affichage enfant portant le nom spécifié.
DisplayObjectContainer
 Inherited
Renvoie la position d'index d'une occurrence enfant de DisplayObject.
DisplayObjectContainer
 Inherited
Récupère l'objet qui détient actuellement le focus.
UIComponent
 Inherited
Renvoie un tableau d'objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l'occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Renvoie un rectangle qui définit les limites de l'objet d'affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes.
DisplayObject
 Inherited
Extrait une propriété de style définie dans la chaîne de recherche de style du composant.
UIComponent
  
[statique] Récupère la texture de style par défaut du composant actif.
Button
 Inherited
Convertit l'objet point des coordonnées de scène (globales) vers les coordonnées de l'objet d'affichage (locales).
DisplayObject
 Inherited
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d'un objet d'affichage tridimensionnel (locales).
DisplayObject
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d'événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Evalue le cadre de délimitation de l'objet d'affichage pour savoir s'il recouvre ou recoupe le cadre de délimitation de l'objet d'affichage obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalue l'objet d'affichage pour savoir s'il recouvre ou recoupe le point spécifié par les paramètres x et y.
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
Marque une propriété comme non valide, puis redessine le composant dans la prochaine image, sauf spécification contraire.
UIComponent
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Convertit un point tridimensionnel des coordonnées de l'objet d'affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales).
DisplayObject
 Inherited
Convertit l'objet point des coordonnées de l'objet d'affichage (locales) vers les coordonnées de la scène (globales).
DisplayObject
 Inherited
[statique] Fusionne les styles de plusieurs classes en un seul objet.
UIComponent
 Inherited
Déplace le composant à la position spécifiée dans son parent.
UIComponent
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Supprime l'occurrence enfant de DisplayObject spécifiée de la liste d'enfants de l'occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Supprime une occurrence enfant de DisplayObject de la position d'index spécifiée dans la liste d'enfants de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l'objet EventDispatcher.
EventDispatcher
 Inherited
Modifie la position d'un enfant existant dans le conteneur d'objet d'affichage.
DisplayObjectContainer
 Inherited
Définit le focus sur ce composant.
UIComponent
 Inherited
Définit l'état de la souris par du code ActionScript.
BaseButton
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
setSize(width:Number, height:Number):void
Définit le composant en fonction de la largeur et de la hauteur spécifiées.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Définit une propriété de style pour cette occurrence de composant.
UIComponent
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permet à l'utilisateur de faire glisser le sprite spécifié.
Sprite
 Inherited
Met fin à la méthode startDrag().
Sprite
 Inherited
Intervertit l'ordre z (ordre d'empilement du premier plan vers l'arrière-plan) des deux objets enfants spécifiés.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Intervertit l'ordre z (ordre d'empilement du premier plan vers l'arrière-plan) des objets enfants aux deux positions d'index spécifiées dans la liste d'enfants.
DisplayObjectContainer
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Valide et met à jour les propriétés et la mise en forme de cet objet, puis le redessine si nécessaire.
UIComponent
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
 Inherited
Vérifie si un écouteur d'événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d'événement spécifié.
EventDispatcher
Méthodes protégées
 MéthodeDéfini par
 Inherited
Renvoie le style spécifié pour un composant, en tenant compte de tous les styles définis au niveau global, au niveau du composant et au niveau de l'occurrence.
UIComponent
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l'application Flash Player obtient le focus du système d'exploitation et devient active.EventDispatcher
 InheritedDistribué lorsqu'un objet d'affichage est ajouté à la liste d'affichage.DisplayObject
 InheritedEnvoyé lorsqu'un objet d'affichage est ajouté dans la liste d'affichage de la scène, directement ou par l'intermédiaire d'une arborescence secondaire qui contient l'objet d'affichage.DisplayObject
 InheritedDistribué lorsque l'utilisateur clique sur le composant Button.BaseButton
 InheritedDistribué lorsque la valeur de la propriété selected change pour un composant Button à basculement.BaseButton
 InheritedDistribué lorsque l'utilisateur sélectionne 'Effacer' (ou 'Supprimer') dans le menu contextuel.InteractiveObject
 InheritedDistribué après la réception d'une entrée de la souris ou de la barre d'espace par le bouton bascule.LabelButton
 InheritedDistribué lorsque l'action d'un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR.InteractiveObject
 InheritedDistribué lorsque l'utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne 'Copier' dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsque l'utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne 'Couper' dans le menu contextuel.InteractiveObject
 Inherited[Evénement de diffusion] Distribué lorsque l'application Flash Player ou AIR perd le focus du système d'exploitation et devient inactive.EventDispatcher
 InheritedDistribué lorsque l'utilisateur appuie sur le bouton principal d'un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d'InteractiveObject si l'indicateur doubleClickEnabled de cet objet est réglé sur true.InteractiveObject
 Inherited[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.DisplayObject
 Inherited[événement de diffusion] Distribué lorsque la tête de lecture quitte l'image en cours.DisplayObject
 InheritedDistribué après la prise de focus par un objet d'affichage.InteractiveObject
 InheritedDistribué après la perte de focus par un objet d'affichage.InteractiveObject
 Inherited[événement de diffusion] Distribué après l'exécution des constructeurs des objets d'affichage d'image, mais avant celle des scripts d'image.DisplayObject
 InheritedDistribué après que la visibilité du composant soit passée de visible à invisible.UIComponent
 InheritedDistribué lorsque l'utilisateur appuie sur une touche.InteractiveObject
 InheritedDistribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier.InteractiveObject
 InheritedDistribué lorsque l'utilisateur relâche une touche.InteractiveObject
 InheritedDistribué lorsque la valeur de l'étiquette change.LabelButton
 InheritedDistribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l'utilisateur tente de déplacer le focus à l'aide d'un périphérique de pointage.InteractiveObject
 InheritedDistribué lorsque l'utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l'utilisateur éloigne un périphérique de pointage d'une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque la molette d'une souris est actionnée sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué à la suite du déplacement du composant.UIComponent
 InheritedDistribué par l'initiateur glisser InteractiveObject lorsque l'utilisateur arrête l'opération glisser.InteractiveObject
 InheritedDistribué par l'objet InteractiveObject cible lorsqu'un objet glissé est déposé dessus et que l'opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop().InteractiveObject
 InheritedDistribué par un InteractiveObject lorsqu'une opération glisser entre dans ses limites.InteractiveObject
 InheritedDistribué par un InteractiveObject lorsqu'une opération glisser sort des limites.InteractiveObject
 InheritedDistribué par un objet InteractiveObject de façon continue lorsqu'une opération glisser reste dans ses limites.InteractiveObject
 InheritedDistribué au début d'une opération glisser par l'objet InteractiveObject spécifié comme initiateur de l'action glisser dans l'appel DragManager.doDrag().InteractiveObject
 InheritedDistribué lors d'une opération glisser par l'objet InteractiveObject spécifié comme initiateur de l'action glisser dans l'appel DragManager.doDrag().InteractiveObject
 InheritedDistribué lorsque l'utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne 'Coller' dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsqu'un objet d'affichage est sur le point d'être supprimé de la liste d'affichage.DisplayObject
 InheritedDistribué lorsqu'un objet d'affichage est sur le point d'être supprimé de la liste d'affichage de la scène, directement ou par l'intermédiaire de la suppression d'une arborescence secondaire qui contient l'objet d'affichage.DisplayObject
 Inherited[événement de diffusion] Distribué lorsque la liste d'affichage est sur le point d'être mise à jour et restituée.DisplayObject
 InheritedDistribué à la suite du redimensionnement du composant.UIComponent
 InheritedDistribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l'utilisateur éloigne un périphérique de pointage d'une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l'utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit 'Sélectionner tout' dans le menu contextuel.InteractiveObject
 InheritedDistribué après que la visibilité du composant soit passée de invisible à visible.UIComponent
 InheritedDistribué lorsque la valeur de l'indicateur tabChildren de l'objet change.InteractiveObject
 InheritedDistribué lorsque l'indicateur tabEnabled de l'objet change.InteractiveObject
 InheritedDistribué lorsque la valeur de la propriété tabIndex de l’objet change.InteractiveObject
Styles
 Style Description Défini par
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsque le bouton n'est pas désactivé.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme enveloppe pour l'arrière-plan et la bordure lorsque le bouton n'est pas sélectionné et est désactivé.
LabelButton
 InheritedType: flash.text.TextFormat
Objet TextFormat à utiliser pour le rendu de l'étiquette du composant lorsque le bouton est désactivé.
UIComponent
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsque le bouton n'est pas sélectionné et que le bouton de la souris est enfoncé.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme enveloppe pour l'arrière-plan et la bordure lorsque le bouton n'est pas sélectionné et que le bouton de la souris est enfoncé.
LabelButton
 InheritedType: Boolean
Indique si des polices vectorielles incorporées sont utilisées pour le rendu du champ de texte.
LabelButton
  
emphasizedPadding
Type: Number Format: Length
Remplissage à appliquer autour des Buttons dans une enveloppe accentuée, en pixels. La valeur par défaut est 2.
Button
  
emphasizedSkin
Type: Class
Enveloppe à utiliser lorsqu'un bouton a le focus. La valeur par défaut est Button_emphasizedSkin.
Button
 InheritedType: Number Format: Length
Remplissage qui sépare les limites extérieures du composant et les bords extérieurs de l'indicateur du focus, en pixels.
UIComponent
 InheritedType: Class
Enveloppe à utiliser pour afficher les indicateurs de focus.
UIComponent
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsqu'un bouton de basculement n'est pas sélectionné et que la souris ne le survole pas.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsque le bouton n'est pas sélectionné et que la souris survole le composant.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme enveloppe pour l'arrière-plan et la bordure lorsque le bouton n'est pas sélectionné et que la souris survole le composant.
LabelButton
 InheritedType: Number Format: Time
Nombre de millisecondes d'attente après la première diffusion de l'événement buttonDown et avant l'envoi d'un second événement buttonDown.
LabelButton
 InheritedType: Number Format: Time
Intervalle, en millisecondes, entre les événements buttonDown distribués après le délai spécifié par le style repeatDelay.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsque le bouton est sélectionné et désactivé.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme enveloppe pour l'arrière-plan et la bordure lorsqu'un bouton bascule est sélectionné et désactivé.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsque le bouton est sélectionné et que le bouton de la souris est enfoncé.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme enveloppe pour l'arrière-plan et la bordure lorsqu'un bouton bascule est sélectionné et que le bouton de la souris est enfoncé.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsque le bouton est sélectionné et que la souris survole le composant.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme enveloppe pour l'arrière-plan et la bordure lorsqu'un bouton bascule est sélectionné et que la souris survole le composant.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsque le bouton est sélectionné et que le bouton de la souris est relevé.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme enveloppe pour l'arrière-plan et la bordure lorsqu'un bouton bascule est sélectionné et que la souris ne survole pas le composant.
LabelButton
 InheritedType: flash.text.TextFormat
Objet TextFormat à utiliser pour le rendu de l'étiquette du composant.
UIComponent
 InheritedType: Number Format: Length
Espacement entre le texte et les bords du composant, et espacement entre le texte et l'icône, en pixels.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme icône lorsqu'un bouton de basculement n'est pas sélectionné et que la souris ne le survole pas.
LabelButton
 InheritedType: Class
Nom de la classe à utiliser comme enveloppe pour l'arrière-plan et la bordure lorsque le bouton n'est pas sélectionné et que la souris ne survole pas le composant.
LabelButton
Détails de la propriété
emphasizedpropriété
emphasized:Boolean  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Lit ou définit une valeur booléenne qui indique si une bordure doit être tracée autour du composant Button lorsque l'état du bouton est relevé. La valeur true indique que le bouton est entouré par une bordure lorsque son état est relevé. La valeur false indique qu'aucune bordure ne sera ajoutée dans ce cas.

La valeur par défaut est false.



Implémentation
    public function get emphasized():Boolean
    public function set emphasized(value:Boolean):void

Voir aussi


Exemple
L'exemple suivant définit le style emphasizedPadding de l'occurrence de Button sur la valeur d'un composant Slider :
import fl.controls.Button;
import fl.controls.Slider;
import fl.events.SliderEvent;

var styleObject:Object = Button.getStyleDefinition();
var defaultEmphasizedPadding:uint = styleObject.emphasizedPadding;

var myButton:Button = new Button();
myButton.label = "emphasizedPadding:" + defaultEmphasizedPadding;
myButton.emphasized = true;
myButton.width = 150;
myButton.move(20, 20);
addChild(myButton);

var mySlider:Slider = new Slider();
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.liveDragging = true;
mySlider.value = defaultEmphasizedPadding;
mySlider.width = myButton.width;
mySlider.move(20, 60);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

function changeHandler(event:SliderEvent):void {
    myButton.label = "emphasizedPadding:" + event.value;
    myButton.setStyle("emphasizedPadding", event.value);
}
Détails du constructeur
Button()Constructeur
public function Button()

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Crée une nouvelle occurrence du composant Button.

Détails de la méthode
getStyleDefinition()méthode
public static function getStyleDefinition():Object

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Récupère la texture de style par défaut du composant actif. La texture de style contient le type adapté au composant, qui dépend du style utilisé par ce dernier. Par exemple, le style disabledTextFormat contient la valeur null ou un objet TextFormat. Vous pouvez utiliser ces styles et appeler setStyle() pour le composant actif. Le code suivant ignore le style par défaut disabledTextFormat dans le composant spécifié :

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Valeur renvoyée
Object — Objet de styles par défaut.

Voir aussi


Exemple

L'exemple suivant crée un navigateur de styles pour différentes classes de composant :
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
Exemples Utilisation des exemples
ButtonExample.as

Cet exemple indique comment créer des boutons de façon dynamique et leur associer un style.
  1. Ajoutez un composant Button à la bibliothèque.
  2. Enregistrez ce code sous le nom ButtonExample.as dans le même répertoire que votre fichier FLA.
  3. Dans le fichier FLA, définissez DocumentClass sur ButtonExample.
package
{
    import flash.display.MovieClip;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFormat;
    import fl.controls.Button;
    
    public class ButtonExample extends MovieClip
    {
        private var b1:Button;
        private var b2:Button;        
        private var b3:Button;
        private var tf:TextField;
        
        public function ButtonExample() {
            createTraceField();
            setupButtons();
        }
        private function createTraceField():void {
            tf = new TextField();
            tf.width = 200;
            tf.height = 400;
            tf.x = 200;
            tf.y = 10;
            addChild(tf);
        }
        private function setupButtons():void {
            b1 = new Button();
            b2 = new Button();
            b3 = new Button();

            b1.move(10,10);
            b2.move(10,40);
            b3.move(10,70);

            b1.label = "Default Button";
            b2.label = "Custom Styled Button";
            b3.label = "Toggleable Button";
            b2.setStyle("textFormat", new TextFormat("Georgia"));
            b3.width = 120;
            b3.toggle = true;
            
            b1.addEventListener(MouseEvent.CLICK,buttonClick);
            b2.addEventListener(MouseEvent.CLICK,buttonClick);
            b3.addEventListener(MouseEvent.CLICK,buttonClick);

            addChild(b1);
            addChild(b2);
            addChild(b3);
        }
        private function buttonClick(e:MouseEvent) {
            var button:Button = Button(e.target);
            tf.appendText(button.label + "\n");
        }
    }
}