Guide de référence du langage ActionScript™ Flash® Lite™ 1.x d'Adobe®
S’il est distribué avec un logiciel comprenant un contrat de licence, ce manuel, ainsi que le logiciel qui y est décrit, sont cédés sous licence et ne peuvent être
utilisés ou copiés que conformément à la présente licence. Sauf lorsque cela est prévu par la licence, aucune partie de ce manuel ne peut être reproduite, conservée
sur un support de stockage ou transmise par un moyen ou sous une forme quelconque (électronique, mécanique, enregistrée ou autre), sans l’autorisation écrite
préalable d’Adobe Systems Incorporated. Veuillez noter que le contenu de ce manuel est protégé par des droits d’auteur, même s’il n’est pas distribué avec un
logiciel comprenant un contrat de licence.
Les informations contenues dans ce manuel sont fournies à titre purement indicatif et ne doivent pas être considérées comme un engagement de la part d’Adobe
Systems Incorporated, qui se réserve le droit de les modifier sans préavis. Adobe Systems Incorporated décline toute responsabilité en cas d’éventuelles erreurs
ou inexactitudes relevées dans le contenu informationnel de ce manuel.
Ce guide contient des liens conduisant à des sites web qui ne sont pas sous le contrôle d'Adobe Systems Incorporated, qui n'est aucunement responsable de leur
contenu. L'accès à ces sites se fait sous votre seule responsabilité. Adobe Systems Incorporated fournit ces liens à des fins pratiques et l’inclusion de ces liens
n’implique pas que Adobe Systems Incorporated parraine ou accepte la moindre responsabilité pour le contenu de ces sites Web tiers.
Nous attirons votre attention sur le fait que les illustrations ou images que vous pouvez être amené à inclure dans vos projets sont peut-être protégées par des
droits d’auteur. L’exploitation de matériel protégé sans l’autorisation de l’auteur constitue une violation de droit. Assurez-vous d’obtenir les autorisations
requises avant de procéder.
Toutes les références à des noms de sociétés utilisés dans les modèles sont purement fictives et ne renvoient à aucune entreprise existante.
Adobe, the Adobe logo, ColdFusion, and Flash are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other
countries.
Symbian and all Symbian based marks and logos are trademarks of Symbian Limited. All other trademarks are the property of their respective owners.
Sorenson Spark™ video compression and decompression technology licensed from Sorenson Media, Inc.
MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson Multimedia (
Updated Information/Additional Third Party Code Information available at http://www.adobe.com/go/thirdparty/.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of
“Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202,
as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and
Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights
as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable
equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment
Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60,
60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.
Index ...............................................................................................................119
Chapitre 1 : Présentation
Ce manuel décrit la syntaxe et l'utilisation des éléments du code ActionScript tels que vous les utilisez en vue de
développer des applications pour les logiciels Macromedia® Flash® Lite™ 1.0 et Macromedia® Flash® Lite™ 1.1 d'Adobe,
dont l'ensemble porte le nom de Flash Lite 1.x. Le code ActionScript de Flash Lite 1.x est basé sur la version du code
ActionScript utilisée dans Macromedia® Flash® 4 d'Adobe. Pour utiliser des exemples dans un script, copiez l'exemple
de code figurant dans ce manuel et collez-le dans le panneau Script ou dans un fichier de script externe. Ce manuel
répertorie tous les éléments du code ActionScript : opérateurs, mots-clés, instructions, commandes, propriétés,
fonctions, classes et méthodes.
Dossier Samples
Pour obtenir des exemples de projets Flash Lite complets lors de l'utilisation du code ActionScript, consultez la page
qui regroupe des didacticiels et des exemples pour Flash Lite à l'adresse
www.adobe.com/go/learn_flt_samples_and_tutorials_fr. Repérez et téléchargez le fichier .zip correspondant à votre
version d'ActionScript, puis décompressez-le. Recherchez ensuite le dossier Samples et ouvrez-le pour afficher
l'exemple qui vous intéresse.
1
Conventions typographiques
Ce manuel utilise les conventions typographiques suivantes :
• La police en italique indique une valeur à remplacer (par exemple, dans le chemin d'un dossier).
• La police de code indique le code ActionScript.
• La police de code en italique signale un paramètre ActionScript.
• La police en gras désigne une entrée littérale.
• Les guillemets droits (""), dans les exemples de code, séparent les chaînes de caractères. Cependant, les
programmeurs peuvent également employer des guillemets simples.
Chapitre 2 : Fonctions globales de Flash
Lite
Cette section décrit la syntaxe et l'utilisation des fonctions globales ActionScript du logiciel Macromedia Flash Lite 1.1
d'Adobe. Elle comprend les rubriques suivantes :
FunctionDescription
call()Exécute le script dans l'image appelée sans positionner la tête de lecture sur celle-ci.
chr()Convertit les numéros de code ASCII en caractères.
duplicateMovieClip() Crée une occurrence de clip pendant la lecture du fichier SWF.
eval ()Accède aux variables, propriétés, objets ou clips en fonction de leur nom.
getProperty()Renvoie la valeur de la propriété spécifiée pour le clip désigné.
2
getTimer()Renvoie le nombre de millisecondes qui se sont écoulées depuis le début de la lecture
getURL()Charge un document en provenance d'une URL spécifique dans une fenêtre ou
gotoAndPlay()Place la tête de lecture sur l'image spécifiée dans une séquence et commence la
gotoAndStop()Place la tête de lecture sur l'image spécifiée sur une séquence et l'arrête à ce niveau.
ifFrameLoaded()Vérifie si le contenu d'une image spécifique est disponible localement.
int()Tronque un nombre décimal pour en faire un entier.
length()Renvoie le nombre de caractères de la chaîne ou variable spécifiée.
loadMovie()Charge un fichier SWF dans Flash Lite pendant la lecture du fichier SWF d'origine.
loadMovieNum()Charge un fichier SWF dans l'un des niveaux de Flash Lite pendant la lecture du fichier
loadVariables()Lit les données dans un fichier externe, tel qu'un fichier texte ou du texte généré par
loadVariablesNum()Lit les données dans un fichier externe, tel qu'un fichier texte ou du texte généré par
du fichier SWF.
transmet des variables à une autre application, à une URL donnée.
lecture à partir de cette image. Si aucune séquence n'est spécifiée, la tête de lecture
passe à l'image spécifiée de la séquence en cours.
Si aucune séquence n'est spécifiée, la tête de lecture passe à l'image de la séquence
en cours.
SWF.
un script Adobe ColdFusion®, CGI ASP, PHP ou Perl, et définit les valeurs des variables
dans un niveau de Flash Lite. Cette fonction permet également de mettre à jour les
variables du fichier SWF actif en fonction des nouvelles valeurs.
un script ColdFusion, CGI ASP, PHP ou Perl, et définit les valeurs pour les variables dans
un niveau de Flash Lite. Cette fonction permet également de mettre à jour les
variables du fichier SWF actif en fonction des nouvelles valeurs.
mbchr()Convertit un numéro de code ASCII en caractère multi-octets.
mblength()Renvoie la longueur de la chaîne de caractères multi-octets.
mbord()Convertit le caractère spécifié en nombre multi-octets.
mbsubstring()Extrait une nouvelle chaîne de caractères multi-octets d'une chaîne de caractères
multi-octets.
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
FunctionDescription
nextFrame()Place la tête de lecture sur l'image suivante et l'arrête.
nextScene()Place la tête de lecture sur l'image 1 de la séquence suivante et l'arrête.
Number()Convertit une expression en nombre et renvoie une valeur.
3
Fonctions globales de Flash Lite
on()Spécifie l'événement de type utilisateur ou pression de touche qui déclenche un autre
ord()Convertit les caractères en numéros de code ASCII.
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 et l'arrête. Si l'image active est l'image
prevScene()Place la tête de lecture sur l'image 1 de la séquence précédente et l'arrête.
« random() » à la
page 24
removeMovieClip()Supprime le clip spécifié initialement créé à l'aide de duplicateMovieClip().
set()Associe une valeur à une variable.
setProperty()Modifie la valeur des propriétés d'un pendant la lecture de ce dernier.
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
String()Renvoie une chaîne représentant le paramètre spécifié.
substring()Extrait une partie d'une chaîne.
tellTarget()Applique les instructions spécifiées dans le paramètre statement(s) au scénario
événement.
1, la tête de lecture ne bouge pas.
Renvoie un entier aléatoire.
de lecture.
désigné dans le paramètre
target.
toggleHighQuality()Active et désactive l'anti-aliasing dans Flash Lite. L'anti-aliasing adoucit les bords des
trace()Evalue l'expression et affiche les résultats dans le panneau Sortie en mode de test.
unloadMovie()Supprime de Flash Lite le clip qui a été chargé par l'intermédiaire de la fonction
unloadMovieNum()Supprime d'un niveau de Flash Lite le clip qui a été chargé par l'intermédiaire de la
objets, mais ralentit la lecture des fichiers SWF.
loadMovie(), loadMovieNum() ou duplicateMovieClip().
loadMovie(), loadMovieNum() ou duplicateMovieClip().
fonction
call()
Disponibilité
Flash Lite 1.0.
Utilisation
call(frame)
call(movieClipInstance:frame)
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
Opérandes
bloc Etiquette ou numéro d'une image dans le scénario.
movieClipInstance Nom d'occurrence d'un clip.
Description
Fonction ; 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. La fonction
call() peut prendre deux formes :
• La forme par défaut exécute le script sur l'image spécifiée du scénario pour lequel la fonction call() a été exécutée,
sans déplacer la tête de lecture jusqu'à cette image.
• La forme à occurrence de clip spécifiée exécute le script sur l'image désignée de l'occurrence de clip, sans déplacer
la tête de lecture jusqu'à cette image.
Remarque : La fonction
call() agit de manière synchronisée ; tout code ActionScript suivant une fonction call()
ne s'exécute que lorsque l'intégralité du code ActionScript est exécutée au niveau de l'image spécifiée.
Exemple
Les exemples suivants exécutent le script dans l'image
// to execute functions in frame with label "myScript"
thisFrame = "myScript";
trace ("Calling the script in frame: " add thisFrame);
// to execute functions in any other frame on the same timeline
call("myScript");
myScript :
4
chr()
Disponibilité
Flash Lite 1.0.
Utilisation
chr(number)
Opérandes
nombre Numéro de code ASCII.
Description
Fonction de la chaîne ; convertit les numéros de code ASCII en caractères.
Exemple
L'exemple suivant convertit le nombre 65 en lettre A et l'affecte à la variable
myVar = chr(65);
trace (myVar);// Output: A
myVar :
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
duplicateMovieClip()
Disponibilité
Flash Lite 1.0.
Utilisation
duplicateMovieClip(target, newname, depth)
Opérandes
target Chemin cible du clip à dupliquer.
newname Identificateur unique du clip dupliqué.
depth 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 est très proche de 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 unique à chaque clip dupliqué pour ne pas remplacer les clips figurant aux
niveaux de profondeur utilisés.
Description
Fonction ; crée une occurrence de clip pendant la lecture du fichier SWF. Ne renvoie aucune valeur. 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
(parent). Les variables du clip parent ne sont pas copiées dans le clip dupliqué. Si le clip parent est supprimé, le clip
dupliqué l'est également. La fonction ou la méthode
créée avec
duplicateMovieClip(). Référencez le nouveau clip en utilisant la chaîne transmise à l'aide de l'opérande
newname.
removeMovieClip() permet de supprimer une occurrence de clip
5
Exemple
L'exemple suivant permet de dupliquer un clip
originalClip pour créer un nouveau clip appelé newClip avec le
niveau de profondeur 10. La position x du nouveau clip est définie sur 100 pixels.
L'exemple suivant utilise duplicateMovieClip() dans une boucle for pour créer plusieurs nouveaux clips à la fois.
Une variable d'indice détermine la profondeur d'empilement occupée la plus élevée. Chaque nom de clip dupliqué
contient un suffixe numérique qui correspond à sa profondeur d'empilement (
for (i = 1; i <= 3; i++) {
newName = "clip" add i;
duplicateMovieClip("originalClip", newName); }
clip1, clip2, clip3).
Voir aussi
removeMovieClip()
eval ()
Disponibilité
Flash Lite 1.0.
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
Utilisation
eval(expression)
Opérandes
expression Chaîne contenant le nom d'une variable, d'une propriété, d'un objet ou d'un clip à extraire.
Description
Fonction ; accède aux variables, propriétés, objets ou clips en fonction de leur nom. Si expression est une variable ou
une propriété, la fonction renvoie la valeur de cette variable ou de cette propriété. Si 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 expression est introuvable, la fonction
renvoie
undefined.
6
Vous pouvez utiliser
eval() pour simuler des tableaux ou définir de façon dynamique la valeur d'une variable et
l'extraire.
Exemple
L'exemple suivant utilise
variable,
piece3 = "dangerous";
x = 3;
y = eval("piece" add x);
trace(y);// Output: dangerous.
piece3, eval() renvoie la valeur de la variable et l'affecte à y :
eval() pour déterminer la valeur de l'expression "piece" + x. Le résultat étant un nom de
L'exemple suivant explique comment il est possible de simuler un tableau :
_x) du clip my_mc dans le scénario du clip racine :
Description
Fonction ; renvoie le nombre de millisecondes qui se sont écoulées depuis le début de la lecture du fichier SWF.
Exemple
L'exemple suivant définit la variable
timeElapsed sur le nombre de millisecondes qui se sont écoulées depuis le début
de la lecture du fichier SWF :
timeElapsed = getTimer();
trace (timeElapsed);// Output: milliseconds of time movie has been playing
getURL()
Disponibilité
Flash Lite 1.0.
Utilisation
getURL(url [ , window [, "variables"]])
Opérandes
url L'URL permettant d'obtenir le document.
window Paramètre facultatif qui spécifie la fenêtre ou l'image HTML dans laquelle le document doit être chargé.
Remarque : Le paramètre
window n'est pas spécifié pour les applications Flash Lite parce que les navigateurs des
téléphones portables ne prennent pas en charge les fenêtres multiples.
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
Vous pouvez entrer une chaîne vide ou le nom d'une fenêtre spécifique, ou sélectionner l'un des noms cibles réservés
suivants :
• _self spécifie le cadre actif de la fenêtre en cours d'utilisation.
• _blank crée une fenêtre.
• _parent appelle le parent du cadre actif.
• _top sélectionne le cadre de plus haut niveau de la fenêtre active.
variables Méthode GET ou POST pour l'envoi de variables. En l'absence de variables, omettez ce paramètre. La
méthode
POST place les variables dans un en-tête HTTP distinct et permet d'envoyer des variables longues de type chaîne.
GET ajoute les variables à la fin de l'URL et est utilisée lorsque les variables sont peu nombreuses. La méthode
Description
Fonction ; 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. Pour tester cette fonction, assurez-vous que le fichier à charger existe à
l'emplacement prévu. Pour utiliser une URL absolue (par exemple, http://www.myserver.com), vous devez disposer
d'une connexion réseau.
Flash Lite 1.0 reconnaît uniquement les protocoles HTTP, HTTPS, mailto et tel. Flash Lite 1.1 reconnaît ces protocoles,
plus les protocoles de fichiers SMS et MMS.
8
Flash Lite transmet l'appel au système d'exploitation et celui-ci le gère avec l'application enregistrée par défaut pour le
protocole spécifié.
Une seule fonction
Certains combinés limitent la fonction
getURL() est traitée par image ou par gestionnaire d'événements.
getURL() à des événements de touche, auquel cas l'appel getURL() est traité
uniquement s'il est déclenché dans un gestionnaire d'événements de touche. Même dans ces circonstances, une seule
fonction
getURL() est traitée par gestionnaire d'événements.
Exemple
Dans le code ActionScript suivant, le lecteur Flash Lite ouvre la page mobile.example.com dans le navigateur par
défaut :
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
Vous pouvez affecter une fonction de bouton pour ouvrir une fenêtre de composition de message électronique avec
les champs de texte
address, subject et body déjà renseignés. Utilisez l'une des méthodes suivantes pour affecter une
fonction de bouton : La méthode 1 permet d'encoder les caractères Shift-JIS ou anglais ; la méthode 2 permet d'encoder
uniquement les caractères anglais.
Méthode 1 : Définissez les variables pour chacun des paramètres souhaités, comme dans cet exemple :
on (release, keyPress "#"){
subject = "email subject";
body = "email body";
getURL("mailto:somebody@anywhere.com", "", "GET");
}
Méthode 2 : Définissez tous les paramètres de la fonction getURL(), comme dans cet exemple :
on (release, keyPress "#"){
getURL("mailto:somebody@anywhere.com?cc=cc@anywhere.com&bcc=bcc@anywhere.
com&subject=I am the email subject&body=I am the email body");
}
La méthode 1 produit un encodage automatique des URL ; la méthode 2 préserve les espaces dans les chaînes. Par
exemple, les chaînes produites avec la méthode 1 se présentent comme suit :
email+subject
email+body
9
En revanche, la méthode 2 produit les chaînes suivantes :
email subject
email body
L'exemple suivant utilise le protocole tel :
on (release, keyPress "#"){
getURL("tel:117");
}
Dans l'exemple suivant, la fonction getURL() est utilisée pour envoyer un SMS :
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
gotoAndPlay()
Disponibilité
Flash Lite 1.0.
Utilisation
gotoAndPlay([scene,] frame)
Opérandes
scene Chaîne facultative qui spécifie le nom de la séquence cible de la tête de lecture.
bloc Nombre représentant le numéro d'image ou chaîne représentant l'étiquette de l'image cible de la tête de lecture.
Description
Fonction ; place la tête de lecture sur l'image spécifiée dans une séquence et commence la lecture à partir de cette image.
Si aucune séquence n'est spécifiée, la tête de lecture passe à l'image spécifiée de la séquence en cours.
Le paramètre scene est réservé au scénario racine. Vous ne pouvez pas l'utiliser dans les scénarios des clips ou d'autres
objets du document.
10
Exemple
Dans l'exemple suivant, lorsque l'utilisateur clique sur un bouton auquel la fonction
gotoAndPlay() est affectée, la
tête de lecture se place sur l'image 16 de la séquence actuelle et commence à lire le fichier SWF :
on(keyPress "7") {
gotoAndPlay(16);
}
gotoAndStop()
Disponibilité
Flash 1.0.
Utilisation
gotoAndStop([scene,] frame)
Opérandes
scene Chaîne facultative qui spécifie le nom de la séquence cible de la tête de lecture.
bloc Nombre représentant le numéro d'image ou chaîne représentant l'étiquette de l'image cible de la tête de lecture.
Description
Fonction ; place la tête de lecture sur l'image spécifiée d'une séquence et l'arrête. Si aucune séquence n'est spécifiée, la
tête de lecture passe à l'image de la séquence en cours.
Le paramètre scene est réservé au scénario racine. Vous ne pouvez pas l'utiliser dans les scénarios des clips ou d'autres
objets du document.
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
Exemple
Dans l'exemple suivant, lorsque l'utilisateur clique sur un bouton auquel la fonction
gotoAndStop() est affectée, la
tête de lecture se place sur l'image 5 de la séquence actuelle et la lecture du fichier SWF est interrompue :
on(keyPress "8") {
gotoAndStop(5);
}
ifFrameLoaded()
Disponibilité
Flash Lite 1.0.
Utilisation
ifFrameLoaded([scene,] frame) {
statement(s);
}
Opérandes
scene Chaîne facultative qui spécifie le nom de la séquence à charger.
11
bloc Numéro ou étiquette d'image à charger avant l'exécution de l'instruction suivante.
statement(s) Instructions d'exécution si l'image spécifiée ou la séquence et l'image sont chargées.
Description
Fonction : vérifie si le contenu d'une image spécifique est disponible localement. Utilisez la fonction
ifFrameLoaded
pour commencer à lire une animation simple pendant le téléchargement du reste du fichier SWF sur l'ordinateur local.
Vous pouvez également utiliser la propriété
fichier SWF externe. La différence d'utilisation entre les fonctions
fait que
_framesloaded, vous permet d'ajouter des instructions if ou else personnalisées.
_framesloaded, pour contrôler la progression du téléchargement d'un
_framesloaded, et ifFrameLoaded réside dans le
Exemple
L'exemple suivant utilise la fonction
est chargée, la commande
trace() affiche le message « frame number 10 is loaded » dans le panneau Sortie. La
variable de sortie est également définie avec une variable
ifFrameLoaded(10) {
trace ("frame number 10 is loaded");
output = "frame loaded: 10";
}
ifFrameLoaded pour vérifier si l'image 10 du fichier SWF est chargée. Si l'image
frame loaded: 10.
Voir aussi
_framesloaded,
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
int()
Disponibilité
Flash Lite 1.0.
Utilisation
int(value)
Opérandes
valeur Nombre ou chaîne à tronquer pour en faire un entier.
Description
Fonction ; tronque un nombre décimal pour en faire un entier.
Exemple
L'exemple suivant tronque les nombres dans les variables
Fonction de la chaîne ; renvoie le nombre de caractères de la chaîne ou variable spécifiée.
Exemple
L'exemple suivant renvoie la longueur de la chaîne «
length("Hello");
Le résultat est 5.
Hello » :
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
L'exemple suivant valide une adresse de messagerie en vérifiant qu'elle contient au moins six caractères :
email = "someone@example.com";
if (length(email) > 6) {
//trace ("email appears to have enough characters to be valid");
}
loadMovie()
Disponibilité
Flash Lite 1,1.
Utilisation
loadMovie(url, target [, method])
Opérandes
url Chaîne qui spécifie l'URL absolue ou relative du fichier SWF à charger. Un chemin relatif doit être relatif au
fichier SWF au niveau 0. Les URL absolues doivent inclure la référence de protocole, telle que http:// ou file:///.
13
target Référence à un clip ou une chaîne représentant le chemin d'un clip cible. Le clip cible est remplacé par le
fichier SWF chargé.
method Paramètre de chaîne facultatif qui spécifie une méthode HTTP d'envoi des variables. Ce paramètre doit
correspondre à la chaîne
ajoute les variables à la fin de l'URL et est utilisée lorsque les variables sont peu nombreuses. La méthode
GET ou POST. En l'absence de variable à envoyer, omettez ce paramètre. La méthode GET
POST place
les variables dans un en-tête HTTP distinct et est utilisée pour des variables longues de type chaîne.
Description
Fonction ; charge un fichier SWF dans Flash Lite pendant la lecture du fichier SWF d'origine.
Pour charger un fichier SWF à un niveau spécifique, utilisez la fonction
loadMovieNum() à la place de loadMovie().
Lorsqu'un fichier SWF est chargé dans un clip cible, vous pouvez utiliser le chemin cible de ce clip pour cibler le fichier
SWF chargé. Un fichier SWF chargé dans une cible hérite des propriétés de position, de rotation et d'échelle du clip
ciblé. Le coin supérieur gauche de l'image chargée ou du fichier SWF s'aligne sur le point de référence du clip ciblé.
Toutefois, lorsque la cible correspond au scénario racine, le coin supérieur gauche de l'image ou du fichier SWF s'aligne
sur le coin supérieur gauche de la scène.
Utilisez la fonction
unloadMovie() pour supprimer les fichiers SWF chargés avec loadMovie().
Exemple
L'exemple suivant charge le fichier SWF circle.swf à partir du même répertoire et remplace un clip intitulé
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
loadMovieNum()
Disponibilité
Flash Lite 1,1.
Utilisation
loadMovieNum(url, level [, method])
Opérandes
url Chaîne qui spécifie l'URL absolue ou relative du fichier SWF à charger. Un chemin relatif doit être relatif par
rapport au fichier SWF au niveau 0. Pour l'utilisation avec une version autonome du lecteur Flash Lite ou en mode test
dans l'application de programmation Flash, tous les fichiers SWF doivent être stockés dans le même dossier et les noms
de fichiers ne doivent pas inclure de spécifications de dossier ou de lecteur de disque.
level Entier qui spécifie le niveau de chargement du fichier SWF dans Flash Lite.
method Paramètre de chaîne facultatif qui spécifie une méthode HTTP d'envoi des variables. Il doit posséder la valeur
GET ou POST. En l'absence de variable à envoyer, omettez ce paramètre. La méthode GET ajoute les variables à la fin de
l'URL et est utilisée lorsque les variables sont peu nombreuses. La méthode
HTTP distinct et est utilisée pour des variables longues de type chaîne.
POST place les variables dans un en-tête
14
Description
Fonction ; charge un fichier SWF dans l'un des niveaux de Flash Lite pendant la lecture du fichier SWF.
Normalement, Flash Lite affiche un fichier SWF, puis se ferme. La fonction
loadMovieNum() permet d'afficher
plusieurs fichiers SWF à la fois et de basculer vers l'un de ces derniers sans avoir à charger un autre document HTML.
Pour spécifier une cible au lieu d'un niveau, utilisez la fonction
loadMovie() à la place de loadMovieNum().
Flash Lite empile les différents niveaux en commençant par le niveau 0. Ces niveaux sont comme des feuilles de papier
calque empilées les unes sur les autres , ils sont transparents à l'exception des objets placés à chaque niveau. Lorsque
vous utilisez
Lorsqu'un fichier SWF est chargé dans un niveau, utilisez la syntaxe
loadMovieNum(), vous devez spécifier le niveau de Flash Lite devant recevoir le fichier SWF à charger.
_levelN, où N correspond au numéro du niveau
cible.
Lorsque vous chargez un fichier SWF, vous pouvez spécifier n'importe quel numéro de niveau. Vous pouvez charger
un fichier SWF dans un niveau qui en contient déjà un ; le nouveau fichier SWF remplacera le fichier existant. Si vous
chargez un fichier SWF dans le niveau 0, tous les autres niveaux de Flash Lite sont vidés et le niveau 0 utilise le nouveau
fichier. Le fichier SWF du niveau 0 définit la cadence d'images, la couleur d'arrière-plan et la taille d'image de tous les
autres fichiers SWF chargés.
La fonction
unloadMovieNum() permet de supprimer les fichiers SWF chargés avec loadMovieNum().
Exemple
L'exemple suivant charge le fichier SWF dans le niveau 2 :
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
loadVariables()
Disponibilité
Flash Lite 1,1.
Utilisation
loadVariables(url, target [, variables])
Opérandes
url Chaîne représentant une URL absolue ou relative par rapport à l'emplacement des variables. Si le fichier SWF
effectuant cet appel s'exécute dans un navigateur Web, url doit appartenir au même domaine que le fichier SWF.
target Chemin cible d'un clip devant recevoir les variables chargées.
variables Paramètre de chaîne facultatif qui spécifie une méthode HTTP d'envoi des variables. Ce paramètre doit
correspondre à la chaîne
ajoute les variables à la fin de l'URL et est utilisée lorsque les variables sont peu nombreuses. La méthode
les variables dans un en-tête HTTP distinct et est utilisée pour des variables longues de type chaîne.
Description
Fonction ; lit les données dans un fichier externe, tel qu'un fichier texte ou du texte généré par un script ColdFusion,
CGI, ASP, PHP ou Perl, et définit les valeurs pour les variables dans un clip cible. Cette fonction permet également de
mettre à jour les variables du fichier SWF actif en fonction des nouvelles valeurs.
GET ou POST. En l'absence de variable à envoyer, omettez ce paramètre. La méthode GET
POST place
15
Le texte de l'URL spécifiée doit être au format MIME standard application/x-www-form-urlencoded (un format
standard utilisé par les scripts CGI). Vous pouvez spécifier autant de variables que nécessaire. Par exemple, cette
séquence définit plusieurs variables :
Pour charger des variables dans un niveau spécifique, utilisez la fonction loadVariablesNum() à la place de
loadVariables().
Exemple
Les exemples suivants chargent des variables à partir d'un fichier texte et d'un serveur :
// load variables from text file on local file system (Symbian Series 60)
on(release, keyPress "1") {
filePath = "file://c:/documents/flash/myApp/myvariables.txt";
loadVariables(filePath, _root);
}
// load variables (from server) into a movieclip
urlPath = "http://www.someserver.com/myvariables.txt";
loadVariables(urlPath, "myClip_mc");
Voir aussi
loadMovieNum(), loadVariablesNum(), unloadMovie()
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
loadVariablesNum()
Disponibilité
Flash Lite 1,1.
Utilisation
loadVariablesNum(url, level [, variables])
Opérandes
url Chaîne représentant une URL absolue ou relative par rapport à l'emplacement des variables à charger. Si le fichier
SWF qui émet cet appel s'exécute sur un navigateur Web, l'url doit appartenir au même domaine que le fichier SWF.
Pour plus d'informations, consultez la section Description suivante.
level Entier qui spécifie le niveau de Flash Lite devant recevoir les variables.
variables Paramètre de chaîne facultatif qui spécifie une méthode HTTP d'envoi des variables. Ce paramètre doit
correspondre à la chaîne
ajoute les variables à la fin de l'URL et est utilisée lorsque les variables sont peu nombreuses. La méthode
les variables dans un en-tête HTTP distinct et est utilisée pour des variables longues de type chaîne.
GET ou POST. En l'absence de variable à envoyer, omettez ce paramètre. La méthode GET
POST place
16
Description
Fonction ; lit les données dans un fichier externe, tel qu'un fichier texte ou du texte généré par un script ColdFusion,
CGI ASP, PHP ou Perl, et définit les valeurs pour les variables dans un niveau de Flash Lite. Cette fonction permet
également de mettre à jour les variables du fichier SWF actif en fonction des nouvelles valeurs.
Le texte de l'URL spécifiée doit être au format MIME standard application/x-www-form-urlencoded (un format
standard utilisé par les scripts CGI). Vous pouvez spécifier autant de variables que nécessaire. L'exemple de phrase
suivant définit plusieurs variables :
Normalement, Flash Lite affiche un fichier SWF, puis se ferme. La fonction loadVariablesNum() permet d'afficher
plusieurs fichiers SWF à la fois et de basculer vers l'un de ces derniers sans avoir à charger un autre document HTML.
Pour charger des variables dans un clip cible, utilisez la fonction
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
on()
Disponibilité
Flash Lite 1.0.
Utilisation
on(event) {
// statement(s)
}
Opérandes
statement(s)Instructions à exécuter lorsqu'un événement event se produit.
event Ce déclencheur est appelé par un événement event. Lorsqu'un événement utilisateur se produit, les instructions
qui le suivent entre accolades (
paramètre event :
• press L'utilisateur appuie sur le bouton pendant que le pointeur de la souris survole le bouton.
• release L'utilisateur relâche le bouton pendant que le pointeur de la souris le survole.
• rollOutLe pointeur quitte la zone du bouton.
• rollOver Le pointeur de la souris survole le bouton.
• keyPress "key" L'utilisateur appuie sur la touche spécifiée. Pour la section « key » du paramètre, spécifiez un code
ou une constante de touche.
{}) s'exécutent. Vous pouvez spécifier n'importe laquelle des valeurs suivantes pour le
21
Description
Gestionnaire d'événements ; spécifie l'événement de type utilisateur ou pression de touche qui déclenche une fonction.
Certains événements ne sont pas pris en charge.
Exemple
Le code suivant, qui fait défiler le champ
par rapport à
on (keyPress "8") {
if (myText.scroll < myText.maxscroll) {
myText.scroll++;
}
}
maxscroll avant de faire défiler :
myText d'une ligne vers le bas lorsque l'utilisateur appuie sur la touche 8, teste
ord()
Disponibilité
Flash Lite 1.0.
Utilisation
ord(character)
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
Opérandes
character Caractère à convertir en numéro de code ASCII.
Description
Fonction de la chaîne ; convertit les caractères en numéros de code ASCII.
Exemple
L'exemple suivant utilise la fonction
trace ("multibyte number = " add ord("A"));// Output: multibyte number = 65
ord() pour afficher le code ASCII du caractère A :
play()
Disponibilité
Flash Lite 1.0.
Utilisation
play()
22
Opérandes
Aucun.
Description
Fonction ; fait avancer la tête de lecture au sein du scénario.
Exemple
L'exemple suivant utilise une instruction
Steve, la fonction play() est appelée et la tête de lecture avance au sein du scénario. Si l'utilisateur saisit un élément
autre que
stop();
if (name == "Steve") {
play();
} else {
alert="You are not Steve!";
}
Steve, le fichier SWF n'est pas lu et un champ texte contenant le nom de variable alert apparaît.
if pour vérifier la valeur d'un nom saisi par l'utilisateur. Si l'utilisateur saisit
prevFrame()
Disponibilité
Flash Lite 1.0.
Utilisation
prevFrame()
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
Opérandes
Aucun.
Description
Fonction ; place la tête de lecture sur l'image précédente et l'arrête. Si l'image active est l'image 1, la tête de lecture ne
bouge pas.
Exemple
Lorsque l'utilisateur clique sur un bouton auquel est associé le gestionnaire suivant, la tête de lecture est positionnée
sur l'image précédente :
on(release) {
prevFrame();
}
Voir aussi
nextFrame()
23
prevScene()
Disponibilité
Flash Lite 1.0.
Utilisation
prevScene()
Opérandes
Aucun.
Description
Fonction ; place la tête de lecture sur l'image 1 de la séquence précédente et l'arrête.
Exemple
Dans cet exemple, lorsque l'utilisateur clique sur un bouton auquel est associé le gestionnaire suivant, la tête de lecture
est positionnée sur la séquence précédente :
on(release) {
prevScene();
}
Voir aussi
nextScene()
GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 1.X
Fonctions globales de Flash Lite
random()
Disponibilité
Flash Lite 1.0.
Utilisation
random(value)
Opérandes
valeur Entier.
Description
Fonction ; renvoie un entier aléatoire compris entre 0 et un entier inférieur au nombre spécifié dans le paramètre value.
Exemple
Les exemples suivants génèrent un nombre en fonction d'un entier spécifiant la plage :
//pick random number between 0 and 5
myNumber = random(5);
trace (myNumber);// Output: could be 0,1,2,3,4
//pick random number between 5 and 10
myNumber = random(5) + 5;
trace (myNumber);// Output: could be 5,6,7,8,9
24
Les exemples suivants génèrent un nombre, puis le concatènent à la fin d'une chaîne en cours d'évaluation sous forme
de nom de variable. L'exemple suivant montre comment utiliser la syntaxe Flash Lite 1.1 pour simuler des tableaux.
// select random name from list
myNames1 = "Mike";
myNames2 = "Debbie";
myNames3 = "Logan";
ran = random(3) + 1;
ranName = "myNames" add ran;
trace (eval(ranName));// Output: will be mike, debbie, or logan
removeMovieClip()
Disponibilité
Flash Lite 1.0.
Utilisation
removeMovieClip(target)
Opérandes
target Chemin cible d'une occurrence de clip créée à l'aide de duplicateMovieClip().
Loading...
+ 97 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.