M > MovieClip (objet)

 

MovieClip (objet)

Les méthodes de l'objet MovieClip fournissent la même fonctionnalité que les actions ciblant les clips. Il existe également des méthodes supplémentaires qui n'ont pas d'action équivalente dans la boîte à outils Actions du panneau Actions.

Il n'est pas nécessaire d'utiliser une méthode constructeur pour appeler les méthodes de l'objet MovieClip : vous faites référence aux occurrences de clips par leurs noms, avec la syntaxe suivante :

monClip.play();
monClip.gotoAndPlay(3);

 
Méthodes de l'objet MovieClip

Méthode

Description

MovieClip.attachMovie

Associe une animation dans la bibliothèque.

MovieClip.createEmptyMovieClip

Crée un clip vide.

MovieClip.createTextField

Crée un champ de texte vide.

MovieClip.duplicateMovieClip

Duplique le clip spécifié.

MovieClip.getBounds

Renvoie les coordonnées x et y minimum et maximum d'une animation dans un espace de coordonnées spécifié.

MovieClip.getBytesLoaded

Renvoie le nombre d'octets chargés pour le clip spécifié.

MovieClip.getBytesTotal

Renvoie la taille du clip, en octets.

MovieClip.getDepth

Renvoie la profondeur d'un clip.

MovieClip.getURL

Récupère un document d'une URL.

MovieClip.globalToLocal

Convertit l'objet de point des coordonnées de scène en coordonnées locales du clip spécifié.

MovieClip.gotoAndPlay

Envoie la tête de lecture à une image spécifique du clip et lit l'animation.

MovieClip.gotoAndStop

Envoie la tête de lecture à une image spécifique du clip et arrête l'animation.

MovieClip.hitTest

Renvoie true si le cadre de délimitation du clip spécifié croise le cadre de délimitation du clip cible.

MovieClip.loadMovie

Charge l'animation spécifiée dans le clip.

MovieClip.loadVariables

Charge les variables depuis une URL ou un autre emplacement dans le clip.

MovieClip.localToGlobal

Convertit un objet de point des coordonnées locales du clip en coordonnées globales de scène.

MovieClip.nextFrame

Envoie la tête de lecture à l'image suivante du clip.

MovieClip.play

Exécute le clip spécifié.

MovieClip.prevFrame

Envoie la tête de lecture à l'image précédente du clip.

MovieClip.removeMovieClip

Supprime le clip du scénario s'il a été créé avec une action ou méthode duplicateMovieClip ou avec la méthode attachMovie.

MovieClip.setMask

Spécifie un clip comme masque d'un autre clip.

MovieClip.startDrag

Spécifie un clip comme déplaçable et commence à déplacer le clip.

MovieClip.stop

Arrête la lecture de l'animation courante.

MovieClip.stopDrag

Arrête le déplacement d'un clip en cours de déplacement.

MovieClip.swapDepths

Permute le niveau de deux animations.

MovieClip.unloadMovie

Supprime une animation chargée avec l'action loadMovie.


 
Méthodes de dessin de l'objet MovieClip

Méthode

Description

MovieClip.beginFill

Commence à tracer un remplissage sur la scène.

MovieClip.beginGradientFill

Commence à tracer un remplissage en dégradé sur la scène.

MovieClip.clear

Supprime toutes les commandes de dessin associées à une occurrence de clip.

MovieClip.curveTo

Dessine une ligne avec le style de trait le plus récent.

MovieClip.endFill

Termine le remplissage spécifié par beginFill ou beginGradientFill.

MovieClip.lineStyle

Définit le trait des lignes créées avec les méthodes lineTo et curveTo.

MovieClip.lineTo

Dessine une ligne avec le style de trait actuel.

MovieClip.moveTo

Déplace la position de dessin actuelle aux coordonnées spécifiées.


 
Propriétés de l'objet MovieClip

Propriété

Description

MovieClip._alpha

La valeur de transparence d'une occurrence de clip.

MovieClip._currentframe

Le numéro de l'image dans laquelle la tête de lecture est actuellement située.

MovieClip._droptarget

Le chemin absolu (avec la syntaxe à barre oblique) de l'occurrence de clip sur laquelle un clip déplaçable a été déposé.

MovieClip.enabled

Indique si un clip de bouton est activé.

MovieClip.focusEnabled

Active un clip pour qu'il puisse recevoir le focus.

MovieClip._focusrect

Indique si un clip avec focus est encadré d'un rectangle jaune.

MovieClip._framesloaded

Le nombre d'images chargées depuis une animation lue en flux continu.

MovieClip._height

La hauteur d'une occurrence de clip, en pixels.

MovieClip.hitArea

Désigne un autre clip qui servira de zone active pour un clip de bouton.

MovieClip._highquality

Définit la qualité de rendu d'une animation

MovieClip._name

Le nom d'occurrence d'une occurrence de clip.

MovieClip._parent

Une référence au clip contenant le clip.

MovieClip._rotation

Le degré de rotation d'une occurrence de clip.

MovieClip._soundbuftime

Le nombre de secondes avant d'un son ne démarre en lecture continue.

MovieClip.tabChildren

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

MovieClip.tabEnabled

Indique si un clip est inclus dans l'ordre de tabulation.

MovieClip.tabIndex

Indique l'ordre de tabulation d'un objet.

MovieClip._target

Le chemin cible d'une occurrence de clip.

MovieClip._totalframes

Le nombre total d'images d'une occurrence de clip.

MovieClip.trackAsMenu

Indique si d'autres boutons peuvent recevoir des événements de relâchement du bouton de la souris.

MovieClip._url

L'URL du fichier SWF d'où le clip a été téléchargé.

MovieClip.useHandCursor

Détermine si le curseur de main est affiché lorsque la souris passe au-dessus d'un clip bouton.

MovieClip._visible

Une valeur booléenne déterminant si l'occurrence d'un clip est masquée ou visible.

MovieClip._width

La largeur d'une occurrence de clip, en pixels.

MovieClip._x

La coordonnée x d'une occurrence de clip.

MovieClip._xmouse

La coordonnée x du curseur dans une occurrence de clip.

MovieClip._xscale

La valeur spécifiant le pourcentage de redimensionnement horizontal d'un clip.

MovieClip._y

La coordonnée y d'une occurrence de clip.

MovieClip._ymouse

La coordonnée y du curseur dans une occurrence de clip.

MovieClip._yscale

La valeur spécifiant le pourcentage de redimensionnement vertical d'un clip.


 
Gestionnaires d'événement de l'objet MovieClip

Propriété

Description

MovieClip.onData

Invoqué lorsque toutes les données sont chargées dans un clip.

MovieClip.onDragOut

Invoqué lorsque le pointeur se trouve en dehors du bouton, le bouton de la souris est enfoncé à l'intérieur, puis le pointeur sort de la zone du bouton.

MovieClip.onDragOver

Invoqué lorsque le pointeur se trouve au-dessus du bouton, le bouton de la souris a été enfoncé puis que le pointeur sort du bouton et ramené au-dessus du bouton.

MovieClip.onEnterFrame

Invoqué continuellement à la cadence de l'animation. Les actions associées à l'événement de clip enterFrame sont traitées avant les actions associées aux images affectées.

MovieClip.onKeyDown

Invoqué lorsqu'une touche est enfoncée. Utilisez les méthodes Key.getCode et Key.getAscii pour récupérer les informations concernant la dernière touche enfoncée.

MovieClip.onKeyUp

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

MovieClip.onKillFocus

Invoqué lorsque le focus est retiré d'un bouton.

MovieClip.onLoad

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

MovieClip.onMouseDown

Invoqué lorsque le bouton gauche de la souris est enfoncé.

MovieClip.onMouseMove

Invoqué à chaque fois que la souris est déplacée.

MovieClip.onMouseUp

Invoqué lorsque le bouton gauche de la souris est relâché.

MovieClip.onPress

Invoqué lorsque le bouton de la souris est enfoncé alors que le pointeur au-dessus d'un bouton.

MovieClip.onRelease

Invoqué lorsque le bouton de la souris est relâché alors que le pointeur au-dessus d'un bouton.

MovieClip.onReleaseOutside

Invoqué lorsque la souris est relâchée alors que le pointeur se trouve au dehors du bouton après l'enfoncement du bouton pendant que le pointeur est à l'intérieur du bouton.

MovieClip.onRollOut

Invoqué lorsque le pointeur passe à l'extérieur d'un bouton.

MovieClip.onRollOver

Invoqué lorsque le pointeur de la souris passe au-dessus d'un bouton.

MovieClip.onSetFocus

Invoqué lorsqu'un bouton a le focus de saisie et qu'une touche est relâchée.

MovieClip.onUnload

Invoqué dans la première image après la suppression du clip du scénario. Les actions associées à l'événement de clip onUnload sont traitées avant que des actions ne soient associées à l'image affectée.