Packageflash.display
Classepublic class SimpleButton
HéritageSimpleButton Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

La classe SimpleButton vous permet de contrôler toutes les occurrences de symboles de bouton dans un fichier SWF. Après avoir créé une occurrence de bouton dans l’outil de programmation, vous pouvez utiliser les méthodes et les propriétés de la classe SimpleButton pour manipuler les boutons avec ActionScript.

Vous pouvez attribuer à un bouton un nom d'occurrence dans l'inspecteur Propriétés. Les noms d'occurrence de SimpleButton s'affichent dans l'explorateur d'animations et dans la boîte de dialogue Insérer un chemin cible du panneau Actions.

Dans ActionScript 3.0, vous devez utiliser le constructeur new SimpleButton() pour créer une occurrence de SimpleButton.

La classe SimpleButton hérite de la classe InteractiveObject.

Consulter les exemples

Voir aussi

Classe InteractiveObject
Classes d'affichage de base


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
 InheritedblendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser.
DisplayObject
 InheritedcacheAsBitmap : Boolean
Si true est défini, Flash Player 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 : ContextMenu
Spécifie le menu contextuel associé à l’objet.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Spécifie si l’objet reçoit les événements doubleClick.
InteractiveObject
  downState : DisplayObject
Spécifie un objet d’affichage utilisé en tant qu’objet visuel associé à l’état Abaissé du bouton (l’état du bouton lorsque l’utilisateur clique sur l’objet hitTestState).
SimpleButton
  enabled : Boolean
Valeur booléenne spécifiant si un bouton est activé.
SimpleButton
 Inheritedfilters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage.
DisplayObject
 InheritedfocusRect : Object
Spécifie si l’objet affiche un rectangle de focus.
InteractiveObject
 Inheritedheight : Number
Indique la hauteur de l'objet d’affichage, en pixels.
DisplayObject
  hitTestState : DisplayObject
Spécifie un objet d’affichage utilisé en tant qu’objet de test de recherche pour le bouton.
SimpleButton
 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
 InheritedmouseEnabled : Boolean
Spécifie si l’objet reçoit les messages souris.
InteractiveObject
 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
 InheritedopaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d'arrière-plan spécifique.
DisplayObject
  overState : DisplayObject
Spécifie un objet d’affichage utilisé en tant qu’objet visuel associé à l’état survol du bouton (l’état du bouton lorsque la souris est placée sur le bouton).
SimpleButton
 Inheritedparent : DisplayObjectContainer
[lecture-seule] Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage.
DisplayObject
 Inheritedprototype : Object
[static] 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
 Inheritedscale9Grid : Rectangle
Grille de mise à l’échelle en vigueur.
DisplayObject
 InheritedscaleX : Number
Indique le redimensionnement horizontal (percentage) de l'objet tel qu'il est appliqué à partir du point d'alignement.
DisplayObject
 InheritedscaleY : Number
Indique le redimensionnement vertical (pourcentage) de l’objet tel qu’il est appliqué à partir du point d’alignement.
DisplayObject
 InheritedscrollRect : Rectangle
Cadre de délimitation du défilement de l’objet d’affichage.
DisplayObject
  soundTransform : SoundTransform
Objet SoundTransform affecté au bouton.
SimpleButton
 Inheritedstage : Stage
[lecture-seule] Scène de l’objet d’affichage.
DisplayObject
 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
  trackAsMenu : Boolean
Indique si d’autres objets d’affichage de type SimpleButton ou MovieClip peuvent recevoir des événements de relâchement de souris.
SimpleButton
 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
  upState : DisplayObject
Spécifie un objet d’affichage utilisé en tant qu’objet visuel associé à l’état relevé du bouton (l’état du bouton lorsque la souris n’est pas placée sur le bouton).
SimpleButton
  useHandCursor : Boolean
Valeur booléenne qui, lorsqu'elle est réglée sur true, indique si Flash Player affiche un curseur en forme de main lorsque la souris survole un bouton.
SimpleButton
 Inheritedvisible : Boolean
Indique si l’objet d’affichage est visible ou non.
DisplayObject
 Inheritedwidth : Number
Indique la largeur de l'objet d’affichage, en pixels.
DisplayObject
 Inheritedx : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.
DisplayObject
 Inheritedy : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.
DisplayObject
Méthodes publiques
 MéthodeDéfini par
  
SimpleButton(upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)
Crée une occurrence de SimpleButton.
SimpleButton
 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
Distribue un événement dans le flux d’événements.
EventDispatcher
 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
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
Convertit l'objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (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 l’objet d’affichage pour savoir s'il recouvre ou recoupe 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
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 l'objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).
DisplayObject
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 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
Evénements
 Evénement Synthèse Défini par
 Inherited Distribué lorsque Flash Player a le focus du système d’exploitation et devient actif.EventDispatcher
 Inherited Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.DisplayObject
 Inherited Envoyé 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
 Inherited Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
 Inherited Distribué lorsque Flash Player perd le focus du système d’exploitation et devient inactif.EventDispatcher
 Inherited Distribué 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 Distribué lorsque la tête de lecture est placée sur une nouvelle image.DisplayObject
 Inherited Distribué après la prise de focus par un objet d'affichage.InteractiveObject
 Inherited Distribué après la perte de focus par un objet d'affichage.InteractiveObject
 Inherited Distribué lorsque l’utilisateur appuie sur une touche.InteractiveObject
 Inherited Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier.InteractiveObject
 Inherited Distribué lorsque l’utilisateur relâche une touche.InteractiveObject
 Inherited Distribué lorsque l’utilisateur appuie à l’aide du bouton du périphérique de pointage sur une occurrence de InteractiveObject dans la fenêtre Flash Player.InteractiveObject
 Inherited Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage.InteractiveObject
 Inherited Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject.InteractiveObject
 Inherited Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject.InteractiveObject
 Inherited Distribué lorsque l’utilisateur déplace un périphérique de pointage sur une occurrence de InteractiveObject dans la fenêtre Flash Player.InteractiveObject
 Inherited Distribué lorsque l’utilisateur relâche le bouton du périphérique de pointage sur une occurrence de InteractiveObject dans la fenêtre Flash Player.InteractiveObject
 Inherited Distribué lorsque l’utilisateur fait tourner la molette de la souris sur une occurrence de InteractiveObject dans la fenêtre Flash Player.InteractiveObject
 Inherited Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage.DisplayObject
 Inherited Envoyé 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 Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et rendue.DisplayObject
 Inherited Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject.InteractiveObject
 Inherited Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.InteractiveObject
 Inherited Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change.InteractiveObject
 Inherited Distribué lorsque l’indicateur tabEnabled de l’objet change.InteractiveObject
 Inherited Distribué lorsque la valeur de la propriété tabIndex de l’objet change.InteractiveObject
Détails des propriétés
downStatepropriété
downState:DisplayObject  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Spécifie un objet d’affichage utilisé en tant qu’objet visuel associé à l’état Abaissé du bouton (l’état du bouton lorsque l’utilisateur clique sur l’objet hitTestState).


Implémentation
    public function get downState():DisplayObject
    public function set downState(value:DisplayObject):void

Voir aussi

enabledpropriété 
enabled:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Valeur booléenne spécifiant si un bouton est activé. Lorsqu'il est désactivé (la propriété enabled est alors réglée sur false), le bouton est visible mais vous ne pouvez pas cliquer dessus. La valeur par défaut est true. Cette propriété s'avère utile si vous souhaitez désactiver certains des boutons de navigation. Par exemple, il peut être souhaitable de désactiver un bouton dans la page actuellement affichée afin d'empêcher l’utilisateur de cliquer dessus et de recharger la page.


Implémentation
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
hitTestStatepropriété 
hitTestState:DisplayObject  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Spécifie un objet d’affichage utilisé en tant qu’objet de test de recherche pour le bouton. Pour un bouton de base, réglez la propriété hitTestState sur le même objet d’affichage que la propriété overState. Si vous ne réglez pas la propriété hitTestState, le bouton SimpleButton est inactif (il ne réagit pas aux événements de souris et de clavier).


Implémentation
    public function get hitTestState():DisplayObject
    public function set hitTestState(value:DisplayObject):void

Voir aussi

overStatepropriété 
overState:DisplayObject  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Spécifie un objet d’affichage utilisé en tant qu’objet visuel associé à l’état survol du bouton (l’état du bouton lorsque la souris est placée sur le bouton).


Implémentation
    public function get overState():DisplayObject
    public function set overState(value:DisplayObject):void

Voir aussi

soundTransformpropriété 
soundTransform:SoundTransform  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Objet SoundTransform affecté au bouton. Un objet SoundTransform comprend les propriétés de réglage du volume, du déplacement panoramique, ainsi que des haut-parleurs gauche et droit. Il s’applique à tous les états du bouton. Cet objet SoundTransform n’affecte que les sons intégrés.


Implémentation
    public function get soundTransform():SoundTransform
    public function set soundTransform(value:SoundTransform):void

Voir aussi

trackAsMenupropriété 
trackAsMenu:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Indique si d’autres objets d’affichage de type SimpleButton ou MovieClip peuvent recevoir des événements de relâchement de souris. La propriété trackAsMenu permet de créer des menus. Vous pouvez définir la propriété trackAsMenu sur n'importe quel objet SimpleButton ou MovieClip. Si la propriété trackAsMenu n'existe pas, la valeur du comportement par défaut devient false.

Vous pouvez modifier la propriété trackAsMenu à tout moment ; le bouton modifié accepte immédiatement le nouveau comportement.


Implémentation
    public function get trackAsMenu():Boolean
    public function set trackAsMenu(value:Boolean):void
upStatepropriété 
upState:DisplayObject  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Spécifie un objet d’affichage utilisé en tant qu’objet visuel associé à l’état relevé du bouton (l’état du bouton lorsque la souris n’est pas placée sur le bouton).


Implémentation
    public function get upState():DisplayObject
    public function set upState(value:DisplayObject):void

Voir aussi

useHandCursorpropriété 
useHandCursor:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Valeur booléenne qui, lorsqu'elle est réglée sur true, indique si Flash Player affiche un curseur en forme de main lorsque la souris survole un bouton. Si cette propriété est réglée sur false, le pointeur flèche s’affiche. La valeur par défaut est true.

Vous pouvez modifier la propriété useHandCursor à tout moment ; le bouton modifié accepte immédiatement le nouveau comportement du curseur.


Implémentation
    public function get useHandCursor():Boolean
    public function set useHandCursor(value:Boolean):void
Détails du constructeur
SimpleButton()Constructeur
public function SimpleButton(upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Crée une occurrence de SimpleButton. Tout ou partie des objets d'affichage qui représentent les différents états de bouton peuvent être définis en tant que paramètres dans le constructeur.

Paramètres
upState:DisplayObject (default = null) — Valeur initiale de l’état relevé de SimpleButton.
 
overState:DisplayObject (default = null) — Valeur initiale de l’état survol de SimpleButton.
 
downState:DisplayObject (default = null) — Valeur initiale de l’état abaissé de SimpleButton.
 
hitTestState:DisplayObject (default = null) — Valeur initiale de l’état cliqué de SimpleButton.
Exemples Utilisation des exemples
SimpleButtonExample.as

L'exemple suivant a recours à la classe SimpleButtonExample, qui en retour utilise la classe CustomSimpleButton, qui crée quatre occurrences d'un objet ButtonDisplayState. Le résultat est un bouton qui est créé sous forme de carré, dont la couleur d'arrière-plan change en fonction de l'état de la souris en contournant les propriétés d'occurrence de la classe SimpleButton. Pour ce faire, procédez comme suit :
  1. Dans le constructeur SimpleButtonExample(), un nouvel objet CustomSimpleButton de type SimpleButton, appelé button, est créé, qui appelle ensuite la méthode de constructeur CustomSimpleButton. L'objet button est ajouté à la liste d'affichage. La couleur et la taille du bouton sont déterminées par les étapes suivantes.
  2. Dans la classe CustomSimpleButton, les propriétés d'occurrence sont déclarées, puis utilisées pour contrôler la taille et la couleur d'arrière-plan de button en fonction de son état (orange dans son état normal, jaune sombre en cas de survol de la souris et bleu clair lorsque l'utilisateur clique sur l'un des boutons). Quel que soit l'état de button, la taille du carré est définie sur 80 pixels en utilisant la propriété size.
  3. La fonction constructeur de la classe CustomSimpleButton définit les propriétés downState, overState, upState, hitTestState et useHandCursor avec quatre occurrences de la classe ButtonDisplayState.
  4. Dans la classe ButtonDisplayState, le constructeur définit la valeur de la taille du carré et la couleur d'arrière-plan, puis appelle la méthode draw().
  5. La méthode draw() redessine le carré avec la taille et la couleur d'arrière-plan définies dans le constructeur reposant sur l'état du bouton.
package {
    import flash.display.Sprite;

    public class SimpleButtonExample extends Sprite {
        public function SimpleButtonExample() {
            var button:CustomSimpleButton = new CustomSimpleButton();
            addChild(button);
        }
    }
}

import flash.display.DisplayObject;
import flash.display.Shape;
import flash.display.SimpleButton;

class CustomSimpleButton extends SimpleButton {
    private var upColor:uint   = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;
    private var size:uint      = 80;

    public function CustomSimpleButton() {
        downState      = new ButtonDisplayState(downColor, size);
        overState      = new ButtonDisplayState(overColor, size);
        upState        = new ButtonDisplayState(upColor, size);
        hitTestState   = new ButtonDisplayState(upColor, size * 2);
        hitTestState.x = -(size / 4);
        hitTestState.y = hitTestState.x;
        useHandCursor  = true;
    }
}

class ButtonDisplayState extends Shape {
    private var bgColor:uint;
    private var size:uint;

    public function ButtonDisplayState(bgColor:uint, size:uint) {
        this.bgColor = bgColor;
        this.size    = size;
        draw();
    }

    private function draw():void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, size, size);
        graphics.endFill();
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/display/SimpleButton.html