MovieClip


Object
    |
    +-MovieClip

public dynamic class MovieClip
extends Object

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

Aucune méthode constructeur n'est requise pour créer un clip. Vous disposez de trois méthodes pour créer des occurrences de clip :

Pour appeler les méthodes de la classe MovieClip, vous devez référencer les occurrences de clip en fonction de leur nom, en appliquant la syntaxe suivante, où my_mc correspond à une occurrence de clip :

my_mc.play();
my_mc.gotoAndPlay(3);

Vous pouvez étendre les méthodes et les gestionnaires d'événements de la classe MovieClip en créant une sous-classe.

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Résumé des propriétés

Modificateurs

Propriété

Description

 

_alpha:Number

La valeur de transparence alpha du clip.

 

_currentframe:Number [lecture seule]

Renvoie le numéro de l'image dans laquelle se trouve la tête de lecture dans le scénario du clip.

 

_droptarget:String [lecture seule]

Renvoi le chemin absolu, en utilisant une notation de syntaxe à barre oblique, de l'occurrence de clip sur laquelle ce clip a été déposé.

 

enabled:Boolean

Valeur booléenne indiquant si un clip est activé.

 

focusEnabled:Boolean

Si la valeur est undefined ou false, un clip ne peut pas recevoir le focus d'entrée sauf s'il s'agit d'un bouton.

 

_focusrect:Boolean

Valeur booléenne indiquant si un clip est entouré d'un rectangle jaune lorsqu'il a le focus d'entrée.

 

_framesloaded:Number [lecture seule]

Le nombre d'images à charger à partir d'un fichier SWF en diffusion continue.

 

_height:Number

Hauteur du clip, en pixels.

 

_highquality:Number

Déconseillé depuis Flash Player 7. Cette propriété a été déconseillée en faveur de MovieClip._quality.

Spécifie le niveau d'anti-aliasing appliqué au fichier SWF actuel.

 

hitArea:Object

Désigne un autre clip pour faire office de zone active d'un clip.

 

_lockroot:Boolean

Une valeur booléenne qui spécifie ce à quoi _root se réfère lorsqu'un fichier SWF est chargé dans un clip.

 

_name:String

Le nom d'occurrence du clip.

 

_parent:MovieClip

Référence au clip ou à l'objet contenant le clip ou l'objet actuel.

 

_quality:String

Définit ou extrait la qualité du rendu appliqué à un fichier SWF.

 

_rotation:Number

Spécifie la rotation du clip, en degrés, à partir de son orientation d'origine.

 

_soundbuftime:Number

Spécifie le nombre de secondes pendant lequel les sons sont chargés en mémoire tampon avant d'être diffusés en continu.

 

tabChildren:Boolean

Détermine si les enfants d'un clip sont inclus dans l'ordre de tabulation automatique.

 

tabEnabled:Boolean

Spécifie si le clip est inclus dans l'ordre de tabulation automatique.

 

tabIndex:Number

Permet de personnaliser l'ordre de tabulation des objets dans un clip.

 

_target:String [lecture seule]

Renvoie le chemin cible de l'occurrence de clip, en notation avec barre oblique.

 

_totalframes:Number [lecture seule]

Renvoie le nombre total d'images dans l'occurrence de clip spécifiée par le paramètre MovieClip.

 

trackAsMenu:Boolean

Valeur booléenne indiquant si d'autres boutons ou clips peuvent recevoir un événement de relâchement de la souris ou du stylet.

 

_url:String [lecture seule]

Récupère l'URL du fichier SWF, JPEG, GIF ou PNG ayant servi à télécharger le clip.

 

_visible:Boolean

Valeur booléenne indiquant si le clip est visible.

 

_width:Number

Largeur du clip, en pixels.

 

_x:Number

Entier qui définit la coordonnée x d'un clip par rapport aux coordonnées locales du clip parent.

 

_xmouse:Number [lecture seule]

Renvoie la coordonnée x de la position de la souris.

 

_xscale:Number

Détermine le redimensionnement horizontal du clip (percentage) tel qu'il est appliqué à partir du point d'alignement du clip.

 

_y:Number

Définit la coordonnée y d'un clip par rapport aux coordonnées locales du clip parent.

 

_ymouse:Number [lecture seule]

Renvoie la coordonnée y de la position de la souris.

 

_yscale:Number

Détermine le redimensionnement vertical du clip (percentage) tel qu'il est appliqué à partir du point d'alignement du clip.

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

constructor (propriété Object.constructor), __proto__ (propriété Object.__proto__), prototype (propriété Object.prototype), __resolve (propriété Object.__resolve)


Résumé des événements

Evénement

Description

onData = function() {}

Appelé lorsqu'un clip reçoit des données provenant d'un appel MovieClip.loadVariables() ou MovieClip.loadMovie().

onDragOut = function() {}

Appelé lorsque l'utilisateur appuie sur le bouton de la souris et que le pointeur se déplace hors de l'objet.

onDragOver = function() {}

Appelé lorsque l'utilisateur fait glisser le pointeur hors du clip, puis sur le clip.

onEnterFrame = function() {}

Appelé à plusieurs reprises à la cadence du fichier SWF.

onKeyDown = function() {}

Appelé lorsqu'un clip reçoit le focus d'entrée et que l'utilisateur appuie sur une touche.

onKeyUp = function() {}

Appelé lorsqu'une touche est relâchée.

onKillFocus = function(newFocus:Object) {}

Appelé lorsqu'un clip perd le focus d'entrée.

onLoad = function() {}

Appelé lorsque le clip est instancié et apparaît dans le scénario.

onMouseDown = function() {}

Appelé lorsque vous appuyez sur le bouton de la souris.

onMouseMove = function() {}

Appelé lorsque la souris bouge.

onMouseUp = function() {}

Appelé lorsque vous relâchez le bouton de la souris.

onPress = function() {}

Appelé lorsque l'utilisateur clique sur le bouton de la souris quand le pointeur est placé sur un clip.

onRelease = function() {}

Appelé lorsque l'utilisateur relâche le bouton de la souris au-dessus d'un clip.

onReleaseOutside = function() {}

Appelé lorsque l'utilisateur a appuyé sur le bouton de la souris dans la zone occupée par un clip, puis l'a relâché en dehors de cette zone.

onRollOut = function() {}

Appelé lorsque le pointeur se déplace hors de la zone du clip.

onRollOver = function() {}

Appelé lorsque le pointeur se place au-dessus de la zone du clip.

onSetFocus = function(oldFocus:Object) {}

Appelé lorsqu'un clip reçoit le focus d'entrée.

onUnload = function() {}

Appelé dans la première image une fois la suppression du clip dans le scénario effectuée.

Résumé de la méthode

Modificateurs

Signature

Description

 

attachMovie(id:String, name:String, depth:Number, [initObject:Object]) : MovieClip

Sélectionne un symbole dans la bibliothèque et l'associe au clip.

 

beginFill(rgb:Number, [alpha:Number]) : Void

Indique le début d'un nouveau chemin de dessin.

 

beginGradientFill(fillType:String, colors:Array, alphas:Array, ratios:Array, matrix:Object) : Void

Indique le début d'un nouveau chemin de dessin.

 

clear() : Void

Supprime tous les graphiques créés lors de l'exécution à l'aide des méthodes de dessin de clips, y compris les styles de trait spécifiés par MovieClip.lineStyle().

 

createEmptyMovieClip(name:String, depth:Number) : MovieClip

Crée un clip vide en tant qu'enfant d'un clip existant.

 

createTextField(instanceName:String, depth:Number, x:Number, y:Number, width:Number, height:Number) : TextField

Crée un nouveau champ texte vide en tant qu'enfant du clip pour lequel vous avez appelé cette méthode.

 

curveTo(controlX:Number, controlY:Number, anchorX:Number, anchorY:Number) : Void

Dessine une courbe en utilisant le style de ligne actuel à partir de la position actuelle à (anchorX, anchorY) en utilisant le point de contrôle spécifié par (controlX, controlY).

 

duplicateMovieClip(name:String, depth:Number, [initObject:Object]) : MovieClip

Crée une occurrence du clip spécifié lors de la lecture du fichier SWF.

 

endFill() : Void

Applique un remplissage aux lignes et aux courbes ajoutées depuis le dernier rappel à beginFill() ou beginGradientFill().

 

getBounds(bounds:Object) : Object

Renvoie des propriétés qui sont les valeurs de coordonnées x et y minimales et maximales du clip, à partir du paramètre bounds.

 

getBytesLoaded() : Number

Renvoie le nombre d'octets déjà chargés (transmis en continu) pour le clip.

 

getBytesTotal() : Number

Renvoie la taille, en octets, du clip.

 

getDepth() : Number

Renvoie la profondeur d'une occurrence de clip.

 

getInstanceAtDepth(depth:Number) : MovieClip

Permet de déterminer si une profondeur spécifique est déjà occupée par un clip.

 

getNextHighestDepth() : Number

Permet de déterminer une valeur de profondeur que vous pouvez transmettre à MovieClip.attachMovie(), MovieClip.duplicateMovieClip(), ou MovieClip.createEmptyMovieClip() afin de vous assurer que Flash rende le clip devant tous les autres objets sur les mêmes niveau et calque dans le clip actuel.

 

getSWFVersion() : Number

Renvoie un entier indiquant la version de Flash Player pour laquelle le clip a été publié.

 

getURL(url:String, [window:String], [method:String]) : Void

Charge un document à partir de l'URL spécifiée dans la fenêtre spécifiée.

 

globalToLocal(pt:Object) : Void

Convertit l'objet pt à partir des coordonnées de scène (globales) vers les coordonnées du clip (locales).

 

gotoAndPlay(frame:Object) : Void

Commence la lecture du fichier SWF sur l'image spécifiée.

 

gotoAndStop(frame:Object) : Void

Place la tête de lecture au niveau de l'image spécifiée du clip et l'arrête à cet endroit.

 

hitTest() : Boolean

Evalue le clip pour savoir s'il recouvre ou recoupe la zone active identifiée par les paramètres de coordonnée target ou x et y.

 

lineStyle(thickness:Number, rgb:Number, alpha:Number, pixelHinting:Boolean, noScale:String, capsStyle:String, jointStyle:String, miterLimit:Number) : Void

Spécifie un style de trait utilisé par Flash pour les appels suivants de lineTo() et curveTo(), jusqu'à ce que vous appeliez lineStyle() avec des paramètres différents.

 

lineTo(x:Number, y:Number) : Void

Trace une ligne en utilisant le style de trait actuel à partir de la position de dessin actuelle jusqu'à (x, y) ; la position de dessin actuelle est ensuite définie sur (x, y).

 

loadMovie(url:String, [method:String]) : Void

Charge un fichier SWF ou JPEG dans un clip Flash Player lors de la lecture du fichier SWF d'origine.

 

loadVariables(url:String, [method:String]) : Void

Lit les données à partir d'un fichier externe et définit les valeurs des variables dans le clip.

 

localToGlobal(pt:Object) : Void

Convertit l'objet pt à partir des coordonnées du clip (locales) vers les coordonnées de la scène (globales).

 

moveTo(x:Number, y:Number) : Void

Déplace la position de dessin actuelle vers (x, y).

 

nextFrame() : Void

Place la tête de lecture sur l'image suivante et l'arrête.

 

play() : Void

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

 

prevFrame() : Void

Place la tête de lecture sur l'image précédente et l'arrête.

 

removeMovieClip() : Void

Supprime une occurrence de clip créée avec duplicateMovieClip(), MovieClip.duplicateMovieClip(), MovieClip.createEmptyMovieClip(), ou MovieClip.attachMovie().

 

setMask(mc:Object) : Void

Définit le clip du paramètre mc comme étant un masque qui révèle le clip appelant.

 

startDrag([lockCenter:Boolean], [left:Number], [top:Number], [right:Number], [bottom:Number]) : Void

Permet à l'utilisateur de faire glisser le clip spécifié.

 

stop() : Void

Arrête le clip en cours de lecture.

 

stopDrag() : Void

Termine une méthode MovieClip.startDrag().

 

swapDepths(target:Object) : Void

Intervertit l'empilement, ou le niveau de profondeur (ordre z), de ce clip avec le clip spécifié par le paramètre target ou avec le clip qui occupe actuellement le niveau de profondeur spécifié dans le paramètre target.

 

unloadMovie() : Void

Supprime le contenu d'une occurrence de clip.

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

addProperty (méthode Object.addProperty), hasOwnProperty (méthode Object.hasOwnProperty), isPropertyEnumerable (méthode Object.isPropertyEnumerable), isPrototypeOf (méthode Object.isPrototypeOf), registerClass (méthode Object.registerClass), toString (méthode Object.toString), unwatch (méthode Object.unwatch), valueOf (méthode Object.valueOf), watch (méthode Object.watch)