ADOBE Flash Lite 2.x User Manual [fr]
REFERENCE DU LANGAGE
™
ACTIONSCRIPT
FLASH® LITE™ 2.x
© 2007 Adobe Systems Incorporated. Tous droits réservés.
Référence du langage ActionScript Flash Lite 2.x
Si le présent guide est fourni avec un logiciel régi par un contrat d'utilisateur final, ce guide ainsi que le logiciel décrit, sont
fournis sous licence et peuvent être utilisés ou copiés uniquement selon les clauses et conditions de la licence. A moins d'une
autorisation expresse accordée par cette licence, aucune partie du présent guide ne peut être reproduite, stockée dans un système
d'interrogation ou transmise, sous quelque forme ou par quelque moyen que ce soit (électronique, mécanique, par enregistrement
ou autre) sans l'autorisation écrite préalable d'Adobe Systems Incorporated. Veuillez noter que le contenu du présent guide est
protégé par la loi sur les droits d'auteur, même s'il n'est pas distribué avec un logiciel régi par un contrat de licence utilisateur final.
Les informations contenues dans le présent guide sont fournies à titre purement informatif ; elles sont susceptibles d'être
modifiées sans préavis et ne doivent pas être interprétées comme étant un engagement de la part d'Adobe Systems Incorporated.
Adobe Systems Incorporated n'accepte aucune responsabilité quant aux erreurs ou inexactitudes pouvant être contenues dans le
présent guide.
Veuillez noter que les illustrations et images existantes que vous souhaiterez éventuellement inclure dans votre projet sont
susceptibles d'être protégées par les lois sur les droits d'auteur. L'inclusion non autorisée de tels éléments dans vos nouveaux
travaux peut constituer une violation des droits du propriétaire. Veuillez vous assurer que vous obtenez toute autorisation
nécessaire auprès du détenteur du copyright.
Toute référence à des noms de sociétés dans les modèles types n'est utilisée qu'à titre d'exemple et ne fait référence à aucune
société réelle.
Adobe, Adobe logo, Flash et Macromedia sont des marques déposées ou des marques de commerce d'Adobe Systems
Incorporated aux Etats-Unis et/ou dans d'autres pays.
Macintosh est une marque de commerce d'Apple Computer, Inc. déposée aux Etats-Unis et dans d'autres pays. Windows est une
marque déposée ou une marque de commerce de Microsoft Corporation aux Etats-Unis et/ou dans d'autres pays. Linux est la
marque déposée de Linus Torvalds aux Etats-Unis et dans d'autres pays. UNIX est une marque déposée de The Open Group aux
Etats-Unis et dans d'autres pays.. Toutes les autres marques citées appartiennent à leurs propriétaires respectifs.
Certaines parties de ce produit utilisent du code sous licence de Nellymoser. (www.nellymoser.com).
Technologie de compression et de décompression vidéo Sorenson™ Spark™ utilisée sous licence de
Sorenson Media, Inc.
La vidéo de Flash CS3 est optimisée par la technoogie vidéo On2 TrueMotion. © 1992-2005 On2 Technologies, Inc. Tous droits
réservés. http://www.on2.com.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, Californie 95110, Etats-Unis. A l'attention des utilisateurs du
Gouvernement des Etats-Unis. Ce logiciel et sa documentation sont des « articles commerciaux », conformément à la définition
de ce terme dans le document 48 C.F.R. §2.101, comprenant d'une part un « logiciel informatique commercial » et d'autre part
une « documentation de logiciel informatique commercial », conformément à la définition de ces termes dans le document 48
C.F.R. §12.212 ou 48 C.F.R. §227.7202, si approprié. Conformément aux documents 48 C.F.R. §12.212 ou 48 C.F.R.
§§227.7202-1 à 227.7202-4, si approprié, le logiciel informatique commercial et la documentation de logiciel informatique
commercial sont accordés sous licence aux tilisateurs du Gouvernement des Etats-Unis (a) uniquement en tant que produits
commerciaux et (b) uniquement avec les droits accordés à tous les autres utilisateurs selon les termes et conditions mentionnés
dans le présent contrat. Droits non publiés réservés dans le cadre des lois sur les droits d'auteur en vigueur aux Etats-Unis. Adobe
Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, Etats-Unis. A l'attention des utilisateurs du Gouvernement
des Etats-Unis, Adobe s'engage à respecter la législation relative à l'égalité des chances y compris, le cas échéant, les dispositions
du décret 11246, tel qu'amendé, à la section 402 de la loi sur l'assistance aux vétérans du Vietnam (Vietnam Era Veterans
Readjustment Assistance Act) de 1974 (38 USC 4212), et à la section 503 de la loi sur la réadaptation (Rehabilitation Act) de
1973, telle qu'amendée, et la réglementation des articles 41 CFR, alinéas 60-1 à 60-60, 60-250 et 60-741. La clause relative à
l'égalité des chances et les règlements énoncés dans la phrase précédente doivent être compris comme tels lorsqu'il y est fait
référence.
Table des matières
Chapitre 1: Eléments du langage ActionScript . . . . . . . . . . . . . . . . . 5
Directives de compilation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Constantes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Fonctions globales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Propriétés globales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
Opérateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
Commandes fscommand2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Chapitre 2: Classes ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . .229
arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231
Boolean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
capabilities (System.capabilities) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Error. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
ExtendedKey. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
LoadVars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
MovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .413
MovieClipLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .515
Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .521
security (System.security) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
SharedObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
Stage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
String. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
3
System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
TextField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
TextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .664
Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680
XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .685
XMLNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
XMLSocket. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .725
Chapitre 3: Code ActionScript déconseillé. . . . . . . . . . . . . . . . . . 735
Fonctions déconseillées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .735
Propriétés déconseillées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737
Opérateurs déconseillés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .739
Chapitre 4: Eléments de code ActionScript non pris en charge . 741
Classes non prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741
Méthodes non prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741
Propriétés non prises en charge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741
Fonctions globales non prises en charge. . . . . . . . . . . . . . . . . . . . . . . .742
Gestionnaires d'événements non pris en charge . . . . . . . . . . . . . . . . .742
Commandes fs non prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . .742
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743
4 Table des matières
CHAPITRE 1
Eléments du langage ActionScript
Cette section fournit des informations sur la syntaxe, l'utilisation et des exemples de code
concernant les fonctions et les propriétés globales (ces éléments n'appartenant pas à une classe
ActionScript), ainsi que les directives de compilation ; pour les constantes, elle décrit les
opérateurs, instructions et mots-clés utilisés dans ActionScript et définis par la spécification de
langage ECMAScript (ECMA-262), version 4.
Directives de compilation
Cette section regroupe les directives à inclure dans votre fichier ActionScript pour demander
au compilateur de prétraiter certaines instructions.
Résumé des directives de compilation
Directive Description
#endinitclip Directive de compilation ; indique la fin d'un bloc d'actions
d'initialisation.
#include Directive de compilation ; inclut le contenu du fichier spécifié, comme
si les commandes du fichier faisaient partie du script d'appel.
#initclip Directive de compilation ; indique le début d'un bloc d'actions
d'initialisation.
1
Directive #endinitclip
#endinitclip
Directive de compilation ; indique la fin d'un bloc d'actions d'initialisation.
Exemple
#initclip
...initialization actions go here...
#endinitclip
5
Directive #include
#include "[path]filename.as" - Ne placez pas de point-virgule (;) à la fin de la ligne qui
contient l'instruction #include.
Directive de compilation : inclut le contenu du fichier spécifié, comme si les commandes du
fichier faisaient partie du script d'appel. La directive
compilation. Cela signifie que si vous apportez des modifications à un fichier externe, vous
devez enregistrer le fichier et recompiler tous les fichiers FLA qui l'utilisent.
Si vous utilisez le bouton Vérifier la syntaxe pour un script contenant des instructions
#include, la syntaxe des fichiers inclus est également vérifiée.
Vous pouvez utiliser
#include dans des fichiers FLA et dans des fichiers de script externes,
mais pas dans les fichiers de classe ActionScript 2.0.
Vous pouvez omettre le chemin, ou spécifier un chemin relatif ou absolu pour le fichier à
inclure. Si vous ne spécifiez pas de chemin, le fichier AS doit figurer dans l'un des
emplacements suivants :
■ Le même répertoire que le fichier FLA. Le même répertoire que le script contenant
l'instruction
■ Le répertoire Include global, qui peut prendre l'une des formes suivantes :
#include.
-Windows 2000 ou Windows XP : C:\Documents and Settings\utilisateur \Local Settings\
Application Data\Macromedia\Flash 8\langue\Configuration\Include
-Macintosh OS X : Disque dur/Users/Library/Application Support/Macromedia/Flash 8/
langue/Configuration/Include
■ Le répertoire programme Flash 8\langue\First Run\Include. Si vous enregistrez un fichier à
cet endroit, il est copié dans le répertoire Include global lors du démarrage suivant de
Flash.
Pour spécifier un chemin relatif pour le fichier AS, placez un point (.) pour représenter le
répertoire actuel, deux points (
..) pour représenter le répertoire parent et une barre oblique (/)
pour représenter les sous-répertoires. Consultez les exemples suivants :
Pour spécifier un chemin absolu pour le fichier AS, appliquez le format correspondant à votre
plate-forme (Macintosh ou Windows). Consultez les exemples suivants : (Cette utilisation
n'est pas recommandée car elle nécessite une structure de répertoires identique sur
l'ordinateur servant à compiler le script.)
Si vous placez des fichiers dans le répertoire First Run/Include ou dans le répertoire global Include,
sauvegardez ces fichiers. En effet, si vous devez désinstaller et réinstaller Flash, ces répertoires
risquent d'être supprimés ou remplacés.
#include est appelée lors de la
6 Eléments du langage ActionScript
Paramètres
[path]filename.as - filename.as Le nom de fichier et le chemin facultatif du script à
ajouter au panneau Actions ou au script actuel. Nous recommandons d'utiliser l'extension .as.
Exemple
Les exemples suivants indiquent différentes manières de spécifier un chemin pour un fichier à
inclure dans votre script :
// Les instructions #include ne se terminent pas par un point-virgule (;)
// Le fichier AS figure dans le même répertoire que le fichier FLA ou le
// script ou figure dans le répertoire global Include ou dans
// First Run/Include
#include "init_script.as"
// Le fichier AS figure dans un sous-répertoire de l'un des répertoires
// ci-dessus. Le sous-répertoire s'appelle " FLA_includes "
#include "FLA_includes/init_script.as"
// Le fichier AS figure dans un sous-répertoire du répertoire du fichier de
// script
// Ce sous-répertoire s'appelle " SCRIPT_includes "
#include "SCRIPT_includes/init_script.as"
// Le fichier AS figure dans un répertoire situé au même niveau que l'un des
// répertoires ci-dessus
// Le fichier AS figure dans un répertoire situé au même
// niveau que le répertoire contenant le fichier script
// Ce répertoire s'appelle " ALL_includes "
#include "../ALL_includes/init_script.as"
// Le fichier AS est spécifié par un chemin absolu sous Windows
// Notez l'utilisation de barres obliques, par opposition aux barres
// obliques inversées
#include "C:/Flash_scripts/init_script.as"
// Le fichier AS est spécifié par un chemin absolu sur le Macintosh
#include "Mac HD:Flash_scripts:init_script.as"
Directives de compilation 7
Directive #initclip
#initclip order - Ne placez pas de point-virgule (;) à la fin de la ligne qui contient l'instruction
#initclip.
Directive de compilation ; indique le début d'un bloc d'actions d'initialisation. Lorsque
plusieurs clips sont initialisés simultanément, vous pouvez utiliser le paramètre
spécifier l'initialisation devant se produire en premier. Les actions d'initialisation s'exécutent
lorsqu'un symbole de clip est défini. Si le clip est un symbole exporté, les actions
d'initialisation s'exécutent avant les actions de l'image 1 du fichier SWF. Sinon, elles
s'exécutent immédiatement avant les actions portant sur l'image qui contient la première
occurrence du symbole de clip correspondant.
Les actions d'initialisation ne s'exécutent qu'une seule fois lors de la lecture d'un fichier SWF ;
utilisez-les pour les initialisations uniques, telles que les opérations de définition de classe et
d'inscription.
Paramètres
order - Un entier non négatif spécifiant l'ordre d'exécution des blocs de code #initclip. Ce
paramètre est facultatif. Vous devez spécifier la valeur à l'aide d'un littéral entier (seules les
valeurs décimales sont autorisées, et non pas les valeurs hexadécimales), et non à l'aide d'une
variable. Si vous incluez plusieurs blocs
compilateur utilise alors la dernière valeur
les blocs
#initclip de ce symbole.
#initclip dans un symbole de clip unique, le
order spécifiée dans ce symbole de clip pour tous
order pour
Exemple
Dans l'exemple suivant, le code ActionScript est placé sur l'image 1 au sein d'une occurrence
de clip. Un fichier texte variables.txt est placé dans le même répertoire.
#initclip
trace("initializing app");
var variables:LoadVars = new LoadVars();
variables.load("variables.txt");
variables.onLoad = function(success:Boolean) {
trace("variables loaded:"+success);
8 Eléments du langage ActionScript
if (success) {
for (i in variables) {
trace("variables."+i+" = "+variables[i]);
}
}
};
#endinitclip
Constantes
Une constante est une variable qui représente une propriété dont la valeur ne change jamais.
Cette section décrit des constantes globales qui sont disponibles pour tous les scripts.
Résumé des constantes
Modificateurs Constante Description
false Valeur booléenne unique qui représente l'opposé
de true.
Infinity Spécifie la valeur IEEE-754 représentant l'infini
positif.
-Infinity Spécifie la valeur IEEE-754 représentant l'infini
négatif.
NaN Variable prédéfinie incluant la valeur IEEE-754
pour NaN (n'est pas un nombre).
newline Insère un caractère de retour chariot (\r) qui insère
une ligne vierge dans le texte généré par votre
code.
null Valeur spéciale qui peut être affectée à des
variables ou renvoyée par une fonction en
l'absence de données.
true Valeur booléenne unique qui représente l'opposé
de false.
undefined Une valeur spéciale, qui indique généralement
qu'une variable n'a pas encore reçu de valeur.
Constantes 9
Constante false
Valeur booléenne unique qui représente l'opposé de true.
Lorsque le typage automatique de données convertit
convertit
false en chaîne, il renvoie "false".
false en nombre, il renvoie 0. Lorsqu'il
Exemple
Cet exemple indique comment le typage automatique de données convertit
false en nombre
et en chaîne :
var bool1:Boolean = Boolean(false);
// Convertit cette valeur en nombre 0
trace(1 + bool1); // Renvoie 1
// Convertit la valeur en chaîne
trace("String: " + bool1); // Renvoie la chaîne : false
Constante Infinity
Spécifie la valeur IEEE-754 représentant l'infini positif. La valeur de cette constante est
identique à
Voir aussi
POSITIVE_INFINITY (propriété Number.POSITIVE_INFINITY)
Number.POSITIVE_INFINITY.
Constante -Infinity
Spécifie la valeur IEEE-754 représentant l'infini négatif. La valeur de cette constante est
identique à
Number.NEGATIVE_INFINITY.
Voir aussi
NEGATIVE_INFINITY (propriété Number.NEGATIVE_INFINITY)
Constante NaN
Variable prédéfinie incluant la valeur IEEE-754 pour NaN (n'est pas un nombre).
Pour déterminer si la valeur d'un nombre est NaN, utilisez
Voir aussi
Fonction isNaN, NaN (propriété Number.NaN)
10 Eléments du langage ActionScript
isNaN().
Constante newline
Insère un caractère de retour de chariot (\r) qui insère une ligne vierge dans le texte généré par
votre code. Utilisez
newline pour ménager un espace pour les informations extraites par une
fonction ou une instruction dans votre code.
Exemple
L'exemple suivant indique comment
trace() sur plusieurs lignes.
var myName:String = "Lisa", myAge:Number = 30;
trace(myName+myAge);
trace("-----");
trace(myName+newline+myAge);
// Renvoie :
Lisa30
----Lisa
30
newline affiche la sortie à partir de l'instruction
Voir aussi
Fonction trace
Constante null
Valeur spéciale qui peut être affectée à des variables ou renvoyée par une fonction en l'absence
de données. Vous pouvez utiliser
type de données n'est pas défini.
null pour représenter les valeurs manquantes ou dont le
Exemple
Dans un contexte numérique,
null. Dans cette instruction, le nœud d'arbre binaire ne comporte pas d'enfant gauche, par
conséquent le champ de cet enfant gauche peut être défini sur
if (tree.left == null) {
tree.left = new TreeNode();
}
null renvoie 0. Vous pouvez exécuter des tests d'égalité avec
null.
Constantes 11
Constante true
Valeur booléenne unique qui représente l'opposé de false. Lorsque le typage automatique de
données convertit
"true".
Exemple
L'exemple suivant illustre l'utilisation de
var shouldExecute:Boolean;
// ...
// le code qui définit shouldExecute sur true ou false vient ici
// shouldExecute est défini sur true dans cet exemple :
shouldExecute = true;
if (shouldExecute == true) {
trace("vos instructions");
}
// true est également implicite, ce qui permettrait également d'utiliser
// l'instruction if :
// if (shouldExecute) {
// trace("vos instructions");
// }
L'exemple suivant indique comment le typage automatique de données convertit true en
nombre 1 :
var myNum:Number;
myNum = 1 + true;
trace(myNum); // Renvoie : 2
true en nombre, il renvoie 1. Lorsqu'il convertit true en chaîne, il renvoie
true dans une instruction if :
Voir aussi
Constante false, Boolean
Constante undefined
Une valeur spéciale, qui indique généralement qu'une variable n'a pas encore reçu de valeur.
Une référence à une valeur non définie renvoie la valeur spéciale
ActionScript
undefined est undefined.
12 Eléments du langage ActionScript
typeof(undefined) renvoie la chaîne "undefined". L'unique valeur du type
undefined. Le code
Dans les fichiers publiés pour Flash Player 6 ou version précédente, la valeur de
String(undefined) est " " (une chaîne vide). Dans les fichiers publiés pour Flash Player 7 ou
version ultérieure, la valeur de
String(undefined) est "undefined" (undefined est
converti en chaîne).
Dans les fichiers publiés pour Flash Player 6 ou version précédente, la valeur de
Number(undefined) est 0. Dans les fichiers publiés pour Flash Player 7 ou version ultérieure,
la valeur de
La valeur
undefined sont comparées avec l'opérateur d'égalité (==), elles sont considérées comme
égales. Lorsque les propriétés
stricte (
Number(undefined) est NaN.
undefined est similaire à la valeur spéciale null. Lorsque les propriétés null et
null et undefined sont comparées avec l'opérateur d'égalité
===), elles sont considérées comme différentes.
Exemple
Dans l'exemple suivant, la variable
Dans la première section du code, l'opérateur d'égalité (
undefined ; le résultat s'affiche dans le panneau Sortie. Dans la première section du code,
l'opérateur d'égalité (
==) compare la valeur de x à la valeur undefined ; le résultat s'inscrit
x n'a pas été déclarée, sa valeur est donc undefined.
==) compare la valeur de x à la valeur
dans le fichier journal.
Dans la deuxième section du code, l'opérateur d'égalité (
undefined.
// x n'a pas été déclaré
trace("The value of x is "+x);
==) compare les valeurs null et
if (x == undefined) {
trace("x is undefined");
} else {
trace("x is not undefined");
}
trace("typeof (x) is "+typeof (x));
if (null == undefined) {
trace("null and undefined are equal");
} else {
trace("null and undefined are not equal");
}
Le résultat suivant s'affiche dans le panneau Sortie.
The value of x is undefined
x is undefined
typeof (x) is undefined
null and undefined are equal
Constantes 13
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 (
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
Boolean(expression:O
bject) : Boolean
call(frame:Object) Déconseillé depuis Flash Player 5. Cette action a
chr(number:Number) :
String
clearInterval(interv
alID:Number)
duplicateMovieClip(t
arget:Object,
newname:String,
depth:Number)
escape(expression:St
ring) : String
eval(expression:Obje
ct) : Object
fscommand(command:St
ring,
parameters:String)
Crée un tableau vide ou convertit les éléments
spécifiés en tableau.
Convertit le paramètre expression en une valeur
booléenne et renvoie true ou false.
é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.
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.
Annule un intervalle créé par un appel à
setInterval().
Crée une occurrence de clip pendant la lecture du
fichier SWF.
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 %.
Accède aux variables, propriétés, objets ou clips en
fonction de leur nom.
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).
Boolean(),
14 Eléments du langage ActionScript
Modificateurs Signature Description
fscommand2(command:S
tring,
parameters:String)
getProperty(my_mc:Ob
ject,
property:Object) :
Object
getTimer() : Number Renvoie le nombre de millisecondes qui se sont
getURL(url:String,
[window:String],
[method:String])
getVersion() :
String
gotoAndPlay([scene:S
tring],
frame:Object)
gotoAndStop([scene:S
tring],
frame:Object)
ifFrameLoaded([scene
:String],
frame:Object,
statement(s):Object)
int(value:Number) :
Number
isFinite(expression:
Object) : Boolean
isNaN(expression:Obj
ect) : Boolean
Permet au fichier SWF de communiquer avec le
lecteur Flash Lite ou une application hôte sur un
périphérique mobile.
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.
écoulées depuis le début de la lecture du fichier
SWF.
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.
Renvoie une chaîne contenant la version de Flash
Player et des informations sur la plate-forme.
Place la tête de lecture sur l'image spécifiée dans
une séquence et commence la lecture à partir de
cette image.
Place la tête de lecture sur l'image spécifiée d'une
séquence et l'arrête à ce niveau.
Déconseillé depuis Flash Player 5. Cette fonction
est déconseillée. Adobe recommande d'employer
la propriété MovieClip._framesloaded.
Vérifie si le contenu d'une image spécifique est
disponible localement.
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.
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.
Evalue le paramètre et renvoie true si la valeur est
NaN (not a number - n'est pas un nombre).
Fonctions globales 15
Modificateurs Signature Description
length(expression:St
ring,
variable:Object) :
Number
loadMovie(url:String
, target:Object,
[method:String])
loadMovieNum(url:Str
ing, level:Number,
[method:String])
loadVariables(url:St
ring, target:Object,
[method:String])
loadVariablesNum(url
:String,
level:Number,
[method:String])
mbchr(number:Number) Déconseillé depuis Flash Player 5. Cette fonction
mblength(string:Stri
ng) : Number
mbord(character:Stri
ng) : Number
Déconseillé depuis Flash Player 5. Cette fonction,
de même que les fonctions de chaîne, est
déconseillée. Adobe 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.
Charge un fichier SWF ou JPEG dans Flash Player
pendant la lecture du fichier SWF d'origine.
Charge un fichier SWF ou JPEG dans l'un des
niveaux de Flash Player pendant la lecture du
fichier SWF.
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.
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.
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.
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.
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 multioctets.
16 Eléments du langage ActionScript
Modificateurs Signature Description
mbsubstring(value:St
ring, index:Number,
count:Number) :
String
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
Number(expression:Ob
ject) : Number
Object([value:Object
]) : Object
on(mouseEvent:Object
)
onClipEvent(movieEve
nt:Object)
ord(character:String)
: Number
parseFloat(string:St
ring) : Number
parseInt(expression:
String,
[radix:Number]) :
Number
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
random(value:Number)
: Number
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 multioctets d'une chaîne de caractères multi-octets.
suivante.
Convertit le paramètre expression en valeur
numérique.
Crée un objet vide ou convertit le nombre, la chaîne
ou la valeur booléenne spécifié en objet.
Spécifie l'événement de type souris ou pression de
touche devant déclencher une action.
Déclenche les actions définies pour une instance
spécifique de clip.
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.
Convertit une chaîne en nombre à virgule flottante.
Convertit une chaîne en entier.
précédente.
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.
Fonctions globales 17
Modificateurs Signature Description
removeMovieClip(targ
et:Object)
setInterval(function
Name:Object,
interval:Number,
[param:Object],
objectName:Object,
methodName:String) :
Number
setProperty(target:O
bject,
property:Object,
expression:Object)
startDrag(target:Obj
ect, [lock:Boolean],
[left,top,right,bott
om:Number])
stop() Arrête le fichier SWF en cours de lecture.
stopAllSounds() Arrête tous les sons en cours de diffusion à partir
stopDrag() Arrête l'opération de déplacement en cours.
String(expression:Ob
ject) : String
substring(string:Str
ing, index:Number,
count:Number) :
String
targetPath(targetObj
ect:Object) : String
tellTarget(target:St
ring,
statement(s):Object)
Supprime le clip spécifié.
Appelle une fonction ou une méthode ou un objet à
des intervalles périodiques pendant la lecture d'un
fichier SWF.
Modifie la valeur des propriétés d'un clip pendant la
lecture de ce dernier.
Rend le clip target déplaçable pendant la lecture
de l'animation.
d'un fichier SWF, sans arrêter la tête de lecture.
Renvoie une chaîne représentant le paramètre
spécifié.
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.
Renvoie une chaîne contenant le chemin cible de
movieClipObject.
Déconseillée depuis Flash Player 5. Adobe
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.
18 Eléments du langage ActionScript
Modificateurs Signature Description
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:Obj
ect)
unescape(string:Stri
ng) : String
unloadMovie(target) Supprime le clip qui a été chargé par l'intermédiaire
unloadMovieNum(level
:Number)
Evalue l'expression et renvoie le résultat.
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.
de la fonction loadMovie() de Flash Player.
Supprime un fichier SWF ou une image qui a été
chargé par l'intermédiaire de la fonction
loadMovieNum() de Flash Player.
Fonction Array
Array(): Array Array(numElements:Number): Array Array([element0:Object
[, element1, element2, ...elementN] ]) : Array
Crée un nouveau tableau de longueur zéro ou supérieure, ou un tableau contenant la liste des
éléments spécifiés, probablement de types de données différents.
Permet de créer l'un des tableaux suivants :
■ un tableau vide ;
■ un tableau d'une longueur spécifique mais dont les éléments ont des valeurs non définies ;
■ un tableau dont les éléments ont des valeurs spécifiques.
L'utilisation de cette fonction revient à créer un tableau avec le constructeur Array (voir
« Constructeur pour la classe Array »).
Vous pouvez transmettre un nombre (
plusieurs types différents (
element0, element1, ... elementN).
Les paramètres qui peuvent accepter plusieurs types de données sont répertoriés dans la
signature sous le type
Object.
numElements) ou la liste des éléments contenant un ou
Fonctions globales 19
Paramètres
numElements [facultatif] - Un entier positif spécifiant le nombre d'éléments contenus dans le
tableau. Vous pouvez spécifier numElements ou la liste des éléments, mais pas les deux.
elementN [facultatif] - un ou plusieurs paramètres, element0, element1, ... ,
elementN
accepter plusieurs types de données sont répertoriés sous le type
, dont les valeurs peuvent être de n'importe quel type. Les paramètres qui peuvent
Object. Vous pouvez
spécifier numElements ou la liste des éléments, mais pas les deux.
Valeur renvoyée
Array - Tableau.
Exemple
var myArray:Array = Array();
myArray.push(12);
trace(myArray); // Renvoie 12
myArray[4] = 7;
trace(myArray); // Renvoie 12,undefined,undefined,undefined,7
Utilisation 2 : L'exemple suivant crée un tableau de longueur 4 qui n'inclut aucun élément
défini :
var myArray:Array = Array(4);
trace(myArray.length); // Renvoie 4
trace(myArray); // Renvoie undefined,undefined,undefined,undefined
Utilisation 3 : L'exemple suivant crée un tableau incluant trois éléments définis :
var myArray:Array = Array("firstElement", "secondElement", "thirdElement");
trace (myArray); // Renvoie firstElement,secondElement,thirdElement
Contrairement au constructeur de classe Array, la fonction Array()
n'utilise pas le mot-clé new.
Voir aussi
Array
Fonction Boolean
Boolean(expression:Object) : Boolean
Convertit le paramètre expression en valeur booléenne et renvoie une valeur comme indiqué
dans la liste suivante :
■ Si expression est une valeur booléenne, la valeur renvoyée est expression.
■ Si expression est un nombre, la valeur renvoyée est true si le nombre diffère de zéro ;
sinon, la valeur renvoyée est
20 Eléments du langage ActionScript
false.
Si expression est une chaîne, renvoie l'une des valeurs suivantes :
■ Dans les fichiers publiés pour Flash Player 6 ou une version plus récente, la chaîne est tout
d'abord convertie en nombre. Sa valeur est
true si le nombre est différent de zéro, false
dans le cas contraire.
■ Dans les fichiers publiés pour Flash Player 7 ou version ultérieure, le résultat est true si la
longueur de la chaîne est supérieure à zéro et
Si
expression est une chaîne, le résultat est true si la longueur de cette chaîne est supérieure
à zéro,
false en cas de chaîne vide.
■ Si l'expression est undefined ou NaN (n'est pas un nombre), la valeur renvoyée est
false.
■ Si expression est un clip ou un objet, la valeur renvoyée est true.
false en cas de chaîne vide.
Contrairement au constructeur de classe Boolean, la fonction Boolean() n'utilise pas le mot-clé new.
De plus, le constructeur de classe Boolean initialise un objet booléen sur false si aucun paramètre
n'est spécifié, bien que la fonction Boolean() renvoie undefined en l'absence de paramètres.
Paramètres
expression:Object - Une expression à convertir en valeur booléenne.
Valeur renvoyée
Boolean - Valeur booléenne.
Exemple
trace(Boolean(-1)); // Renvoie : true
trace(Boolean(0)); // Renvoie : false
trace(Boolean(1)); // Renvoie : true
trace(Boolean(true)); // Renvoie : true
trace(Boolean(false)); // Renvoie : false
trace(Boolean("true")); // Renvoie : true
trace(Boolean("false")); // Renvoie : true
trace(Boolean("Craiggers")); // Renvoie : true
trace(Boolean("")); // Renvoie : false
Si les fichiers sont publiés pour Flash Player 6 ou version antérieure, les résultats diffèrent pour
trois des exemples précédents :
trace(Boolean("true")); // Renvoie : false
trace(Boolean("false")); // Renvoie : false
trace(Boolean("Craiggers")); // Renvoie : false
Fonctions globales 21
Cet exemple illustre une différence significative entre l'utilisation de la fonction Boolean() et
celle de la classe Boolean. La fonction
Boolean() permet de créer une valeur booléenne,
tandis que la classe Boolean crée un objet booléen. Les valeurs booléennes sont comparées en
fonction de leur valeur, tandis que les objets booléens sont comparés par référence.
// Les variables représentant des valeurs booléennes sont comparées en
// fonction de leur valeur
var a:Boolean = Boolean("a"); // a est True
var b:Boolean = Boolean(1); // b est True
trace(a==b); // True
// Les variables représentant des objets booléens sont comparées par
// référence
var a:Boolean = new Boolean("a"); // a est True
var b:Boolean = new Boolean(1); // b est True
trace(a == b); // False
Voir aussi
Boolean
Fonction call
call(frame)
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.
Les variables locales n'existent pas après l'exécution du script.
■ Si les variables ne sont pas déclarées dans un bloc ({}) mais que la liste d'actions a été
exécutée à l'aide d'une action call(), les variables sont locales et expirent à la fin de la liste
actuelle.
■ Si les variables ne sont pas déclarées dans un bloc et que la liste d'action actuelle n'a pas été
exécutée à l'aide de l'action call(), les variables sont interprétées en tant que variables de
scénario.
Paramètres
frame:Object - L'étiquette ou le numéro d'une image dans le scénario.
Voir aussi
Instruction function, call (méthode Function.call)
22 Eléments du langage ActionScript
Fonction chr
chr(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.
Paramètres
number:Number - Un numéro de code ASCII.
Valeur renvoyée
String - La valeur de caractère du code ASCII spécifié.
Exemple
L'exemple suivant convertit le nombre 65 en lettre A et l'affecte à la variable
chr(65);
Voir aussi
fromCharCode (méthode String.fromCharCode)
Fonction clearInterval
clearInterval(intervalID:Number) : Void
Annule un intervalle créé par un appel à setInterval().
myVar : myVar =
Paramètres
intervalID:Number - Un identificateur numérique (entier) renvoyé par un appel à
setInterval().
Exemple
L'exemple suivant définit, puis supprime un appel interval :
function callback() {
trace("interval called: "+getTimer()+" ms.");
}
var intervalID:Number = setInterval(callback, 1000);
Fonctions globales 23
Vous devez supprimer l'intervalle lorsque vous n'avez plus besoin de la fonction. Créez un
bouton intitulé
setInterval() :
clearInt_btn.onRelease = function(){
clearInterval(intervalID);
trace("cleared interval");
};
clearInt_btn et utilisez le code ActionScript suivant pour supprimer
Voir aussi
Fonction setInterval
Fonction duplicateMovieClip
duplicateMovieClip(target:String, newname:String, depth:Number) :
VoidduplicateMovieClip(target:MovieClip, newname:String, depth:Number) :
Void
Crée une occurrence de clip pendant la lecture du fichier SWF. La tête de lecture des clips
dupliqués commence toujours à l'image 1, quelle que soit la position de la tête de lecture dans
le clip d'origine. Les variables du clip d'origine ne sont pas copiées dans le clip dupliqué.
Utilisez la fonction ou la méthode
clip créée avec
duplicateMovieClip().
Paramètres
target:Object - Le chemin cible du clip à dupliquer. Ce paramètre peut être de type String
(tel que « my_mc ») ou une référence directe à l'occurrence de clip (par exemple my_mc). Les
paramètres qui peuvent accepter plusieurs types de données sont répertoriés sous le type
Object.
newname:String - Un identificateur unique pour le clip dupliqué.
depth:Number - Un niveau de profondeur unique pour le clip dupliqué. Le niveau de
profondeur correspond à l'ordre d'empilement des clips dupliqués. Cet ordre d'empilement
correspond à l'ordre d'empilement des calques dans le scénario ; les clips dont le niveau de
profondeur est inférieur sont masqués par les clips de niveau supérieur. Vous devez associer un
niveau de profondeur à chaque clip pour ne pas remplacer les fichiers SWF figurant à des
profondeurs non utilisées.
removeMovieClip() pour supprimer une occurrence de
24 Eléments du langage ActionScript
Exemple
Dans l'exemple suivant, une nouvelle occurrence de clip intitulée
image est chargée dans le clip, puis le clip
newImg_mc ; ce nouveau clip est déplacé sur la scène afin de ne pas recouvrir le clip d'origine
img_mc est dupliqué. Le clip dupliqué est intitulé
img_mc. est créée. Une
et la même image est chargée dans le deuxième clip.
this.createEmptyMovieClip("img_mc", this.getNextHighestDepth());
img_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg");
duplicateMovieClip(img_mc, "newImg_mc", this.getNextHighestDepth());
newImg_mc._x = 200;
newImg_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg");
Pour supprimer le clip dupliqué, vous pouvez ajouter ce code pour un bouton intitulé
myButton_btn.
this.myButton_btn.onRelease = function(){
removeMovieClip(newImg_mc);
};
Voir aussi
Fonction removeMovieClip, duplicateMovieClip (méthode
MovieClip.duplicateMovieClip)
MovieClip.removeMovieClip)
, removeMovieClip (méthode
Fonction escape
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 (%). Lorsque
cette fonction est utilisée dans une chaîne codée au format URL, le symbole pour-cent (%)
introduit les caractères d'échappement et ne doit pas être confondu avec l'opérateur modulo (%).
Paramètres
expression:String - L'expression est convertie en chaîne et est codée au format URL.
Valeur renvoyée
String - Chaîne codée au format URL.
Fonctions globales 25
Exemple
Le code suivant donne le résultat
var email:String = "someuser@somedomain.com";
trace(escape(email));
someuser%40somedomain%2Ecom :
Dans cet exemple, le symbole (@) a été remplacé par %40 et le point (.) par %2E. Cela est
particulièrement utile lorsque vous essayez de transmettre des informations à un serveur
distant et si les données contiennent des caractères spéciaux (par exemple,
& ou ?), comme
indiqué dans le code suivant :
var redirectUrl = "http://www.somedomain.com?loggedin=true&username=Gus";
getURL("http://www.myothersite.com?returnurl="+ escape(redirectUrl));
Voir aussi
Fonction unescape
Fonction eval
eval(expression:Object) : Objecteval(expression:String) : Object
Accède aux variables, propriétés, objets ou clips en fonction de leur nom. Lorsque l'expression
est une variable ou une propriété, la fonction renvoie la valeur de cette variable ou de cette
propriété. Si l'expression est un objet ou un clip, la fonction renvoie une référence de l'objet
ou du clip. Si l'élément nommé dans l'expression est introuvable, la fonction renvoie
undefined.
Sous Flash 4,
utiliser la classe Array pour ce faire.
Sous Flash 4, vous pouvez également utiliser
valeur d'une variable ou d'un nom d'occurrence et l'extraire. Cette opération est également
possible avec l'opérateur de tableau (
A partir de Flash 5, vous ne pouvez plus recourir à
extraire la valeur d'une variable ou d'un nom d'occurrence, car vous ne pouvez pas utiliser
eval() dans la partie gauche d'une équation. Par exemple, remplacez le code
eval ("var" + i) = "first";
par :
this["var"+i] = "first"
ou par :
set ("var" + i, "first");
eval() permettait de simuler des tableaux ; à partir de Flash 5, vous devez
eval() pour définir de façon dynamique la
[]).
eval() pour définir de façon dynamique et
26 Eléments du langage ActionScript
Paramètres
expression:Object - Le nom d'une variable, d'une propriété, d'un objet ou d'un clip à
extraire. Ce paramètre peut être de type String ou une référence directe à l'occurrence d'objet
(les guillemets (" ") sont facultatifs.)
Valeur renvoyée
Object - Une valeur, une référence à un objet ou un clip, ou undefined.
Exemple
L'exemple suivant utilise
dynamique. Ce code ActionScript définit la propriété
square1_mc, square2_mc et square3_mc.
for (var i = 1; i <= 3; i++) {
setProperty(eval("square"+i+"_mc"), _rotation, 5);
}
eval() pour définir les propriétés des clips nommés de façon
_rotation de trois clips intitulés
Vous pouvez également utiliser le code ActionScript suivant :
for (var i = 1; i <= 3; i++) {
this["square"+i+"_mc"]._rotation = -5;
}
Voir aussi
Array, Instruction set variable
Fonctions globales 27
Fonction fscommand
fscommand(command:String, parameters:String): Void
La fonction fscommand() 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). Les
paramètres définissent le nom de l'application en cours de démarrage et les paramètres
correspondants, séparés par des virgules.
Commande Paramètres Rôle
launch application-path,
arg1, arg2,..., argn
Cette commande lance une autre application
sur un périphérique mobile. Le nom de
l'application et ses paramètres sont transmis à
l'aide d'un argument unique.
Remarque : Cette fonctionnalité dépend du
système d'exploitation. Utilisez cette
commande avec circonspection, dans la
mesure où elle a recours au périphérique hôte
pour exécuter une opération non prise en
charge. Ceci risque d'entraîner un blocage sur
ce périphérique.
Cette commande est prise en charge
uniquement lorsque le lecteur Flash Lite est en
cours d'exécution en mode autonome. Il n'est
pas pris en charge lorsque le lecteur s'exécute
dans le contexte d'une autre application (par
exemple, en tant que module externe dans un
navigateur).
28 Eléments du langage ActionScript
Commande Paramètres Rôle
activateTextField "" (ignored) Cette commande active de façon asynchrone le
champ texte sélectionné, ce qui autorise les
modifications par l'utilisateur. En raison de son
comportement asynchrone, cette commande
est traitée à la fin de l'image. Le code
ActionScript qui suit immédiatement l'appel à
fscommand() s'exécute en premier. Si aucun
texte n'est sélectionné lorsque la commande
est traitée, rien ne se produit. Cette commande
donne le focus a un champ texte qui a été
transmis auparavant à la méthode
Selection.setFocus() et active le champ
texte en vue de sa modification. Cette
commande a uniquement un effet lorsque le
téléphone prend en charge la modification de
texte en ligne.
Cette commande peut être appelée dans le
cadre d'un rappel de l'écouteur d'événements
Selection.onSetFocus(). Les champs texte
deviennent alors actifs et peuvent être modifiés
lorsqu'ils sont sélectionnés.
Remarque : Dans la mesure où la fonction
fscommand() s'exécute de façon asynchrone,
le champ texte ne devient pas immédiatement
actif ; il devient actif à la fin de l'image.
Paramètres
command:String - Une chaîne transmise à l'application hôte ou une commande passée au
lecteur Flash Lite.
parameters:String - Une chaîne transmise à l'application hôte ou une commande passée à
Flash Lite.
Exemple
Dans l'exemple suivant, la fonction
fscommand() ouvre wap.yahoo.com sur le navigateur
services/Web des téléphones Série 60 :
on(keyPress "9") {
status = fscommand("launch",
"z:\\system\\apps\\browser\\browser.app,http://wap.yahoo.com");
}
Fonctions globales 29
Fonction fscommand2
fscommand2(command:String, parameter1:String,...parameterN:String): Void
Permet au fichier SWF de communiquer avec le lecteur Flash Lite ou une application hôte sur
un périphérique mobile.
Pour utiliser
utiliser les commandes et les paramètres prédéfinis. Consultez la section « Commandes
fscommand2 » de la rubrique « Eléments du langage ActionScript » pour prendre
connaissance des commandes et des paramètres pouvant être spécifiés pour la fonction
fscommand(). Ces valeurs contrôlent les fichiers SWF lus par le lecteur Flash Player.
La fonction
suivantes :
■ La fonction fscommand2() accepte autant d'arguments que nécessaire. Par opposition,
fscommand() ne peut recevoir qu'un seul argument.
■ Flash Lite exécute fscommand2() immédiatement (en d'autres termes, dans l'image) alors
que
■ La fonction fscommand2() renvoie une valeur qui permet de signaler le succès, l'échec ou
le résultat de la commande.
Remarque : Aucune des commandes
Commandes fscommand2() déconseillées
Certaines commandes
Flash Lite 2.0. Le tableau suivant regroupe les commandes
fscommand2() afin d'envoyer un message au lecteur Flash Lite, vous devez
fscommand2() est similaire à la fonction fscommand(), avec les différences
fscommand() est exécuté à la fin du traitement de l'image.
fscommand2() ne sont disponibles dans les lecteurs Web.
fscommand2() de Flash Lite 1.1 sont désormais déconseillées dans
fscommand2() déconseillées :
Commande Remplacée par
Escape Fonction globale escape
GetDateDay
GetDateMonth getMonth(), méthode de l'objet Date
GetDateWeekday
GetDateYear
GetLanguage propriété System.capabilities.language
GetLocaleLongDate getLocaleLongDate(), méthode de l'objet Date
GetLocaleShortDate
GetLocaleTime getLocaleTime(), méthode de l'objet Date
GetTimeHours
GetTimeMinutes
30 Eléments du langage ActionScript
getDate(), méthode de l'objet Date
getDay(), méthode de l'objet Date
getYear(), méthode de l'objet Date
getLocaleShortDate(), méthode de l'objet Date
getHours(), méthode de l'objet Date
getMinutes(), méthode de l'objet Date
Loading...