ADOBE Flash 8 User Manual [fr]

Guide de référence du langage ActionScript Flash Lite 1.x

Marques de commerce

1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central, ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite, FlashPaper, Flash Video Endocer, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit, Studio MX, UltraDev et WebHelp sont des marques de commerce ou des marques déposées de Macromedia, Inc. qui peuvent être déposées aux Etats-Unis et/ou dans d’autres juridictions ou pays. Les autres noms de produits, logos, graphiques, mises en page, titres, mots ou expressions mentionnés dans cette publication peuvent être des marques de commerce, des marques de service ou des noms de marque appartenant à Macromedia, Inc. ou à d’autres entités et peuvent être déposés dans certaines juridictions ou pays.

Informations au sujet des parties tierces

Ce guide contient des liens vers des sites Web qui ne sont pas sous le contrôle de Macromedia, qui n’est donc aucunement responsable de leur contenu. Si vous accédez à un site Web tiers mentionné dans ce guide, vous le faites à vos propres risques. Macromedia fournit ces liens à des fins pratiques et l’inclusion de ces liens n’implique pas que Macromedia parraine ou accepte la moindre responsabilité pour le contenu de ces sites Web tiers.

Technologie de compression et décompression audio discours utilisée sous licence de Nellymoser, Inc. (www.nellymoser.com).

Technologie de compression et décompression vidéo Sorenson™ Spark™ utilisée sous licence de Sorenson Media, Inc.

Visual SourceSafe est une marque commerciale ou une marque déposée de Microsoft Corporation aux Etats-Unis et/ou dans d’autres pays.

Copyright © 2005 Macromedia, Inc. Tous droits réservés. La copie, photocopie, reproduction, traduction ou conversion de ce manuel, sous quelque forme que ce soit, mécanique ou électronique, est interdite sans une autorisation préalable écrite de Macromedia, Inc. Le propriétaire ou l’utilisateur autorisé d’une copie valide du logiciel qu’accompagne ce manuel peut néanmoins imprimer une copie de ce dernier à partir d’une version électronique afin d’apprendre à utiliser le logiciel, à condition qu’aucune partie de ce manuel ne soit imprimée, reproduite, distribuée, revendue ou cédée dans un autre but, y compris, mais sans limitation aucune, dans un but commercial, tel que la revente de copies de cette documentation ou l’offre de services de maintenance rémunérés.

Remerciements

Gestion du projet : Mary Leigh Burke

Rédaction : Guy Haas, Denise Green, Mike Krisher

Rédactrice en chef : Rosana Francescato

Révision : Linda Adler, Geta Carlson, Evelyn Eldridge

Gestion de la production : Patrice O’Neill, Kristin Conradi, Yuko Yagi

Conception et production : Adam Barnett, Aaron Begley, Paul Benkman. John Francis, Geeta Karmarkar, Masayo Noda, Paul Rangel, Arena Reed, Mario Reynoso

Remerciements particuliers à Lisa Friendly, Bonnie Loo, Erick Vera, Florian de Joannès, les testeurs bêta ainsi qu’à toute l’équipe d’ingénierie et d’assurance qualité Flash Lite.

Première édition : Septembre 2005

Macromedia, Inc. 601 Townsend St. San Francisco, CA 94103, Etats-Unis

Table des matières

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Exemple d’entrée utilisée pour la plupart des éléments

ActionScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Dossier Exemples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Conventions typographiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapitre 1 : Fonctions globales de Flash Lite . . . . . . . . . . . . . . . . .11

call() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

chr() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

duplicateMovieClip() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

eval () . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

getProperty() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

getTimer() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

getURL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

gotoAndPlay() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

gotoAndStop() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

ifFrameLoaded() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

int() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

length() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

loadMovie() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

loadMovieNum() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

loadVariables() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

loadVariablesNum() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

mbchr() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

mblength() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

mbord() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

mbsubstring() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

nextFrame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

nextScene() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Number() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

on() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

ord() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

play() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

prevFrame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

prevScene() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

random() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

removeMovieClip() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

set() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

setProperty() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

stop() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

stopAllSounds() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

String() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

substring() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

tellTarget() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

toggleHighQuality() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

trace() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

unloadMovie() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

unloadMovieNum() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Chapitre 2 : Propriétés de Flash Lite . . . . . . . . . . . . . . . . . . . . . . . 51

/ (barre de fraction) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

_alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

_currentframe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

_focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

_framesloaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

_height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

_highquality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

_level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

maxscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

_rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

_target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

_totalframes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

_visible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

_width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

_x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

_xscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

_y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

_yscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Chapitre 3 : Instructions de Flash Lite . . . . . . . . . . . . . . . . . . . . . .67

break . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

continue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

do..while . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

else . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

else if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

for . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

4 Table des matières

switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

while . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78

Chapitre 4 : Opérateurs de Flash Lite . . . . . . . . . . . . . . . . . . . . . . 81

add (concaténation de chaîne) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

+= (affectation d’addition) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

and . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

= (affectation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87

/* (bloc de commentaires) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

, (virgule) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

// (commentaire) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

?: (conditionnel) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

–– (décrément) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

/ (division) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

/= (affectation de division) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

. (point) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

++ (incrément) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

&& (AND logique) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

! (NOT logique) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

|| (OR logique) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97

% (modulo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

%= (affectation modulo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

*= (affectation de multiplication) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

* (produit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

+ (addition numérique) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

== (égalité numérique) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

> (numérique supérieur à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102

>= (numérique supérieur ou égal à) . . . . . . . . . . . . . . . . . . . . . . . . . . .103

<> (inégalité numérique) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103

< (numérique inférieur à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104

<= (numérique inférieur ou égal à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

() (parenthèses) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

" " (séparateur de chaîne) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

eq (égalité de chaîne) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

gt (chaîne supérieure à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

ge (chaîne supérieure ou égale à) . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

ne (inégalité de chaîne) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

lt (chaîne inférieure à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

le (chaîne inférieure ou égale à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

– (soustraction) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

-= (affectation de soustraction) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Table des matières 5

Chapitre 5 : Eléments de langage spécifiques de Flash Lite . . . 115

Fonctionnalités. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118

fscommand() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

fscommand2() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

6 Table des matières

Introduction

Ce manuel décrit la syntaxe et le rôle des éléments ActionScript utilisés pour développer des applications pour Flash Lite 1.0 et Flash Lite 1.1, communément appelées Flash Lite 1.x. ActionScript de Flash Lite 1.x est basé sur la version d’ActionScript utilisée dans Flash 4. Pour utiliser les exemples de ce manuel dans un script, copiez le code et collez-le dans la fenêtre de script ou dans un fichier de script externe. Ce manuel répertorie l’ensemble des éléments ActionScript : opérateurs, mots-clés, instructions, commandes, propriétés, fonctions, classes et méthodes.

Exemple d’entrée utilisée pour la plupart des éléments ActionScript

L’exemple d’entrée suivant illustre les conventions utilisées pour la plupart des éléments ActionScript.

Titre de l’entrée

Les entrées sont classées par ordre alphabétique dans un chapitre. L’ordre alphabétique ne tient pas compte des majuscules, des traits de soulignement de préfixe, et ainsi de suite.

Disponibilité

Sauf mention contraire, la section Disponibilité indique les versions de Flash Lite qui prennent en charge l’élément.

Utilisation

Cette section présente la syntaxe correcte d’utilisation des éléments ActionScript dans votre code. La partie obligatoire de la syntaxe est indiquée en police de code. Le code que vous devez fournir ainsi que les informations de type de données sont en italique. Les deuxpoints (:) qui précèdent toujours les informations de type de données permettent de différencier les types de données du code que vous devez fournir. Les crochets (

[]) indiquent

des paramètres facultatifs.

Opérandes

Cette section décrit les paramètres répertoriés dans la syntaxe.

Description

Cette section identifie le type d’élément (par exemple, opérateur, fonction ou autre) ainsi que les valeurs renvoyées par l’élément (le cas échéant), et décrit son utilisation.

Exemple

Cette section fournit un exemple de code illustrant l’utilisation de l’élément.

Voir aussi

Cette section répertorie les entrées connexes du dictionnaire ActionScript.

Dossier Exemples

Un ensemble de fichiers d’exemples se trouve dans le répertoire /Samples and Tutorials/ Samples/FlashLite/ du répertoire d’installation de Flash 8.

Les chemins d’accès types à ce dossier sont les suivants :

■ Windows : /Program Files/Macromedia/Flash 8/Samples et Tutorials/Samples/FlashLite/

■ Macintosh : DD/Applications/Macromedia/Flash 8/Samples et Tutorials/Samples/

FlashLite/

Le dossier FlashLite contient un ensemble de fichiers FLA correspondant à des projets Flash Lite complets contenant du code ActionScript.

8Introduction

Conventions typographiques

Ce manuel utilise les conventions typographiques suivantes :

■ La police en italique indique une valeur qui devrait être remplacée (par exemple, dans le

chemin d’un dossier).

■ La police de code indique le code ActionScript.

■ La police de code en italique identifie les paramètres ActionScript.

■ La police en gras indique une entrée que vous devez saisir exactement à l’identique.

■ Les guillemets doubles (" ") figurant dans les exemples de code indiquent des chaînes

délimitées. Les programmeurs peuvent néanmoins également utiliser des guillemets simples.

Conventions typographiques 9

10 Introduction

CHAPITRE 1

Fonctions globales de Flash Lite

Cette section décrit la syntaxe et le rôle des fonctions globales ActionScript de Macromedia Flash Lite 1.1. Elle inclut les fonctions suivantes.

Fonction Description

call()

chr()

duplicateMovieClip()

eval ()

getProperty()

getTimer()

getURL()

gotoAndPlay()

gotoAndStop()

ifFrameLoaded()

int()

length()

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

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

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

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

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

Renvoie le nombre de millisecondes qui se sont é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 sur une URL définie.

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.

Place la tête de lecture sur l’image spécifiée dans une séquence et l’arrête à ce niveau. Si aucune séquence n’est spécifiée, la tête de lecture passe à l’image de la séquence en cours.

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

Tronque un nombre décimal en une valeur entière.

Renvoie le nombre de caractères du nom de chaîne ou variable spécifié.

Fonction Description

loadMovie()

loadMovieNum()

loadVariables()

loadVariablesNum()

mbchr()

mblength()

mbord()

mbsubstring()

nextFrame()

nextScene()

Number()

on()

ord()

play()

prevFrame()

prevScene()

removeMovieClip()

set()

Charge un fichier SWF dans Flash Lite pendant la lecture du fichier SWF d’origine.

Charge un fichier SWF dans l’un des niveaux de Flash Lite 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 un script ColdFusion, CGI, des pages ASP CGI, PHP ou un script 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.

Lit les données dans un fichier externe, tel qu’un fichier texte ou du texte généré par un script ColdFusion, 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 Lite. Cette fonction permet également de mettre à jour les variables du fichier SWF actif en fonction des nouvelles valeurs.

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

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

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

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

Place la tête de lecture sur l’image suivante et l’arrête.

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

Convertit une expression en nombre et renvoie une valeur.

Spécifie l’événement de type utilisateur ou pression de touche devant déclencher un événement.

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

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

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.

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

Supprime le clip spécifié, initialement créé à l’aide de la méthode

duplicateMovieClip().

Associe une valeur à une variable.

12 Fonctions globales de Flash Lite

Fonction Description

setProperty()

stop()

stopAllSounds()

String()

substring()

tellTarget()

toggleHighQuality()

trace()

unloadMovie()

unloadMovieNum()

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

Arrête le fichier SWF en cours de lecture.

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

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

Extrait une partie d’une chaîne.

Applique les instructions spécifiées dans le paramètre statement(s) au scénario spécifié dans le paramètre target.

Active et désactive l’anti-aliasing dans Flash Lite. L’anti-aliasing adoucit les bords des objets mais ralentit la lecture du fichier SWF.

Evalue l’expression et affiche le résultat dans le panneau Sortie en mode test.

Supprime le clip qui a été chargé par l’intermédiaire de loadMovie(),

loadMovieNum() ou duplicateMovieClip() de Flash Lite.

Supprime le clip qui a été chargé par l’intermédiaire de loadMovie(),

loadMovieNum() ou duplicateMovieClip() d’un niveau de Flash Lite.

call()

Disponibilité

Flash Lite 1.0.

Utilisation

call(frame)

call(movieClipInstance:frame)

Opérandes

frame L’étiquette ou le numéro d’une image dans le scénario.

movieClipInstance Le nom d’occurrence d’un clip.

call() 13

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 avoir deux formes possibles :

■ La forme par défaut exécute le script sur l’image spécifiée dans le même scénario que celui

dans lequel a été exécutée la fonction call() sans positionner la tête de lecture sur celle-ci.

■ La forme d’occurrence de clip spécifiée exécute le script sur l’image spécifiée de

l’occurrence de clip sans positionner la tête de lecture sur celle-ci.

REMARQUE

La fonction call() fonctionne de façon synchronisée ; tout code ActionScript suivant une fonction call() ne s’exécute que lorsque l’intégralité du code ActionScript est terminée au niveau de l’image spécifiée.

Exemple

Les exemples suivants exécutent le script dans l’image myScript :

// exécution des fonctions de l’image ayant l’étiquette "myScript" thisFrame = "myScript"; trace ("Calling the script in frame: " add thisFrame);

// exécution des fonctions d’une autre image dans le même scénario call("myScript");

chr()

Disponibilité

Flash Lite 1.0.

Utilisation

chr(number)

Opérandes

number Un 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 :

myVar = chr(65); trace (myVar);// Sortie : A

14 Fonctions globales de Flash Lite

duplicateMovieClip()

Disponibilité

Flash Lite 1.0.

Utilisation

duplicateMovieClip(target, newname, depth)

Opérandes

target Le chemin cible du clip à dupliquer.

newname Un identificateur unique pour le clip dupliqué.

depth Un niveau de profondeur unique pour le clip dupliqué. Le niveau de profondeur

indique l’ordre d’empilement des clips dupliqués. Cet ordre d’empilement ressemble à 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 risquer d’écraser des clips existants figurant à des profondeurs déjà occupées.

Description

Fonction ; crée une occurrence de clip pendant la lecture du fichier SWF et renvoie une référence au clip dupliqué. 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 permet de supprimer une occurrence de clip créée avec duplicateMovieClip().

removeMovieClip()

Exemple

L’exemple suivant duplique un clip appelé originalClip pour créer un nouveau clip appelé

newClip à un niveau de profondeur de 10. La position x du nouveau clip est définie sur

100 pixels.

duplicateMovieClip("originalClip", "newClip", 10); setProperty("newClip", _x, 100);

duplicateMovieClip() 15

L’exemple suivant utilise la méthode duplicateMovieClip() dans une boucle for pour créer plusieurs nouveaux clips simultanément. Une variable d’indice permet de conserver une trace de la profondeur d’empilement maximale occupée. Tous les noms des clips dupliqués contiennent un suffixe numérique correspondant à leur profondeur d’empilement (

clip2, clip3).

for (i = 1; i <= 3; i++) {

newName = "clip" add i; duplicateMovieClip("originalClip", newName); }

Voir aussi

removeMovieClip()

clip1,

eval ()

Disponibilité

Flash Lite 1.0.

Utilisation

eval(expression)

Opérandes

expression Une 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 (non défini).

Vous pouvez utiliser la fonction eval() pour simuler des tableaux, ou définir et récupérer dynamiquement la valeur d’une variable.

16 Fonctions globales de Flash Lite

Exemple

L’exemple suivant utilise eval() pour déterminer la valeur de l’expression "piece" + x. Le résultat étant un nom de variable, piece3, eval() renvoie la valeur de la variable et l’associe à y :

piece3 = "dangerous"; x = 3; y = eval("piece" add x); trace(y);// Sortie : dangerous.

L’exemple suivant décrit la simulation d’un tableau :

name1 = "mike"; name2 = "debbie"; name3 = "logan"; for(i = 1; i <= 3; i++) {

trace (eval("name" add i));/// Sortie : mike, debbie, logan

}

getProperty()

Disponibilité

Flash Lite 1.0.

Utilisation

getProperty(my_mc, property)

Opérandes

my_mc Le nom d’occurrence d’un clip pour lequel la propriété est extraite.

property Une propriété d’un clip.

Description

Fonction ; renvoie la valeur de la propriété spécifiée pour le clip person_mc.

Exemple

L’exemple suivant récupère la coordonnée de l’axe horizontal (_x) pour le clip my_mc dans le scénario du clip racine :

xPos = getProperty("person_mc", _x); trace (xPos); // sortie : -75

Voir aussi

setProperty()

getProperty() 17

getTimer()

Disponibilité

Flash Lite 1.0.

Utilisation

getTimer()

Opérandes

Aucun.

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);// Sortie : nombre de millisecondes durant lesquelles

le clip a été lu

getURL()

Disponibilité

Flash Lite 1.0.

Utilisation

getURL(url [ , window [, "variables"]])

Opérandes

url L’URL permettant d’obtenir le document.

window Un paramètre facultatif spécifiant la fenêtre ou le cadre HTML dans lequel le

document doit se charger.

REMARQUE

Le paramètre window n’est pas spécifié pour les applications Flash Lite, car les navigateurs des téléphones cellulaires ne prennent pas en charge plusieurs fenêtres.

18 Fonctions globales de Flash Lite

Vous pouvez entrer une chaîne vide ou le nom d’une fenêtre spécifique, ou le sélectionner à partir 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 Une méthode GET ou POST permettant d’envoyer des variables. En l’absence de

variables, 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 POST place les variables dans un en-tête HTTP distinct et permet d’envoyer des variables longues de type chaîne.

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.monserveur.com), vous devez disposer d’une connexion réseau.

Flash Lite 1.0 reconnaît uniquement les protocoles HTTP, HTTPS, mailto et tel. Outre ces protocoles, Flash Lite 1.1 reconnaît également les protocoles de fichier ainsi que les protocoles SMS et MMS.

Flash Lite transmet l’appel au système d’exploitation qui le gère à l’aide de l’application par défaut enregistrée pour le protocole spécifié.

Une seule fonction

getURL() est traitée par image ou par gestionnaire d’événements.

Certains combinés limitent la fonction getURL() aux événements de touche uniquement, auquel cas l’appel getURL() n’est traité que s’il est déclenché dans un gestionnaire d’événements de touche. Même dans ces conditions, 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.macromedia.com dans le navigateur par défaut :

myURL = "http://mobile.macromedia.com"; on(keyPress "1") {

getURL(myURL);

}

getURL() 19

Vous pouvez également utiliser la méthode GET ou POST pour envoyer des variables du scénario actif. L’exemple suivant utilise la méthode GET pour ajouter des variables à une URL :

firstName = "Gus"; lastName = "Richardson"; age = 92; getURL("http://www.macromedia.com", "_blank", "GET");

Le code ActionScript suivant utilise la méthode POST pour placer les variables dans un en-tête HTTP :

firstName = "Gus"; lastName = "Richardson"; age = 92; getURL("http://www.macromedia.com", "POST");

Vous pouvez affecter une fonction de bouton permettant d’ouvrir une fenêtre de composition de message dont les champs de texte address, subject et body seraient déjà remplis. Pour affecter une fonction de bouton, utilisez l’une des méthodes suivantes : pour Shift-JIS ou le codage de caractères anglais, utilisez la méthode 1 ; la méthode 2 ne prend en charge que le codage de caractères anglais.

Méthode 1 : définissez des variables pour chacun des paramètres voulus, comme dans l’exemple suivant :

on (release, keyPress "#"){ subject = "email subject"; body = "email body"; getURL("mailto:somebody@anywhere.com", "", "GET"); }

Méthode 2 : définissez chaque paramètre dans la fonction getURL(), comme dans l’exemple suivant :

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 renvoie automatiquement un codage URL tandis que la méthode 2 préserve les espaces dans les chaînes. Par exemple, les chaînes résultant de l’utilisation de la méthode 1 ont l’aspect suivant :

email+subject email+body

Par opposition, la méthode 2 renvoie les chaînes suivantes :

email subject email body

20 Fonctions globales de Flash Lite

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 message SMS :

mySMS = "sms:4156095555?body=sample sms message"; on(keyPress "5") {

getURL(mySMS);

}

Dans l’exemple suivant, la fonction getURL() est utilisée pour envoyer un message MMS :

// exemple mms myMMS = "mms:4156095555?body=sample mms message"; on(keyPress "6") {

getURL(myMMS);

}

Dans l’exemple suivant, la fonction getURL() est utilisée pour ouvrir un fichier texte stocké dans le système de fichiers local :

// exemple de protocole de fichier filePath = "file://c:/documents/flash/myApp/myvariables.txt"; on(keyPress "7") {

getURL(filePath);

}

gotoAndPlay()

Disponibilité

Flash Lite 1.0.

Utilisation

gotoAndPlay([scene,] frame)

Opérandes

scene Une chaîne facultative qui spécifie le nom de la séquence cible de la tête de lecture.

frame Un nombre représentant le numéro d’image ou une chaîne représentant l’étiquette de

l’image cible de la tête de lecture.

gotoAndPlay() 21

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 autres objets du document.

Exemple

Dans l’exemple suivant, lorsque l’utilisateur clique sur un bouton auquel est affectée la fonction gotoAndPlay(), la tête de lecture se positionne sur l’image 16 de la séquence active et commence la lecture du fichier SWF :

on(keyPress "7") {

gotoAndPlay(16);

}

gotoAndStop()

Disponibilité

Flash 1.0.

Utilisation

gotoAndStop([scene,] frame)

Opérandes

scene Une chaîne facultative qui spécifie le nom de la séquence cible de la tête de lecture.

frame Un nombre représentant le numéro d’image ou une 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 sur une séquence et l’arrête à ce niveau. 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 autres objets du document.

22 Fonctions globales de Flash Lite

Exemple

Dans l’exemple suivant, lorsque l’utilisateur clique sur un bouton auquel est affectée la fonction gotoAndStop(), la tête de lecture se positionne sur l’image 5 de la séquence active 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 Une chaîne facultative qui spécifie le nom de la séquence à charger.

frame Le numéro ou l’étiquette d’image devant être chargé(e) avant l’exécution de

l’instruction suivante.

statement(s) Les instructions à exécuter en cas de chargement de la séquence, ou de la

séquence et de l’image, spécifiée(s).

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é externe. La différence d’utilisation entre les fonctions réside dans le fait que

_framesloaded pour vérifier la progression du téléchargement d’un fichier SWF

_framesloaded et ifFrameLoaded

_framesloaded vous permet d’ajouter des instructions if ou else

personnalisées.

ifFrameLoaded() 23

Exemple

L’exemple suivant utilise la fonction ifFrameLoaded pour vérifier si l’image 10 du fichier SWF est chargée. Si c’est le cas, la commande trace() imprime le texte « frame number 10 is loaded » dans le panneau Sortie. La variable de sortie est également définie avec le chargement d’une variable d’image : 10.

ifFrameLoaded(10) { trace ("frame number 10 is loaded"); output = "frame loaded: 10"; }

Voir aussi

_framesloaded

int()

Disponibilité

Flash Lite 1.0.

Utilisation

int(value)

Opérandes

value Un nombre ou une chaîne devant être tronqué en un entier.

Description

Fonction ; tronque un nombre décimal en valeur entière.

Exemple

L’exemple suivant tronque les nombres des variables distance et myDistance :

distance = 6.04 - 3.96; //trace ("distance = " add distance add " and rounded to:" add

int(distance)); // Sortie : distance = 2,08 et arrondie à : 2 myDistance = "3.8"; //trace ("myDistance = " add int(myDistance)); // Sortie : 3

24 Fonctions globales de Flash Lite

length()

Disponibilité

Flash Lite 1.0.

Utilisation

length(expression)

length(variable)

Opérandes

expression Une chaîne.

variable Le nom d’une variable.

Description

Fonction de la chaîne ; renvoie le nombre de caractères du nom de chaîne ou variable spécifié.

Exemple

L’exemple suivant renvoie la longueur de la chaîne « Hello » :

length("Hello");

Le résultat est 5.

L’exemple suivant valide une adresse de messagerie en vérifiant qu’elle contienne au moins six caractères :

email = "someone@macromedia.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 Une 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:///.

loadMovie() 25

target Une 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 Un paramètre de chaîne facultatif spécifiant la méthode HTTP à utiliser pour

l’envoi de variables. Ce paramètre doit correspondre à la chaîne 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 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 dans un niveau spécifique, utilisez la fonction

loadMovieNum()

plutôt que 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 de la position, des propriétés de rotation et d’échelle du clip ciblé. Le coin supérieur gauche de l’image ou du fichier SWF chargé s’aligne sur le point de référence du clip cible. Cependant, 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.

La fonction

loadMovie().

Exemple

unloadMovie() permet de supprimer les fichiers SWF chargés avec

L’exemple suivant charge le fichier SWF circle.swf à partir du même répertoire et remplace un clip intitulé mySquare qui existe déjà sur la scène :

loadMovie("circle.swf", "mySquare"); // Instruction équivalente : loadMovie("circle.swf", _level0.mySquare);

Voir aussi

_level, loadMovieNum(), unloadMovie(), unloadMovieNum()

26 Fonctions globales de Flash Lite

loadMovieNum()

Disponibilité

Flash Lite 1.1.

Utilisation

loadMovieNum(url, level [, method])

Opérandes

url Une chaîne qui spécifie l’URL absolue ou relative du fichier SWF à charger. Un chemin

relatif doit faire référence au fichier SWF du 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 fichier ne doivent pas inclure de spécifications de dossier ou lecteur.

level Un entier spécifiant le niveau de Flash Lite dans lequel le fichier SWF doit se charger.

method Un paramètre de chaîne facultatif spécifiant la méthode HTTP à utiliser pour

l’envoi de variables. La valeur de ce paramètre doit être 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 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 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 plutôt qu’un niveau, utilisez la fonction

loadMovieNum().

Flash Lite empile les différents niveaux en commençant par le niveau 0. Ces niveaux correspondent à 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

loadMovieNum(), vous devez spécifier le niveau de Flash Lite devant recevoir le fichier SWF à

charger. Lorsqu’un fichier SWF est chargé dans un niveau, utilisez la syntaxe correspond au numéro du niveau cible.

loadMovie() plutôt que

_levelN, où N

loadMovieNum() 27

Lorsque vous chargez un fichier SWF, vous pouvez spécifier le niveau de votre choix. Vous pouvez charger un fichier SWF dans un niveau qui comporte déjà un fichier de ce type, et le nouveau fichier SWF remplace 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 le débit 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 la suppression des fichiers SWF ou des images qui

ont été chargés avec loadMovieNum().

Exemple

L’exemple suivant charge le fichier SWF dans le niveau 2 :

loadMovieNum("http://www.someserver.com/flash/circle.swf", 2);

Voir aussi

_level, loadMovie(), unloadMovieNum()

loadVariables()

Disponibilité

Flash Lite 1.1.

Utilisation

loadVariables(url, target [, variables])

Opérandes

url Une 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 Le chemin cible d’un clip devant recevoir les variables chargées.

variables Un paramètre de chaîne facultatif spécifiant la méthode HTTP à utiliser pour

28 Fonctions globales de Flash Lite

Description

Fonction ; 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. 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. Par exemple, cette séquence définit plusieurs variables :

company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103

Pour charger des variables dans un niveau spécifique, utilisez la fonction

loadVariablesNum() plutôt que loadVariables().

Exemple

Les exemples suivants chargent des variables à partir d’un fichier texte et d’un serveur :

// chargement de variables à partir d’un fichier texte sur le système de

fichiers local (Symbian Series 60) on(release, keyPress "1") {

filePath = "file://c:/documents/flash/myApp/myvariables.txt";

loadVariables(filePath, _root); }

// charger des variables (à partir d’un serveur) dans un clip urlPath = "http://www.someserver.com/myvariables.txt"; loadVariables(urlPath, "myClip_mc");

Voir aussi

loadMovieNum(), loadVariablesNum(), unloadMovie()

loadVariables() 29

loadVariablesNum()

Disponibilité

Flash Lite 1.1.

Utilisation

loadVariablesNum(url, level [, variables])

Opérandes

url Une chaîne représentant une URL absolue ou relative par rapport à l’emplacement des

variables à charger. 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. Pour plus de détails, voir la section

Description.

level Un entier spécifiant le niveau de Flash Lite devant recevoir les variables.

variables Un paramètre de chaîne facultatif spécifiant la méthode HTTP à utiliser pour

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, des pages ASP (Active Server Pages), PHP ou un script 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. La séquence suivante définit plusieurs variables :

company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103

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, préférez la fonction fonction loadVariablesNum().

loadVariables() à la

Voir aussi

getURL(), loadMovie(), loadMovieNum(), loadVariables()

30 Fonctions globales de Flash Lite

+ 138 hidden pages