Fonctions globales

Cette section regroupe des fonctions intégrées qui sont disponibles dans tout fichier SWF ayant recours à ActionScript. Ces fonctions globales couvrent un vaste ensemble de tâches communes de programmation, telles que l'application des types de données (Boolean(), int(), etc.), la production d'informations de débogage (trace()) et la communication avec Flash Player ou le navigateur (fscommand()).

Résumé des fonctions globales

Modificateurs

Signature

Description

 

Array([numElements], [elementN]) : Array

Crée un tableau vide ou convertit les éléments spécifiés en tableau.

 

Boolean(expression:Object) : Boolean

Convertit le paramètre expression en une valeur booléenne et renvoie true ou false.

 

call(frame:Object)

Déconseillé depuis Flash Player 5. Cette action a été déconseillée au profit de l'instruction function.

Exécute le script dans l'image appelée sans positionner la tête de lecture sur celle-ci.

 

chr(number:Number) : String

Déconseillé depuis Flash Player 5. Cette action a été déconseillée au profit de String.fromCharCode().

Convertit les numéros de code ASCII en caractères.

 

clearInterval(intervalID:Number)

Annule un intervalle créé par un appel à setInterval().

 

duplicateMovieClip(target:Object, newname:String, depth:Number)

Crée une occurrence de clip pendant la lecture du fichier SWF.

 

escape(expression:String) : String

Convertit le paramètre en chaîne et applique le format de code URL, où tous les caractères qui ne sont pas de type alphanumérique sont remplacés par des séquences hexadécimales %.

 

eval(expression:Object) : Object

Accède aux variables, propriétés, objets ou clips en fonction de leur nom.

 

fscommand(command:String, parameters:String)

Permet à un fichier SWF de communiquer avec le lecteur Flash Lite ou l'environnement d'un périphérique mobile (tel qu'un système d'exploitation).

 

fscommand2(command:String, parameters:String)

Permet au fichier SWF de communiquer avec le lecteur Flash Lite ou une application hôte sur un périphérique mobile.

 

getProperty(my_mc:Object, property:Object) : Object

Déconseillé depuis Flash Player 5. La syntaxe à point, introduite dans Flash Player 5, est à préférer.

Renvoie la valeur de la propriété spécifiée pour le clip my_mc.

 

getTimer() : Number

Renvoie le nombre de millisecondes qui se sont écoulées depuis le début de la lecture du fichier SWF.

 

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

Charge un document en provenance d'une URL spécifique dans une fenêtre ou transmet des variables à une autre application, à une URL donnée.

 

getVersion() : String

Renvoie une chaîne contenant la version de Flash Player et des informations sur la plate-forme.

 

gotoAndPlay([scene:String], frame:Object)

Place la tête de lecture sur l'image spécifiée dans une séquence et commence la lecture à partir de cette image.

 

gotoAndStop([scene:String], frame:Object)

Place la tête de lecture sur l'image spécifiée d'une séquence et l'arrête à ce niveau.

 

ifFrameLoaded([scene:String], frame:Object, statement(s):Object)

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée. Macromedia vous recommande d'employer la propriété MovieClip._framesloaded.

Vérifie si le contenu d'une image spécifique est disponible localement.

 

int(value:Number) : Number

Déconseillé depuis Flash Player 5. Cette action a été déconseillée au profit de Math.round().

Convertit un nombre décimal en valeur entière en tronquant la valeur décimale.

 

isFinite(expression:Object) : Boolean

Evalue l'expression et renvoie true s'il s'agit d'un nombre fini ou false s'il s'agit de l'infini ou de l'infini négatif.

 

isNaN(expression:Object) : Boolean

Evalue le paramètre et renvoie true si la valeur est NaN (not a number - n'est pas un nombre).

 

length(expression:String, variable:Object) : Number

Déconseillé depuis Flash Player 5. Cette fonction, de même que les fonctions de chaîne, est déconseillée. Macromedia vous recommande d'employer les méthodes de la classe String et la propriété String.length pour effectuer les mêmes opérations.

Renvoie la longueur de la chaîne ou variable spécifiée.

 

loadMovie(url:String, target:Object, [method:String])

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

 

loadMovieNum(url:String, level:Number, [method:String])

Charge un fichier SWF ou JPEG dans l'un des niveaux de Flash Player pendant la lecture du fichier SWF.

 

loadVariables(url:String, target:Object, [method:String])

Lit les données dans un fichier externe, tel qu'un fichier texte ou du texte généré par ColdFusion, un script CGI, des pages ASP (Active Server Pages), PHP ou un script Perl et définit les valeurs pour les variables dans un clip cible.

 

loadVariablesNum(url:String, level:Number, [method:String])

Lit les données dans un fichier externe, tel qu'un fichier texte ou du texte généré par ColdFusion, un script CGI, des pages ASP (Active Server Pages), PHP ou un script Perl et définit les valeurs pour les variables dans un niveau de Flash Player.

 

mbchr(number:Number)

Déconseillé depuis Flash Player 5. Cette fonction a été déconseillée au profit de la méthode String.fromCharCode().

Convertit un numéro de code ASCII en caractère multi-octets.

 

mblength(string:String) : Number

Déconseillé depuis Flash Player 5. Cette fonction a été déconseillée au profit de la propriété String.length.

Renvoie la longueur de la chaîne de caractères multi-octets.

 

mbord(character:String) : Number

Déconseillé depuis Flash Player 5. Cette action a été déconseillée au profit de la méthode String.charCodeAt().

Convertit le caractère spécifié en nombre multi-octets.

 

mbsubstring(value:String, index:Number, count:Number) : String

Déconseillé depuis Flash Player 5. Cette action a été déconseillée au profit de la méthode String.substr().

Extrait une nouvelle chaîne de caractères multi-octets d'une chaîne de caractères multi-octets.

 

nextFrame()

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

 

nextScene()

Place la tête de lecture sur l'image 1 de la séquence suivante.

 

Number(expression:Object) : Number

Convertit le paramètre expression en valeur numérique.

 

Object([value:Object]) : Object

Crée un objet vide ou convertit le nombre, la chaîne ou la valeur booléenne spécifié en objet.

 

on(mouseEvent:Object)

Spécifie l'événement de type souris ou pression de touche devant déclencher une action.

 

onClipEvent(movieEvent:Object)

Déclenche les actions définies pour une instance spécifique de clip.

 

ord(character:String) : Number

Déconseillé depuis Flash Player 5. Cette fonction a été déconseillée au profit de la méthode et des propriétés de la classe String.

Convertit les caractères en numéros de code ASCII.

 

parseFloat(string:String) : Number

Convertit une chaîne en nombre à virgule flottante.

 

parseInt(expression:String, [radix:Number]) : Number

Convertit une chaîne en entier.

 

play()

Fait avancer la tête de lecture au sein du scénario.

 

prevFrame()

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

 

prevScene()

Place la tête de lecture sur l'image 1 de la séquence précédente.

 

random(value:Number) : Number

Déconseillé depuis Flash Player 5. Cette action a été déconseillée au profit de Math.random().

Renvoie un entier aléatoire compris entre 0 et un inférieur au nombre entier spécifié dans le paramètre value.

 

removeMovieClip(target:Object)

Supprime le clip spécifié.

 

setInterval(functionName:Object, interval:Number, [param:Object], objectName:Object, methodName:String) : Number

Appelle une fonction ou une méthode ou un objet à des intervalles périodiques pendant la lecture d'un fichier SWF.

 

setProperty(target:Object, property:Object, expression:Object)

Modifie la valeur des propriétés d'un clip pendant la lecture de ce dernier.

 

startDrag(target:Object, [lock:Boolean], [left,top,right,bottom:Number])

Rend le clip target déplaçable pendant la lecture de l'animation.

 

stop()

Arrête le fichier SWF en cours de lecture.

 

stopAllSounds()

Arrête tous les sons en cours de diffusion à partir d'un fichier SWF, sans arrêter la tête de lecture.

 

stopDrag()

Arrête l'opération de déplacement en cours.

 

String(expression:Object) : String

Renvoie une chaîne représentant le paramètre spécifié.

 

substring(string:String, index:Number, count:Number) : String

Déconseillé depuis Flash Player 5. Cette action a été déconseillée au profit de String.substr().

Extrait une partie d'une chaîne.

 

targetPath(targetObject:Object) : String

Renvoie une chaîne contenant le chemin cible de movieClipObject.

 

tellTarget(target:String, statement(s):Object)

Déconseillé depuis Flash Player 5. Macromedia vous recommande d'employer la notation avec point (.) et l'instruction with.

Applique les instructions spécifiées dans le paramètre statements au scénario spécifié dans le paramètre target.

 

toggleHighQuality()

Déconseillé depuis Flash Player 5. Cette action a été déconseillée au profit de _quality.

Active et désactive l'anti-aliasing dans Flash Player.

 

trace(expression:Object)

Evalue l'expression et renvoie le résultat.

 

unescape(string:String) : String

Evalue le paramètre x en tant que chaîne, décode la chaîne qui est au format codé en URL (en convertissant toutes les séquences hexadécimales en caractères ASCII) et renvoie la chaîne.

 

unloadMovie(target)

Supprime le clip qui a été chargé par l'intermédiaire de la fonction loadMovie() de Flash Player.

 

unloadMovieNum(level:Number)

Supprime un fichier SWF ou une image qui a été chargé par l'intermédiaire de la fonction loadMovieNum() de Flash Player.