documentation flash movieclip

Vous êtes ici: Les articles techniques » documentation » Eléments du langage ActionScript » MovieClip

Table des matières

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.

  • Unordered List Item

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 :

  • La méthode attachMovie() permet de créer une occurrence de clip en fonction d’un symbole de clip provenant de la bibliothèque.
  • La méthode createEmptyMovieClip() permet de créer une occurrence de clip vide en tant qu’enfant reposant sur un autre clip.
  • La méthode duplicateMovieClip() permet de créer une occurrence de clip à partir d’un autre 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 Player 3

Voir également

Résumé des propriétés

Modificateurs Propriété Description
_alpha:Number Valeur de transparence alpha du clip.
blendMode:Object Mode de fondu de ce clip.
cacheAsBitmap:Boolean S’il a pour valeur true, Flash Player place en mémoire cache une représentation bitmap interne 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] Renvoie 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é.
filters:Array Tableau indexé contenant tous les objets filtre associés au clip.
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 clavier.
_framesloaded:Number [lecture seule] Nombre d’images à charger à partir d’un fichier SWF en diffusion continue.
_height:Number Hauteur du clip, en pixels.
_highquality:Number Déconseillé à partir de Flash Player 7. Il est recommandé d’utiliser 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 Valeur booléenne qui spécifie ce à quoi _root se réfère lorsqu’un fichier SWF est chargé dans un clip.
menu:ContextMenu Associe l’objet ContextMenu spécifié au clip.
_name:String Nom d’occurrence du clip.
opaqueBackground:Number Couleur de l’arrière-plan opaque (non transparent) du clip, spécifiée par un nombre (une valeur RVB hexadécimale).
_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.
scale9Grid:Rectangle La zone rectangulaire qui définit les neuf zones de redimensionnement du clip.
scrollRect:Object La propriété scrollRect permet de parcourir rapidement le contenu du clip et d’ouvrir une fenêtre plus grande pour afficher davantage de contenu.
_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 des événements de relâchement de souris.
transform:Transform Un objet avec des propriétés se rapportant à la matrice d’un clip, à la transformation des couleurs et aux limites des pixels.
_url:String [lecture seule] Récupère l’URL du fichier SWF, JPEG, GIF ou PNG ayant servi à télécharger le clip.
useHandCursor:Boolean Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque la souris passe sur un 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

Résumé des événements

Evénement Description
onData = function() {} Invoqué lorsqu’un clip reçoit des données d’un appel MovieClip.loadVariables() ou d’un appel 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 clavier.
onLoad = function() {} Appelé lorsque le clip est instancié et apparaît dans le scénario.
onMouseDown = function() {} Appelé lorsque l’utilisateur appuie sur le bouton de la souris.
onMouseMove = function() {} Appelé lorsque la souris bouge.
onMouseUp = function() {} Appelé lorsque l’utilisateur relâche 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é lorsqu’un utilisateur relâche le bouton de la souris sur un clip.
onReleaseOutside = function() {} Appelé lorsqu’un utilisateur appuie sur le bouton de la souris dans une zone de clip et le relâche ensuite en dehors de la zone de clip.
onRollOut = function() {} Appelé lorsqu’un utilisateur déplace le pointeur hors d’une zone de clip.
onRollOver = function() {} Appelé lorsqu’un utilisateur déplace le pointeur sur une zone de clip.
onSetFocus = function(oldFocus:Object) {} Appelé lorsqu’un clip reçoit le focus clavier.
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
attachAudio(id:Object) : Void Spécifie la source audio à jouer.
attachBitmap(bmp:BitmapData, depth:Number, [pixelSnapping:String], [smoothing:Boolean]) : Void Associe une image bitmap à un clip.
attachMovie(id:String, name:String, depth:Number, [initObject:Object]) : MovieClip Sélectionne un symbole dans la bibliothèque et l’associe au clip.
beginBitmapFill(bmp:BitmapData, [matrix:Matrix], [repeat:Boolean], [smoothing:Boolean]) : Void Remplit une zone de dessin avec une image bitmap.
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, [spreadMethod:String], [interpolationMethod:String], [focalPointRatio:Number]) : 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 de 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 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 appel de beginFill() ou beginGradientFill().
getBounds(bounds:Object) : Object Renvoie des propriétés dont les coordonnées x et y sont les valeurs 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.
getRect(bounds:Object) : Object Renvoie des propriétés dont les coordonnées x et y sont les valeurs minimales et maximales du clip, à partir du paramètre bounds, ce qui exclut tout tracé sur les formes.
getSWFVersion() : Number Renvoie un entier indiquant la version de Flash Player pour laquelle le clip a été publié.
getTextSnapshot() : TextSnapshot Renvoie un objet TextSnapshot contenant le texte de tous les champs de texte statiques contenus dans le clip spécifié ; le texte des clips enfants n’est pas inclus.
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ées target ou x et y.
lineGradientStyle(fillType:String, colors:Array, alphas:Array, ratios:Array, matrix:Object, [spreadMethod:String], [interpolationMethod:String], [focalPointRatio:Number]) : Void Spécifie un style de trait utilisé par Flash pour les prochains appels des méthodes lineTo() et curveTo(), jusqu’à ce que vous appeliez la méthode lineStyle() ou la méthode lineGradientStyle() avec des paramètres différents.
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 prochains appels des méthodes lineTo() et curveTo() jusqu’à ce que vous appeliez la méthode lineStyle() avec des paramètres différents.
lineTo(x:Number, y:Number) : Void Trace une ligne en utilisant le style de trait actuel de la position de dessin actuelle à (x, y) ; la position de dessin actuelle est ensuite définie sur (x, y).
loadMovie(url:String, [method:String]) : Void Charge un fichier SWF, JPEG, GIF ou PNG 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




veille
inscrits inscrits ! Compensation à la rédaction
  • Inscription au wiki
  • Connexion

vod