Packageflash.display
Classepublic dynamic class MovieClip
HéritageMovieClip Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Sous-classes LivePreviewParent

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

La classe MovieClip hérite des classes suivantes : Sprite, DisplayObjectContainer, InteractiveObject, DisplayObject et EventDispatcher.

A l’inverse de l’objet Sprite, un objet MovieClip dispose d’un scénario.

Les méthodes de la classe MovieClip fournissent les mêmes fonctionnalités que les actions permettant de cibler des clips. Certaines autres méthodes ne possèdent pas d'actions équivalentes dans la boîte à outils Actions du panneau Actions de l’outil de programmation Flash.

Les instances enfant placées sur la scène dans l'outil de programmation de Flash ne sont pas accessibles par le code depuis l'intérieur du constructeur d'une instance parent car, à ce stade de l'exécution du code, elles n'ont pas été créées. Avant d'accéder à l'enfant, le parent doit soit créer l'instance enfant par du code, soit retarder l'accès à une fonction de rappel qui écoute l'enfant en vue de la distribution de son événement Event.ADDED_TO_STAGE.

Si vous modifiez l'une des propriétés suivantes d'un objet MovieClip contenant une interpolation de mouvement, Flash Player arrête la tête de lecture dans cet objet MovieClip : alpha, blendMode, filters, height, opaqueBackground, rotation, scaleX, scaleY, scale9Grid, scrollRect, transform, visible, width, x ou y. Il n’arrête cependant pas la tête de lecture dans tout objet MovieClip enfant de l’objet MovieClip correspondant.

Consulter les exemples

Voir aussi

Classes d'affichage de base
Principes de base des clips


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
 InheritedbuttonMode : Boolean
Spécifie le mode de bouton du sprite.
Sprite
 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
  currentFrame : int
[lecture-seule] Spécifie le numéro de l’image où réside la tête de lecture dans le scénario de l’occurrence de MovieClip.
MovieClip
  currentLabel : String
[lecture-seule] Etiquette où réside actuellement la tête de lecture dans le scénario de l’occurrence de MovieClip.
MovieClip
  currentLabels : Array
[lecture-seule] Renvoie un tableau des objets FrameLabel extraits de la séquence en cours.
MovieClip
  currentScene : Scene
[lecture-seule] Séquence où réside actuellement la tête de lecture dans le scénario de l’occurrence de MovieClip.
MovieClip
 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
  enabled : Boolean
Valeur booléenne indiquant si un clip est activé.
MovieClip
 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
  framesLoaded : int
[lecture-seule] Nombre d'images à charger à partir d'un fichier SWF en diffusion continue.
MovieClip
 Inheritedgraphics : Graphics
[lecture-seule] Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel.
Sprite
 Inheritedheight : Number
Indique la hauteur de l'objet d’affichage, en pixels.
DisplayObject
 InheritedhitArea : Sprite
Désigne un autre sprite qui fera office de zone active d'un sprite.
Sprite
 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
 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
[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
  scenes : Array
[lecture-seule] Tableau des objets Scene, chacun d’eux indiquant le nom, le nombre d’images et les étiquettes d’image d’une séquence dans l’occurrence de MovieClip.
MovieClip
 InheritedscrollRect : Rectangle
Cadre de délimitation du défilement de l’objet d’affichage.
DisplayObject
 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
 InheritedtextSnapshot : TextSnapshot
[lecture-seule] Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer.
DisplayObjectContainer
  totalFrames : int
[lecture-seule] Nombre total d’images dans l’occurrence de MovieClip.
MovieClip
  trackAsMenu : Boolean
Indique si d’autres objets d’affichage de type SimpleButton ou MovieClip peuvent recevoir des événements de relâchement de souris.
MovieClip
 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
 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
  
Crée une occurrence de MovieClip.
MovieClip
 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é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
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
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
Convertit l'objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).
DisplayObject
  
gotoAndPlay(frame:Object, scene:String = null):void
Commence la lecture du fichier SWF sur l'image spécifiée.
MovieClip
  
gotoAndStop(frame:Object, scene:String = null):void
Place la tête de lecture au niveau de l'image spécifiée du clip et l'arrête à cet endroit.
MovieClip
 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
  
Place la tête de lecture sur l'image suivante et l'arrête.
MovieClip
  
Place la tête de lecture sur la séquence suivante de l’occurrence de MovieClip.
MovieClip
  
Déplace la tête de lecture dans le scénario du clip.
MovieClip
  
Place la tête de lecture sur l'image précédente et l'arrête.
MovieClip
  
Place la tête de lecture sur la séquence précédente de l’occurrence de MovieClip.
MovieClip
 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 la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permet à l'utilisateur de faire glisser le sprite spécifié.
Sprite
  
Arrête la tête de lecture dans le clip.
MovieClip
 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
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
currentFramepropriété
currentFrame:int  [lecture-seule]

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

Spécifie le numéro de l’image où réside la tête de lecture dans le scénario de l’occurrence de MovieClip. Si le clip contient plusieurs séquences, cette valeur correspond au numéro de l’image dans la séquence en cours.


Implémentation
    public function get currentFrame():int

Exemple

L'exemple suivant utilise la méthode gotoAndStop() et la propriété currentFrame pour diriger la tête de lecture du clip mc1 pour avancer de cinq images par rapport à sa position actuelle et s'arrêter :
mc1.gotoAndStop(mc1.currentFrame + 5);
currentLabelpropriété 
currentLabel:String  [lecture-seule]

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

Etiquette où réside actuellement la tête de lecture dans le scénario de l’occurrence de MovieClip. Si l'image suivante ne dispose pas d'étiquette, currentLabel est défini en fonction du nom de la première image ayant inclus une étiquette. Si l'image actuelle et les images précédentes n'incluent pas d'étiquette, currentLabel renvoie null.


Implémentation
    public function get currentLabel():String

Exemple

Le code suivant illustre comment accéder à la propriété currentLabel d'un objet MovieClip appelé mc1 :
trace(mc1.currentLabel);
currentLabelspropriété 
currentLabels:Array  [lecture-seule]

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

Renvoie un tableau des objets FrameLabel extraits de la séquence en cours. Si l’occurrence de MovieClip n’utilise pas de séquence, le tableau comprend toutes les étiquettes d'image extraites de la totalité de l'occurrence de MovieClip.


Implémentation
    public function get currentLabels():Array

Voir aussi


Exemple

Le code suivant illustre le mode d'utilisation de la propriété currentLabels d'un objet MovieClip appelé mc1 :
import flash.display.FrameLabel;
 
var labels:Array = mc1.currentLabels;

for (var i:uint = 0; i < labels.length; i++) {
    var label:FrameLabel = labels[i];
    trace("frame " + label.frame + ": " + label.name);
}
currentScenepropriété 
currentScene:Scene  [lecture-seule]

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

Séquence où réside actuellement la tête de lecture dans le scénario de l’occurrence de MovieClip.


Implémentation
    public function get currentScene():Scene

Voir aussi


Exemple

Le code suivant illustre le mode d'utilisation de la propriété currentScene d'un objet MovieClip appelé mc1 :
import flash.display.Scene;
 
var scene:Scene = mc1.currentScene;
trace(scene.name + ": " + scene.numFrames + " frames");
enabledpropriété 
enabled:Boolean  [lecture-écriture]

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

Valeur booléenne indiquant si un clip est activé. La valeur par défaut de enabled est true. Si enabled est défini sur false, les images Dessus, Abaissé et Haut du clip sont désactivées. Le clip continue à recevoir des événements (par exemple, mouseDown, mouseUp, keyDown et keyUp).

La propriété enabled gère uniquement les propriétés spécifiques aux boutons d'un clip. Vous pouvez modifier la propriété enabled à tout moment ; le clip modifié est immédiatement activé ou désactivé. Si la propriété enabled est définie sur false, l'objet n'est pas inclus dans l'ordre de tabulation automatique.


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

Exemple

Le code suivant illustre le mode d'utilisation de la propriété enabled pour désactiver les propriétés de type bouton d'un objet MovieClip appelé mc1 :
mc1.enabled = false;
framesLoadedpropriété 
framesLoaded:int  [lecture-seule]

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

Nombre d'images à charger à partir d'un fichier SWF en diffusion continue. Vous pouvez utiliser la propriété frameLoaded pour déterminer si le contenu d'une image spécifique, ainsi que l'ensemble des images chargées précédemment sont disponibles de façon locale dans le navigateur. Vous pouvez également l'utiliser pour superviser le téléchargement de fichiers SWF volumineux. Par exemple, si désiré, affichez un message aux utilisateurs leur indiquant que le chargement du fichier SWF ne commencera pas tant que le chargement d'une image spécifiée dans le fichier SWF ne sera pas terminé.

Si le clip contient plusieurs séquences, la propriété framesLoaded renvoie le nombre d’images chargées pour all les séquences.


Implémentation
    public function get framesLoaded():int

Voir aussi


Exemple

Le code suivant illustre comment utiliser les propriétés framesLoaded et totalFrames pour déterminer si un objet MovieClip en flux continu appelé mc1 est totalement chargé :
if (mc1.framesLoaded == mc1.totalFrames) {
    trace("OK.");
}
scenespropriété 
scenes:Array  [lecture-seule]

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

Tableau des objets Scene, chacun d’eux indiquant le nom, le nombre d’images et les étiquettes d’image d’une séquence dans l’occurrence de MovieClip.


Implémentation
    public function get scenes():Array

Voir aussi


Exemple

Le code suivant illustre le mode d'utilisation de la propriété scenes d'un objet MovieClip appelé mc1 :
import flash.display.Scene;
 
for (var i:uint = 0; i < mc1.scenes.length; i++) {
    var scene:Scene = mc1.scenes[i];
    trace("scene " + scene.name + ": " + scene.numFrames + " frames");
}
totalFramespropriété 
totalFrames:int  [lecture-seule]

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

Nombre total d’images dans l’occurrence de MovieClip.

Si le clip contient plusieurs images, la propriété totalFrames renvoie le nombre total d’images dans all les séquences.


Implémentation
    public function get totalFrames():int

Exemple

Le code suivant illustre l'utilisation de la propriété totalFrames d'un objet MovieClip appelé mc1 :
 trace(mc1.totalFrames);
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. La valeur par défaut de la propriété trackAsMenu est false.

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


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

Exemple

Le code suivant illustre comment utiliser la propriété trackAsMenu pour activer les événements de relâchement de la souris pour un objet MovieClip appelé mc1 :
 mc1.trackAsMenu = true;
Détails du constructeur
MovieClip()Constructeur
public function MovieClip()

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

Crée une occurrence de MovieClip. Après avoir créé l'objet MovieClip, appelle la méthode addChild() ou addChildAt() d'un objet conteneur d'affichage qui est sur la scène.

Détails des méthodes
gotoAndPlay()méthode
public function gotoAndPlay(frame:Object, scene:String = null):void

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

Commence la lecture du fichier SWF sur l'image spécifiée. Cette opération se produit lorsque l’exécution de toutes les autres actions de l’image est terminée. Pour spécifier une séquence et une image, affectez une valeur au paramètre scene.

Paramètres

frame:Object — Nombre représentant le numéro d'image ou une chaîne représentant l'étiquette de l'image cible de la tête de lecture. Si vous spécifiez un nombre, il est relatif à la séquence indiquée. Si vous ne spécifiez pas de séquence, Flash Player utilise la séquence en cours pour déterminer le numéro d’image global à lire. Si vous spécifiez une séquence, la tête de lecture passe au numéro d’image de la séquence indiquée.
 
scene:String (default = null) — Nom de la séquence à lire. Ce paramètre est facultatif.


Exemple

L'exemple suivant utilise la propriété gotoAndPlay() pour faire avancer de cinq images la tête de lecture du clip mc1 par rapport à sa position actuelle :
mc1.gotoAndPlay(mc1.currentFrame + 5);

Le code suivant utilise la méthode gotoAndPlay() pour diriger la tête de lecture du clip mc1 vers l'image "intro" de la séquence "Scene 12" :
mc1.gotoAndPlay("intro", "Scene 12");
gotoAndStop()méthode 
public function gotoAndStop(frame:Object, scene:String = null):void

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

Place la tête de lecture au niveau de l'image spécifiée du clip et l'arrête à cet endroit. Cette opération se produit lorsque l’exécution de toutes les autres actions de l’image est terminée. Pour spécifier une séquence en plus d'une image, utilisez un paramètre scene.

Paramètres

frame:Object — Nombre représentant le numéro d'image ou une chaîne représentant l'étiquette de l'image cible de la tête de lecture. Si vous spécifiez un nombre, il est relatif à la séquence indiquée. Si vous ne spécifiez pas de séquence, Flash Player utilise la séquence en cours pour déterminer le numéro d’image global cible sur laquelle s’arrêter. Si vous spécifiez une séquence, la tête de lecture passe au numéro d’image de la séquence indiquée et s’arrête.
 
scene:String (default = null) — Nom de la séquence. Ce paramètre est facultatif.


Lance
ArgumentError — Si les paramètres scene ou frame spécifiés ne figurent pas dans le clip.

Exemple

L'exemple suivant utilise la méthode gotoAndStop() et la propriété currentFrame pour diriger la tête de lecture du clip mc1 pour avancer de cinq images par rapport à sa position actuelle et s'arrêter :
mc1.gotoAndStop(mc1.currentFrame + 5);

Le code suivant utilise gotoAndStop() pour diriger la tête de lecture du clip mc1 vers l'image "finale" de la séquence "Scene 12" :
mc1.gotoAndStop("finale", "Scene 12");
nextFrame()méthode 
public function nextFrame():void

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

Place la tête de lecture sur l'image suivante et l'arrête. Cette opération se produit lorsque l’exécution de toutes les autres actions de l’image est terminée.

Voir aussi


Exemple

Dans l'exemple suivant, deux objets SimpleButton contrôlent le scénario. Le bouton prev déplace la tête de lecture vers l'image précédente alors que le bouton nextBtn la déplace vers l'image suivante.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevFrame();
}

function goForward(event:MouseEvent):void {
    mc1.nextFrame();
}
nextScene()méthode 
public function nextScene():void

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

Place la tête de lecture sur la séquence suivante de l’occurrence de MovieClip. Cette opération se produit lorsque l’exécution de toutes les autres actions de l’image est terminée.


Exemple

Dans l'exemple suivant, deux objets SimpleButton contrôlent le scénario. Le bouton prevBtn déplace la tête de lecture vers la séquence précédente alors que le bouton nextBtn la déplace vers la séquence suivante.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevScene();
}

function goForward(event:MouseEvent):void {
    mc1.nextScene();
}
play()méthode 
public function play():void

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

Déplace la tête de lecture dans le scénario du clip.

Voir aussi


Exemple

Le code suivant exploite la méthode pour arrêter un clip stop() appelé mc1 et pour reprendre la lecture lorsque l'utilisateur clique sur le champ de texte appelé continueText :

import flash.text.TextField;
import flash.events.MouseEvent;

var continueText:TextField = new TextField();
continueText.text = "Play movie...";
addChild(continueText);

mc1.stop();
continueText.addEventListener(MouseEvent.CLICK, resumeMovie);

function resumeMovie(event:MouseEvent):void {
    mc1.play();
}
prevFrame()méthode 
public function prevFrame():void

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

Place la tête de lecture sur l'image précédente et l'arrête. Cette opération se produit lorsque l’exécution de toutes les autres actions de l’image est terminée.


Exemple

Dans l'exemple suivant, deux objets SimpleButton contrôlent le scénario. Le bouton prev déplace la tête de lecture vers l'image précédente alors que le bouton nextBtn la déplace vers l'image suivante.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevFrame();
}

function goForward(event:MouseEvent):void {
    mc1.nextFrame();
}
prevScene()méthode 
public function prevScene():void

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

Place la tête de lecture sur la séquence précédente de l’occurrence de MovieClip. Cette opération se produit lorsque l’exécution de toutes les autres actions de l’image est terminée.


Exemple

Dans l'exemple suivant, deux objets SimpleButton contrôlent le scénario. Le bouton prevBtn déplace la tête de lecture vers la séquence précédente alors que le bouton nextBtn la déplace vers la séquence suivante.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevScene();
}

function goForward(event:MouseEvent):void {
    mc1.nextScene();
}
stop()méthode 
public function stop():void

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

Arrête la tête de lecture dans le clip.

Exemples Utilisation des exemples
MovieClipExample.as

L'exemple suivant utilise la classe MovieClipExample pour illustrer la façon de suivre les différentes propriétés d'un objet MovieClip. Pour ce faire, procédez comme suit :
  1. La fonction constructeur définit un champ de texte, qui permet d'afficher les valeurs des propriétés de l'objet MovieClipExample (qui étend MovieClip).
  2. La valeur renvoyée par la méthode getPropertiesString() est utilisée en tant que texte pour le champ de texte outputText. La méthode getPropertiesString() renvoie une chaîne qui est remplie avec des valeurs provenant des propriétés suivantes du clip : currentFrame, currentLabel, currentScene, framesLoaded, totalFrames et trackAsMenu.
  3. Deux des lignes de code de la fonction constructeur règlent les propriétés width et height du champ de texte outputText.
  4. La dernière ligne de la fonction constructeur ajoute le champ de texte outputText à la liste d'affichage.

package {
    import flash.display.MovieClip;
    import flash.text.TextField;

    public class MovieClipExample extends MovieClip {

        public function MovieClipExample() {
            var outputText:TextField = new TextField();
            outputText.text = getPropertiesString();
            outputText.width = stage.stageWidth;
            outputText.height = outputText.textHeight;
            addChild(outputText);
        }

        private function getPropertiesString():String {
            var str:String = ""
                + "currentFrame: " + currentFrame + "\n"
                + "currentLabel: " + currentLabel + "\n"
                + "currentScene: " + currentScene + "\n"
                + "framesLoaded: " + framesLoaded + "\n"
                + "totalFrames: " + totalFrames + "\n"
                + "trackAsMenu: " + trackAsMenu + "\n";
            return str;
        }
    }
}




 

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/MovieClip.html