Docstoc

DictionnaireActionScript

Document Sample
DictionnaireActionScript Powered By Docstoc
					Dictionnaire ActionScript




                             ™


                    macromedia
                             ®
Marques
Afterburner, AppletAce, Attain, Attain Enterprise Learning System, Attain Essentials, Attain Objects for Dreamweaver,
Authorware, Authorware Attain, Authorware Interactive Studio, Authorware Star, Authorware Synergy, Backstage, Backstage
Designer, Backstage Desktop Studio, Backstage Enterprise Studio, Backstage Internet Studio, Design in Motion, Director,
Director Multimedia Studio, Doc Around the Clock, Dreamweaver, Dreamweaver Attain, Drumbeat, Drumbeat 2000, Extreme
3D, Fireworks, Flash, Fontographer, FreeHand, FreeHand Graphics Studio, Generator, Generator Developer's Studio,
Generator Dynamic Graphics Server, Knowledge Objects, Knowledge Stream, Knowledge Track, Lingo, Live Effects,
Macromedia, le logoe « M » de Macromedia, Macromedia Flash, Macromedia Xres, Macromind, Macromind Action, MAGIC,
Mediamaker, Object Authoring, Power Applets, Priority Access, Roundtrip HTML, Scriptlets, SoundEdit, ShockRave,
Shockmachine, Shockwave, Shockwave Remote, Shockwave Internet Studio, Showcase, Tools to Power Your Ideas, Universal
Media, Virtuoso, Web Design 101, Whirlwind et Xtra sont des marques de Macromedia, Inc. et peuvent être déposées aux Etats-
Unis et dans d’autres pays. Les autres noms de produits, logos, graphiques, mises en page, titres, mots ou phrases mentionnés
dans cette publication peuvent être des marques, des marques de service ou des noms de marque appartenant à Macromedia, Inc.
ou à d’autres entités et peuvent être déposés dans certains pays, états ou provinces.

Autres marques mentionnées
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.


Ce guide contient des liens conduisant à des sites web qui ne sont pas sous le contrôle de Macromedia, qui n’est aucunement
responsable de leur contenu. L’accès à ces sites se fait sous votre seule responsabilité. Macromedia mentionne ces liens pour
référence, ce qui n’implique pas son soutien, accord ou responsabilité quant au contenu des sites.

Limite de garantie et de responsabilité Apple
Apple computer, inc. n’offre aucune garantie, exprès ou implicite, concernant ce logiciel, sa capacité à être commercialisé ou à
répondre à un besoin particulier. L’exclusion des garanties implicites est interdite par certains pays, états ou provinces.
L’exclusion énoncée ci-dessus peut ne pas s’appliquer à votre cas particulier. Cette garantie vous assure des droits spécifiques.
D’autres droits variant d’un pays à l’autre peuvent également vous être accordés.

Copyright © 2002 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 obtenue
par écrit auprès de Macromedia, Inc.

Remerciements
Directeur : Erick Vera
Producteur : Wayne Wieseler
Rédaction : Jody Bleyle, JuLee Burdekin, Mary Burger, Dale Crawford, Marcelle Taylor
Matériaux pédagogiques : Stephanie Gowin, Barbara Nelson
Révision : Rosana Francescato, Lisa Stanziano, Anne Szabla
Conception et production multimédia : Aaron Begley, Benjamin Salles, Noah Zilberberg
Conception et production des matériaux imprimés : Chris Basmajian, Caroline Branch
Version française : Juliette Chochon-Davis, Florian de Joannès, Michael Dominguez, Cristina Guembe, Sabine Hathaway,
Yoshika Hedberg, Tim Hussey, Gwenhaël Jacq, Masayo « Noppe » Noda, Simone Pux, Yoko Shindo, Yuko Yagi

Première édition : mars 2002

Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103 Etats-Unis
                    TABLE DES MATIERES



Exemple d’entrée pour la plupart des éléments ActionScript . . . . . . . . . . . . . . . . . . . . . 22
Exemple d’entrée pour les objets et composants. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Contenu du dictionnaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
–– (décrémentation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
++ (incrémentation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
! (NOT logique) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
!= (inégalité) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
!== (inégalité stricte) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
% (modulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
%= (affectation de modulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
& (AND au niveau du bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
&& (AND court-circuit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
&= (affectation AND au niveau du bit). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
() (parenthèses) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
– (moins). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
* (multiplication) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
*= (affectation de multiplication). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
, (virgule). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
. (point). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
?: (conditionnel) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
/ (division). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
// (délimiteur de commentaires) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
/* (délimiteur de commentaires) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
/= (affectation de division). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
[] (accès tableau) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
^ (XOR au niveau du bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
^= (affectation XOR au niveau du bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
{} (initialisateur d’objet). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
| (OR au niveau du bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
|| (OR logique) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
|= (affectation OR au niveau du bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
~ (NOT au niveau du bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
+ (addition) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
+= (affectation d’addition). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
< (inférieur à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
<< (décalage gauche au niveau du bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
<<= (décalage gauche au niveau du bit et affectation) . . . . . . . . . . . . . . . . . . . . . . . . . . 68
<= (inférieur ou égal à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68



                                                                                                                                  3
    <> (inégalité) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
    = (affectation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
    -= (affectation de soustraction) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
    == (égalité) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
    === (égalité stricte) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
    > (supérieur à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
    >= (supérieur ou égal à) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
    >> (décalage droit au niveau du bit). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
    >>= (décalage droit au niveau du bit et affectation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
    >>> (décalage droit non signé au niveau du bit). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
    >>>= (décalage droit non signé au niveau du bit et affectation) . . . . . . . . . . . . . . . . . . . 77
    Accessibility (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
    Accessibility.isActive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
    add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
    and . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
    arguments (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
    arguments.callee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
    arguments.caller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
    arguments.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
    Array (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
    Array.concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
    Array.join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
    Array.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
    Array.pop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
    Array.push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
    Array.reverse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
    Array.shift . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
    Array.slice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
    Array.sort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
    Array.sortOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
    Array.splice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
    Array.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
    Array.unshift . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
    asfunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
    Boolean (fonction) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
    Boolean (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
    Boolean.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
    Boolean.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
    break . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
    Button (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
    Evénements de l’objet Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
    Button._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
    Button.enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
    Button._focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
    Button.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
    Button._height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
    Button._highquality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
    Button._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
    Button.onDragOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
    Button.onDragOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99



4       Table des matières
Button.onKeyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Button.onKeyUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Button.onKillFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Button.onPress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Button.onRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Button.onReleaseOutside . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Button.onRollOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Button.onRollOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Button.onSetFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Button._parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Button._quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Button._rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Button._soundbuftime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Button.tabEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Button.tabIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Button._target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Button.trackAsMenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Button._url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Button.useHandCursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Button._visible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Button._width. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Button._x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Button._xmouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Button._xscale. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Button._y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Button._ymouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Button._yscale. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
call function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
chr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
clearInterval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Color (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Color.getRGB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Color.getTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Color.setRGB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Color.setTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
continue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
CustomActions (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
CustomActions.get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
CustomActions.install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
CustomActions.list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
CustomActions.uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Date (objet). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Date.getDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Date.getDay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Date.getFullYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Date.getHours. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Date.getMilliseconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Date.getMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126



                                                                                                Table des matières                 5
    Date.getMonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
    Date.getSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
    Date.getTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
    Date.getTimezoneOffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
    Date.getUTCDate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
    Date.getUTCDay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
    Date.getUTCFullYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
    Date.getUTCHours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
    Date.getUTCMilliseconds. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
    Date.getUTCMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
    Date.getUTCMonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
    Date.getUTCSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
    Date.getYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
    Date.setDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
    Date.setFullYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
    Date.setHours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
    Date.setMilliseconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
    Date.setMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
    Date.setMonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
    Date.setSeconds. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
    Date.setTime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
    Date.setUTCDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
    Date.setUTCFullYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
    Date.setUTCHours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
    Date.setUTCMilliseconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
    Date.setUTCMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
    Date.setUTCMonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
    Date.setUTCSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
    Date.setYear. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
    Date.toString. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
    Date.UTC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
    default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
    delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
    do while . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
    duplicateMovieClip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
    else . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
    else if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
    #endinitclip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
    eq (égal à – spécifique aux chaînes) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
    escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
    eval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
    evaluate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
    false . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
    FCheckBox (composant) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
    FCheckBox.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
    FCheckBox.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
    FCheckBox.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
    FCheckBox.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
    FCheckBox.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
    FCheckBox.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151



6       Table des matières
FCheckBox.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
FCheckBox.setLabelPlacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
FCheckBox.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
FCheckBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
FCheckBox.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
FComboBox (composant) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
FComboBox.addItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
FComboBox.addItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
FComboBox.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
FComboBox.getItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
FComboBox.getLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
FComboBox.getRowCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
FComboBox.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
FComboBox.getSelectedIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
FComboBox.getSelectedItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
FComboBox.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
FComboBox.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
FComboBox.removeAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
FComboBox.removeItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
FComboBox.replaceItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
FComboBox.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
FComboBox.setDataProvider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
FComboBox.setEditable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
FComboBox.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
FComboBox.setItemSymbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
FComboBox.setRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
FComboBox.setSelectedIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
FComboBox.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
FComboBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
FComboBox.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
FComboBox.sortItemsBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
FListBox (composant) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
FListBox.addItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
FListBox.addItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
FListBox.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
FListBox.getItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
FListBox.getLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
FListBox.getRowCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
FListBox.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
FListBox.getSelectedIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
FListBox.getSelectedIndices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
FListBox.getSelectedItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
FListBox.getSelectedItems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
FListBox.getSelectMultiple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
FListBox.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
FListBox.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
FListBox.removeAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
FListBox.removeItemAt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
FListBox.replaceItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
FListBox.setAutoHideScrollBar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184



                                                                                         Table des matières               7
    FListBox.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
    FListBox.setDataProvider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
    FListBox.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
    FListBox.setItemSymbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
    FListBox.setRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
    FListBox.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
    FListBox.setSelectedIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
    FListBox.setSelectedIndices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
    FListBox.setSelectMultiple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
    FListBox.setSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
    FListBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
    FListBox.setWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
    FListBox.sortItemsBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
    _focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
    for . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
    for..in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
    FPushButton (composant). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
    FPushButton.getEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
    FPushButton.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
    FPushButton.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
    FPushButton.setClickHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
    FPushButton.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
    FPushButton.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
    FPushButton.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
    FPushButton.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
    FRadioButton (composant) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
    FRadioButton.getData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
    FRadioButton.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
    FRadioButton.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
    FRadioButton.getState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
    FRadioButton.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
    FRadioButton.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
    FRadioButton.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
    FRadioButton.setData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
    FRadioButton.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
    FRadioButton.setGroupName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
    FRadioButton.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
    FRadioButton.setLabelPlacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
    FRadioButton.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
    FRadioButton.setState. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
    FRadioButton.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
    FRadioButton.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
    FScrollBar (composant) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
    FScrollBar.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
    FScrollBar.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
    FScrollBar.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
    FScrollBar.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
    FScrollBar.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
    FScrollBar.setHorizontal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
    FScrollBar.setLargeScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220



8       Table des matières
FScrollBar.setScrollContent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
FScrollBar.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
FScrollBar.setScrollProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
FScrollBar.setScrollTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
FScrollBar.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
FScrollBar.setSmallScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
FScrollBar.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
FScrollPane (composant) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
FScrollPane.getPaneHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
FScrollPane.getPaneWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
FScrollPane.getScrollContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
FScrollPane.getScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
FScrollPane.loadScrollContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
FScrollPane.refreshPane. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
FScrollPane.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
FScrollPane.setDragContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
FScrollPane.setHScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
FScrollPane.setScrollContent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
FScrollPane.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
FScrollPane.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
FScrollPane.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
FScrollPane.setVScroll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
FStyleFormat (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Propriétés de l’objet FStyleFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
FStyleFormat.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
FStyleFormat.applyChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
FStyleFormat.arrow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
FStyleFormat.background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
FStyleFormat.backgroundDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
FStyleFormat.check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
FStyleFormat.darkshadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
FStyleFormat.face . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
FStyleFormat.foregroundDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
FStyleFormat.highlight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
FStyleFormat.highlight3D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
FStyleFormat.radioDot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
FStyleFormat.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
FStyleFormat.scrollTrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
FStyleFormat.selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
FStyleFormat.selectionDisabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
FStyleFormat.selectionUnfocused . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
FStyleFormat.shadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
FStyleFormat.textAlign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
FStyleFormat.textBold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
FStyleFormat.textColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
FStyleFormat.textDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
FStyleFormat.textFont. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
FStyleFormat.textIndent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
FStyleFormat.textItalic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
FStyleFormat.textLeftMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250



                                                                                          Table des matières               9
     FStyleFormat.textRightMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
     FStyleFormat.textSelected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
     FStyleFormat.textSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
     FStyleFormat.textUnderline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
     Function (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
     Function.apply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
     Function.call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
     Function.prototype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
     fscommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
     function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
     ge (supérieur ou égal à – spécifique aux chaînes) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
     getProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
     getTimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
     getURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
     getVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
     _global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
     globalStyleFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
     gotoAndPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
     gotoAndStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
     gt (supérieur à — spécifique aux chaînes) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
     _highquality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
     if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
     ifFrameLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
     #include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
     #initclip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
     instanceof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
     int . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
     isFinite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
     isNaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
     Key (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
     Key.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
     Key.BACKSPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
     Key.CAPSLOCK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
     Key.CONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
     Key.DELETEKEY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
     Key.DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
     Key.END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
     Key.ENTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
     Key.ESCAPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
     Key.getAscii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
     Key.getCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
     Key.HOME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
     Key.INSERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
     Key.isDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
     Key.isToggled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
     Key.LEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
     Key.onKeyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
     Key.onKeyUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
     Key.PGDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
     Key.PGUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278



10       Table des matières
Key.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Key.RIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Key.SHIFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Key.SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Key.TAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Key.UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
le (inférieur ou égal à — spécifique aux chaînes) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
_level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
loadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
loadMovieNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
loadVariables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
loadVariablesNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
LoadVars (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
LoadVars.contentType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
LoadVars.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
LoadVars.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
LoadVars.load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
LoadVars.loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
LoadVars.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
LoadVars.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
LoadVars.sendAndLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
LoadVars.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
lt (inférieur à — spécifique aux chaînes) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Math (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Math.abs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Math.acos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Math.asin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Math.atan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Math.atan2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Math.ceil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Math.cos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Math.E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Math.exp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Math.floor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Math.log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Math.LOG2E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Math.LOG10E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Math.LN2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Math.LN10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Math.max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Math.min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Math.PI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Math.pow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Math.random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Math.round. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Math.sin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Math.sqrt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Math.SQRT1_2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Math.SQRT2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304



                                                                                               Table des matières                 11
     Math.tan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
     maxscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
     mbchr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
     mblength. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
     mbord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
     mbsubstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
     method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
     Mouse (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
     Mouse.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
     Mouse.hide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
     Mouse.onMouseDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
     Mouse.onMouseMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
     Mouse.onMouseUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
     Mouse.removeListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
     Mouse.show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
     MovieClip (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
     MovieClip._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
     MovieClip.attachMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
     MovieClip.beginFill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
     MovieClip.beginGradientFill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
     MovieClip.clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
     MovieClip.createEmptyMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
     MovieClip.createTextField. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
     MovieClip._currentframe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
     MovieClip.curveTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
     MovieClip._droptarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
     MovieClip.duplicateMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
     MovieClip.enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
     MovieClip.endFill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
     MovieClip.focusEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
     MovieClip._focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
     MovieClip._framesloaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
     MovieClip.getBounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
     MovieClip.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
     MovieClip.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
     MovieClip.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
     MovieClip.getURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
     MovieClip.globalToLocal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
     MovieClip.gotoAndPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
     MovieClip.gotoAndStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
     MovieClip._height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
     MovieClip._highquality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
     MovieClip.hitArea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
     MovieClip.hitTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
     MovieClip.lineStyle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
     MovieClip.lineTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
     MovieClip.loadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
     MovieClip.loadVariables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
     MovieClip.localToGlobal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
     MovieClip.moveTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337



12       Table des matières
MovieClip._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
MovieClip.nextFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
MovieClip.onData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
MovieClip.onDragOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
MovieClip.onDragOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
MovieClip.onEnterFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
MovieClip.onKeyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
MovieClip.onKeyUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
MovieClip.onKillFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
MovieClip.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
MovieClip.onMouseDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
MovieClip.onMouseMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
MovieClip.onMouseUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
MovieClip.onPress. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
MovieClip.onRelease. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
MovieClip.onReleaseOutside . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
MovieClip.onRollOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
MovieClip.onRollOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
MovieClip.onSetFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
MovieClip.onUnload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
MovieClip._parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
MovieClip.play . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
MovieClip.prevFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
MovieClip.removeMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
MovieClip._rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
MovieClip.setMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
MovieClip._soundbuftime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
MovieClip.startDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
MovieClip.stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
MovieClip.stopDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
MovieClip.swapDepths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
MovieClip.tabChildren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
MovieClip.tabEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
MovieClip.tabIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
MovieClip._target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
MovieClip._totalframes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
MovieClip.trackAsMenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
MovieClip.unloadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
MovieClip._url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
MovieClip.useHandCursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
MovieClip._visible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
MovieClip._width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
MovieClip._x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
MovieClip._xmouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
MovieClip._xscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
MovieClip._y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
MovieClip._ymouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
MovieClip._yscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
NaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
ne (pas égal à — spécifique aux chaînes) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360



                                                                                              Table des matières               13
     new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
     newline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
     nextFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
     nextScene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
     not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
     null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
     Number (fonction) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
     Number (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
     Number.MAX_VALUE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
     Number.MIN_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
     Number.NaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
     Number.NEGATIVE_INFINITY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
     Number.POSITIVE_INFINITY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
     Number.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
     Number.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
     Object (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
     Object.addProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
     Object.__proto__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
     Object.registerClass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
     Object.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
     Object.unwatch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
     Object.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
     Object.watch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
     onClipEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
     on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
     or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
     ord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
     _parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
     parseFloat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
     parseInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
     play . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
     prevFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
     prevScene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
     print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
     printAsBitmap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
     printAsBitmapNum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
     printNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
     _quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
     random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
     removeMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
     return . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
     _root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
     scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
     Selection (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
     Selection.addListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
     Selection.getBeginIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
     Selection.getCaretIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
     Selection.getEndIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
     Selection.getFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
     Selection.onSetFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393



14       Table des matières
Selection.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .               393
Selection.setFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .           394
Selection.setSelection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .            395
set variable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      395
setInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      396
setProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        397
Sound (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .          398
Sound.attachSound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .              400
Sound.duration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .           400
Sound.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                 400
Sound.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .              401
Sound.getPan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .           401
Sound.getTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .               402
Sound.getVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .              402
Sound.loadSound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .              402
Sound.onLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .            403
Sound.onSoundComplete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                    404
Sound.position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .           404
Sound.setPan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .          405
Sound.setTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .               406
Sound.setVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .              408
Sound.start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        408
Sound.stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .         409
_soundbuftime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .            409
Stage (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        410
Stage.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .            410
Stage.align . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      411
Stage.height. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        412
Stage.onResize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .         412
Stage.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .             412
Stage.scaleMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .            413
Stage.width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        413
startDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      413
stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   414
stopAllSounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .          414
stopDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       415
String (fonction) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .          416
" " (délimiteur de chaîne) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .               416
String (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       417
String.charAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        419
String.charCodeAt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .             419
String.concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        420
String.fromCharCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                420
String.indexOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .           420
String.lastIndexOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .           421
String.length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        421
String.slice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      422
String.split. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      422
String.substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        423
String.substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .         424



                                                                                                  Table des matières                  15
     String.toLowerCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
     String.toUpperCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
     substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
     super . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
     switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
     System (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
     System.capabilities (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
     System.capabilities.hasAudioEncoder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
     System.capabilities.hasAccessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
     System.capabilities.hasAudio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
     System.capabilities.hasMP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
     System.capabilities.language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
     System.capabilities.manufacturer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
     System.capabilities.os . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
     System.capabilities.pixelAspectRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
     System.capabilities.screenColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
     System.capabilities.screenDPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
     System.capabilities.screenResolution.x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
     System.capabilities.screenResolution.y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
     System.capabilities.version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
     System.capabilities.hasVideoEncoder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
     targetPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
     tellTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
     TextField (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
     TextField._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
     TextField.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
     TextField.autoSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
     TextField.background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
     TextField.backgroundColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
     TextField.border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
     TextField.borderColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
     TextField.bottomScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
     TextField.embedFonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
     TextField._focusrect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
     TextField.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
     TextField.getFontList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
     TextField.getNewTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
     TextField.getTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
     TextField._height. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
     TextField._highquality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
     TextField.hscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
     TextField.html. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
     TextField.htmlText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
     TextField.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
     TextField.maxChars. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
     TextField.maxhscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
     TextField.maxscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
     TextField.multiline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
     TextField._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
     TextField.onChanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447



16       Table des matières
TextField.onKillFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
TextField.onScroller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
TextField.onSetFocus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
TextField._parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
TextField.password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
TextField._quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
TextField.removeListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
TextField.removeTextField. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
TextField.replaceSel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
TextField.restrict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
TextField._rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
TextField.scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
TextField.selectable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
TextField.setNewTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
TextField.setTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
TextField._soundbuftime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
TextField.tabEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
TextField.tabIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
TextField._target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
TextField.text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
TextField.textColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
TextField.textHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
TextField.textWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
TextField.type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
TextField._url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
TextField.variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
TextField._visible. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
TextField._width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
TextField.wordWrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
TextField._x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
TextField._xmouse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
TextField._xscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
TextField._y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
TextField._ymouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
TextField._yscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
TextFormat (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
TextFormat.align . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
TextFormat.blockIndent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
TextFormat.bold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
TextFormat.bullet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
TextFormat.color. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
TextFormat.font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
TextFormat.getTextExtent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
TextFormat.indent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
TextFormat.italic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
TextFormat.leading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
TextFormat.leftMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
TextFormat.rightMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
TextFormat.size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
TextFormat.tabStops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468



                                                                                            Table des matières               17
     TextFormat.target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
     TextFormat.underline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
     TextFormat.url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
     this . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
     toggleHighQuality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
     trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
     true . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
     typeof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
     undefined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
     unescape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
     unloadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
     unloadMovieNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
     updateAfterEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
     var . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
     void . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
     while . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
     with. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
     XML (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
     XML.appendChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
     XML.attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
     XML.childNodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
     XML.cloneNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
     XML.contentType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
     XML.createElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
     XML.createTextNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
     XML.docTypeDecl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
     XML.firstChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
     XML.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
     XML.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
     XML.hasChildNodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
     XML.ignoreWhite. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
     XML.insertBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
     XML.lastChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
     XML.load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
     XML.loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
     XML.nextSibling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
     XML.nodeName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
     XML.nodeType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
     XML.nodeValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
     XML.onData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
     XML.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
     XML.parentNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
     XML.parseXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
     XML.previousSibling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
     XML.removeNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
     XML.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
     XML.sendAndLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
     XML.status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
     XML.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
     XML.xmlDecl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498



18       Table des matières
XMLSocket (objet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
XMLSocket.close. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
XMLSocket.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
XMLSocket.onClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
XMLSocket.onConnect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
XMLSocket.onData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
XMLSocket.onXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
XMLSocket.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505




                                                                                         Table des matières             19
20   Table des matières
                                           Dictionnaire ActionScript


Ce dictionnaire présente la syntaxe et l’usage des divers éléments ActionScript de Macromedia
Flash MX. Pour utiliser les exemples de scripts, il vous suffit de copier le texte de l’exemple dans le
système d’aide du dictionnaire ActionScript et de le coller dans le panneau Actions en mode
Expert.
Ce dictionnaire répertorie l’ensemble des éléments ActionScript (opérateurs, mots-clés,
instructions, actions, propriétés, fonctions, objets, composants et méthodes). Une vue d’ensemble
de toutes les entrées du dictionnaire apparaît sous Contenu du dictionnaire, page 24 ; les tableaux
de cette section sont un bon point de départ pour rechercher des méthodes ou opérateurs
symboles dont vous ne connaissez pas la classe d’objet ou de composant.
ActionScript respecte la norme ECMA-262 (spécification rédigée par l’association européenne
des fabricants de matériel informatique), sauf remarques contraires. Certains éléments
ActionScript de Flash 5 (et des versions précédentes) sont maintenant déconseillés et ont été
remplacés par de nouveaux éléments ActionScript répondant à la norme ECMA. Nous vous
recommandons d’utiliser ces nouveaux éléments Flash MX, même si les éléments déconseillés
sont encore supportés par Flash Player 6.
Ce dictionnaire contient deux types d’entrées différents :
• Des entrées individuelles pour les opérateurs, les mots-clés, les fonctions, les variables, les
  propriétés, les méthodes et les instructions.
• Des entrées pour les objets et composants, qui fournissent des informations d’ordre général sur
  les objets et composants intégrés de Flash.
Utilisez les informations contenues dans les entrées en exemple pour interpréter la structure et les
conventions utilisées dans ces deux types d’entrées.




                                                                                                    21
Exemple d’entrée pour la plupart des éléments ActionScript
     L’exemple d’entrée suivant illustre les conventions utilisées pour tous les éléments ActionScript
     qui ne sont pas des objets ou composants.

Titre de l’entrée
     Toutes les entrées sont classées par ordre alphabétique. L’ordre alphabétique ne tient pas compte
     des majuscules, des traits de soulignement de préfixe, et ainsi de suite.
     Disponibilité
     Cette section indique les versions de Flash Player qui supportent l’élément. Ceci est différent de la
     version de Flash utilisée pour développer le contenu. Par exemple, si vous utilisez l’outil de
     programmation Flash MX pour créer du contenu pour Flash Player 5, vous ne pouvez utiliser que
     les éléments ActionScript qui sont disponibles pour Flash Player 5.
     Usage
     Cette section présente la syntaxe correcte d’utilisation des éléments ActionScript dans votre code.
     La portion obligatoire de la syntaxe est indiquée avec la police de code et le code que vous
     devez fournir est en police italique. Les crochets ([]) indiquent des paramètres facultatifs.
     Paramètres
     Cette section décrit les paramètres répertoriés dans la syntaxe.
     Renvoie
     Cette section identifie les valeurs renvoyées par l’élément (le cas échéant).
     Description
     Cette section identifie le type d’élément (par exemple, comme opérateur, méthode, fonction ou
     autre) 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.




22
Exemple d’entrée pour les objets et composants
    L’exemple d’entrée suivant illustre les conventions utilisées pour les objets et composants
    ActionScript intégrés. Les objets et composants sont classés par ordre alphabétique avec tous les
    autres éléments du dictionnaire. Les composants Flash sont mentionnés sous la forme
    FCheckBox, FComboBox, etc.

Titre de l’entrée
    Le titre de l’entrée fournit le nom de l’objet ou du composant. Le nom de l’objet ou composant
    est suivi d’un paragraphe contenant les informations de description générales.

Tableaux récapitulatifs des méthodes et propriétés
    Chaque entrée d’objet et de composant contient un tableau répertoriant toutes les méthodes
    associées. Si l’objet ou composant possède des propriétés (souvent des constantes), ces éléments
    sont répertoriés dans un tableau supplémentaire. Toutes les méthodes et propriétés indiquées
    dans ces tableaux possèdent leurs propres entrées dans le dictionnaire, à la suite de l’entrée de
    l’objet ou du composant.

Constructeur
    Si un objet ou composant nécessite l’utilisation d’un constructeur pour accéder à ses méthodes et
    propriétés, le constructeur est décrit dans chaque entrée d’objet ou composant. Cette description
    contient tous les éléments standard (syntaxe, description, etc.) des autres entrées de dictionnaire.

Listes des méthodes et propriétés
    Les méthodes et propriétés d’un objet ou composant sont classées par ordre alphabétique après
    l’entrée de l’objet ou composant.




                                                                           Dictionnaire ActionScript   23
Contenu du dictionnaire
     Toutes les entrées du dictionnaire sont classées par ordre alphabétique. Cependant, certains
     opérateurs sont des symboles et sont classés dans l’ordre ASCII. De plus, les méthodes associées à
     un objet ou composant sont répertoriées avec le nom de l’objet ou composant (par exemple, la
     méthode abs de l’objet Math est répertoriée sous la forme Math.abs et la méthode getValue du
     composant FRadioButton est répertoriée sous la forme FRadioButton.getValue).
     Les deux tableaux suivants vous aideront à trouver ces éléments. Le premier tableau répertorie les
     opérateurs symboles dans leur ordre d’apparition dans le dictionnaire. Le second tableau
     répertorie tous les autres éléments ActionScript.
     Remarque L’ordre de priorité et l’associativité des opérateurs sont présentés dans l’annexe B, Priorité et
     associativité des opérateurs.

     Opérateurs symboles

     ––                                  –– (décrémentation)

     ++                                  ++ (incrémentation)

     !                                   ! (NOT logique)

     !=                                  != (inégalité)

     !==                                 !== (inégalité stricte)

     %                                   % (modulo)

     %=                                  %= (affectation de modulo)

     &                                   & (AND au niveau du bit)

     &&                                  && (AND court-circuit)

     &=                                  &= (affectation AND au niveau du bit)

     ()                                  () (parenthèses)

     –                                   – (moins)

     *                                   * (multiplication)

     *=                                  *= (affectation de multiplication)

     ,                                   , (virgule)

     .                                   . (point)

     ?:                                  ?: (conditionnel)

     /                                   / (division)

     //                                  // (délimiteur de commentaires)

     /*                                  /* (délimiteur de commentaires)

     /=                                  /= (affectation de division)

     []                                  [] (accès tableau)

     ^                                   ^ (XOR au niveau du bit)

     ^=                                  ^= (affectation XOR au niveau du bit)

     {}                                  {} (initialisateur d’objet)

     |                                   | (OR au niveau du bit)




24
Opérateurs symboles

||                             || (OR logique)

|=                             |= (affectation OR au niveau du bit)

~                              ~ (NOT au niveau du bit)

+                              + (addition)

+=                             += (affectation d’addition)

<                              < (inférieur à)

<<                             << (décalage gauche au niveau du bit)

<<=                            <<= (décalage gauche au niveau du bit et affectation)

<=                             <= (inférieur ou égal à)

<>                             <> (inégalité)

=                              = (affectation)

-=                             -= (affectation de soustraction)

==                             == (égalité)

===                            === (égalité stricte)

>                              > (supérieur à)

>=                             >= (supérieur ou égal à)

>>                             >> (décalage droit au niveau du bit)

>>=                            >>= (décalage droit au niveau du bit et affectation)

>>>                            >>> (décalage droit non signé au niveau du bit)

>>>=                           >>>= (décalage droit non signé au niveau du bit et
                               affectation)

Le tableau suivant répertorie tous les éléments ActionScript qui ne sont pas des opérateurs
symboles.

Elément ActionScript           Consultez l’entrée

abs                            Math.abs

acos                           Math.acos

add                            add

addItem                        FComboBox.addItem, FListBox.addItem

addItemAt                      FComboBox.addItemAt, FListBox.addItem

addListener                    FStyleFormat.addListener, Key.addListener,
                               Mouse.addListener, Selection.addListener, Stage.addListener,
                               TextField.addListener

addProperty                    Object.addProperty

and                            and

align                          Stage.align, TextFormat.align
_alpha                         MovieClip._alpha, Button._alpha, TextField._alpha

appendChild                    XML.appendChild




                                                                     Dictionnaire ActionScript   25
     Elément ActionScript   Consultez l’entrée

     apply                  Function.apply

     applyChanges           FStyleFormat.applyChanges

     Arguments              arguments (objet)

     Array                  Array (objet)

     arrow                  FStyleFormat.arrow

     asfunction             asfunction

     asin                   Math.asin

     atan                   Math.atan

     atan2                  Math.atan2

     attachMovie            MovieClip.attachMovie

     attachSound            Sound.attachSound

     attributes             XML.attributes

     autosize               TextField.autoSize

     background             FStyleFormat.background, TextField.background

     backgroundColor        TextField.backgroundColor

     backgroundDisabled     FStyleFormat.backgroundDisabled

     BACKSPACE              Key.BACKSPACE

     beginFill              MovieClip.beginFill

     beginGradientFill      MovieClip.beginGradientFill

     blockIndent            TextFormat.blockIndent

     bold                   TextFormat.bold

     Boolean                Boolean (fonction), Boolean (objet)

     border                 TextField.border

     borderColor            TextField.borderColor

     bottomScroll           TextField.bottomScroll

     break                  break

     bullet                 TextFormat.bullet

     Button                 Button (objet)

     call                   call, Function.call

     call function          call function

     callee                 arguments.callee

     caller                 arguments.caller

     capabilities           System.capabilities (objet)

     CAPSLOCK               Key.CAPSLOCK

     case                   case

     ceil                   Math.ceil




26
Elément ActionScript   Consultez l’entrée

charAt                 String.charAt

charCodeAt             String.charCodeAt

check                  FStyleFormat.check

childNodes             XML.childNodes

chr                    chr

clear                  MovieClip.clear

clearInterval          clearInterval

cloneNode              XML.cloneNode

close                  XMLSocket.close

Color                  Color (objet), TextFormat.color
concat                 Array.concat, String.concat

connect                XMLSocket.connect

constructor            Array (objet), Boolean (objet), Color (objet), Date (objet),
                       Number (fonction), Object (objet), Sound (objet), String
                       (objet), XML (objet), XMLSocket (objet)

contentType            LoadVars.contentType, XML.contentType

ccntinue               continue

CONTROL                Key.CONTROL

cos                    Math.cos

createElement          XML.createElement

createEmptyMovieClip   MovieClip.createEmptyMovieClip

createTextField        MovieClip.createTextField

createTextNode         XML.createTextNode

_currentframe          MovieClip._currentframe

curveTo                MovieClip.curveTo

Date                   Date (objet)

darkshadow             FStyleFormat.darkshadow

default                default

delete                 delete

DELETEKEY              Key.DELETEKEY

docTypeDecl            XML.docTypeDecl

do while               do while

DOWN                   Key.DOWN

_droptarget            MovieClip._droptarget

duplicateMovieClip     duplicateMovieClip, MovieClip.duplicateMovieClip

duration               Sound.duration

E                      Math.E




                                                           Dictionnaire ActionScript   27
     Elément ActionScript   Consultez l’entrée

     #endinitclip           #endinitclip

     else                   else

     else if                else if

     embedFonts             TextField.embedFonts

     enab led               Button.enabled, MovieClip.enabled

     END                    Key.END

     endFill                MovieClip.endFill

     ENTER                  Key.ENTER

     eq                     eq (égal à – spécifique aux chaînes)

     escape (fonction)      escape

     ESCAPE (constante)     Key.ESCAPE

     eval                   eval

     evaluate               evaluate

     exp                    Math.exp

     face                   FStyleFormat.face

     false                  false

     FCheckBox              FCheckBox (composant)

     FComboBox              FListBox (composant)

     firstChild             XML.firstChild

     FListBox               FListBox (composant)

     floor                  Math.floor

     focusEnabled           MovieClip.focusEnabled

     _focusrect             _focusrect, Button._focusrect, TextField._focusrect,
                            MovieClip._focusrect

     font                   TextFormat.font

     for                    for

     for..in                for..in

     foregroundDisabled     FStyleFormat.foregroundDisabled

     FPushButton            FPushButton (composant)

     FRadioButton           FPushButton (composant)

     _framesloaded          MovieClip._framesloaded

     fromCharCode           String.fromCharCode

     fscommand              fscommand

     FScrollBar             FScrollBar (composant)

     FScrollPane            FScrollPane (composant)

     FStyleFormat           FStyleFormat (objet)




28
Elément ActionScript   Consultez l’entrée

function               function, Function (objet)

ge                     ge (supérieur ou égal à – spécifique aux chaînes)

get                    CustomActions.get

getAscii               Key.getAscii

getBeginIndex          Selection.getBeginIndex

getBounds              MovieClip.getBounds

getBytesLoaded         LoadVars.getBytesLoaded, MovieClip.getBytesLoaded,
                       Sound.getBytesLoaded, XML.getBytesLoaded

getBytesTotal          LoadVars.getBytesTotal, MovieClip.getBytesTotal,
                       Sound.getBytesTotal, XML.getBytesTotal

getCaretIndex          Selection.getCaretIndex

getCode                Key.getCode

getData                FRadioButton.getData

getDate                Date.getDate

getDay                 Date.getDay

getDepth               Button.getDepth, MovieClip.getDepth, TextField.getDepth

getEnabled             FCheckBox.getEnabled, FComboBox.getEnabled,
                       FListBox.getEnabled, FPushButton.getEnabled,
                       FRadioButton.getEnabled, FScrollBar.getEnabled

getEndIndex            Selection.getEndIndex

getFocus               Selection.getFocus

getFontList            TextField.getFontList

getFullYear            Date.getFullYear

getHours               Date.getHours

getItemAt              FComboBox.getItemAt, FListBox.addItemAt

getLabel               FCheckBox.getLabel, FPushButton.getLabel,
                       FRadioButton.getLabel

getLength              FComboBox.getLength, FListBox.getLength

getMilliseconds        Date.getMilliseconds

getMinutes             Date.getMinutes

getMonth               Date.getMonth

getNewTextFormet       TextField.getNewTextFormat

getPan                 Sound.getPan

getPaneHeight          FScrollPane.getPaneHeight

getPaneWidth           FScrollPane.getPaneWidth

getProperty            getProperty

getRowCount            FComboBox.getRowCount, FListBox.getRowCount

getRGB                 Color.getRGB




                                                          Dictionnaire ActionScript   29
     Elément ActionScript   Consultez l’entrée

     getScrollContent       FScrollPane.getScrollContent

     getScrollPosition      FComboBox.getScrollPosition, FListBox.getScrollPosition,
                            FScrollBar.getScrollPosition, FScrollPane.getScrollPosition

     getSeconds             Date.getSeconds

     getSelectedIndex       FComboBox.getSelectedIndex, FListBox.getSelectedIndex

     getSelectedIndices     FListBox.getSelectedIndices

     getSelectedItem        FComboBox.getSelectedItem, FListBox.getSelectedItem

     getSelectedItems       FListBox.getSelectedItem

     getSelectMultiple      FListBox.getSelectMultiple

     getState               FRadioButton.getState

     getTextExtent          TextFormat.getTextExtent

     getTextFormat          TextField.getTextFormat

     getTime                Date.getTime

     getTimer               getTimer

     getTimezoneOffset      Date.getTimezoneOffset

     getTransform           Color.getTransform, Sound.getTransform

     getURL                 getURL, MovieClip.getURL

     getUTCDate             Date.getUTCDate

     getUTCDay              Date.getUTCDay

     getUTCFullYear         Date.getUTCFullYear

     getUTCHours            Date.getUTCHours

     getUTCMilliseconds     Date.getUTCMilliseconds

     getUTCMinutes          Date.getUTCMinutes

     getUTCMonth            Date.getUTCMonth

     getUTCSeconds          Date.getUTCSeconds

     getValue               FCheckBox.getValue, FComboBox.getValue, FListBox.getValue,
                            FRadioButton.getValue

     getVersion             getVersion

     getVolume              Sound.getVolume

     getYear                Date.getYear

     _global                _global

     globalStyleFormat      globalStyleFormat

     globalToLocal          MovieClip.globalToLocal

     goto                   gotoAndPlay, gotoAndStop

     gotoAndPlay            gotoAndPlay, MovieClip.gotoAndPlay

     gotoAndStop            gotoAndStop, MovieClip.gotoAndStop

     gt                     gt (supérieur à — spécifique aux chaînes)




30
Elément ActionScript   Consultez l’entrée

hasAccessibility       System.capabilities.hasAccessibility

hasAudio               System.capabilities.hasAudio

hasAudioEncoder        System.capabilities.hasAudioEncoder

hasMP3                 System.capabilities.hasMP3

hasVideoEncoder        System.capabilities.hasVideoEncoder

hasChildNodes          XML.hasChildNodes

height                 Stage.height

_height                MovieClip._height, TextField._height, Button._height

hide                   Mouse.hide

highlight              FStyleFormat.highlight

highlight3D            FStyleFormat.highlight3D

_highquality           _highquality, Button._highquality, MovieClip._highquality,
                       TextField._highquality

hitArea                MovieClip.hitArea

hitTest                MovieClip.hitTest

HOME                   Key.HOME

hscroll                TextField.hscroll

html                   TextField.html

htmlText               TextField.htmlText

if                     if

ifFrameLoaded          ifFrameLoaded

ignoreWhite            XML.ignoreWhite

#include               #include

indent                 TextFormat.indent

indexOf                String.indexOf

#initclip              #initclip

INSERT                 Key.INSERT

insertBefore           XML.insertBefore

install                CustomActions.install

instanceof             instanceof

int                    int

isActive               Accessibility.isActive

isDown                 Key.isDown

isFinite               isFinite

isNaN                  isNaN

isToggled              Key.isToggled




                                                           Dictionnaire ActionScript   31
     Elément ActionScript   Consultez l’entrée

     italic                 TextFormat.italic

     join                   Array.join

     Key                    Key (objet)

     language               System.capabilities.language

     lastChild              XML.lastChild

     lastIndexOf            String.lastIndexOf

     le                     le (inférieur ou égal à — spécifique aux chaînes)

     leading                TextFormat.leading

     LEFT                   Key.LEFT

     leftMargin             TextFormat.leftMargin

     length                 arguments.length, Array.length, String.length, Sound.loadSound,
                            TextField.length

     level                  _level

     lineStyle              MovieClip.lineStyle

     lineTo                 MovieClip.lineTo

     list                   CustomActions.uninstall

     LN2                    Math.LN2

     LN10                   Math.LN10

     load                   XML.load, LoadVars.load

     loaded                 XML.loaded, LoadVars.loaded

     loadMovie              loadMovie, MovieClip.loadMovie

     loadMovieNum           loadMovieNum

     loadScrollContent      FScrollPane.loadScrollContent

     loadSound              Sound.loadSound

     loadVariables          loadVariables, MovieClip.loadVariables

     loadVariablesNum       loadVariablesNum

     LoadVars               LoadVars (objet)

     localToGlobal          MovieClip.localToGlobal

     log                    Math.log

     LOG2E                  Math.LOG2E

     LOG10E                 Math.LOG10E

     lt                     lt (inférieur à — spécifique aux chaînes)

     manufacturer           System.capabilities.manufacturer

     Math                   Math (objet)

     max                    Math.max

     maxChars               TextField.maxChars




32
Elément ActionScript   Consultez l’entrée

maxhscroll             TextField.maxhscroll

maxscroll              maxscroll, TextField.maxscroll

MAX_VALUE              Number.MAX_VALUE

mbchr                  mbchr

mblength               mblength

mbord                  mbord

mbsubstring            mbsubstring

method                 method

min                    Math.min

MIN_VALUE              Number.MIN_VALUE

Mouse                  Mouse (objet)

moveTo                 MovieClip.moveTo

MovieClip              MovieClip (objet)

multiline              TextField.multiline

_name                  MovieClip._name, TextField._name, Button._name

NaN                    NaN, Number.NaN

ne                     ne (pas égal à — spécifique aux chaînes)

NEGATIVE_INFINITY      Number.NEGATIVE_INFINITY

new (opérateur)        new

newline                newline

nextFrame              nextFrame, MovieClip.nextFrame

nextScene              nextScene

nextSibling            XML.nextSibling

nodeName               XML.nodeName

nodeType               XML.nodeType

nodeValue              XML.nodeValue

not                    not

null                   null

Number                 Number (fonction), Number (objet)

Object                 Object (objet)

on                     on

onClipEvent            onClipEvent

onClose                XMLSocket.onClose

onChanged              TextField.onChanged

onConnect              XMLSocket.onConnect

onData                 XML.onData, XMLSocket.onData




                                                           Dictionnaire ActionScript   33
     Elément ActionScript   Consultez l’entrée

     onDragOut              Button.onDragOut, MovieClip.onDragOut

     onDragOver             Button.onDragOver, MovieClip.onDragOver

     onEnterFrame           MovieClip.onEnterFrame

     onKeyDown              Button.onKeyDown, Key.onKeyDown, MovieClip.onKeyDown

     onKeyUp                Button.onKeyUp, Key.onKeyUp, MovieClip.onKeyUp

     onKillFocus            Button.onKillFocus, MovieClip.onKillFocus,
                            TextField.onKillFocus

     onLoad                 LoadVars.onLoad, MovieClip.onLoad, Sound.onLoad, XML.onLoad

     onMouseDown            Mouse.onMouseDown, MovieClip.onMouseDown

     onMouseMove            Mouse.onMouseMove, MovieClip.onMouseMove

     onMouseUp              Mouse.onMouseUp, MovieClip.onMouseUp

     onPress                Button.onPress, MovieClip.onPress

     onRelease              Button.onRelease, MovieClip.onRelease

     onReleaseOutisde       Button.onReleaseOutside, MovieClip.onReleaseOutside

     onResize               Stage.onResize

     onRollOut              Button.onRollOut

     onRollOver             Button.onRollOver

     onScroller             TextField.onScroller

     onSetFocus             Button.onSetFocus, MovieClip.onSetFocus, Selection.onSetFocus,
                            TextField.onSetFocus

     onSort                 Array.pop

     onSoundComplete        Sound.onSoundComplete

     onUnload               MovieClip.onUnload

     onXML                  XMLSocket.onXML

     or (OR logique)        or

     ord                    ord

     os                     System.capabilities.os

     _parent                _parent, Button._parent, MovieClip._parent, TextField._parent

     parentNode             XML.parentNode

     parseFloat             parseFloat

     parseInt               parseInt

     parseXML               XML.parseXML

     password               TextField.password

     PGDN                   Key.PGDN

     PGUP                   Key.PGUP

     PI                     Math.PI

     pixelAspectRatio       System.capabilities.pixelAspectRatio




34
Elément ActionScript   Consultez l’entrée

play                   play, MovieClip.play

pop                    Array.pop

position               Sound.position

POSITIVE_INFINITY      Number.POSITIVE_INFINITY

pow                    Math.pow

prevFrame              prevFrame, MovieClip.prevFrame

previousSibling        XML.previousSibling

prevScene              prevScene

print                  print

printAsBitmap          printAsBitmap

printAsBitmapNum       printAsBitmapNum

printNum               printNum

__proto__              Object.__proto__

push                   Array.push

_quality               _quality, TextField._quality, Button._quality

radioDot               FStyleFormat.radioDot

random                 random, Math.random

refreshPane            FScrollPane.refreshPane

registerClass          Object.registerClass

registerSkinElement    FCheckBox.registerSkinElement, FComboBox.registerSkinElement,
                       FListBox.registerSkinElement,
                       FPushButton.registerSkinElement,
                       FRadioButton.registerSkinElement,
                       FScrollPane.registerSkinElement,
                       FScrollPane.registerSkinElement

removeAll              FComboBox.removeAll, FListBox.removeAll

removeItemAt           FComboBox.removeItemAt, FListBox.removeItemAt

removeListener         FStyleFormat.removeListener, Key.removeListener,
                       Mouse.removeListener, Selection.removeListener,
                       Stage.removeListener, TextField.removeListener

removeMovieClip        removeMovieClip, MovieClip.removeMovieClip

removeNode             XML.removeNode

removeTextField        TextField.removeTextField

replaceItemAt          FComboBox.replaceItemAt, FListBox.replaceItemAt

replaceSel             TextField.replaceSel

resolutionX            Capabilities.screenResolutionX

resolutionY            Capabilities.screenResolutionY

restrict               TextField.restrict

return                 return




                                                           Dictionnaire ActionScript   35
     Elément ActionScript   Consultez l’entrée

     reverse                Array.reverse

     RIGHT                  Key.RIGHT

     rightMargin            TextFormat.rightMargin

     _root                  _root

     _rotation              MovieClip._rotation, Button._rotation, TextField._rotation

     round                  Math.round

     scaleMode              Stage.scaleMode

     screenColor            System.capabilities.screenColor

     screenDPI              System.capabilities.screenDPI

     screenResolution.x     System.capabilities.screenResolution.x

     screenResolution.y     System.capabilities.screenResolution.y

     scroll                 scroll, TextField.scroll

     scrollTrack            FStyleFormat.scrollTrack

     selectable             TextField.selectable

     selection              FStyleFormat.selection

     Selection              Selection (objet)

     selectionDisabled      FStyleFormat.selectionDisabled

     selectionUnfocused     FStyleFormat.selectionUnfocused

     send                   LoadVars.send, XML.send, XMLSocket.send

     sendAndLoad            LoadVars.sendAndLoad, XML.sendAndLoad

     set variable           set variable

     setAutoHideScrollBar   FListBox.setAutoHideScrollBar

     setChangeHandler       FCheckBox.setChangeHandler, FComboBox.setChangeHandler,
                            FListBox.setChangeHandler, FRadioButton.setChangeHandler,
                            FScrollBar.setChangeHandler

     setClickHandler        FPushButton.setClickHandler

     setData                FRadioButton.setData

     setDataProvider        FComboBox.setDataProvider, FListBox.setDataProvider

     setDate                Date.setDate

     setDragContent         FScrollPane.setDragContent

     setEditable            FComboBox.setEditable

     setEnabled             FCheckBox.setEnabled,FComboBox.setEnabled,
                            FListBox.setEnabled, FPushButton.setEnabled,
                            FRadioButton.setEnabled, FScrollBar.setEnabled

     setFocus               Selection.setFocus

     setFullYear            Date.setFullYear

     setGroupName           FRadioButton.setGroupName




36
Elément ActionScript   Consultez l’entrée

setHorizontal          FScrollBar.setHorizontal

setHours               Date.setHours

setHScroll             FScrollPane.setHScroll

setInterval            setInterval

setItemSymbol          FComboBox.setItemSymbol, FListBox.setItemSymbol

setLabel               FCheckBox.setLabel, FPushButton.setLabel,
                       FRadioButton.setLabel

setLabelPlacement      FCheckBox.setLabelPlacement, FRadioButton.setLabelPlacement

setLargeScroll         FScrollBar.setLargeScroll

setMask                MovieClip.setMask

setMilliseconds        Date.setMilliseconds

setMinutes             Date.setMinutes

setMonth               Date.setMonth

setNewTextFormat       TextField.setNewTextFormat

setPan                 Sound.setPan

setProperty            setProperty

setRGB                 Color.setRGB

setRowCount            FComboBox.setRowCount, FListBox.setRowCount

setScrollContent       FScrollBar.setSize, FScrollPane.setScrollContent

setScrollPosition      FListBox.setScrollPosition, FScrollBar.setScrollPosition,
                       FScrollPane.setScrollPosition

setScrollProperties    FScrollBar.setScrollProperties

setScrollTarget        FScrollBar.setScrollTarget

setSeconds             Date.setSeconds

setSelectedIndex       FComboBox.setSelectedIndex, FListBox.setSelectedIndex

setSelectedIndices     FListBox.setSelectedIndices

setSelection           Selection.setSelection

setSelectMultiple      FListBox.setSelectMultiple

setSize                FCheckBox.setSize, FComboBox.setSize, FListBox.setSize,
                       FPushButton.setSize, FScrollBar.setSize, FScrollPane.setSize

setSmallScroll         FScrollBar.setSmallScroll

setState               FRadioButton.setState

setStyleProperty       FCheckBox.setStyleProperty, FComboBox.setStyleProperty,
                       FListBox.setStyleProperty, FPushButton.setStyleProperty,
                       FRadioButton.setStyleProperty, FScrollBar.setStyleProperty,
                       FScrollPane.setStyleProperty

setTextFormat          TextField.setTextFormat

setTime                Date.setTime




                                                          Dictionnaire ActionScript   37
     Elément ActionScript   Consultez l’entrée

     setTransform           Color.setTransform,Sound.setTransform

     setUTCDate             Date.setUTCDate

     setUTCFullYear         Date.setUTCFullYear

     setUTCHours            Date.setUTCHours

     setUTCMilliseconds     Date.setUTCMilliseconds

     setUTCMinutes          Date.setUTCMinutes

     setUTCMonth            Date.setUTCMonth

     setUTCSeconds          Date.setUTCSeconds

     setValue               FCheckBox.setValue, FComboBox.setValue,FRadioButton.setValue

     setVolume              Sound.setVolume

     setVScroll             FScrollPane.setVScroll

     setWidth               FListBox.setWidth

     setYear                Date.setYear

     shadow                 FStyleFormat.shadow

     shift (méthode)        Array.shift

     SHIFT (constante)      Key.SHIFT

     show                   Mouse.show

     sin                    Math.sin

     size                   TextFormat.size

     slice                  Array.slice, String.slice

     sort                   Array.sort

     sortItemsBy            FComboBox.sortItemsBy, FListBox.sortItemsBy

     Sound                  Sound (objet)

     _soundbuftime          _soundbuftime, TextField._soundbuftime,
                            MovieClip._soundbuftime, Button._soundbuftime

     SPACE                  Key.SPACE

     splice                 Array.splice

     split                  String.split

     sqrt                   Math.sqrt

     SQRT1_2                Math.SQRT1_2

     SQRT2                  Math.SQRT2

     start                  Sound.start

     startDrag              startDrag, MovieClip.startDrag

     status                 XML.status

     stop                   stop, MovieClip.stop, Sound.stop

     stopAllSounds          stopAllSounds




38
Elément ActionScript   Consultez l’entrée

stopDrag               stopDrag, MovieClip.stopDrag

String                 String (fonction), String (objet)

substr                 String.substring

substring              substring, String.substring

super                  super

swapDepths             MovieClip.swapDepths

switch                 switch

System                 System (objet)

TAB                    Key.TAB

tabChildren            MovieClip.tabChildren

tabEnabled             Button.tabEnabled, TextField.tabEnabled, MovieClip.tabEnabled

tabIndex               Button.tabIndex, MovieClip.tabIndex, TextField.tabIndex

tabStops               TextFormat.tabStops

tan                    Math.tan

target                 TextFormat.target

_target                Button._target, MovieClip._target, TextField._target

targetPath             targetPath

tellTarget             tellTarget

text                   TextField.text

textAlign              FStyleFormat.textAlign

textBold               FStyleFormat.textBold

textColor              FStyleFormat.textColor, TextField.textColor

textDisabled           FStyleFormat.textDisabled

TextField              TextField (objet)

textFont               FStyleFormat.textFont

TextFormat             TextFormat (objet)

textHeight             TextField.textHeight

textIndent             FStyleFormat.textIndent

textItalic             FStyleFormat.textItalic

textLeftMargin         FStyleFormat.textLeftMargin

textRightMargin        FStyleFormat.textRightMargin

textSelected           FStyleFormat.textSelected

textSize               FStyleFormat.textSize

textUnderline          FStyleFormat.textUnderline

textWidth              TextField.textWidth

this                   this




                                                           Dictionnaire ActionScript   39
     Elément ActionScript   Consultez l’entrée

     toggleHighQuality      toggleHighQuality

     toLowerCase            String.toLowerCase

     toString               Array.toString, Boolean.toString, Date.toString,
                            Number.toString, Object.toString, XML.toString

     _totalframes           MovieClip._totalframes

     toUpperCase            String.toUpperCase

     trace                  trace

     trackAsMenu            Button.trackAsMenu, MovieClip.trackAsMenu

     true                   true

     type                   TextField.type

     typeof                 typeof

     undefined              undefined

     underline              TextFormat.underline

     unescape               unescape

     uninstall              CustomActions.uninstall

     unloadMovie            unloadMovie, MovieClip.unloadMovie

     unLoadMovieNum         unloadMovieNum

     unshift                Array.unshift

     unwatch                Object.unwatch

     UP                     Key.UP

     updateAfterEvent       updateAfterEvent

     url                    TextFormat.url

     _url                   MovieClip._url, TextField._url, Button._url

     useHandCursor          Button.useHandCursor, MovieClip.useHandCursor

     UTC                    Date.UTC

     valueOf                Boolean.valueOf, Number.valueOf, Object.valueOf

     var                    var

     variable               TextField.variable

     version                System.capabilities.version

     _visible               MovieClip._visible, Button._visible, TextField._visible

     void                   void

     watch                  Object.watch

     while                  while

     width                  Stage.width

     _width                 MovieClip._width, TextField._width, Button._width

     with                   with




40
Elément ActionScript   Consultez l’entrée

wordwrap               TextField.wordWrap

_x                     Button._x, MovieClip._x, TextField._x

XML                    XML (objet)

xmlDecl                XML.xmlDecl

XMLSocket              XMLSocket (objet)

_xmouse                Button._xmouse, MovieClip._xmouse, TextField._xmouse

_xscale                Button._xscale, MovieClip._xscale, TextField._xscale

_y                     Button._y, MovieClip._y, TextField._y

_ymouse                Button._ymouse, MovieClip._ymouse, TextField._ymouse

_yscale                Button._yscale, MovieClip._yscale, TextField._yscale




                                                           Dictionnaire ActionScript   41
–– (décrémentation)
     Disponibilité
     Flash Player 4.
     Usage
     ––expression
     expression––

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Opérateur (arithmétique) ; opérateur unaire de pré et post-décrémentation qui soustrait 1 de
     l’expression. La forme de pré-décrémentation de l’opérateur (––expression) soustrait 1 de
     l’expression et renvoie le résultat. La forme de post-décrémentation de l’opérateur
     (expression––) soustrait 1 de l’expression et renvoie la valeur initiale de l’expression (le
     résultat avant la soustraction).
     Exemple
     La forme de pré-décrémentation de l’opérateur décrémente x de 2 (x - 1 = 2) et renvoie le
     résultat comme y :
     x = 3;
     y = --x;
     // y est égal à 2
     La forme de post-décrémentation de l’opérateur décrémente x de 2 (x - 1 = 2) et renvoie la
     valeur originale de x comme résultat y :
     x = 3;
     y = x--
     // y est égal à 3

++ (incrémentation)
     Disponibilité
     Flash Player 4.
     Usage
     ++expression
     expression++

     Paramètres
     Aucun.
     Renvoie
     Rien.




42
Description
Opérateur (arithmétique) ; opérateur unaire de pré et post-incrémentation qui ajoute 1 à
l’expression. expression peut être une variable, l’élément d’un tableau ou la propriété d’un
objet. La forme de pré-incrémentation de l’opérateur (++expression) ajoute 1 à l’expression et
renvoie le résultat. La forme de post-incrémentation de l’opérateur (expression++) ajoute 1 à
l’expression et renvoie la valeur initiale de l’expression (la valeur avant l’addition).
La forme de pré-incrémentation de l’opérateur incrémente x à 2 (x + 1 = 2) et renvoie le résultat
comme y :
x = 1;
y = ++x
// y est égal à 2
La forme de post-incrémentation de l’opérateur incrémente x à 2 (x + 1 = 2) et renvoie la valeur
originale de x comme résultat y :
x = 1;
y = x++;
// y est égal à 1

Exemple
L’exemple suivant utilise ++ comme opérateur de post-incrémentation pour entraîner cinq
boucles de while.
i = 0;
while(i++ < 5){
trace("ceci est l’exécution " + i);
}
Cet exemple utilise ++ comme opérateur de pré-incrémentation.
var a = [];
var i = 0;
while (i < 10) {
  a.push(++i);
}
trace(a.join());
Ce script affiche le résultat suivant dans la fenêtre Sortie :
1,2,3,4,5,6,7,8,9,10
L’exemple suivant utilise ++ comme opérateur de post-incrémentation.
var a = [];
var i = 0;
while (i < 10) {
a.push(i++);
  }
trace(a.join());
Ce script affiche le résultat suivant dans la fenêtre Sortie :
0,1,2,3,4,5,6,7,8,9




                                                                    Dictionnaire ActionScript   43
! (NOT logique)
     Disponibilité
     Flash Player 4.
     Usage
     !expression

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Opérateur (logique) ; inverse la valeur booléenne d’une variable ou expression. Si expression est
     une variable avec la valeur absolue ou convertie true, la valeur de !expression est false. Si
     l’expression x && y est false, l’expression !(x && y) est true.
     Les expressions suivantes illustrent le résultat de l’utilisation de l’opérateur ! :
     !true   renvoie false
     !false   renvoie true
     Exemple
     Dans l’exemple suivant, la variable heureux est définie sur false. La condition if évalue la
     condition !heureux et, si la condition est true, l’action trace envoie une chaîne à la fenêtre
     Sortie.
     heureux = false;
     if (!heureux) {
       trace("le bonheur, c’est être heureux");
     }

!= (inégalité)
     Disponibilité
     Flash Player 5.
     Usage
     expression1 != expression2

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Opérateur (inégalité) ; teste l’opposé exact de l’opérateur ==. Si expression1 est égale à
     expression2, le résultat est false. Tout comme pour l’opérateur ==, la définition du terme
     égalité dépend des types de données comparés.
     • Les nombres, les chaînes et les valeurs booléennes sont comparés par valeur.
     • Les variables, les objets, les tableaux et les fonctions sont comparés par référence.

44
    Exemple
    L’exemple suivant illustre le résultat de l’opérateur != :
    5 != 8   renvoie true
    5 != 5   renvoie false
    Cet exemple illustre l’utilisation de l’opérateur != dans une instruction if :
    a = "David";
    b = "Idiot"
    if (a != b){
      trace("David n’est pas idiot");
    }

    Voir aussi
    !== (inégalité stricte), == (égalité), === (égalité stricte)


!== (inégalité stricte)
    Disponibilité
    Flash Player 6.
    Usage
    expression1 !== expression2

    Description
    Opérateur ; teste l’opposé exact de l’opérateur ===. L’opérateur d’inégalité stricte fonctionne de la
    même façon que l’opérateur d’inégalité, à ceci près que les types de données ne sont pas convertis.
    Si expression1 est égale à expression2, et leur type de données est égal, le résultat est false.
    Tout comme pour l’opérateur ===, la définition du terme égalité dépend des types de données
    comparés.
    • Les nombres, les chaînes et les valeurs booléennes sont comparés par valeur.
    • Les variables, les objets, les tableaux et les fonctions sont comparés par référence.




                                                                           Dictionnaire ActionScript   45
     Exemple
     Le code suivant affiche la valeur renvoyée par les opérations utilisant les opérateurs d’égalité,
     d’égalité stricte et d’inégalité stricte.
     s1 = new String("5");
     s2 = new String("5");
     s3 = new String("Bonjour");
     n = new Number(5);
     b = new Boolean(true);

     s1   ==    s2; // true
     s1   ==    s3; // false
     s1   ==    n; // true
     s1   ==    b; // false

     s1   ===    s2; // true
     s1   ===    s3; // false
     s1   ===    n; // false
     s1   ===    b; // false

     s1   !==    s2; // false
     s1   !==    s3; // true
     s1   !==    n; // true
     s1   !==    b; // true

     Voir aussi
     != (inégalité), == (égalité), === (égalité stricte)


% (modulo)
     Disponibilité
     Flash Player 4. Dans les fichiers Flash 4, l’opérateur % est développé dans le fichier SWF sous la
     forme x - int(x/y) * y et peut ne pas être aussi rapide ou précis dans les versions suivantes de
     Flash Player.
     Usage
     expression1 % expression2

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Opérateur (arithmétique) ; calcule le reste de expression1 divisé par expression2. Si l’un des
     paramètres de expression n’est pas un nombre, l’opérateur de modulo tente de les convertir en
     nombre. expression peut être un nombre ou une chaîne convertie en valeur numérique.
     Exemple
     L’exemple suivant illustre l’emploi de l’opérateur modulo (%).
     trace (12 % 5);
     // renvoie 2
     trace (4.3 % 2.1);
     // renvoie approximativement 0.1




46
%= (affectation de modulo)
   Disponibilité
   Flash Player 4.
   Usage
   expression1 %= expression2

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Opérateur (affectation composée arithmétique) ; affecte à expression1 la valeur de
   expression1 % expression2. Par exemple, les deux expressions suivantes sont équivalentes :
   x %= y
   x = x % y

   Exemple
   L’exemple suivant affecte la valeur 4 à la variable x.
   x = 14;
   y = 5;
   trace(x %= y);
   // renvoie 4

   Voir aussi
   % (modulo)

& (AND au niveau du bit)
   Disponibilité
   Flash Player 5. Dans Flash 4, l’opérateur & était utilisé pour concaténer les chaînes. Dans Flash 5,
   l’opérateur & est un AND au niveau du bit et vous devez utiliser les opérateurs add et + pour
   concaténer les chaînes. Les fichiers Flash 4 utilisant l’opérateur & sont automatiquement mis à
   jour pour utiliser add lorsqu’ils sont importés dans l’environnement de programmation de
   Flash 5.
   Usage
   expression1 & expression2

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Opérateur (au niveau du bit) ; convertit expression1 et expression2 en entiers 32 bits non
   signés et effectue une opération AND booléenne sur chaque bit des paramètres entiers. Le résultat
   est un nouvel entier 32 bits non signé.




                                                                          Dictionnaire ActionScript   47
&& (AND court-circuit)
     Disponibilité
     Flash Player 4.
     Usage

     expression1 && expression2

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Opérateur (logique) ; effectue une opération booléenne sur les valeurs d’une ou des deux
     expressions. Evalue expression1 (l’expression du côté gauche de l’opérateur) et renvoie false si
     l’expression est false. Si expression1 est true, expression2 (l’expression du côté droit de
     l’opérateur) est évaluée. Si expression2 est true, le résultat final est true ; sinon, il est false.
     Exemple
     Cet exemple utilise l’opérateur && pour effectuer un test permettant de déterminer si un joueur a
     gagné la partie. Les variables tours et score sont mises à jour lorsqu’un joueur prend son tour ou
     marque des points pendant la partie. Le script suivant affiche « Vous avez gagné ! » dans la fenêtre
     Sortie lorsque le score du joueur atteint 75 ou plus en 3 tours ou moins.
     tours =2;
     score=77;
     gagnant = (tours <= 3) && (score >= 75);
     if (gagnant) {
       trace("Vous avez gagné !");
     } else {
       trace("Réessayez !");
     }

&= (affectation AND au niveau du bit)
     Disponibilité
     Flash Player 5.
     Usage
     expression1 &= expression2

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Opérateur (affectation composée au niveau du bit) ; affecte à expression1 la valeur de
     expression1 & expression2. Par exemple, les deux expressions suivantes sont équivalentes.
     x &= y
     x = x & y



48
   Exemple
   L’exemple suivant affecte la valeur 9 à x.
   x = 15;
   y = 9;
   trace(x &= y);
   // renvoie 9

   Voir aussi
   & (AND au niveau du bit)

() (parenthèses)
   Disponibilité
   Flash Player 4.
   Usage
   (expression1, expression2);
   fonction(paramètre1,..., paramètreN);

   Paramètres
   expression1, expression2         Nombres, chaînes, variables ou texte.
   fonction     La fonction devant être effectuée sur le contenu des parenthèses.
   paramètre1...paramètreN       Une série de paramètres à exécuter avant que le résultat ne soit
   transmis comme paramètres à la fonction extérieure aux parenthèses.
   Renvoie
   Rien.
   Description
   Opérateur ; effectue une opération de regroupement sur un ou plusieurs paramètres ou entoure
   un ou plusieurs paramètres et les transmet comme paramètres à une fonction extérieure aux
   parenthèses.
   Usage 1. Contrôle l’ordre dans lequel les opérateurs sont exécutés dans l’expression. Les
   parenthèses annulent l’ordre normal de priorité et obligent l’évaluation des expressions entre
   parenthèses en premier. Lorsque les parenthèses sont imbriquées, le contenu des parenthèses
   internes est évalué avant le contenu des parenthèses externes.
   Usage 2. Encadre un ou plusieurs paramètres et les transmet sous forme de paramètres à la
   fonction extérieure aux parenthèses.
   Exemple
   Usage 1. Les instructions suivantes illustrent l’emploi des parenthèses pour contrôler l’ordre
   d’exécution des expressions. La valeur de chaque expression est affichée en dessous de chaque
   ligne, comme suit :
   trace((2 + 3) * (4 + 5));
   // affiche 45

   trace(2 + (3 * (4 + 5)));
   // affiche 29

   trace(2 + (3 * 4) + 5);
   // affiche 19




                                                                         Dictionnaire ActionScript   49
     Usage 2. L’exemple suivant illustre l’emploi des parenthèses avec des fonctions.
     getDate();

     facture(article, montant);

     function traceParameter(param){
       trace(param);
     }
     traceParameter(2*2);

     Voir aussi
     with

– (moins)
     Disponibilité
     Flash Player 4.
     Usage
     (Négation) –expression
     (Soustraction) expression1 - expression2
     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Opérateur (arithmétique) ; utilisé pour la négation ou la soustraction.
     Usage 1. Lorsque utilisé pour la négation, il inverse le signe de l’expression numérique.
     Usage 2. Lorsque utilisé pour la soustraction, il effectue une soustraction arithmétique sur deux
     expressions numériques, soustrayant expression2 de expression1. Lorsque les deux expressions
     sont des entiers, la différence est un entier. Lorsque l’une des expressions, ou les deux, est un
     nombre à virgule flottante, la différence est un nombre à virgule flottante.
     Exemple
     Usage 1. L’instruction suivante inverse le signe de l’expression 2 + 3.
     -(2 + 3)
     Le résultat est -5.
     Usage 2. L’instruction suivante soustrait l’entier 2 de l’entier 5.
     5 - 2
     Le résultat est 3, qui est un entier.
     Usage 2. L’instruction suivante soustrait le nombre à virgule flottante 1.5 du nombre à virgule
     flottante 3.25.
     3.25 - 1.5
     Le résultat est 1.75, qui est un nombre à virgule flottante.




50
* (multiplication)
   Disponibilité
   Flash Player 4.
   Usage
   expression1 * expression2

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Opérateur (arithmétique) ; multiplie deux expressions numériques. Si les deux expressions sont
   des entiers, le produit est un entier. Si l’une des expressions, ou les deux, est un nombre à virgule
   flottante, le produit est un nombre à virgule flottante.
   Exemple
   L’instruction suivante multiplie les entiers 2 et 3 :
   2 * 3
   Le résultat est 6, qui est un entier.
   Exemple
   Cette instruction multiplie les nombres à virgule flottante 2.0 et 3.1416.
   2.0 * 3.1416
   Le résultat est 6.2832, qui est un nombre à virgule flottante.

*= (affectation de multiplication)
   Disponibilité
   Flash Player 4.
   Usage
   expression1 *= expression2

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Opérateur (affectation composée arithmétique) ; affecte à expression1 la valeur de
   expression1 * expression2. Par exemple, les deux expressions suivantes sont équivalentes :
   x *= y
   x = x * y




                                                                           Dictionnaire ActionScript   51
     Exemple
     L’exemple suivant affecte la valeur 50 à la variable x.
     x = 5;
     y = 10;
     trace(x *= y);
     // renvoie 50

     Exemple
     Les deuxième et troisième lignes de l’exemple suivant calculent les expressions se trouvant à droite
     du signe égal et affectent les résultats à x et y.
     i = 5;
     x = 4 - 6;
     y = i + 2;
     trace(x *= y);
     // renvoie -14

     Voir aussi
     * (multiplication)

, (virgule)
     Disponibilité
     Flash Player 4.
     Usage
     expression1, expression2

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Opérateur ; évalue expression1, puis expression2, et renvoie la valeur de expression2. Cet
     opérateur est principalement utilisé avec l’instruction de boucle for.
     Exemple
     Le code suivant utilise l’opérateur virgule :
     var a=1, b=2, c=3;
     Ceci est équivalent à la rédaction du code suivant :
     var a=1;
     var b=2;
     var c=3;




52
. (point)
    Disponibilité
    Flash Player 4.
    Usage
    objet.proprieté_ou_méthode
    nomDoccurrence.variable
    nomDoccurrence.occurrenceEnfant.variable

    Paramètres
    objet Une occurrence d’un objet. L’objet peut être un des objets ActionScript intégrés ou un
    objet personnalisé. Ce paramètre se situe toujours à gauche de l’opérateur point (.).
    proprieté_ou_méthode Le nom d’une propriété ou méthode associée à un objet. Toutes les
    méthodes et propriétés valides pour les objets intégrés sont répertoriées dans les récapitulatifs des
    propriétés et méthodes correspondants. Ce paramètre se situe toujours à droite de l’opérateur
    point (.).
    nomDoccurrence      Le nom d’occurrence d’un clip.
    occurrenceEnfant       Une occurrence de clip qui est un enfant d’un autre clip.
    variable     Une variable dans le scénario du clip dont le nom d’occurrence figure à gauche de
    l’opérateur point (.).
    Renvoie
    Rien.
    Description
    Opérateur ; utilisé pour naviguer dans les hiérarchies de clip afin d’accéder aux clips (enfants)
    imbriqués, variables ou propriétés. L’opérateur point est également utilisé pour tester ou définir
    les propriétés d’un objet, exécuter une méthode d’un objet ou créer une structure de données.
    Exemple
    L’instruction suivante identifie la valeur courante de la variable couleurDeCheveux du clip
    personne.
    personne.couleurDeCheveux
    Ceci est équivalent à la syntaxe de Flash 4 suivante :
    /personne:couleurDeCheveux

    Exemple
    Le code suivant illustre un emploi de l’opérateur point pour créer une structure de tableau.
    compte.nom = "Amélie";
    compte.adresse = "123 rue Grande";
    compte.ville = "Une ville";
    compte.pays = "France";
    compte.codePostal = "12345";

    Voir aussi
    [] (accès tableau)




                                                                           Dictionnaire ActionScript   53
?: (conditionnel)
     Disponibilité
     Flash Player 4.
     Usage
     expression1 ? expression2 : expression3

     Paramètres
     expression1    Une expression évaluée comme valeur booléenne, généralement une expression
     de comparaison telle que x < 5.
     expression2, expression3         Des valeurs de tout type.
     Renvoie
     Rien.
     Description
     Opérateur ; indique à Flash d’évaluer expression1 et, si la valeur de expression1 est true,
     renvoie la valeur de expression2 ; sinon, renvoie la valeur de expression3.
     Exemple
     L’instruction suivante affecte la valeur de la variable x à la variable z étant donné que
     expression1 est true :
     x = 5;
     y = 10;
     z = (x < 6) ? x: y;
     trace (z);
     // renvoie 5

/ (division)
     Disponibilité
     Flash Player 4.
     Usage
     expression1 / expression2

     Paramètres
     expression      Un nombre ou une variable évalué comme nombre.
     Renvoie
     Rien.
     Description
     Opérateur (arithmétique) ; divise expression1 par expression2. Le résultat de la division est un
     nombre à virgule flottante à double précision.
     Exemple
     L’instruction suivante divise le nombre à virgule flottante 22.0 par 7.0 et affiche ensuite le résultat
     dans la fenêtre Sortie.
     trace(22.0 / 7.0);
     Le résultat est 3.1429, qui est un nombre à virgule flottante.


54
// (délimiteur de commentaires)
   Disponibilité
   Flash 1.
   Usage
   // commentaire

   Paramètres
   commentaire       Tout caractère.
   Renvoie
   Rien.
   Description
   Commentaire ; indique le début d’un commentaire de script. Tout caractère qui apparaît entre le
   délimiteur de commentaires // et le caractère de fin de ligne est interprété comme un
   commentaire et ignoré par l’interprète d’ActionScript.
   Exemple
   Ce script utilise des délimiteurs de commentaires pour identifier les première, troisième,
   cinquième et septième lignes comme commentaires.
   // enregistrer la position          X du clip de la balle
   balleX = balle._x;
   // enregistrer la position          Y du clip de la balle
   balleY = balle._y;
   // enregistrer la position          X du clip de la batte
   batteX = batte._x;
   // enregistrer la position          Y du clip de la batte
   batteY = batte._y;

   Voir aussi
   /* (délimiteur de commentaires)

/* (délimiteur de commentaires)
   Disponibilité
   Flash Player 5.
   Usage
   /* commentaire */
   /*
   commentaire
   commentaire
   */

   Paramètres
   commentaire       Tout caractère.
   Renvoie
   Rien.




                                                                         Dictionnaire ActionScript   55
     Description
     Commentaire ; indique une ou plusieurs lignes de commentaires de script. Tout caractère qui
     apparaît entre la balise d’ouverture de commentaires /* et la balise de fermeture de commentaires
     */ est interprété comme un commentaire et ignoré par l’interprète d’ActionScript. Utilisez le
     premier type de syntaxe pour identifier les commentaires à une seule ligne. Utilisez le second type
     de syntaxe pour identifier les commentaires contenant plusieurs lignes successives. L’oubli de la
     balise de fermeture */ lors de l’utilisation de cette forme de délimiteur de commentaires provoque
     un message d’erreur.
     Exemple
     Ce script utilise des délimiteurs de commentaires au début du script.
     /* enregistre les positions X et Y des clips
     de la balle et de la batte
     */

     balleX   =   balle._x;
     balleY   =   balle._y;
     batteX   =   batte._x;
     batteY   =   batte._y;

     Voir aussi
     // (délimiteur de commentaires)

/= (affectation de division)
     Disponibilité
     Flash Player 4.
     Usage
     expression1 /= expression2

     Paramètres
     expression1,expression2         Un nombre ou une variable évalué comme nombre.
     Renvoie
     Rien.
     Description
     Opérateur (affectation composée arithmétique) ; affecte à expression1 la valeur de
     expression1 / expression2. Par exemple, les deux instructions suivantes sont équivalentes :
     x /= y
     x = x / y

     Exemple
     Le code suivant illustre l’utilisation de l’opérateur /= avec des variables et des nombres.
     x = 10;
     y = 2;
     x /= y;
     // x contient maintenant la valeur 5




56
[] (accès tableau)
   Disponibilité
   Flash Player 4.
   Usage
   monTableau = ["a0", a1,...aN];
   monTableauMultiDimensionnel = [["a0",...aN],...["a0",...aN]]
   monTableau =[E] = valeur
   monTableauMultiDimensionnel[E][E] = valeur
   objet["valeur"];

   Paramètres
   monTableau      Le nom d’un tableau.
   a0, a1,...aN      Eléments d’un tableau.
   monTableauMultiDimensionnel         Le nom d’un tableau multidimensionnel simulé.
   E   Le nombre (ou index) d’un élément d’un tableau.
   objet      Le nom d’un objet.
   valeur      Une chaîne ou une expression évaluée comme chaîne qui nomme une propriété de
   l’objet.
   Renvoie
   Rien.
   Description
   Opérateur ; initialise un nouveau tableau ou un tableau multidimensionnel avec les éléments
   spécifiés (a0, etc.) ou accède aux éléments d’un tableau. L’opérateur d’accès tableau vous permet
   de définir et récupérer dynamiquement les noms d’occurrences, variables et objets. Il vous permet
   également d’accéder aux propriétés des objets.
   Usage 1. Un tableau est un objet dont les propriétés sont appelées éléments, qui sont chacune
   identifiées par un nombre appelé index. Lorsque vous créez un tableau, vous encadrez ses éléments
   par l’opérateur d’accès tableau (ou crochets). Un tableau peut contenir des éléments de divers
   types. Par exemple, le tableau suivant, appelé personnel, contient trois éléments ; le premier est
   un nombre et les deux suivants sont des chaînes (entre guillemets).
   personnel = [15, "Barbara", "Erick"];
   Usage 2. Vous pouvez imbriquer des crochets pour simuler des tableaux multidimensionnels. Le
   code suivant crée un tableau, appelé ticTacToe, avec trois éléments ; chaque élément est
   également un tableau contenant trois éléments.
   ticTacToe = [[1,2,3],[4,5,6],[7,8,9]];

   // choisissez Déboguer > Lister les variables en mode de test d’animation
   // pour afficher une liste des éléments du tableau




                                                                        Dictionnaire ActionScript   57
     Usage 3. Encadrez l’index de chaque élément avec des crochets pour y accéder directement ; vous
     pouvez ajouter un nouvel élément à un tableau, changer ou récupérer la valeur d’un élément
     existant. Le premier élément d’un tableau est toujours 0 :
     monTableau[0] = 15;
     monTableau[1] = "Bonjour";
     monTableau[2] = true;
     Vous pouvez utiliser des crochets pour ajouter un quatrième élément, comme dans l’exemple
     suivant :
     monTableau[3] = "George";
     Usage 4. Vous pouvez utiliser des crochets pour accéder à un élément dans un tableau
     multidimensionnel. Le premier jeu de crochets identifie l’élément dans le tableau d’origine, le
     second jeu identifiant l’élément dans le tableau imbriqué. La ligne de code suivante envoie 6 à la
     fenêtre Sortie.
     ticTacToe = [[1,2,3],[4,5,6],[7,8,9]];
     trace(ticTacToe[1][2]);

     // renvoie 6
     Usage 5. Vous pouvez utiliser l’opérateur d’accès tableau au lieu de la fonction eval pour définir
     et récupérer dynamiquement des valeurs pour des noms de clip ou n’importe quelle propriété
     d’un objet :
     nom["mc" + i] = "coin_gauche";

     Exemple
     Usage 1. Les exemples de code suivants indiquent deux manières différentes de créer un objet
     Array vide (la première ligne utilisant des crochets).
     monTableau =[];
     monTableau = new Array();
     Usage 1 et 2. L’exemple suivant crée un tableau appelé personnel et utilise une action trace
     pour envoyer les éléments à la fenêtre Sortie. A la quatrième ligne, un élément du tableau est
     changé, et la cinquième ligne envoie le tableau nouvellement modifié à la fenêtre Sortie :
     personnel=["Barbara", "George", "Mary"];
     trace(personnel);
     // Barbara, George, Mary
     personnel[2]="Sam";
     trace(personnel);
     // Barbara, George, Sam
     Usage 3. Dans l’exemple suivant, l’expression entre crochets ("morceau" + i) est évaluée et le
     résultat est utilisé comme nom de la variable qui doit être récupérée du clip mc. Dans cet exemple,
     la variable i doit exister dans le même scénario que le bouton. Si la variable i est égale à 5, par
     exemple, la valeur de la variable morceau5 dans le clip mc est affichée dans la fenêtre Sortie :
     on(release) {
       x = mc["morceau"+i];
       trace(x);
     }
     Usage 3. Dans le code suivant, l’expression entre crochets est évaluée et le résultat est utilisé
     comme nom de la variable qui doit être récupérée du clip nom :
     groupe["A" + i];




58
   Si vous êtes habitué(e) à la syntaxe ActionScript à barre oblique de Flash 4, vous pouvez obtenir le
   même résultat en utilisant la fonction eval :
   eval("A" & i);
   Usage 3. Vous pouvez également utiliser l’opérateur d’accès tableau sur le côté gauche d’une
   instruction d’affectation pour définir dynamiquement des noms d’occurrences, de variables et
   d’objets :
   nom[index] = "Gary";

   Voir aussi
   Array (objet), Object (objet), eval

^ (XOR au niveau du bit)
   Disponibilité
   Flash Player 5.
   Usage
   expression1 ^ expression2

   Paramètres
   expression1,expression2         Un nombre.
   Renvoie
   Rien.
   Description
   Opérateur (au niveau du bit) ; convertit expression1 et expression2 en entiers 32 bits non
   signés et renvoie un 1 dans chaque position de bit où les bits correspondants dans expression1
   ou expression2, mais pas les deux, sont 1.
   Exemple
   L’exemple suivant utilise l’opérateur XOR au niveau du bit sur les décimales 15 et 9 et affecte le
   résultat à la variable x.
   // 15 décimal = 1111 binaire
   // 9 décimal = 1001 binaire
   x = 15 ^ 9
   trace (x)
   // 1111 ^ 1001 = 0110
   // renvoie 6 décimal (= 0110 binaire)

^= (affectation XOR au niveau du bit)
   Disponibilité
   Flash Player 5.
   Usage
   expression1 ^= expression2

   Paramètres
   expression1,expression2         Entiers et variables.




                                                                          Dictionnaire ActionScript   59
     Renvoie
     Rien.
     Description
     Opérateur (affectation composée au niveau du bit) ; affecte à expression1 la valeur de
     expression1 ^ expression2. Par exemple, les deux instructions suivantes sont équivalentes :
     x ^= y
     x = x ^ y

     Exemple
     L’exemple suivant illustre une opération ^=.
     // 15 décimal = 1111 binaire
     x = 15;
     // 9 décimal = 1001 binaire
     y = 9;
     trace(x ^= y);
     // renvoie 6 décimal ( = 0110 binaire)

     Voir aussi
     ^ (XOR au niveau du bit)

{} (initialisateur d’objet)
     Disponibilité
     Flash Player 5.
     Usage
     objet = {nom1: valeur1, nom2: valeur2,...nomN: valeurN};

     Paramètres
     objet   L’objet à créer.
     nom1,2,...N       Le nom des propriétés.
     valeur1,2,...N       La valeur correspondante pour chaque propriété nom.
     Renvoie
     Rien.
     Description
     Opérateur ; crée un objet et l’initialise avec les paires de propriétés nom et valeur spécifiées.
     L’utilisation de cet opérateur est identique à l’utilisation de la syntaxe new Object et la
     distribution des paires de propriétés avec l’opérateur d’affectation. Le prototype de l’objet
     nouvellement créé est nommé de façon générique Object.
     Exemple
     La première ligne du code suivant crée un objet vide à l’aide de l’opérateur initialisateur d’objet, la
     seconde ligne créant un nouvel objet avec une fonction constructeur.
     objet = {};
     objet = new Object();




60
   L’exemple suivant crée un objet compte et initialise les propriétés nom, adresse, ville, pays,
   codePostal et solde avec les valeurs associées.
   compte = { nom: "Toi",
     adresse: "123 rue Grande",
     ville: "Une ville",
     pays: "France",
     codePostal: "12345",
     solde: "1000" };
   L’exemple suivant illustre l’imbrication d’initialisateurs d’objet et de tableau les uns dans les
   autres.
   personne = { nom: "Gina Vechio",
     enfants: [ "Ruby", "Chickie", "Puppa"] };
   L’exemple suivant utilise les informations de l’exemple précédent et produit le même résultat avec
   des fonctions constructeur.
   personne = new Personne();
   personne.nom = 'Gina Vechio';
   personne.enfants = new Array();
   personne.enfants[0] = 'Ruby';
   personne.enfants[1] = 'Chickie';
   personne.enfants[2] = 'Puppa';

   Voir aussi
   [] (accès tableau), new,      Object (objet)

| (OR au niveau du bit)
   Disponibilité
   Flash Player 5.
   Usage
   expression1 | expression2

   Paramètres
   expression1,expression2          Un nombre.
   Renvoie
   Rien.
   Description
   Opérateur (au niveau du bit) ; convertit expression1 et expression2 en entiers 32 bits non
   signés et renvoie un 1 à chaque position de bit où les bits correspondants de expression1 ou de
   expression2 sont 1.

   Exemple
   L’exemple suivant illustre une opération OR au niveau du bit.
   // 15 décimal = 1111 binaire
   x = 15;
   // 9 décimal = 1001 binaire
   y = 9;
   trace(x | y);
   // 1111 | 0011 = 1111
   // renvoie 15 décimal (= 1111 binaire)




                                                                            Dictionnaire ActionScript   61
|| (OR logique)
     Disponibilité
     Flash Player 4.
     Usage
     expression1 || expression2

     Paramètres
     expression1,expression2          Une valeur booléenne ou une expression convertie en valeur
     booléenne.
     Renvoie
     Rien.
     Description
     Opérateur (logique) ; évalue expression1 et expression2. Le résultat est true si une des deux
     ou les deux expressions sont true. Le résultat est false seulement si les deux expressions sont
     false. Vous pouvez utiliser l’opérateur logique OR avec n’importe quel nombre d’opérandes ; si
     un opérande est évalué comme true, le résultat est true.
     Avec des expressions non booléennes, l’opérateur logique OR oblige Flash à évaluer l’expression
     de gauche ; si elle peut être convertie en true, le résultat est true. Sinon, il évalue l’expression de
     droite et le résultat est la valeur de cette expression.
     Exemple
     L’exemple suivant utilise l’opérateur || dans une instruction if. La deuxième expression est
     true, le résultat final étant donc true :
     x = 10
     y = 250
     start = false
     if(x > 25 || y > 200 || start){
       trace('le test de OR logique a réussi);
     }

     Exemple
     Cet exemple illustre la façon dont une expression non booléenne peut produire un résultat
     inattendu. Si l’expression de gauche est convertie en true, ce résultat est renvoyé sans convertir
     l’expression de droite.
     function fx1(){
       trace ("fx1 appelé");
       returns true;
     }
     function fx2(){
       trace ("fx2 appelé");
       return true;
     }
     if (fx1() || fx2()){
       trace ("instruction IF entrée");
     }
     // Le résultat suivant est affiché dans la fenêtre Sortie :
     // fx1 appelé
     // instruction IF entrée




62
|= (affectation OR au niveau du bit)
   Disponibilité
   Flash Player 5.
   Usage
   expression1 |= expression2

   Paramètres
   expression1,expression2         Un nombre ou une variable.
   Renvoie
   Rien.
   Description
   Opérateur (affectation composée au niveau du bit) ; affecte à expression1 la valeur de
   expression1 | expression2. Par exemple, les deux instructions suivantes sont équivalentes :
   x |= y;
   x = x | y;

   Exemple
   L’exemple suivant utilise l’opérateur |= :
   // 15 décimal = 1111 binaire
   x = 15;
   // 9 décimal = 1001 binaire
   y = 9;
   trace(x |= y);
   // 1111 |= 1001
   // renvoie 15 décimal (= 1111 binaire)

   Voir aussi
   | (OR au niveau du bit)

~ (NOT au niveau du bit)
   Disponibilité
   Flash Player 5.
   Usage
   ~ expression

   Paramètres
   expression        Un nombre.
   Renvoie
   Rien.
   Description
   Opérateur (au niveau du bit) ; convertit l’expression en entier 32 bits non signé, puis inverse les
   bits. Une opération NOT au niveau du bit change le signe d’un nombre et soustrait 1.




                                                                         Dictionnaire ActionScript   63
     Exemple
     L’exemple suivant illustre une opération NOT au niveau du bit effectuée sur une variable.
     a = 0;
     trace ("lorsque a      = 0, ~a = "+~a);
     // lorsque a = 0,      ~a = -1
     a = 1;
     trace ("lorsque a      = 1, ~a = "+~a);
     // lorsque a = 0,      ~a = -2
     // donc, ~0=-1 et      ~1=-2

+ (addition)
     Disponibilité
     Flash Player 4 ; Flash Player 5. Dans Flash 5, + est un opérateur numérique ou un concaténateur
     de chaînes, selon le type de données du paramètre. Dans Flash 4, + est seulement un opérateur
     numérique. Les fichiers Flash 4 importés dans l’environnement de programmation de Flash 5
     subissent un processus de conversion visant à préserver l’intégrité des types de données. L’exemple
     suivant illustre la conversion d’un fichier Flash 4 contenant une comparaison de qualité
     numérique :
     Fichier Flash 4 :
     x + y
     Fichier Flash 5 converti :
     Number(x) + Number(y)

     Usage
     expression1 + expression2

     Paramètres
     expression1,expression2         Un nombre ou une chaîne.
     Renvoie
     Rien.
     Description
     Opérateur ; additionne des expressions numériques ou concatène (combine) des chaînes. Si une
     expression est une chaîne, toutes les autres expressions sont converties en chaînes et concaténées.
     Si les deux expressions sont des entiers, la somme est un entier ; si une des deux ou les deux
     expressions sont des nombres à virgule flottante, la somme est un nombre à virgule flottante.
     Exemple
     L’exemple suivant concatène deux chaînes et affiche le résultat dans la fenêtre Sortie.
     nom = "Cola";
     instrument = "percussions";
     trace (nom + " joue des " + instrument);




64
   Exemple
   Les variables associées à des champs de texte dynamique et de saisie ont le type de données String.
   Dans l’exemple suivant, la variable dépôt est un champ de texte de saisie sur la scène. Une fois
   qu’un utilisateur a entré un montant de dépôt, le script essaie d’ajouter dépôt à ancienSolde.
   Cependant, étant donné que dépôt est du type de données String, le script concatène (combine
   pour former une seule chaîne) les valeurs des variables plutôt que de les additionner.
   ancienSolde = 1345.23;
   soldeActuel = dépôt + ancienSolde;
   trace (soldeActuel);
   Par exemple, si l’utilisateur entre 475 dans le champ de texte de dépôt, l’action trace envoie la
   valeur 4751345.23 à la fenêtre Sortie.
   Pour corriger cela, utilisez la fonction Number pour convertir la chaîne en un nombre, comme
   dans l’exemple suivant :
   soldeActuel = Number(dépôt) + ancienSolde;

   Exemple
   Cette instruction additionne les entiers 2 et 3 et affiche ensuite le résultat, l’entier 5, dans la
   fenêtre Sortie :
   trace (2 + 3);
   Cette instruction additionne les nombres à virgule flottante 2.5 et 3.25 et affiche le résultat, 5.75,
   un nombre à virgule flottante, dans la fenêtre Sortie :
   trace (2.5 + 3.25);

   Voir aussi
   add

+= (affectation d’addition)
   Disponibilité
   Flash Player 4.
   Usage
   expression1 += expression2

   Paramètres
   expression1,expression2          Un nombre ou une chaîne.
   Renvoie
   Rien.
   Description
   Opérateur (affectation composée arithmétique) ; affecte à expression1 la valeur de
   expression1 + expression2. Par exemple, les deux instructions suivantes produisent le même
   résultat :
   x += y;
   x = x + y;
   Cet opérateur effectue également la concaténation de chaînes. Toutes les règles de l’opérateur
   addition (+) s’appliquent à l’opérateur d’affectation d’addition (+=).




                                                                             Dictionnaire ActionScript   65
     Exemple
     L’exemple suivant illustre une utilisation numérique de l’opérateur +=.
     x = 5;
     y = 10;
     x += y;
     trace(x);
     // x renvoie 15
     Cet exemple utilise l’opérateur += avec une expression chaîne et envoie « Je m’appelle Gilbert » à
     la fenêtre Sortie.
     x = "Je m’appelle "
     x += "Gilbert"
     trace (x)

     Voir aussi
     + (addition)

< (inférieur à)
     Disponibilité
     Flash Player 4 ; Flash Player 5. Dans Flash 5, l’opérateur < (inférieur à) est un opérateur de
     comparaison capable de manipuler divers types de données. Dans Flash 4, < est un opérateur
     numérique. Les fichiers Flash 4 importés dans l’environnement de programmation de Flash 5
     subissent un processus de conversion visant à préserver l’intégrité des types de données. L’exemple
     suivant illustre la conversion d’un fichier Flash 4 contenant une comparaison de qualité
     numérique.
     Fichier Flash 4 :
     x < y
     Fichier Flash 5 converti :
     Number(x) < Number(y)

     Usage
     expression1 < expression2

     Paramètres
     expression1,expression2         Un nombre ou une chaîne.
     Description
     Opérateur (comparaison) ; compare deux expressions et détermine si expression1 est inférieure
     à expression2 ; le cas échéant, renvoie true. Si expression1 est supérieure ou égale à
     expression2, l’opérateur renvoie false. Les expressions chaînes sont évaluées par ordre
     alphabétique ; les majuscules apparaissant avant les minuscules.




66
   Exemple
   Les exemples suivants illustrent les renvois true et false pour des comparaisons numériques et
   chaînes.
   3 < 10;
   // true

   10 < 3;
   // false

   "Allen" < "Jack";
   // true

   "Jack" < "Allen";
   // false

   "11" < "3";
   // true

   "11" < 3;
   // comparaison numérique
   // false

   "C" < "abc";
   // false

   "A" < "a";
   // true

<< (décalage gauche au niveau du bit)
   Disponibilité
   Flash Player 5.
   Usage
   expression1 << expression2

   Paramètres
   expression1       Un nombre ou une expression devant être décalé vers la gauche.
   expression2       Un nombre ou une expression convertis en entier de 0 à 31.
   Renvoie
   Rien.
   Description
   Opérateur (au niveau du bit) ; convertit expression1 et expression2 en entiers 32 bits et décale
   tous les bits de expression1 vers la gauche du nombre de places spécifié par l’entier résultant de
   la conversion de expression2. Les emplacements des bits vidés par cette opération sont remplis
   par des 0. Le décalage d’une valeur vers la gauche de une position revient à la multiplier par deux.
   Exemple
   Dans l’exemple suivant, l’entier 1 est décalé de 10 bits vers la gauche.
   x = 1 << 10




                                                                          Dictionnaire ActionScript   67
     Le résultat de cette opération est x = 1024. Cela est dû au fait que 1 décimal est égal à 1 binaire,
     1 binaire décalé sur la gauche de 10 est 10000000000 binaire, et 10000000000 binaire est 1024
     décimal.
     Dans l’exemple suivant, l’entier 7 est décalé de 8 bits vers la gauche.
     x = 7 << 8
     Le résultat de cette opération est x = 1792. Cela est dû au fait que 7 décimal est égal à 111
     binaire, 111 binaire décalé sur la gauche de 8 bits est 11100000000 binaire, et 11100000000
     binaire est 1792 décimal.
     Voir aussi
     >>= (décalage droit au niveau du bit et affectation), >> (décalage droit au
     niveau du bit), <<= (décalage gauche au niveau du bit et affectation)


<<= (décalage gauche au niveau du bit et affectation)
     Disponibilité
     Flash Player 5.
     Usage
     expression1 <<= expression2

     Paramètres
     expression1         Un nombre ou une expression devant être décalé vers la gauche.
     expression2         Un nombre ou une expression convertis en entier de 0 à 31.
     Renvoie
     Rien.
     Description
     Opérateur (affectation composée au niveau du bit) ; cet opérateur effectue une opération de
     décalage gauche au niveau du bit et stocke le contenu comme résultat dans expression1. Les
     deux expressions suivantes sont équivalentes.
     A <<= B
     A = (A << B)

     Voir aussi
     << (décalage gauche au niveau du bit), >>= (décalage droit au niveau du bit et
     affectation), >> (décalage droit au niveau du bit)


<= (inférieur ou égal à)
     Disponibilité
     Flash Player 4.
     Fichier Flash 4 :
     x <= y
     Fichier Flash 5 converti :
     Number(x) <= Number(y)




68
Usage
expression1 <= expression2

Paramètres
expression1,expression2        Un nombre ou une chaîne.
Renvoie
Rien.
Description
Opérateur (comparaison) ; compare deux expressions et détermine si expression1 est inférieure
ou égale à expression2 ; le cas échéant, renvoie true. Si expression1 est supérieure à
expression2, l’opérateur renvoie false. Les expressions chaînes sont évaluées par ordre
alphabétique ; les majuscules apparaissant avant les minuscules.
Dans Flash 5, l’opérateur <= est un opérateur de comparaison capable de manipuler divers types
de données. Dans Flash 4, <= est un opérateur numérique. Les fichiers Flash 4 importés dans
l’environnement de programmation de Flash 5 subissent un processus de conversion visant à
préserver l’intégrité des types de données. L’exemple suivant illustre la conversion d’un fichier
Flash 4 contenant une comparaison de qualité numérique.
Exemple
Les exemples suivants illustrent les résultats true et false pour des comparaisons numériques et
chaînes :
5 <= 10;
// true

2 <= 2;
// true

10 <= 3;
// false

"Allen" <= "Jack";
// true

"Jack" <= "Allen";
// false

"11" <= "3";
// true

"11" <= 3;
// comparaison numérique
// false

"C" <= "abc";
// false

"A" <= "a";
// true




                                                                     Dictionnaire ActionScript   69
<> (inégalité)
     Disponibilité
     Flash 2.
     Usage
     expression1 <> expression2

     Paramètres
     expression1,expression2        Un nombre, une chaîne, une valeur booléenne, une variable, un
     objet, un tableau ou une fonction.
     Renvoie
     Rien.
     Description
     Opérateur (inégalité) ; teste l’opposé exact de l’opérateur ==. Si expression1 est égale à
     expression2, le résultat est false. Tout comme pour l’opérateur ==, la définition du terme
     égalité dépend des types de données comparés :
     • Les nombres, les chaînes et les valeurs booléennes sont comparés par valeur.
     • Les variables, les objets, les tableaux et les fonctions sont comparés par référence.
     Cet opérateur est déconseillé dans Flash 5 et nous recommandons l’opérateur !=.
     Voir aussi
     != (inégalité)

= (affectation)
     Disponibilité
     Flash Player 4.
     Fichier Flash 4 :
     x = y
     Fichier Flash 5 converti :
     Number(x) == Number(y)

     Usage
     expression1 = expression2

     Paramètres
     expression1       Une variable, un élément d’un tableau ou une propriété d’un objet.
     expression2       Une valeur de tout type.
     Renvoie
     Rien.
     Description
     Opérateur ; affecte le type de expression2 (le paramètre de droite) à la variable, à l’élément de
     tableau ou à la propriété dans expression1.




70
   Dans Flash 5, = est un opérateur d’affectation et l’opérateur == est utilisé pour évaluer une égalité.
   Dans Flash 4, = est un opérateur d’égalité numérique. Les fichiers Flash 4 importés dans
   l’environnement de programmation de Flash 5 subissent un processus de conversion visant à
   préserver l’intégrité des types de données.
   Exemple
   L’exemple suivant utilise l’opérateur d’affectation pour affecter le type de données Number à la
   variable x.
   x = 5
   L’exemple suivant utilise l’opérateur d’affectation pour affecter le type de données String à la
   variable x.
   x = "Bonjour"

   Voir aussi
   == (égalité)

-= (affectation de soustraction)
   Disponibilité
   Flash Player 4.
   Usage
   expression1 -= expression2

   Paramètres
   expression1,expression2          Un nombre ou une expression évalué comme nombre.
   Renvoie
   Rien.
   Description
   Opérateur (affectation composée arithmétique) ; affecte à expression1 la valeur de
   expression1 - expression2. Par exemple, les deux instructions suivantes sont équivalentes :
   x -= y;
   x = x - y;
   Les expressions chaînes doivent être converties en nombres, sinon NaN est renvoyé.
   Exemple
   L’exemple suivant utilise l’opérateur -= pour soustraire 10 de 5 et affecter le résultat à la variable x.
   x = 5;
   y = 10;
   x -= y
   trace(x);
   // renvoie -5

   Exemple
   L’exemple suivant montre comment des chaînes sont converties en nombres.
   x = "5";
   y = "10";
   x -= y;
   trace(x);
   // renvoie -5



                                                                             Dictionnaire ActionScript   71
== (égalité)
     Disponibilité
     Flash Player 5.
     Usage
     expression1 == expression2

     Paramètres
     expression1,expression2        Un nombre, une chaîne, une valeur booléenne, une variable, un
     objet, un tableau ou une fonction.
     Renvoie
     Rien.
     Description
     Opérateur (égalité) ; teste l’égalité de deux expressions. Le résultat est true si les deux expressions
     sont égales.
     La définition du terme égalité dépend du type de données du paramètre :
     • Les nombres et les valeurs booléennes sont comparés par valeur et sont considérés égaux s’ils
       possèdent les mêmes valeurs.
     • Les expressions chaînes sont égales si elles possèdent le même nombre de caractères
       (identiques).
     • Les variables, les objets, les tableaux et les fonctions sont comparés par référence. Deux
       variables sont égales si elles font référence au même objet ou tableau ou à la même fonction.
       Deux tableaux distincts ne sont jamais considérés égaux, même s’ils comportent le même
       nombre d’éléments.
     Exemple
     L’exemple suivant utilise l’opérateur == avec une instruction if :
     a = "David" , b = "David";
     if (a == b){
       trace("David est David");
     }

     Exemple
     Ces exemples montrent les résultats d’opérations qui comparent des types différents.
     x = "5"; y = "5";
     trace (x == y);
     // true

     x = "5"; y = "66";
     trace (x == y);
     // false

     x = "chris"; y = "steve";
     trace (x == y);
     // false

     Voir aussi

     != (inégalité), === (égalité stricte), !== (inégalité stricte)




72
=== (égalité stricte)
    Disponibilité
    Flash Player 6.
    Usage
    expression1 === expression2

    Description
    Opérateur ; teste l’égalité de deux expressions – l’opérateur d’égalité stricte fonctionne de la même
    façon que l’opérateur d’égalité, à ceci près que les types de données ne sont pas convertis. Le
    résultat est true si les deux expressions, y compris leurs types de données, sont égales.
    La définition du terme égalité dépend du type de données du paramètre :
    • Les nombres et les valeurs booléennes sont comparés par valeur et sont considérés égaux s’ils
         possèdent les mêmes valeurs.
    • Les expressions chaînes sont égales si elles possèdent le même nombre de caractères
         (identiques).
    • Les variables, les objets, les tableaux et les fonctions sont comparés par référence. Deux
         variables sont égales si elles font référence au même objet ou tableau ou à la même fonction.
         Deux tableaux distincts ne sont jamais considérés égaux, même s’ils comportent le même
         nombre d’éléments.
    Exemple
    Le code suivant affiche la valeur renvoyée par les opérations utilisant les opérateurs d’égalité,
    d’égalité stricte et d’inégalité stricte.
    s1 = new String("5");
    s2 = new String("5");
    s3 = new String("Bonjour");
    n = new Number(5);
    b = new Boolean(true);

    s1   ==    s2; // true
    s1   ==    s3; // false
    s1   ==    n; // true
    s1   ==    b; // false

    s1   ===    s2; // true
    s1   ===    s3; // false
    s1   ===    n; // false
    s1   ===    b; // false

    s1   !==    s2; // false
    s1   !==    s3; // true
    s1   !==    n; // true
    s1   !==    b; // true

    Voir aussi
    == (égalité), != (inégalité), === (égalité stricte)




                                                                            Dictionnaire ActionScript   73
> (supérieur à)
     Disponibilité
     Flash Player 5.
     Usage
     expression1 > expression2

     Paramètres
     expression1,expression2        Un entier, un nombre à virgule flottante ou une chaîne.
     Renvoie
     Rien.
     Description
     Opérateur (comparaison) ; compare deux expressions et détermine si expression1 est supérieure
     à expression2 (true) ou si expression1 est inférieure ou égale à expression2 (false).

>= (supérieur ou égal à)
     Disponibilité
     Flash Player 4.
     Fichier Flash 4 :
     x >= y
     Fichier Flash 5 converti :
     Number(x) >= Number(y)

     Usage
     expression1 >= expression2

     Paramètres
     expression1, expression2        Une chaîne, un entier ou un nombre à virgule flottante.
     Renvoie
     Rien.
     Description
     Opérateur (comparaison) ; compare deux expressions et détermine si expression1 est supérieure
     ou égale à expression2 (true) ou si expression1 est inférieure à expression2 (false).
     Dans Flash 5, l’opérateur > est un opérateur de comparaison capable de manipuler divers types de
     données. Dans Flash 4, > est un opérateur numérique. Les fichiers Flash 4 importés dans
     l’environnement de programmation de Flash 5 subissent un processus de conversion visant à
     préserver l’intégrité des types de données.




74
>> (décalage droit au niveau du bit)
   Disponibilité
   Flash Player 5.
   Usage
   expression1 >> expression2

   Paramètres
   expression1       Un nombre ou une expression devant être décalé vers la droite.
   expression2       Un nombre ou une expression convertis en entier de 0 à 31.
   Renvoie
   Rien.
   Description
   Opérateur (au niveau du bit) ; convertit expression1 et expression2 en entiers 32 bits et décale
   tous les bits de expression1 vers la droite du nombre de places spécifié par l’entier résultant de la
   conversion de expression2. Les bits décalés vers la droite sont éliminés. Pour préserver le signe
   de l’expression d’origine, les bits de gauche sont remplis de 0 si le bit le plus significatif (le bit le
   plus à gauche) de expression1 est 0 et remplis de 1 si le bit le plus significatif est 1. Le décalage
   d’une valeur à droite d’une position revient à la diviser par 2 et à éliminer le reste.
   Exemple
   L’exemple suivant convertit 65535 en entier de 32 bits et le décale de 8 bits vers la droite.
   x = 65535 >> 8
   Le résultat de l’opération précédente est :
   x = 255
   Ceci est dû au fait que 65535 décimal est égal à 1111111111111111 binaire (seize 1),
   1111111111111111 binaire décalé à droite de 8 bits est 11111111 binaire, et 11111111 binaire
   est 255 décimal. Le bit le plus significatif est 0 car les entiers sont 32 bits, le bit de remplissage
   étant donc 0.
   L’exemple suivant convertit -1 en un entier de 32 bits et le décale de 1 bit vers la droite.
   x = -1 >> 1
   Le résultat de l’opération précédente est :
   x = -1
   Ceci est dû au fait que -1 décimal est égal à 11111111111111111111111111111111 binaire
   (trente-deux 1), le décalage vers la droite de 1 bit fait que le bit le moins significatif (le bit le plus
   à droite) est éliminé et que le bit le plus significatif est rempli de 1. Le résultat est
   11111111111111111111111111111111 (trente-deux 1) binaire, ce qui représente l’entier de 32
   bits -1.
   Voir aussi
   >>= (décalage droit au niveau du bit et affectation)




                                                                              Dictionnaire ActionScript   75
>>= (décalage droit au niveau du bit et affectation)
     Disponibilité
     Flash Player 5.
     Usage
     expression1 = >>expression2

     Paramètres
     expression1       Un nombre ou une expression devant être décalé vers la gauche.
     expression2       Un nombre ou une expression convertis en entier de 0 à 31.
     Renvoie
     Rien.
     Description
     Opérateur (affectation composée au niveau du bit) ; cet opérateur effectue une opération de
     décalage droit au niveau du bit et stocke le contenu comme résultat dans expression1.
     Exemple
     Les deux expressions suivantes sont équivalentes.
     A >>= B
     A = (A >> B)
     Le code commenté suivant utilise l’opérateur (>>=) au niveau du bit. Cet exemple illustre
     également l’utilisation de tous les opérateurs au niveau du bit.
     function convertToBinary(number){
       var result = "";
       for (var i=0; i<32; i++) {
          // extraire le bit le moins significatif avec AND au niveau du bit
          var lsb = number & 1;
          // ajouter ce bit à la chaîne de résultat
          result = (lsb ? "1" : "0") + result;
          // décaler le nombre de un bit vers la droite, pour voir le bit suivant
          number >>= 1;}
       return result;
     }
     trace(convertToBinary(479));
     // renvoie la chaîne 00000000000000000000000111011111
     // la chaîne ci-dessus est une représentation binaire
     // du décimal 479

     Voir aussi
     << (décalage gauche au niveau du bit)




76
>>> (décalage droit non signé au niveau du bit)
   Disponibilité
   Flash Player 5.
   Usage
   expression1 >>> expression2

   Paramètres
   expression1       Un nombre ou une expression devant être décalé vers la droite.
   expression2       Un nombre ou une expression convertis en entier de 0 à 31.
   Renvoie
   Rien.
   Description
   Opérateur (au niveau du bit) ; identique à l’opérateur de décalage droit au niveau du bit (>>)
   excepté qu’il ne conserve pas le signe de l’expression d’origine car les bits de gauche sont
   toujours remplis avec des 0.
   Exemple
   L’exemple suivant convertit -1 en un entier de 32 bits et le décale de 1 bit vers la droite.
   x = -1 >>> 1
   Le résultat de l’opération précédente est :
   x = 2147483647
   Cela est dû au fait que -1 décimal est 11111111111111111111111111111111 binaire (trente-
   deux 1) et, quand vous le décalez vers la droite (non signé) de 1 bit, le bit le moins significatif (le
   plus à droite) est éliminé et le bit le plus significatif (le plus à gauche) est rempli avec un 0. Le
   résultat est 01111111111111111111111111111111 binaire, qui représente l’entier de 32 bits
   2147483647.
   Voir aussi
   >>= (décalage droit au niveau du bit et affectation)

>>>= (décalage droit non signé au niveau du bit et affectation)
   Disponibilité
   Flash Player 5.
   Usage
   expression1 >>>= expression2

   Paramètres
   expression1       Un nombre ou une expression devant être décalé vers la gauche.
   expression2       Un nombre ou une expression convertis en entier de 0 à 31.
   Renvoie
   Rien.




                                                                            Dictionnaire ActionScript   77
     Description
     Opérateur (affectation composée au niveau du bit) ; effectue une opération de décalage vers la
     droite au niveau du bit non signé et stocke le contenu comme résultat dans expression1. Les
     deux expressions suivantes sont équivalentes :
     A >>>= B
     A = (A >>> B)

     Voir aussi
     >>> (décalage droit non signé au niveau du bit), >>= (décalage droit au niveau
     du bit et affectation)


Accessibility (objet)
     L’objet Accessibility est une collection de méthodes que vous pouvez utiliser pour créer du
     contenu accessible avec ActionScript. Dans Flash MX, il n’existe qu’une méthode.
     Cet objet est disponible dans Flash Player 6.

Méthodes de l’objet Accessibility

     Propriété                                        Description

     Accessibility.isActive                           Indique si un programme de lecture d’écran est actif.


Accessibility.isActive
     Disponibilité
     Flash Player 6.
     Usage
     Accessibility.isActive()
     Paramètres
     Aucun.
     Renvoie
     Une valeur booléenne.
     Description
     Méthode ; indique si un programme de lecture d’écran est actuellement actif ou non. Utilisez
     cette méthode lorsque vous voulez que votre animation se comporte différemment en présence
     d’un lecteur d’écran.
     Voir aussi
     System.capabilities.hasAccessibility




78
add
  Disponibilité
  Flash Player 4.
  Usage
  chaîne1 add chaîne2

  Paramètres
  chaîne1, chaîne2       Une chaîne.
  Renvoie
  Rien.
  Description
  Opérateur ; concatène (combine) deux ou plusieurs chaînes. L’opérateur add remplace l’opérateur
  addition (&) de Flash 4. Les fichiers Flash 4 utilisant l’opérateur & sont automatiquement
  convertis pour utiliser l’opérateur add pour la concaténation de chaînes lorsqu’ils sont importés
  dans l’environnement de programmation de Flash 5. Cependant, l’opérateur add est déconseillé
  dans Flash 5, et l’emploi de l’opérateur + est recommandé lors de la création de contenu pour
  Flash Player 5 ou Flash Player 6. Utilisez l’opérateur add pour concaténer des chaînes si vous créez
  du contenu pour Flash Player 4 ou des versions antérieures du lecteur.
  Voir aussi
  + (addition)

and
  Disponibilité
  Flash Player 4.
  Usage
  condition1 and condition2

  Paramètres
  condition1,condition2        Conditions ou expressions qui équivalent à true ou false.
  Renvoie
  Rien.
  Description
  Opérateur ; effectue une opération AND logique dans Flash 4 Player. Si les deux expressions sont
  évaluées comme true, l’expression entière est alors true. Cet opérateur est déconseillé dans
  Flash 5 (et ultérieur) et nous recommandons l’opérateur &&.
  Voir aussi
  && (AND court-circuit)




                                                                         Dictionnaire ActionScript   79
arguments (objet)
     L’objet Arguments est un tableau qui contient les valeurs qui ont été transmises comme
     paramètres à une fonction. Un objet Arguments est automatiquement créé à chaque fois qu’une
     fonction est appelée dans ActionScript. Une variable locale, arguments, est également créée et
     vous permet de faire référence à l’objet Arguments.
     L’objet Arguments est disponible dans Flash Player 6.

Propriétés de l’objet Arguments

     Propriété                                          Description

     arguments.callee                                   Fait référence à la fonction appelée.

     arguments.caller                                   Fait référence à la fonction appelante.

     arguments.length                                   Le nombre de paramètres transmis à une fonction.


arguments.callee
     Disponibilité
     Flash Player 5.
     Usage
     arguments.callee
     Description
     Propriété ; fait référence à la fonction qui est actuellement appelée.
     Exemple
     Vous pouvez utiliser la propriété arguments.callee pour créer une fonction anonyme
     récurrente, comme dans l’exemple suivant :
     factorial = function (x) {
        if (x <= 1) {
          return 1;
        } else {
          return x * arguments.callee(x-1);
        }
     };
     L’exemple suivant est une fonction récurrente nommée :
     function factorial (x) {
       if (x <= 1) {
         return 1;
       } else {
         return x * factorial(x-1);
         }
     }




80
arguments.caller
    Disponibilité
    Flash Player 6.
    Usage
    arguments.caller
    Description
    Propriété ; fait référence à l’objet Arguments de la fonction appelante.

arguments.length
    Disponibilité
    Flash Player 6.
    Usage
    arguments.length
    Description
    Propriété ; le nombre de paramètres transmis à une fonction.

Array (objet)
    L’objet Array vous permet d’accéder à des tableaux et de les manipuler. Un tableau est un objet
    dont les propriétés sont identifiées par un nombre représentant leur position dans le tableau. Ce
    nombre est appelé index. Tous les tableaux sont basés sur zéro, ce qui signifie que le premier
    élément du tableau est [0], le second élément est [1], et ainsi de suite. Dans l’exemple suivant,
    monTableau contient les mois de l’année.
    monTableau[0]     =   "janvier"
    monTableau[1]     =   "février"
    monTableau[2]     =   "mars"
    monTableau[3]     =   "avril"
    Pour créer un objet Array, utilisez le constructeur new Array ou l’opérateur d’accès tableau ([]).
    Pour accéder aux éléments d’un tableau, utilisez l’opérateur d’accès tableau ([ ]).
    Dans Flash MX, l’objet Array est devenu un objet natif. Vous pourrez donc constater
    d’importantes améliorations des performances.

Méthodes de l’objet Array

    Méthode               Description

    Array.concat          Concatène les paramètres et les renvoie sous forme de nouveau tableau.

    Array.join            Joint tous les éléments d’un tableau dans une chaîne.

    Array.pop             Supprime le dernier élément d’un tableau et renvoie sa valeur.

    Array.push            Ajoute un ou plusieurs éléments à la fin d’un tableau et renvoie la nouvelle longueur du
                          tableau.

    Array.reverse         Inverse la direction d’un tableau.

    Array.shift           Supprime le premier élément d’un tableau et renvoie sa valeur.

    Array.slice           Extrait une section d’un tableau et la renvoie sous forme de nouveau tableau.




                                                                                   Dictionnaire ActionScript         81
     Méthode               Description

     Array.sort            Trie un tableau en place.

     Array.sortOn          Trie un tableau en fonction d’un champ du tableau.

     Array.splice          Ajoute et/ou retire des éléments d’un tableau.

     Array.toString        Renvoie une valeur de chaîne représentant les éléments dans l’objet Array.

     Array.unshift         Ajoute un ou plusieurs éléments au début d’un tableau et renvoie la nouvelle longueur du
                           tableau.


Propriétés de l’objet Array

     Propriété             Description

     Array.length          Renvoie la longueur du tableau.


Constructeur de l’objet Array
     Disponibilité
     Flash Player 5.
     Usage
     new Array()
     new Array(longueur)
     new Array(élément0, élément1, élément2,...élémentN)

     Paramètres
     longueur Un entier spécifiant le nombre d’éléments dans un tableau. Dans le cas d’éléments
     non contigus, le paramètre longueur spécifie le numéro d’index du dernier élément du tableau
     plus 1.
     élément0...élémentN       Une liste de deux ou plusieurs valeurs arbitraires. Les valeurs peuvent
     être des nombres, des chaînes, des objets ou d’autres tableaux. Le premier élément d’un tableau a
     toujours un index ou une position de 0.
     Renvoie
     Rien.
     Description
     Constructeur ; permet de créer un tableau. Vous pouvez utiliser le constructeur pour créer
     différents types de tableaux : un tableau vide, un tableau avec une longueur spécifique, mais dont
     les éléments n’ont pas de valeur, ou un tableau dont les éléments ont des valeurs spécifiques.
     Usage 1. Si vous ne spécifiez aucun paramètre, un tableau de longueur zéro est créé.
     Usage 2. Si vous spécifiez seulement une longueur, un tableau est créé avec le nombre longueur
     d’éléments sans valeur.
     Usage 3. Si vous utilisez les paramètres élément pour spécifier des valeurs, le tableau est créé avec
     des valeurs spécifiques.
     Exemple
     Usage 1. L’exemple suivant crée un nouvel objet Array avec une longueur initiale de 0.
     monTableau = new Array();



82
   Usage 3. L’exemple suivant crée le nouvel objet Array go_gos, avec une longueur initiale de 5.
   go_gos = new Array("Belinda", "Gina", "Kathy", "Charlotte", "Jane");
   trace(go_gos.join(" + "));
   Les éléments initiaux du tableau go_gos sont identifiés comme suit :
   go_gos[0]    =    "Belinda";
   go_gos[1]    =    "Gina";
   go_gos[2]    =    "Kathy";
   go_gos[3]    =    "Charlotte";
   go_gos[4]    =    "Jane";
   Le code suivant ajoute un sixième élément au tableau go-gos et change le premier élément :
   go_gos[5] = "Donna";
   go_gos[1] = "Nina"
   trace(go_gos.join(" + "));

   Voir aussi
   Array.length, [] (accès tableau)


Array.concat
   Disponibilité
   Flash Player 5.
   Usage
   monTableau.concat(valeur0,valeur1,...valeurN)

   Paramètres
   valeur0,...valeurN        Nombres, éléments ou chaînes devant être concaténés dans un nouveau
   tableau.
   Renvoie
   Rien.
   Description
   Méthode ; concatène les éléments spécifiés dans les paramètres, s’il y en a, avec les éléments de
   monTableau, et crée un nouveau tableau. Si les paramètres valeur spécifient un tableau, ce sont
   les éléments de ce tableau qui sont concaténés et non le tableau même. Le tableau monTableau
   reste inchangé.
   Exemple
   Le code suivant concatène deux tableaux.
   alpha = new Array("a","b","c");
   numérique = new Array(1,2,3);
   alphaNumérique=alpha.concat(numérique);
   trace(alphaNumérique);
   // crée le tableau ["a","b","c",1,2,3]
   Le code suivant concatène trois tableaux.
   num1=[1,3,5];
   num2=[2,4,6];
   num3=[7,8,9];
   nums=num1.concat(num2,num3)
   trace(nums);
   // crée le tableau [1,3,5,2,4,6,7,8,9]



                                                                          Dictionnaire ActionScript   83
     Les tableaux imbriqués ne sont pas aplatis de la même façon que les tableaux normaux. Les
     éléments d’un tableau imbriqué ne sont pas divisés en éléments séparés dans le tableau x, comme
     dans l’exemple suivant.
     a = new Array ("a","b","c");
     n = new Array(1, [2, 3], 4);
     // 2 et 3 sont des éléments d’un tableau imbriqué
     x = a.concat(n);
     x[0] = "a"
     x[1] = "b"
     x[2] = "c"
     x[3] = 1
     x[4] = 2, 3
     x[5] = 4

Array.join
     Disponibilité
     Flash Player 5.
     Usage
     monTableau.join([séparateur])

     Paramètres
     séparateur     Un caractère ou une chaîne qui sépare les éléments de tableau dans la chaîne
     renvoyée. Si vous omettez ce paramètre, une virgule est utilisée comme séparateur par défaut.
     Renvoie
     Voir ci-dessous.
     Description
     Méthode ; convertit les éléments d’un tableau en chaînes, insère le séparateur spécifié entre les
     éléments, les concatène, et renvoie la chaîne résultante. Un tableau imbriqué est toujours séparé
     par une virgule, pas par le séparateur transmis à la méthode join.
     Exemple
     L’exemple suivant crée un tableau avec trois éléments. Il joint ensuite le tableau trois fois – en
     utilisant le séparateur par défaut, une virgule et un espace, et un signe plus – et les affiche dans la
     fenêtre Sortie.
     a = new Array("Terre","Lune","Soleil")
     trace(a.join());
     // renvoie Terre, Lune, Soleil
     trace(a.join(" - "));
     // renvoie Terre - Lune - Soleil
     trace(a.join(" + "));
     // renvoie Terre + Lune + Soleil




84
Array.length
   Disponibilité
   Flash Player 5.
   Usage
   monTableau.length

   Description
   Propriété ; contient la longueur du tableau. Cette propriété est automatiquement mise à jour
   lorsque de nouveaux éléments sont ajoutés au tableau. Lorsque vous affectez une valeur à un
   élément de tableau (par exemple, monTableau[index] = valeur), si index est un nombre et
   index+1 est supérieur à la propriété length, la propriété length est mise à jour à index + 1.

   Exemple
   Le code suivant explique la façon dont la propriété length est mise à jour.
   // la longueur initiale est 0
   monTableau = new Array();
   monTableau[0] = 'a';
   // monTableau.length est mise à jour à 1
   monTableau[1] = 'b';
   // monTableau.length est mise à jour à 2
   monTableau[9] = 'c';
   // monTableau.length est mise à jour à 10

Array.pop
   Disponibilité
   Flash Player 5.
   Usage
   monTableau.pop()

   Paramètres
   Aucun.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; supprime le dernier élément d’un tableau et renvoie la valeur de cet élément.
   Exemple
   Le code suivant crée le tableau mesAnimaux contenant quatre éléments et supprime le dernier
   élément.
   mesAnimaux = ["chat", "chien", "oiseau", "poisson"];
   popped = mesAnimaux.pop();
   trace(popped);
   // renvoie poisson




                                                                        Dictionnaire ActionScript   85
Array.push
     Disponibilité
     Flash Player 5.
     Usage
     monTableau.push(valeur,...)

     Paramètres
     valeur    Une ou plusieurs valeurs à ajouter au tableau.
     Renvoie
     La longueur du nouveau tableau.
     Description
     Méthode ; ajoute un ou plusieurs éléments à la fin du tableau et renvoie la nouvelle longueur du
     tableau.
     Exemple
     L’exemple suivant crée le tableau mesAnimaux contenant deux éléments, chat et chien. La
     deuxième ligne ajoute deux éléments au tableau. Après l’appel de la méthode push, la variable
     pushed contient quatre éléments. La méthode push renvoyant la nouvelle longueur du tableau,
     l’action trace de la dernière ligne envoie la nouvelle longueur de mesAnimaux (4) à la fenêtre
     Sortie :
     mesAnimaux = ["chat", "chien"];
     pushed = mesAnimaux.push("oiseau", "poisson");
     trace(pushed);

Array.reverse
     Disponibilité
     Flash Player 5.
     Usage
     monTableau.reverse()

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Méthode ; inverse le tableau en place.




86
   Exemple
   L’exemple suivant utilise la méthode Array.reverse.
   var numbers = [1, 2, 3, 4, 5, 6];
   trace(numbers.join());
   numbers.reverse();
   trace(numbers.join());
   Résultat :
   1,2,3,4,5,6
   6,5,4,3,2,1

Array.shift
   Disponibilité
   Flash Player 5.
   Usage
   monTableau.shift()

   Paramètres
   Aucun.
   Renvoie
   Le premier élément d’un tableau.
   Description
   Méthode ; supprime le premier élément d’un tableau et renvoie sa valeur.
   Exemple
   Le code suivant crée le tableau mesAnimaux puis supprime le premier élément du tableau et
   l’affecte à la variable shifted.
   mesAnimaux = ["chat", "chien", "oiseau", "poisson"];
   shifted = mesAnimaux.shift();
   trace(shifted);
   // renvoie chat

   Voir aussi
   Array.pop

Array.slice
   Disponibilité
   Flash Player 5.
   Usage
   monTableau.slice(début, fin)

   Paramètres
   début     Un nombre spécifiant l’index du point de début de la section. Si début est un nombre
   négatif, le point de début commence à la fin du tableau, où -1 est le dernier élément.
   fin    Un nombre spécifiant l’index du point de fin de la section. Si vous omettez ce paramètre, la
   section comprend tous les éléments du début à la fin du tableau. Si fin est un nombre négatif, le
   point de fin est spécifié depuis la fin du tableau, où -1 est le dernier élément.



                                                                         Dictionnaire ActionScript   87
     Renvoie
     Voir ci-dessous.
     Description
     Méthode ; extrait une section ou une sous-chaîne du tableau et la renvoie sous forme de nouveau
     tableau sans modifier le tableau original. Le tableau renvoyé comprend l’élément début et tous les
     éléments jusqu’à l’élément fin (exclu).

Array.sort
     Disponibilité
     Flash Player 5.
     Usage
     monTableau.sort([fonctionDeComparaison])

     Paramètres
     fonctionDeComparaison Une fonction de comparaison facultative utilisée pour déterminer
     l’ordre de tri des éléments d’un tableau. Pour des éléments A et B donnés, le paramètre
     fonctionDeComparaison peut avoir l’une des trois valeurs suivantes :

     • -1 si A apparaît avant B dans la séquence triée
     • 0 si A = B
     • 1 si A apparaît après B dans la séquence triée
     Renvoie
     Rien.
     Description
     Méthode ; trie le tableau en place sans en faire de copie. Si vous omettez le paramètre
     fonctionDeComparaison, Flash trie les éléments en place avec l’opérateur de comparaison <.

     Exemple
     L’exemple suivant utilise Array.sort sans spécifier le paramètre fonctionDeComparaison :
     var fruits = ["oranges", "pommes", "fraises", "ananas", "cerises"];
     trace(fruits.join());
     fruits.sort();
     trace(fruits.join());

     Résultat :
     oranges,pommes,fraises,ananas,cerises
     displays pommes,cerises,oranges,ananas,fraises




88
   L’exemple suivant utilise Array.sort avec une fonction de tri spécifiée.
   var motsDePasse = [
       "gary:machin",
       "mike:chose",
       "john:snafu",
       "steve:yuck",
       "daniel:1234"
    ];
    function order (a, b) {
       // entrées du formulaire à trier
       // nom:motDePasse
       // trier avec uniquement la partie nom
       // de l’entrée comme clé.
       var nom1 = a.split(':')[0];
       var nom2 = b.split(':')[0];
       if (nom1 < nom2) {
         return -1;
       } else if (nom1 > nom2) {
         return 1;
       } else {
         return 0;
       }
    }
    for (var i=0; i< motDePasse.length; i++) {
       trace (motsDePasse.join());
    }
    motsDePasse.sort(order);
    trace ("Trié :");
    for (var i=0; i< motDePasse.length; i++) {
       trace (motsDePasse.join());
    }
   L’exécution du script précédent affiche les résultats suivants dans la fenêtre Sortie.
   daniel:1234
   gary:machin
   john:snafu
   mike:chose
   steve:yuck

Array.sortOn
   Disponibilité
   Flash Player 6.
   Usage
   Array.sortOn(nomDeChamp)

   Paramètres
   nomDeChamp        Une chaîne qui identifie un champ dans un élément du tableau à utiliser comme
   valeur de tri.
   Renvoie
   Rien.
   Description
   Méthode ; trie les éléments d’un tableau en fonction d’un champ du tableau. Si aucun paramètre
   nomDeChamp n’est transmis, la fonction échoue. Si plusieurs paramètres nomDeChamp sont
   transmis, le premier champ est converti en une valeur chaîne et les autres paramètres sont ignorés.


                                                                           Dictionnaire ActionScript   89
     Si l’un des éléments comparés ne contient pas le champ spécifié dans le paramètre nomDeChamp, le
     tri s’effectue par défaut selon le comportement de la méthode Array.sort.
     Exemple
     L’exemple suivant crée un tableau et le trie en fonction du champ ville :
     var monTableau = new Array();
     monTableau.push( { nom: "bob", ville: "omaha", codePostal: 68144 } );
     monTableau.push( { nom: "greg", ville: "kansas city", codePostal: 72345 } );
     monTableau.push( { nom: "chris", ville: "burlingame", codePostal: 94010 } );
     monTableau.sortOn("ville");
     // a le résultat suivant :
     monTableau[0] = nom: "chris", ville: "burlingame", codePostal: 94010
     monTableau[1] = nom: "greg", ville: "kansas city", codePostal: 72345
     monTableau[2] = nom: "bob", ville: "omaha", codePostal: 68144

     Voir aussi
     Array.sort

Array.splice
     Disponibilité
     Flash Player 5.
     Usage
     monTableau.splice(début, nombreAsupprimer, valeur0,valeur1...valeurN)

     Paramètres
     début L’index de l’élément du tableau à partir duquel commencent l’insertion et/ou la
     suppression.
     nombreAsupprimer       Le nombre d’éléments à supprimer. Ce nombre comprend l’élément
     spécifié dans le paramètre début. Si aucune valeur n’est spécifiée pour nombreAsupprimer, la
     méthode supprime toutes les valeurs en commençant par l’élément début jusqu’au dernier
     élément du tableau. Si la valeur est 0, aucun élément n’est supprimé.
     valeur Zéro ou plusieurs valeurs à insérer dans le tableau au point d’insertion spécifié dans le
     paramètre début. Ce paramètre est facultatif.
     Renvoie
     Rien.
     Description
     Méthode ; ajoute et supprime des éléments d’un tableau. Cette méthode modifie le tableau sans
     en faire de copie.

Array.toString
     Disponibilité
     Flash Player 5.
     Usage
     monTableau.toString()

     Paramètres
     Aucun.


90
   Renvoie
   Une chaîne.
   Description
   Méthode ; renvoie une valeur chaîne représentant les éléments de l’objet Array spécifié. Chaque
   élément du tableau, à compter de l’index 0 et jusqu’à l’index monTableau.length-1, est converti
   en chaîne concaténée séparée par des virgules.
   Exemple
   L’exemple suivant crée monTableau, le convertit en une chaîne et affiche 1,2,3,4,5 dans la fenêtre
   Sortie.
   monTableau = new Array();
   monTableau[0] = 1;
   monTableau[1] = 2;
   monTableau[2] = 3;
   monTableau[3] = 4;
   monTableau[4] = 5;
   trace(monTableau.toString());

Array.unshift
   Disponibilité
   Flash Player 5.
   Usage
   monTableau.unshift(valeur1,valeur2,...valeurN)

   Paramètres
   valeur1,...valeurN        Un ou plusieurs nombres, éléments ou variables devant être insérés au
   début du tableau.
   Renvoie
   La nouvelle longueur du tableau.
   Description
   Méthode ; ajoute un ou plusieurs éléments au début d’un tableau et renvoie la nouvelle longueur
   du tableau.

asfunction
   Disponibilité
   Flash Player 5.
   Usage
   asfunction:fonction,"paramètre"

   Paramètres
   fonction      Un identifiant pour une fonction.
   paramètre       Une chaîne qui est transmise à la fonction nommée dans le paramètre fonction.
   Renvoie
   Rien.



                                                                        Dictionnaire ActionScript   91
     Description
     Protocole ; un protocole spécial pour les adresses URL dans les champs de texte HTML. Dans les
     champs de texte HTML, un hyperlien peut être créé avec la balise HTML A. L’attribut HREF de
     la balise A contient une URL qui peut être pour un protocole standard comme HTTP, HTTPS
     ou FTP. Le protocole asfunction est un protocole supplémentaire spécifique à Flash, selon
     lequel le lien invoque une fonction ActionScript.
     Exemple
     Dans cet exemple, la fonction maFonc est définie dans les trois premières lignes de code. La
     variable monChampDeTexte est associée à un champ de texte HTML. Le texte « Cliquez-moi ! » est
     un hyperlien à l’intérieur du champ de texte. La fonction maFonc est appelée lorsque l’utilisateur
     clique sur l’hyperlien :
     function maFonc(param){
     trace ("Vous m’avez cliqué ! Le paramètre était "+param);
     }
     monChampDeTexte.text ="<A HREF=\"asfunction:maFonc,unParam \">Cliquez-moi !</
       A>";
     Lorsque l’hyperlien est activé, le résultat suivant est affiché dans la fenêtre Sortie :
     Vous m’avez cliqué ! Le paramètre était unParam

Boolean (fonction)
     Disponibilité
     Flash Player 5.
     Usage
     Boolean(expression)

     Paramètres
     expression        Une expression à convertir en valeur booléenne.
     Renvoie
     Rien.
     Description
     Fonction ; convertit le paramètre expression en valeur booléenne et renvoie une valeur comme
     suit :
     • 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 n’est pas zéro ; sinon,
        la valeur renvoyée est false.
     • Si expression est une chaîne, la méthode toNumber est appelée et la valeur renvoyée est true
        si le nombre n’est pas zéro ; sinon, la valeur renvoyée est false.
     • Si expression est undefined, la valeur renvoyée est false.
     • Si expression est un clip ou un objet, la valeur renvoyée est true.




92
Boolean (objet)
    L’objet Boolean est un objet enveloppe ayant la même fonctionnalité que l’objet Boolean
    standard de JavaScript. Utilisez l’objet Boolean pour récupérer le type de données primitif ou la
    représentation chaîne d’un objet Boolean. Dans Flash MX, l’objet Boolean est devenu un objet
    natif. Vous pourrez donc constater d’importantes améliorations des performances.
    Vous devez utiliser le constructeur new Boolean() pour créer une occurrence de l’objet Boolean
    avant d’en appeler les méthodes.

Méthodes de l’objet Boolean

    Méthode                 Description

    Boolean.toString        Renvoie la représentation chaîne (true) ou (false) de l’objet Boolean.

    Boolean.valueOf         Renvoie le type de valeur primitif de l’objet Boolean spécifié.


Constructeur de l’objet Boolean
    Disponibilité
    Flash Player 5.
    Usage
    new Boolean([x])

    Paramètres
    x   Toute expression. Ce paramètre est facultatif.
    Renvoie
    Voir ci-dessous.
    Description
    Constructeur ; crée une occurrence de l’objet Boolean. Si vous omettez le paramètre x, l’objet
    Boolean est initialisé avec la valeur false. Si vous spécifiez une valeur pour le paramètre x, la
    méthode l’évalue et renvoie le résultat sous forme de valeur booléenne selon les règles de la
    fonction Boolean (fonction).
    Remarque Pour préserver la compatibilité avec Flash Player 4, le traitement des chaînes avec l’objet Boolean
    n’est pas à la norme ECMA-262.

    Exemple
    Le code suivant crée un objet booléen vide appelé maValeurBooléenne.
    maValeurBooléenne = new Boolean();

Boolean.toString
    Disponibilité
    Flash Player 5.
    Usage
    maValeurBooléenne.toString()

    Paramètres
    Aucun.


                                                                                      Dictionnaire ActionScript    93
     Renvoie
     Voir ci-dessous.
     Description
     Méthode ; renvoie la représentation chaîne, true ou false, de l’objet Boolean.

Boolean.valueOf
     Disponibilité
     Flash Player 5.
     Usage
     Boolean.valueOf()

     Paramètres
     Aucun.
     Renvoie
     Voir ci-dessous.
     Description
     Méthode ; renvoie le type de valeur primitif de l’objet Boolean spécifié.

break
     Disponibilité
     Flash Player 4.
     Usage
     break

     Paramètres
     Aucun.
     Renvoie
     Rien.
     Description
     Action ; apparaît dans une boucle (for, for..in, do while ou while) ou dans un bloc
     d’instructions associé à un cas particulier dans une action switch. L’action break indique à Flash
     d’ignorer le reste du corps de la boucle, de stopper l’action de boucle et d’exécuter l’instruction
     qui suit l’instruction de boucle. Lors de l’emploi d’une action break, l’interprète de Flash ignore
     le reste des instructions dans ce bloc case et passe à la première instruction suivant l’action
     switch le contenant. Utilisez l’action break pour sortir d’une série de boucles imbriquées.




94
    Exemple
    L’exemple suivant utilise l’action break pour sortir d’une boucle sans fin.
    i = 0;
    while (true) {
      if (i >= 100) {
         break;
      }
      i++;
    }

    Voir aussi
    for, for..in, do while, while, switch, case


Button (objet)
    Tous les symboles de boutons d’une animation Flash sont des occurrences de l’objet Button.
    Vous pouvez donner un nom d’occurrence à un bouton dans l’inspecteur des propriétés et utiliser
    les méthodes et propriétés de l’objet Button pour le manipuler avec ActionScript. Les noms
    d’occurrence de bouton sont affichés dans l’explorateur d’animations et dans la boîte de dialogue
    Insérer un chemin cible du panneau Actions.
    L’objet Button hérite de l’objet Object.
    L’objet Button est supporté par Flash Player 6.

Méthodes de l’objet Button

    Méthode                          Description

    Button.getDepth                  Renvoie la profondeur d’une occurrence de bouton.


Propriétés de l’objet Button

    Propriété                  Description

    Button._alpha              La valeur de transparence d’une occurrence de bouton.

    Button.enabled             Indique si un bouton est actif.

    Button._focusrect          Indique si un bouton avec focus est encadré d’un rectangle jaune.

    Button._height             La hauteur d’une occurrence de bouton, en pixels.

    Button._highquality        Indique la qualité de rendu de l’animation.

    Button._name               Le nom d’occurrence d’une occurrence de bouton.

    Button._parent             Une référence à l’occurrence de clip qui est le parent de cette occurrence.

    Button._quality            Indique la qualité de rendu de l’animation.

    Button._rotation           Le degré de rotation d’une occurrence de bouton.

    Button._soundbuftime       Nombre de secondes nécessaires au pré-chargement d’un son.

    Button.tabEnabled          Indique si un bouton est inclus dans l’ordre de tabulation automatique.

    Button.tabIndex            Indique l’ordre de tabulation d’un objet.

    Button._target             Le chemin cible d’une occurrence de bouton.




                                                                                 Dictionnaire ActionScript   95
     Propriété                  Description

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

     Button._url                L’URL du fichier SWF créateur de l’occurrence de bouton.

     Button.useHandCursor       Indique si le curseur de main est affiché lorsque la souris passe au-dessus d’un
                                bouton.

     Button._visible            Une valeur booléenne déterminant si l’occurrence d’un bouton est masquée ou
                                visible.

     Button._width              La largeur d’une occurrence de bouton, en pixels.

     Button._x                  La coordonnée x d’une occurrence de bouton.

     Button._xmouse             La coordonnée x du curseur par rapport à une occurrence de bouton.

     Button._xscale             La valeur spécifiant le pourcentage de redimensionnement horizontal d’une
                                occurrence de bouton.

     Button._y                  La coordonnée y d’une occurrence de bouton.

     Button._ymouse             La coordonnée y du curseur par rapport à une occurrence de bouton.

     Button._yscale             La valeur spécifiant le pourcentage de redimensionnement vertical d’une
                                occurrence de bouton.


Evénements de l’objet Button
     Le tableau suivant récapitule les événements de l’objet Button.

     Méthode                          Description

     Button.onDragOut                 Invoqué lorsque le pointeur se trouve en dehors du bouton, le bouton de la
                                      souris est enfoncé, puis le pointeur sort de la zone du bouton.

     Button.onDragOver                Invoqué lorsque le pointeur se trouve au-dessus du bouton, le bouton de la
                                      souris a été enfoncé, puis le pointeur est sorti du bouton avant d'être ramené
                                      au-dessus de celui-ci.

     Button.onKeyUp                   Invoqué lorsqu’une touche est relâchée.

     Button.onKillFocus               Invoqué lorsque le focus est retiré d’un bouton.

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

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

     Button.onReleaseOutside          Invoqué lorsque la souris est relâchée alors que le pointeur se trouve en
                                      dehors du bouton après que l’enfoncement du bouton ait été effectué
                                      pendant que le pointeur était à l’intérieur de celui-ci.

     Button.onRollOut                 Invoqué lorsque le pointeur passe à l’extérieur d’un bouton.

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

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




96
Button._alpha
   Disponibilité
   Flash Player 6.
   Usage
   monBouton._alpha

   Description
   Propriété ; définit et récupère la transparence alpha (valeur) du bouton spécifié par monBouton.
   Les valeurs valides vont de 0 (transparence complète) à 100 (opacité complète). Les objets d’un
   bouton avec _alpha défini sur 0 sont actifs, même s’ils sont invisibles.
   Exemple
   Les instructions suivantes définissent la propriété _alpha d’un bouton nommé étoile sur 30 %.
   on(release) {
     étoile._alpha = 30;
   }

Button.enabled
   Disponibilité
   Flash Player 6.
   Usage
   monBouton.enabled

   Description
   Propriété ; une valeur booléenne spécifiant si un bouton est activé. La valeur par défaut est true.

Button._focusrect
   Disponibilité
   Flash Player 6.
   Usage
   monBouton._focusrect

   Description
   Propriété ; une valeur booléenne spécifiant si un rectangle jaune apparaît autour du bouton avec
   focus clavier. Cette propriété peut annuler la propriété _focusrect globale.




                                                                         Dictionnaire ActionScript   97
Button.getDepth
     Disponibilité
     Flash Player 6.
     Usage
     monBouton.getDepth()

     Renvoie
     Un entier.
     Description
     Méthode ; renvoie la profondeur d’une occurrence de bouton.

Button._height
     Disponibilité
     Flash Player 6.
     Usage
     monBouton._height

     Description
     Propriété ; définit et récupère la hauteur du bouton, en pixels.
     Exemple
     L’exemple de code suivant définit la hauteur et la largeur d’un bouton lorsque l’utilisateur clique
     sur la souris :
     monBouton._width = 200;
     monBouton._height = 200;

Button._highquality
     Disponibilité
     Flash Player 6.
     Usage
     monBouton._highquality

     Description
     Propriété (globale) ; spécifie le niveau d’anti-alias appliqué à l’animation en cours. Spécifiez 2
     (qualité maximum) pour appliquer une qualité élevée avec le lissage bitmap toujours actif.
     Spécifiez 1 (qualité élevée) pour appliquer l’anti-alias ; cela lissera les bitmaps si le clip ne contient
     pas d’animation. Spécifiez 0 (faible qualité) pour empêcher l’anti-alias.
     Exemple
     _highquality = 1;

     Voir aussi
     _quality, toggleHighQuality




98
Button._name
   Disponibilité
   Flash Player 6.
   Usage
   monBouton._name

   Description
   Propriété ; renvoie le nom d’occurrence du bouton spécifié par monBouton.

Button.onDragOut
   Disponibilité
   Flash Player 6.
   Usage
   monBouton.onDragOut

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsqu’une pression est exercée sur le bouton de la souris
   alors que le pointeur se trouve sur le bouton et qu’il passe ensuite en dehors du bouton.

Button.onDragOver
   Disponibilité
   Flash Player 6.
   Usage
   monBouton.onDragOver

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque l’utilisateur appuie sur le bouton de la souris et la fait
   glisser en dehors du bouton, puis revient au-dessus de celui-ci.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.




                                                                          Dictionnaire ActionScript   99
      Exemple
      L’exemple suivant définit une fonction pour la méthode onKeyDown qui envoie un trace à la
      fenêtre Sortie :
      monBouton.onDragOver = function () {
         trace ("onDragOver appelé");
      };

      Voir aussi
      Button.onKeyUp

Button.onKeyDown
      Disponibilité
      Flash Player 6.
      Usage
      monBouton.onKeyDown

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsqu’un bouton a le focus clavier et qu’une touche est
      enfoncée. L’événement onKeyDown est invoqué sans paramètres. Vous pouvez utiliser les
      méthodes Key.getAscii et Key.getCode pour prendre connaissance de la touche enfoncée.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onKeyDown qui envoie un trace à la
      fenêtre Sortie :
      monBouton.onKeyDown = function () {
         trace ("onKeyDown appelé");
      };

      Voir aussi
      Button.onKeyUp

Button.onKeyUp
      Disponibilité
      Flash Player 6.
      Usage
      monBouton.onKeyUp

      Paramètres
      Aucun.
      Renvoie
      Rien.


100
   Description
   Gestionnaire d’événement ; invoqué lorsqu’un bouton a le focus de saisie et qu’une touche est
   relâchée. L’événement onKeyUp est invoqué sans paramètres. Vous pouvez utiliser les méthodes
   Key.getAscii et Key.getCode pour prendre connaissance de la touche enfoncée.

   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
   Exemple
   L’exemple suivant définit une fonction pour la méthode onKeyPress qui envoie un trace à la
   fenêtre Sortie :
   monBouton.onKeyUp = function () {
      trace ("onKeyUp appelé");
   };

Button.onKillFocus
   Disponibilité
   Flash Player 6.
   Usage
   monBouton.onKillFocus = function (nouveauFocus) {
   instructions;
   };
   Paramètres
   nouveauFocus      L’objet recevant le focus.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; un événement invoqué lorsqu’un bouton perd le focus clavier. La
   méthode onKillFocus reçoit un paramètre, nouveauFocus, qui est un objet représentant le
   nouvel objet recevant le focus. Si aucun objet ne reçoit le focus, nouveauFocus contient la valeur
   null.


Button.onPress
   Disponibilité
   Flash Player 6.
   Usage
   monBouton.onPress

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsqu’un bouton est enfoncé. Vous devez définir une
   fonction exécutée lorsque l’événement est invoqué.



                                                                        Dictionnaire ActionScript   101
      Exemple
      L’exemple suivant définit une fonction pour la méthode onPress qui envoie une action trace à
      la fenêtre Sortie.
      monBouton.onPress = function () {
         trace ("onPress appelé");
      };

Button.onRelease
      Disponibilité
      Flash Player 6.
      Usage
      monBouton.onRelease

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsqu’un bouton est relâché.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onRelease qui envoie une action trace
      à la fenêtre Sortie.
      monBouton.onRelease = function () {
         trace ("onRelease appelé");
      };

Button.onReleaseOutside
      Disponibilité
      Flash Player 6.
      Usage
      monBouton.onReleaseOutside

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsque la souris est relâchée pendant que le pointeur se
      trouve en dehors du bouton après que l’enfoncement du bouton ait été effectué pendant que le
      pointeur était à l’intérieur de celui-ci.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.



102
   Exemple
   L’exemple suivant définit une fonction pour la méthode onReleaseOutside qui envoie un
   trace à la fenêtre Sortie.
   monBouton.onReleaseOutside = function () {
      trace ("onReleaseOutside appelé");
   };

Button.onRollOut
   Disponibilité
   Flash Player 6.
   Usage
   monBouton.onRollOut

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque le pointeur passe à l’extérieur d’un bouton.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
   Exemple
   L’exemple suivant définit une fonction pour la méthode onRollOut qui envoie un trace à la
   fenêtre Sortie.
   monBouton.onRollOut = function () {
      trace ("onRollOut appelé");
   };

Button.onRollOver
   Disponibilité
   Flash Player 6.
   Usage
   monBouton.onRollOver

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque le pointeur passe au-dessus d’un bouton.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.




                                                                       Dictionnaire ActionScript 103
      Exemple
      L’exemple suivant définit une fonction pour la méthode onRollOver qui envoie une action
      trace à la fenêtre Sortie.
      monBouton.onRollOver = function () {
        trace ("onRollOver appelé");
      };

Button.onSetFocus
      Disponibilité
      Flash Player 6.
      Usage
      monBouton.onSetFocus = function(ancienFocus){
      instructions;
      };

      Paramètres
      ancienFocus       L’objet devant perdre le focus clavier.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsqu’un bouton reçoit le focus clavier. Le paramètre
      ancienFocus est l’objet perdant le focus. Par exemple, si l’utilisateur appuie sur la touche Tab
      pour faire passer le focus de saisie d’un champ de texte à un bouton, ancienFocus contient
      l’occurrence de champ de texte.
      Si aucun objet n’a précédemment reçu le focus, ancienFocus contient une valeur null.

Button._parent
      Disponibilité
      Flash Player 6.
      Usage
      _parent.propriété

      Description
      Propriété ; spécifie ou renvoie une référence au clip ou objet contenant le clip ou objet courant.
      L’objet courant est celui contenant le code ActionScript faisant référence à _parent. Utilisez
      _parent pour spécifier un chemin relatif aux clips ou objets qui se trouvent au-dessus du clip ou
      objet actuel. Vous pouvez utiliser _parent pour monter de plusieurs niveaux dans la liste
      d’affichage, comme dans l’exemple suivant :
      _parent._parent._alpha = 20;

      Voir aussi
      _root, targetPath




104
Button._quality
   Disponibilité
   Flash Player 6.
   Usage
   monBouton._quality

   Description
   Propriété (globale) ; définit ou récupère la qualité de rendu utilisée pour une animation. Les
   polices de périphérique sont toujours aliasées et ne sont donc pas affectées par la propriété
   _quality.

   La propriété _quality peut être définie avec les valeurs suivantes :
   •   "LOW"  Qualité de rendu minimum. Les graphiques ne sont pas anti-aliasés et les bitmaps ne
       sont pas lissés.
   •   "MEDIUM"      Qualité de rendu moyenne. Les graphiques sont anti-aliasés avec une grille 2x2, en
       pixels, mais les bitmaps ne sont pas lissés. Convient aux animations ne contenant pas de texte.
   •   "HIGH" Qualité de rendu élevée. Les graphiques sont anti-aliasés avec une grille 4x4, en
       pixels, et les bitmaps sont lissés si l’animation est statique. Il s’agit du paramètre de qualité de
       rendu par défaut utilisé par Flash.
   •   "BEST" Qualité de rendu très élevée. Les graphiques sont anti-aliasés avec une grille 4x4, en
       pixels, et les bitmaps sont toujours lissés.
   Exemple
   L’exemple suivant définit la qualité de rendu sur LOW :
   monBouton._quality = "LOW";

   Voir aussi
   _highquality, toggleHighQuality


Button._rotation
   Disponibilité
   Flash Player 6.
   Usage
   monBouton._rotation

   Description
   Propriété ; spécifie la rotation du bouton, en degrés.




                                                                             Dictionnaire ActionScript 105
Button._soundbuftime
      Disponibilité
      Flash Player 6.
      Usage
      monBouton._soundbuftime

      Description
      Propriété (globale) ; un entier spécifiant le nombre de secondes de mise en tampon d’un son avant
      sa lecture en flux continu.

Button.tabEnabled
      Disponibilité
      Flash Player 6.
      Usage
      monBouton.tabEnabled
      Description
      Propriété ; peut être définie pour une occurrence des objets MovieClip, Button ou TextField.
      Valeur undefined par défaut.
      Si la propriété tabEnabled est undefined ou true, l’objet est inclus dans l’ordre de tabulation
      automatique. L’objet est inclus dans l’ordre de tabulation automatique si la propriété tabIndex
      reçoit également une valeur. Si tabEnabled est false, l’objet n’est pas inclus dans l’ordre de
      tabulation automatique. Pour un clip, si tabEnabled est false, les enfants du clip peuvent
      toujours être inclus dans l’ordre de tabulation automatique, à moins que la propriété
      tabChildren ait également été définie sur false.

      Si tabEnabled est undefined ou true, si la propriété tabIndex est définie, l’objet est inclus dans
      l’ordre de tabulation automatique. Si tabEnabled est false, l’objet n’est pas inclus dans l’ordre
      de tabulation automatique, même si la propriété tabIndex est définie. Si tabEnabled est défini
      sur false dans un clip, les enfants du clip peuvent toujours être inclus dans l’ordre de tabulation
      automatique.
      Voir aussi
      Button.tabIndex

Button.tabIndex
      Disponibilité
      Flash Player 6.
      Usage
      monBouton.tabIndex
      Description
      Propriété ; permet de définir l’ordre de tabulation automatique des objets d’une animation. Vous
      pouvez définir la propriété tabIndex, qui est undefined par défaut, pour une occurrence de
      bouton, clip ou champ de texte.




106
   Si un des objets affichés dans l’animation Flash contient une propriété tabIndex, l’ordre de
   tabulation automatique est désactivé, et l’ordre de tabulation est calculé en fonction des propriétés
   tabIndex des objets de l’animation. L’ordre de tabulation personnalisé n’inclut que les objets
   possédant des propriétés tabIndex.
   La propriété tabIndex peut être un entier non-négatif. Les objets sont placés dans l’ordre
   correspondant à leurs propriétés tabIndex, dans un ordre croissant. Un objet avec une propriété
   tabIndex dont la valeur est 1 précède un objet avec une valeur tabIndex de 2. Si deux objets ont
   la même valeur tabIndex, celui qui précède l’autre dans l’ordre de tabulation est undefined.
   L’ordre de tabulation personnalisé défini par la propriété tabIndex est flat. Cela signifie que la
   relation hiérarchique des objets de l’animation Flash n’a pas importance. Tous les objets de
   l’animation Flash possédant des propriétés tabIndex sont placés dans l’ordre de tabulation, qui
   est déterminé par l’ordre des valeurs tabIndex. Si deux objets ont la même valeur tabIndex,
   celui qui précède l’autre est undefined. Vous ne devriez pas utiliser la même valeur tabIndex
   pour plusieurs objets.

Button._target
   Disponibilité
   Flash Player 6.
   Usage
   monBouton._target

   Description
   Propriété (lecture seule) ; renvoie le chemin cible de l’occurrence de bouton spécifiée dans le
   paramètre monBouton.

Button.trackAsMenu
   Disponibilité
   Flash Player 6.
   Usage
   monBouton.trackAsMenu
   Description
   Propriété ; une propriété booléenne qui indique si d’autres boutons ou clips peuvent recevoir des
   événements de relâchement de bouton de souris Cela vous permet de créer des menus. Vous
   pouvez définir la propriété trackAsMenu pour n’importe quel objet de bouton ou clip. Si la
   propriété trackAsMenu n’existe pas, le comportement par défaut est false.
   Vous pouvez changer la propriété trackAsMenu à tout moment, le bouton modifié prenant
   immédiatement le nouveau comportement.
   Voir aussi
   MovieClip.trackAsMenu




                                                                          Dictionnaire ActionScript 107
Button._url
      Disponibilité
      Flash Player 6.
      Usage
      monBouton._url

      Description
      Propriété (lecture seule) ; récupère l’URL du fichier SWF créateur de ce bouton.

Button.useHandCursor
      Disponibilité
      Flash Player 6.
      Usage
      monBouton.useHandCursor
      Description
      Propriété ; une valeur booléenne qui, lorsque true, indique qu’un curseur de main est affiché
      lorsque la souris passe au-dessus d’un bouton. La valeur par défaut de useHandCursor est true.
      Si la propriété useHandCursor est définie sur false, c’est le curseur de flèche qui est utilisé.
      Vous pouvez changer la propriété useHandCursor à tout moment, le bouton modifié prenant
      immédiatement le nouveau comportement. La propriété useHandCursor peut être lue à partir
      d’un objet prototype.

Button._visible
      Disponibilité
      Flash Player 6.
      Usage
      monBouton._visible

      Description
      Propriété ; une valeur booléenne indiquant si le bouton spécifié par le paramètre monBouton est
      visible. Les boutons qui ne sont pas visibles (propriété _visible définie sur false) sont
      désactivés.

Button._width
      Disponibilité
      Flash Player 6.
      Usage
      monBouton._width

      Description
      Propriété ; définit et récupère la largeur du bouton, en pixels.




108
   Exemple
   L’exemple suivant définit les propriétés de hauteur et de largeur d’un bouton.
   monBouton._width=200;
   monBouton._height=200;

   Voir aussi
   MovieClip._width

Button._x
   Disponibilité
   Flash Player 6.
   Usage
   monBouton._x

   Description
   Propriété ; un entier définissant la coordonnée x du bouton par rapport aux coordonnées locales
   du clip parent. Si un bouton se trouve dans le scénario principal, son système de coordonnées fait
   référence au coin supérieur gauche de la scène, sous la forme (0, 0). Si le bouton se trouve dans un
   clip qui a subi des transformations, le bouton est dans le système de coordonnées local du clip le
   contenant. Donc, pour un clip ayant pivoté de 90° dans le sens inverse des aiguilles d’une montre,
   le bouton inclus hérite d’un système de coordonnées qui a pivoté de 90° dans le sens inverse des
   aiguilles d’une montre. Les coordonnées du bouton font référence à la position du point
   d’alignement.
   Voir aussi
   Button._xscale, Button._y, Button._yscale


Button._xmouse
   Disponibilité
   Flash Player 6.
   Usage
   monBouton._xmouse

   Description
   Propriété (lecture seule) ; renvoie la coordonnée x de la position de la souris par rapport au
   bouton.
   Voir aussi
   Button._ymouse




                                                                          Dictionnaire ActionScript 109
Button._xscale
      Disponibilité
      Flash Player 6.
      Usage
      monBouton._xscale

      Description
      Propriété ; détermine l’échelle horizontale (pourcentage) du bouton telle qu’appliquée à partir
      du point d’alignement du bouton. Le point d’alignement par défaut est (0,0).
      Le redimensionnement du système de coordonnées locales affecte les paramètres de propriété _x
      et _y, définis en pixels. Par exemple, si le clip parent est dimensionné à 50 %, la définition de la
      propriété _x bouge un objet du bouton de la moitié du nombre de pixels d’une animation à
      100 %.
      Voir aussi
      Button._x, Button._y, Button._yscale


Button._y
      Disponibilité
      Flash Player 6.
      Usage
      monBouton._y

      Description
      Propriété ; définit la coordonnée y du bouton par rapport aux coordonnées locales du clip parent.
      Si un bouton se trouve dans le scénario principal, son système de coordonnées fait référence au
      coin supérieur gauche de la scène, sous la forme (0, 0). Si le bouton se trouve dans un autre clip
      qui a subi des transformations, le bouton est dans le système de coordonnées local du clip le
      contenant. Donc, pour un clip ayant pivoté de 90° dans le sens inverse des aiguilles d’une montre,
      le bouton inclus hérite d’un système de coordonnées qui a pivoté de 90° dans le sens inverse des
      aiguilles d’une montre. Les coordonnées du bouton font référence à la position du point
      d’alignement.
      Voir aussi
      Button._x, Button._xscale, Button._yscale


Button._ymouse
      Disponibilité
      Flash Player 6.
      Usage
      monBouton._ymouse

      Description
      Propriété (lecture seule) ; indique la coordonnée y de la position de la souris par rapport au
      bouton.
      Voir aussi
      Button._xmouse

110
Button._yscale
       Disponibilité
       Flash Player 6.
       Usage
       monBouton._yscale

       Description
       Propriété ; définit l’échelle verticale (pourcentage) du bouton telle qu’appliquée à partir du
       point d’alignement du bouton. Le point d’alignement par défaut est (0,0).
       Voir aussi
       Button._y, Button._x, Button._xscale


call
       Disponibilité
       Flash Player 4. Cette action est déconseillée dans Flash 5 et il est recommandé d’utiliser l’action
       function.

       Usage
       call(image)

       Paramètres
       image    L’étiquette ou le numéro d’une image du scénario.
       Renvoie
       Rien.
       Description
       Action ; exécute le script dans l’image appelée sans déplacer la tête de lecture jusqu’à cette image.
       Les variables locales n’existeront pas une fois l’exécution du script terminée.
       Voir aussi
       function

call function
       Disponibilité
       Flash Player 6
       Usage
       objet.fonction([paramètres])

       Paramètres
       objet  Un objet (éventuellement un clip) dans lequel la fonction a été définie.
       fonction  Un identifiant spécifiant une fonction définie par l’utilisateur.
       paramètres Un paramètre facultatif indiquant tous les paramètres que la fonction exige.




                                                                              Dictionnaire ActionScript   111
      Renvoie
      Rien.
      Description
      Action ; vous permet d’utiliser des champs de paramètres pour appeler une fonction définie par
      l’utilisateur en mode Normal dans le panneau Actions.

case
      Disponibilité
      Flash Player 4.
      Usage
      case expression: instructions

      Paramètres
      expression        Toute expression.
      instructions        Toute instruction.
      Renvoie
      Rien.
      Description
      Mot-clé ; définit une condition pour l’action switch. Les instructions du paramètre
      instructions sont exécutées si le paramètre expression qui suit le mot-clé case est égal au
      paramètre expression de l’action switch avec une égalité stricte (===).
      L’action case utilisée en dehors d’une instruction switch produit une erreur et la compilation du
      script échoue.
      Voir aussi
      switch, default, break, === (égalité stricte)


chr
      Disponibilité
      Flash Player 4. Cette fonction est déconseillée dans Flash 5 et remplacée par la méthode
      String.fromCharCode.

      Usage
      chr(nombre)

      Paramètres
      nombre    Un code ASCII.
      Renvoie
      Rien.
      Description
      Fonction de chaîne ; convertit les codes ASCII en caractères.




112
   Exemple
   L’exemple suivant convertit le nombre 65 en la lettre A et l’affecte à la variable maVar.
   maVar = chr(65);

   Voir aussi
   String.fromCharCode

clearInterval
   Disponibilité
   Flash Player 6.
   Usage
   clearInterval( idDintervalle )

   Paramètres
   idDintervalle      Un objet renvoyé d’un appel à la fonction setInterval.
   Renvoie
   Rien.
   Description
   Action ; annule un appel à la fonction setInterval.
   Exemple
   L’exemple suivant définir d’abord, puis annule un appel d’intervalle :
   function callback() {
           trace("intervalle appelé");
   }
   var idDintervalle;
   idDintervalle = setInterval( callback, 1000 );

   // plus tard
   clearInterval( idDintervalle );

   Voir aussi
   setInterval




                                                                            Dictionnaire ActionScript   113
Color (objet)
      L’objet Color vous permet de définir et de récupérer la valeur RVB et la transformation de couleur
      d’un clip.
      Vous devez utiliser le constructeur new Color() pour créer une occurrence de l’objet Color avant
      d’en appeler les méthodes.
      L’objet Color est supporté par Flash 5 et les versions suivantes de Flash Player.

Méthodes de l’objet Color

      Méthode                Description

      Color.getRGB           Renvoie la valeur numérique RVB définie par le dernier appel setRGB.

      Color.getTransform     Renvoie les informations de transformation définies par le dernier appel setTransform.

      Color.setRGB           Définit la représentation hexadécimale de la valeur RVB pour un objet Color.

      Color.setTransform     Définit la transformation de couleur pour un objet Color.


Constructeur de l’objet Color
      Disponibilité
      Flash Player 5.
      Usage
      new Color(cible)

      Paramètres
      cible     Le nom d’occurrence d’un clip.
      Renvoie
      Rien.
      Description
      Constructeur ; crée une occurrence de l’objet Color pour le clip spécifié par le paramètre cible .
      Vous pouvez alors utiliser les méthodes de cet objet Color pour changer la couleur du clip cible.
      Exemple
      L’exemple suivant crée une occurrence de l’objet Color appelée maCouleur pour le clip monClip
      et définit sa valeur RVB :
      maCouleur = new Color(monClip);
      maCouleur.setRGB(0xff9933);

Color.getRGB
      Disponibilité
      Flash Player 5.
      Usage
      maCouleur.getRGB()

      Paramètres
      Aucun.



114
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; renvoie les valeurs numériques définies par le dernier appel setRGB.
   Exemple
   Le code suivant récupère la valeur RVB de l’occurrence maCouleur de l’objet Color, la convertit
   en une chaîne hexadécimale et l’affecte à la variable valeur.
   valeur = maCouleur.getRGB().toString(16);

   Voir aussi
   Color.setRGB

Color.getTransform
   Disponibilité
   Flash Player 5.
   Usage
   maCouleur.getTransform()

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Méthode ; renvoie la valeur de transformation définie par le dernier appel setTransform.
   Voir aussi
   Color.setTransform

Color.setRGB
   Disponibilité
   Flash Player 5.
   Usage
   maCouleur.setRGB(0xRRVVBB)

   Paramètres
   0xRRVVBB La couleur hexadécimale ou RVB à définir. RR, VV et BB consistent chacun en deux
   chiffres hexadécimaux spécifiant le décalage de chaque composante de couleur. Le 0x indique au
   compilateur ActionScript que le nombre est une valeur hexadécimale.
   Description
   Méthode ; spécifie une couleur RVB pour une occurrence de l’objet Color. L’appel de cette
   méthode annule les paramètres précédents définis par la méthode setTransform.
   Renvoie
   Rien.



                                                                       Dictionnaire ActionScript   115
      Exemple
      Cet exemple définit la valeur de couleur RVB pour le clip monAnimation. Pour voir ce code
      fonctionner, placez un clip sur la scène avec le nom d’occurrence monAnimation. Placez ensuite le
      code suivant sur l’image 1 du scénario principal et choisissez Contrôle > Tester l’animation.
      maCouleur = new Color(monAnimation);
      maCouleur.setRGB(0x993366);

      Voir aussi
      Color.setTransform

Color.setTransform
      Disponibilité
      Flash Player 5.
      Usage
      maCouleur.setTransform(objetDeTransformationDeCouleur);

      Paramètres
      objetDeTransformationDeCouleur           Un objet créé avec le constructeur new Object. Cette
      occurrence de l’objet Object doit avoir les propriétés suivantes, qui spécifient les valeurs de
      transformation de couleur : ra, rb, ga, gb, ba, bb, aa, ab. Ces propriétés sont expliquées ci-
      dessous.
      Renvoie
      Rien.
      Description
      Méthode ; définit les informations de transformation de couleur pour une occurrence de l’objet
      Color. Le paramètre objetDeTransformationDeCouleur est un objet générique que vous créez à
      partir du constructeur new Object. Il a des paramètres spécifiant les valeurs de pourcentage et de
      décalage pour les composantes rouge, verte, bleue et alpha (transparence) d’une couleur, entrées
      suivant le format 0xRRVVBBAA.
      Les paramètres pour un objet de transformation de couleur correspondent aux paramètres définis
      dans la boîte de dialogue Effet avancé et sont définis comme suit :
      •   ra   est le pourcentage de la composante rouge (-100 à 100).
      •   rb   est le décalage de la composante rouge (-255 à 255).
      •   ga   est le pourcentage de la composante verte (-100 à 100).
      •   gb   est le décalage de la composante verte (-255 à 255).
      •   ba   est le pourcentage de la composante bleue (-100 à 100).
      •   bb   est le décalage de la composante bleue (-255 à 255).
      •   aa   est le pourcentage pour alpha (-100 à 100).
      •   ab   est le décalage pour alpha (-255 à 255).




116
   Vous créez un paramètre objetDeTransformationDeCouleur comme suit :
   maTransformationDeCouleur = new Object();
   maTransformationDeCouleur.ra = 50;
   maTransformationDeCouleur.rb = 244;
   maTransformationDeCouleur.ga = 40;
   maTransformationDeCouleur.gb = 112;
   maTransformationDeCouleur.ba = 12;
   maTransformationDeCouleur.bb = 90;
   maTransformationDeCouleur.aa = 40;
   maTransformationDeCouleur.ab = 70;
   Vous pouvez également utiliser la syntaxe suivante pour créer un paramètre
   objetDeTransformationDeCouleur :
   maTransformationDeCouleur = { ra: '50', rb: '244', ga: '40', gb: '112', ba:
     '12', bb: '90', aa: '40', ab: '70'}

   Exemple
   Cet exemple crée une nouvelle occurrence de l’objet Color pour une animation cible, crée un
   objet générique appelé maTransformationDeCouleur avec les propriétés définies ci-dessus, et
   utilise la méthode setTransform pour transmettre objetDeTransformationDeCouleur à un
   objet Color. Pour utiliser ce code dans un document Flash (FLA), placez-le sur l’image 1 du
   scénario principal et placez un clip sur la scène avec le nom d’occurrence monAnimation, comme
   dans le code suivant :
   // créer un objet Color appelé maCouleur pour la cible monAnimation
   maCouleur = new Color(monAnimation);
   // créer un objet de transformation de couleur appelé
     maTransformationDeCouleur
   // avec l’objet générique Object
   maTransformationDeCouleur = new Object();
   // définir les valeurs de maTransformationDeCouleur
   maTransformationDeCouleur = { ra: '50', rb: '244', ga: '40', gb: '112', ba:
     '12', bb: '90', aa: '40', ab: '70'};
   // associer l’objet de transformation de couleur à l’objet Color
   // créé pour monAnimation
   maCouleur.setTransform(maTransformationDeCouleur);

continue
   Disponibilité
   Flash Player 4.
   Usage
   continue

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Action ; apparaît dans plusieurs types d’instructions de boucle et se comporte différemment dans
   chaque type de boucle.




                                                                       Dictionnaire ActionScript   117
      Dans une boucle while, continue oblige l’interprète de Flash à ignorer le reste du corps de la
      boucle et à atteindre le haut de la boucle, où la condition est testée.
      Dans une boucle do while, continue oblige l’interprète de Flash à ignorer le reste du corps de la
      boucle et à atteindre le bas de la boucle, où la condition est testée.
      Dans une boucle for, continue oblige l’interprète de Flash à ignorer le reste du corps de la
      boucle et à atteindre l’évaluation de la post-expression for de la boucle.
      Dans une boucle for...in, continue oblige l’interprète de Flash à ignorer le reste du corps de la
      boucle et à retourner au début de la boucle, où la valeur suivante dans l’énumération est traitée.
      Voir aussi
      do while, for, for..in, while


CustomActions (objet)
      Les méthodes de l’objet CustomActions permettent à une animation Flash lue dans l’outil de
      programmation Flash de gérer toutes les actions personnalisées qui sont enregistrées avec l’outil de
      programmation. Une animation Flash peut installer et désinstaller des actions personnalisées,
      récupérer la définition XML d’une action personnalisée et récupérer la liste des actions
      personnalisées enregistrées.
      Vous pouvez utiliser ces méthodes pour développer des animations Flash qui sont des extensions
      de l’outil de programmation Flash. Une telle animation d’extension pourrait, par exemple, utiliser
      le protocole d’application Flash pour naviguer dans un référentiel UDDI et télécharger des
      services web dans la boîte à outils Actions.

Méthodes de l’objet CustomActions

      Méthode                        Description

      CustomActions.get              Lit le contenu du fichier XML de définition d’actions personnalisées.

      CustomActions.install          Installe un nouveau fichier XML de définition d’actions personnalisées.

      CustomActions.list             Renvoie une liste de toutes les actions personnalisées enregistrées.

      CustomActions.uninstall        Supprime un fichier XML de définition d’actions personnalisées.


CustomActions.get
      Disponibilité
      Flash Player 6.
      Usage
      CustomActions.get(définitionDactionsPersonnalisées)

      Paramètres
      définitionDactionsPersonnalisées              Le nom de la définition d’actions personnalisées à
      récupérer.
      Renvoie
      Rien.




118
   Description
   Méthode ; lit le contenu du fichier XML de définition d’actions personnalisées nommé
   définitionDactionsPersonnalisées.

   Le nom du fichier de définition doit être un nom de fichier simple, sans l’extension .xml et sans
   séparateurs de répertoires (« : », « / » ou « \ »).
   Si le fichier de définition spécifié par définitionDactionsPersonnalisées est introuvable, une
   valeur de undefined est renvoyée. Si la définition XML des actions personnalisées spécifiée par le
   paramètre définitionDactionsPersonnalisées est trouvée, elle est lue en totalité et renvoyée
   sous forme de chaîne.

CustomActions.install
   Disponibilité
   Flash Player 6.
   Usage
   CustomActions.install(définitionDactionsPersonnalisées,
     définitionXMLPersonnalisée)

   Paramètres
   définitionDactionsPersonnalisées            Le nom de la définition d’actions personnalisées à
   installer.
   définitionXMLPersonnalisée          Le texte de la définition XML à installer.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; installe un nouveau fichier XML de définition d’actions personnalisées indiqué par le
   paramètre définitionDactionsPersonnalisées. Le contenu du fichier est spécifié par la
   chaîne définitionXMLPersonnalisée.
   Le nom du fichier de définition doit être un nom de fichier simple, sans l’extension .xml et sans
   séparateurs de répertoires (« : », « / » ou « \ »).
   Si un fichier d’actions personnalisées existe déjà avec le nom définitionDactionsPersonnalisées, il
   est écrasé.
   Si une erreur se produit au cours de l’installation, une valeur false est renvoyée. Sinon, une
   valeur de true est renvoyée pour indiquer que l’installation s’est déroulée avec succès.
   Si le répertoire Configuration/ActionsPanel/CustomActions n’existe pas lorsque cette méthode
   est invoquée, il est créé.




                                                                         Dictionnaire ActionScript   119
CustomActions.list
      Disponibilité
      Flash Player 6.
      Usage
      CustomActions.list()

      Paramètres
      Aucun.
      Renvoie
      Un tableau.
      Description
      Méthode ; renvoie un objet Array contenant les noms de toutes les actions personnalisées qui sont
      enregistrées avec l’outil de programmation Flash. Les éléments du tableau sont de simples noms,
      sans l’extension .xml et sans séparateurs de répertoires (par exemple, « : », « / » ou « \ »). Si aucune
      action personnalisée n’est enregistrée, la méthode list renvoie un tableau de longueur zéro. Si
      une erreur se produit, la méthode list renvoie la valeur undefined.

CustomActions.uninstall
      Disponibilité
      Flash Player 6.
      Usage
      CustomActions.uninstall(définitionDactionsPersonnalisées)

      Paramètres
      définitionDactionsPersonnalisées              Le nom de la définition d’actions personnalisées à
      désinstaller.
      Renvoie
      Voir ci-dessous.
      Description
      Méthode ; supprime le fichier XML de définition d’actions personnalisées nommé
      définitionDactionsPersonnalisées.

      Le nom du fichier de définition doit être un nom de fichier simple, sans l’extension .xml et sans
      séparateurs de répertoires (« : », « / » ou « \ »).
      Si aucune action personnalisée portant le même customActionsName n’existe, une valeur de
      false est renvoyée. Si les actions personnalisées ont été correctement retirées, une valeur de true
      est renvoyée.




120
Date (objet)
    L’objet Date vous permet de récupérer les valeurs horaires en fonction du temps universel (Temps
    moyen de Greenwich, maintenant appelé Temps Universel Coordonné) ou en fonction du
    système d’exploitation sur lequel Flash Player est exécuté. Les méthodes de l’objet Date ne sont
    pas statiques, mais ne s’appliquent qu’à l’occurrence de l’objet Date spécifiée à l’appel de la
    méthode. La méthode Date.UTC est une exception : c’est une méthode statique.
    L’objet Date gère l’heure d’été différemment suivant le système d’exploitation et la version de
    Flash Player. Flash Player 6 gère l’heure d’été sur les systèmes d’exploitation suivants comme suit :
    • Windows – l’objet Date ajuste automatiquement son résultat pour refléter l’heure d’été.
      L’objet Date détecte si l’heure d’été est employée à l’endroit en question et, si c’est le cas,
      détecte les dates et heures de transition de l’heure d’hiver à l’heure d’été. Cependant, les dates
      de transition actuellement en vigueur sont appliquées aux dates passées et futures, et l’écart dû
      à l’heure d’été peut donc être calculé de façon incorrecte pour les dates passées lorsque le lieu
      en question avait des dates de transition différentes.
    • Mac OS 8 et 9 – l’objet Date utilise l’écart actuel dû à l’heure d’été, quelle que soit la date ou
      l’heure calculée. Par exemple, dans le fuseau horaire Pacifique des Etats-Unis en août, lorsque
      l’heure d’été est en vigueur, un objet Date contenant la date du 1er janvier 2001 indique
      toujours l’heure d’été, bien que l’heure d’été ne soit pas en vigueur en janvier. Ce problème ne
      peut pas être corrigé sous Mac OS 8 ou 9 étant donné qu’aucune base de données
      d’informations de fuseau horaire n’est disponible.
    • Mac OS X – l’objet Date ajuste automatiquement son résultat pour refléter l’heure d’été. La
      base de données d’informations de fuseau horaire sous Mac OS X est utilisée pour déterminer
      si un écart dû à l’heure d’été devrait être appliqué à une date ou à une heure présente ou passée.
    Flash Player 5 gère l’heure d’été sur les systèmes d’exploitation suivants comme suit :
    • Mac OS 8 et 9 – le comportement est le même que celui décrit pour Flash Player 6.
    • Windows – les règles utilisées aux Etats-Unis pour l’heure d’été sont toujours appliquées, ce
      qui donne lieu à des transitions incorrectes en Europe et dans d’autres régions qui utilisent
      l’heure d’été mais ont des dates de transition différentes de celles des Etats-Unis. Flash détecte
      correctement si l’heure d’été est employée à l’endroit en question.
    Pour appeler les méthodes de l’objet Date, vous devez d’abord créer une occurrence de l’objet
    Date en utilisant son constructeur.
    L’objet Date requiert Flash Player 5.

Méthodes de l’objet Date

    Méthode                      Description

    Date.getDate                 Renvoie le jour du mois, en fonction de l’heure locale.

    Date.getDay                  Renvoie le jour de la semaine, en fonction de l’heure locale.

    Date.getFullYear             Renvoie l’année (quatre chiffres), en fonction de l’heure locale.

    Date.getHours                Renvoie l’heure, en fonction de l’heure locale.

    Date.getMilliseconds         Renvoie les millisecondes, en fonction de l’heure locale.

    Date.getMinutes              Renvoie les minutes, en fonction de l’heure locale.

    Date.getMonth                Renvoie le mois, en fonction de l’heure locale.




                                                                                   Dictionnaire ActionScript   121
      Méthode                   Description

      Date.getSeconds           Renvoie les secondes, en fonction de l’heure locale.

      Date.getTime              Renvoie le nombre de millisecondes écoulées depuis le premier janvier 1970 à
                                minuit, temps universel.

      Date.getTimezoneOffset    Renvoie la différence, en minutes, entre l’heure locale de l’ordinateur et le temps
                                universel.

      Date.getUTCDate           Renvoie le jour (date) du mois, en fonction du temps universel.

      Date.getUTCDay            Renvoie le jour de la semaine, en fonction du temps universel.

      Date.getUTCFullYear       Renvoie l’année (quatre chiffres), en fonction du temps universel.

      Date.getUTCHours          Renvoie l’heure, en fonction du temps universel.

      Date.getUTCMilliseconds   Renvoie les millisecondes, en fonction du temps universel.

      Date.getUTCMinutes        Renvoie les minutes, en fonction du temps universel.

      Date.getUTCMonth          Renvoie le mois, en fonction du temps universel.

      Date.getUTCSeconds        Renvoie les secondes, en fonction du temps universel.

      Date.getYear              Renvoie l’année, en fonction de l’heure locale.

      Date.setDate              Définit le jour du mois, en fonction de l’heure locale. Renvoie les nouvelles
                                informations horaires, en millisecondes.

      Date.setFullYear          Définit l’année complète, en fonction de l’heure locale. Renvoie les nouvelles
                                informations horaires, en millisecondes.

      Date.setHours             Définit l’heure, en fonction de l’heure locale. Renvoie les nouvelles informations
                                horaires, en millisecondes.

      Date.setMilliseconds      Définit les millisecondes, en fonction de l’heure locale. Renvoie les nouvelles
                                informations horaires, en millisecondes.

      Date.setMinutes           Définit les minutes, en fonction de l’heure locale. Renvoie les nouvelles
                                informations horaires, en millisecondes.

      Date.setMonth             Définit le mois, en fonction de l’heure locale. Renvoie les nouvelles informations
                                horaires, en millisecondes.

      Date.setSeconds           Définit les secondes, en fonction de l’heure locale. Renvoie les nouvelles
                                informations horaires, en millisecondes.

      Date.setTime              Définit la date, en millisecondes. Renvoie les nouvelles informations horaires, en
                                millisecondes.

      Date.setUTCDate           Définit la date, en fonction du temps universel. Renvoie les nouvelles informations
                                horaires, en millisecondes.

      Date.setUTCFullYear       Définit l’année, en fonction du temps universel. Renvoie les nouvelles
                                informations horaires, en millisecondes.

      Date.setUTCHours          Définit l’heure, en fonction du temps universel. Renvoie les nouvelles informations
                                horaires, en millisecondes.

      Date.setUTCMilliseconds   Définit les millisecondes, en fonction du temps universel. Renvoie les nouvelles
                                informations horaires, en millisecondes.

      Date.setUTCMinutes        Définit les minutes, en fonction du temps universel. Renvoie les nouvelles
                                informations horaires, en millisecondes.

      Date.setUTCMonth          Définit le mois, en fonction du temps universel. Renvoie les nouvelles informations
                                horaires, en millisecondes.




122
    Méthode                        Description

    Date.setUTCSeconds             Définit les secondes, en fonction du temps universel. Renvoie les nouvelles
                                   informations horaires, en millisecondes.

    Date.setYear                   Définit l’année, en fonction de l’heure locale.

    Date.toString                  Renvoie une valeur de chaîne représentant la date et l’heure stockées dans l’objet
                                   Date spécifié.

    Date.UTC                       Renvoie le nombre de millisecondes écoulées entre le premier janvier 1970 à
                                   minuit, temps universel, et l’heure spécifiée.


Constructeur de l’objet Date
    Disponibilité
    Flash Player 5.
    Usage
    new Date()
    new Date(année, mois [, date [, heure [, minute [, seconde [, milliseconde
      ]]]]])

    Paramètres
    année Une valeur entre 0 et 99 indique une année entre 1900 et 1999, sinon, les quatre chiffres
    de l’année doivent être spécifiés.
    mois     Un entier compris entre 0 (janvier) et 11 (décembre).
    date     Un entier compris entre 1 et 31. Ce paramètre est facultatif.
    heure     Un entier compris entre 0 (minuit) et 23 (23h00).
    minute       Un entier compris entre 0 et 59. Ce paramètre est facultatif.
    seconde       Un entier compris entre 0 et 59. Ce paramètre est facultatif.
    milliseconde        Un entier compris entre 0 et 999. Ce paramètre est facultatif.
    Renvoie
    Un entier.
    Description
    Objet ; construit un nouvel objet Date contenant les informations horaires actuelles ou la date
    spécifiée.
    Exemple
    L’exemple suivant récupère l’heure et la date actuelles.
    maintenant = new Date();
    L’exemple suivant crée un nouvel objet Date pour l’anniversaire de Gary, le 7 août 1974.
    anniversaire_gary = new Date (74, 7, 7);




                                                                                     Dictionnaire ActionScript 123
      L’exemple suivant crée un nouvel objet Date, concatène les valeurs renvoyées des méthodes
      getMonth, getDate et getFullYear, et les affiche dans le champ de texte spécifié par la variable
      dateTextField.
      maDate = new Date();
      dateTextField = ((maDate.getMonth() + 1) + "/" + maDate.getDate() + "/" +
        maDate.getFullYear());

Date.getDate
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getDate()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie le jour du mois (un entier compris entre 1 et 31) de l’objet Date spécifié, en
      fonction de l’heure locale. L’heure locale est déterminée par le système d’exploitation sur lequel
      Flash Player est exécuté.

Date.getDay
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getDay()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie le jour de la semaine (0 pour dimanche, 1 pour lundi, et ainsi de suite) de
      l’objet Date spécifié, en fonction de l’heure locale. L’heure locale est déterminée par le système
      d’exploitation sur lequel Flash Player est exécuté.




124
Date.getFullYear
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getFullYear()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie l’année complète (un nombre à quatre chiffres, tel que 2002) de l’objet Date
   spécifié, en fonction de l’heure locale. L’heure locale est déterminée par le système d’exploitation
   sur lequel Flash Player est exécuté.
   Exemple
   L’exemple suivant utilise le constructeur pour créer un nouvel objet Date et envoie la valeur
   renvoyée par la méthode getFullYear à la fenêtre Sortie.
   maDate = new Date();
   trace(maDate.getFullYear());

Date.getHours
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getHours()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie l’heure (un entier compris entre 0 et 23) de l’objet Date spécifié, en fonction
   de l’heure locale. L’heure locale est déterminée par le système d’exploitation sur lequel Flash
   Player est exécuté.




                                                                          Dictionnaire ActionScript 125
Date.getMilliseconds
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getMilliseconds()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie les millisecondes (un entier compris entre 0 et 999) de l’objet Date spécifié, en
      fonction de l’heure locale. L’heure locale est déterminée par le système d’exploitation sur lequel
      Flash Player est exécuté.

Date.getMinutes
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getMinutes()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie les minutes (un entier compris entre 0 et 59) de l’objet Date spécifié, en
      fonction de l’heure locale. L’heure locale est déterminée par le système d’exploitation sur lequel
      Flash Player est exécuté.

Date.getMonth
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getMonth()

      Paramètres
      Aucun.
      Renvoie
      Un entier.




126
   Description
   Méthode ; renvoie le mois (0 pour janvier, 1 pour février, et ainsi de suite) de l’objet Date
   spécifié, en fonction de l’heure locale. L’heure locale est déterminée par le système d’exploitation
   sur lequel Flash Player est exécuté.

Date.getSeconds
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getSeconds()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie les secondes (un entier compris entre 0 et 59) de l’objet Date spécifié, en
   fonction de l’heure locale. L’heure locale est déterminée par le système d’exploitation sur lequel
   Flash Player est exécuté.

Date.getTime
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getTime()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit,
   temps universel, pour l’objet Date spécifié. Utilisez cette méthode pour représenter un instant
   spécifique dans le temps lors d’une comparaison entre deux ou plusieurs objets Date.

Date.getTimezoneOffset
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getTimezoneOffset()

   Paramètres
   Aucun.


                                                                          Dictionnaire ActionScript 127
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie la différence, en minutes, entre l’heure locale de l’ordinateur et le temps
      universel.
      Exemple
      L’exemple suivant renvoie la différence entre l’heure d’été locale de San Francisco et le temps
      universel. L’heure d’été est prise en compte dans le résultat renvoyé uniquement si la date définie
      dans l’objet Date est en heure d’été.
      trace(new Date().getTimezoneOffset());
      // 420 est affiché dans la fenêtre Sortie
      // (7 heures * 60 minutes/heure = 420 minutes)
      // cet exemple est donné dans le fuseau horaire de la Californie (PDT, GMT-
        0700).
      // le résultat peut varier en fonction du lieu et de la date.

Date.getUTCDate
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getUTCDate()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie le jour (date) du mois dans l’objet Date spécifié, en fonction du temps
      universel.

Date.getUTCDay
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getUTCDate()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie le jour de la semaine de l’objet Date spécifié, en fonction du temps universel.




128
Date.getUTCFullYear
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getUTCFullYear()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie l’année complète (quatre chiffres) de l’objet Date spécifié, en fonction du
   temps universel.

Date.getUTCHours
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getUTCHours()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie les heures de l’objet Date spécifié, en fonction du temps universel.

Date.getUTCMilliseconds
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getUTCMilliseconds()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie les millisecondes de l’objet Date spécifié, en fonction du temps universel.




                                                                        Dictionnaire ActionScript 129
Date.getUTCMinutes
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getUTCMinutes()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie les minutes de l’objet Date spécifié, en fonction du temps universel.

Date.getUTCMonth
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getUTCMonth()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie les mois de l’objet Date spécifié, en fonction du temps universel.

Date.getUTCSeconds
      Disponibilité
      Flash Player 5.
      Usage
      maDate.getUTCSeconds()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie les secondes dans l’objet Date spécifié, en fonction du temps universel.




130
Date.getYear
   Disponibilité
   Flash Player 5.
   Usage
   maDate.getYear()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie l’année de l’objet Date spécifié, en fonction de l’heure locale. L’heure locale est
   déterminée par le système d’exploitation sur lequel Flash Player est exécuté. L’année est l’année
   complète moins 1900. Par exemple, l’an 2000 est représenté par 100.

Date.setDate
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setDate(date)

   Paramètres
   date     Un entier compris entre 1 et 31.
   Renvoie
   Un entier.
   Description
   Méthode ; définit le jour du mois pour l’objet Date spécifié, en fonction de l’heure locale et
   renvoie les nouvelles informations, en millisecondes. L’heure locale est déterminée par le système
   d’exploitation sur lequel Flash Player est exécuté.

Date.setFullYear
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setFullYear(année [, mois [, date]] )

   Paramètres
   année    Un nombre à quatre chiffres spécifiant une année. Les nombres à deux chiffres ne
   représentent pas les années ; par exemple, 99 n’est pas l’année 1999, mais l’année 99.
   mois     Un entier compris entre 0 (janvier) et 11 (décembre). Ce paramètre est facultatif.
   date     Un nombre entre 1 et 31. Ce paramètre est facultatif.




                                                                          Dictionnaire ActionScript   131
      Renvoie
      Un entier.
      Description
      Méthode ; définit l’année pour l’objet Date spécifié, en fonction de l’heure locale et renvoie les
      nouvelles informations, en millisecondes. Si les paramètres mois et date sont spécifiés, ils sont
      également définis sur l’heure locale. L’heure locale est déterminée par le système d’exploitation sur
      lequel Flash Player est exécuté.
      L’appel de cette méthode ne modifie pas les autres champs de l’objet Date spécifié, mais les
      méthodes getUTCDay et getDay peuvent rapporter une nouvelle valeur si le jour de la semaine
      change suite à l’appel de cette méthode.

Date.setHours
      Disponibilité
      Flash Player 5.
      Usage
      maDate.setHours(heure)

      Paramètres
      heure    Un entier compris entre 0 (minuit) et 23 (23h00).
      Renvoie
      Un entier.
      Description
      Méthode ; définit les heures pour l’objet Date spécifié, en fonction de l’heure locale et renvoie les
      nouvelles informations, en millisecondes. L’heure locale est déterminée par le système
      d’exploitation sur lequel Flash Player est exécuté.

Date.setMilliseconds
      Disponibilité
      Flash Player 5.
      Usage
      maDate.setMilliseconds(milliseconde)

      Paramètres
      milliseconde      Un entier compris entre 0 et 999.
      Renvoie
      Un entier.
      Description
      Méthode ; définit les millisecondes pour l’objet Date spécifié, en fonction du temps universel et
      renvoie les nouvelles informations, en millisecondes. L’heure locale est déterminée par le système
      d’exploitation sur lequel Flash Player est exécuté.




132
Date.setMinutes
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setMinutes(minute)

   Paramètres
   minute       Un entier compris entre 0 et 59.
   Renvoie
   Un entier.
   Description
   Méthode ; définit les minutes pour l’objet Date spécifié, en fonction du temps universel et
   renvoie les nouvelles informations, en millisecondes. L’heure locale est déterminée par le système
   d’exploitation sur lequel Flash Player est exécuté.

Date.setMonth
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setMonth(mois [, date ])

   Paramètres
   mois     Un entier compris entre 0 (janvier) et 11 (décembre).
   date     Un entier compris entre 1 et 31. Ce paramètre est facultatif.
   Renvoie
   Un entier.
   Description
   Méthode ; définit le mois pour l’objet Date spécifié, en fonction de l’heure locale et renvoie les
   nouvelles informations, en millisecondes. L’heure locale est déterminée par le système
   d’exploitation sur lequel Flash Player est exécuté.

Date.setSeconds
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setSeconds(seconde)

   Paramètres
   seconde       Un entier compris entre 0 et 59.
   Renvoie
   Un entier.



                                                                            Dictionnaire ActionScript 133
      Description
      Méthode ; définit les secondes pour l’objet Date spécifié, en fonction de l’heure locale et renvoie
      les nouvelles informations, en millisecondes. L’heure locale est déterminée par le système
      d’exploitation sur lequel Flash Player est exécuté.

Date.setTime
      Disponibilité
      Flash Player 5.
      Usage
      maDate.setTime(milliseconde)

      Paramètres
      milliseconde      Une valeur entière où 0 est le 1er janvier 1970 à 0h00 GMT.
      Renvoie
      Un entier.
      Description
      Méthode ; définit la date pour l’objet Date spécifié en millisecondes depuis le 1er janvier 1970 à
      minuit et renvoie les nouvelles informations horaires, en millisecondes.

Date.setUTCDate
      Disponibilité
      Flash Player 5.
      Usage
      maDate.setUTCDate(date)

      Paramètres
      date    Un entier compris entre 1 et 31.
      Renvoie
      Un entier.
      Description
      Méthode ; définit la date pour l’objet Date spécifié, en fonction du temps universel et renvoie les
      nouvelles informations, en millisecondes. L’appel de cette méthode ne modifie pas les autres
      champs de l’objet Date spécifié, mais les méthodes getUTCDay et getDay peuvent rapporter une
      nouvelle valeur si le jour de la semaine change suite à l’appel de cette méthode.

Date.setUTCFullYear
      Disponibilité
      Flash Player 5.
      Usage
      maDate.setUTCFullYear(année [, mois [, date]])

      Paramètres
      année    L’année spécifiée avec un nombre à quatre chiffres, tel que 2000.


134
   mois     Un entier compris entre 0 (janvier) et 11 (décembre). Ce paramètre est facultatif.
   date     Un entier compris entre 1 et 31. Ce paramètre est facultatif.
   Renvoie
   Un entier.
   Description
   Méthode ; définit l’année pour l’objet Date spécifié (maDate) en fonction du temps universel et
   renvoie les nouvelles informations, en millisecondes.
   En option, cette méthode peut également définir le mois et la date représentés par l’objet Date
   spécifié. Aucun autre champ de l’objet Date n’est modifié. L’appel de setUTCFullyear peut
   obliger getUTCDay et getDay à rapporter une nouvelle valeur si le jour de la semaine change suite
   à cette opération.

Date.setUTCHours
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setUTCHours(heure [, minute [, seconde [, milliseconde]]])

   Paramètres
   heure     Un entier compris entre 0 (minuit) et 23 (23h00).
   minute       Un entier compris entre 0 et 59. Ce paramètre est facultatif.
   seconde       Un entier compris entre 0 et 59. Ce paramètre est facultatif.
   milliseconde        Un entier compris entre 0 et 999. Ce paramètre est facultatif.
   Renvoie
   Un entier.
   Description
   Méthode ; définit l’heure pour l’objet Date spécifié, en fonction du temps universel et renvoie les
   nouvelles informations, en millisecondes.

Date.setUTCMilliseconds
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setUTCMilliseconds(milliseconde)

   Paramètres
   milliseconde        Un entier compris entre 0 et 999.
   Renvoie
   Un entier.
   Description
   Méthode ; définit les millisecondes pour l’objet Date spécifié, en fonction du temps universel et
   renvoie les nouvelles informations, en millisecondes.

                                                                            Dictionnaire ActionScript 135
Date.setUTCMinutes
      Disponibilité
      Flash Player 5.
      Usage
      maDate.setUTCMinutes(minute [, seconde [, milliseconde]])

      Paramètres
      minute       Un entier compris entre 0 et 59.
      seconde       Un entier compris entre 0 et 59. Ce paramètre est facultatif.
      milliseconde        Un entier compris entre 0 et 999. Ce paramètre est facultatif.
      Renvoie
      Un entier.
      Description
      Méthode ; définit la minute pour l’objet Date spécifié, en fonction du temps universel et renvoie
      les nouvelles informations, en millisecondes.

Date.setUTCMonth
      Disponibilité
      Flash Player 5.
      Usage
      maDate.setUTCMonth(mois [, date])

      Paramètres
      mois     Un entier compris entre 0 (janvier) et 11 (décembre).
      date     Un entier compris entre 1 et 31. Ce paramètre est facultatif.
      Renvoie
      Un entier.
      Description
      Méthode ; définit le mois et, en option le jour (la date) pour l’objet Date spécifié, en fonction du
      temps universel et renvoie les nouvelles informations, en millisecondes. L’appel de cette méthode
      ne modifie pas les autres champs de l’objet Date spécifié, mais les méthodes getUTCDay et getDay
      peuvent rapporter une nouvelle valeur si le jour de la semaine change suite à la spécification du
      paramètre date lors de l’appel de setUTCMonth.




136
Date.setUTCSeconds
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setUTCSeconds(seconde [, milliseconde]))

   Paramètres
   seconde      Un entier compris entre 0 et 59.
   milliseconde       Un entier compris entre 0 et 999. Ce paramètre est facultatif.
   Renvoie
   Un entier.
   Description
   Méthode ; définit les secondes pour l’objet Date spécifié, en fonction du temps universel et
   renvoie les nouvelles informations, en millisecondes.

Date.setYear
   Disponibilité
   Flash Player 5.
   Usage
   maDate.setYear(année)

   Paramètres
   année     Si année est un entier compris entre 0 et 99, setYear définit l’année comme 1900 +
   année.   Sinon, l’année est la valeur du paramètre année.
   Renvoie
   Un entier.
   Description
   Méthode ; définit l’année pour l’objet Date spécifié, en fonction de l’heure locale et renvoie les
   nouvelles informations, en millisecondes. L’heure locale est déterminée par le système
   d’exploitation sur lequel Flash Player est exécuté.

Date.toString
   Disponibilité
   Flash Player 5.
   Usage
   maDate.toString()

   Paramètres
   Aucun.
   Renvoie
   Une chaîne.



                                                                          Dictionnaire ActionScript 137
      Description
      Méthode ; renvoie une valeur chaîne pour l’objet Date spécifié dans un format lisible et renvoie
      les nouvelles informations, en millisecondes.
      Exemple
      L’exemple suivant renvoie les informations de l’objet Date annéeDeNaissance sous forme de
      chaîne.
      var annéeDeNaissance = new Date(74, 7, 7, 18, 15);
      trace (annéeDeNaissance.toString());
      Résultat (pour l’heure standard du Pacifique) :
      Wed Aug 7 18:15:00 GMT-0700 1974

Date.UTC
      Disponibilité
      Flash Player 5.
      Usage
      Date.UTC(année, mois [, date [, heure [, minute [, seconde [, milliseconde
        ]]]]])

      Paramètres
      année     Un nombre à quatre chiffres, tel que 2000.
      mois     Un entier compris entre 0 (janvier) et 11 (décembre).
      date     Un entier compris entre 1 et 31. Ce paramètre est facultatif.
      heure     Un entier compris entre 0 (minuit) et 23 (23h00).
      minute       Un entier compris entre 0 et 59. Ce paramètre est facultatif.
      seconde       Un entier compris entre 0 et 59. Ce paramètre est facultatif.
      milliseconde        Un entier compris entre 0 et 999. Ce paramètre est facultatif.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit,
      temps universel, et la date spécifiée dans les paramètres. Ceci est une méthode statique invoquée
      avec le constructeur d’objet Date et non avec un objet Date spécifique. Cette méthode vous
      permet de créer un objet Date qui adopte le temps universel, alors que le constructeur Date
      adopte l’heure locale.
      Exemple
      L’exemple suivant crée un nouvel objet Date anniversaire_gary, défini en fonction du temps
      universel. Il s’agit de la variante en temps universel de l’exemple utilisé pour la méthode
      constructeur new Date.
      anniversaire_gary = new Date(Date.UTC(1974, 7, 8));




138
default
   Disponibilité
   Flash Player 6.
   Usage
   default: instructions

   Paramètres
   instructions       Toute instruction.
   Renvoie
   Rien.
   Description
   Mot-clé ; définit la hauteur de casse par défaut pour une action switch. Les instructions sont
   exécutées si le paramètre Expression de l’action switch n’est pas égal (avec égalité stricte) à un
   des paramètres Expression suivant les mots-clés case pour une action switch donnée.
   Une action switch n’est pas nécessaire pour avoir une hauteur de casse par défaut (default).
   Une hauteur de casse par défaut (default) n’a pas besoin d’être la dernière dans la liste.
   L’utilisation d’une action default en dehors d’une action switch est une erreur, et la
   compilation du script échouera si elle est utilisée comme telle.
   Exemple
   Dans l’exemple suivant, l’expression A n’est pas égale aux expressions B ou D, l’instruction qui
   suit le mot-clé default étant donc exécutée et l’action trace envoyée à la fenêtre Sortie.
   switch ( A ) {
     case B:
        C;
        break;
     case D:
        E;
        break;
     default:
        trace ("aucun cas spécifique");
   }

   Voir aussi
   switch, case, break


delete
   Disponibilité
   Flash Player 5.
   Usage
   delete référence

   Paramètres
   référence       Le nom de la variable ou de l’objet à supprimer.
   Renvoie
   Voir ci-dessous.



                                                                         Dictionnaire ActionScript 139
      Description
      Opérateur ; détruit l’objet ou la variable spécifié par le paramètre référence et renvoie true si
      l’objet a été supprimé avec succès ; sinon, renvoie false. Cet opérateur est utile pour libérer de la
      mémoire utilisée par des scripts. Quoique delete soit un opérateur, il est généralement utilisé
      comme instruction, comme dans l’exemple suivant :
      delete x;
      L’opérateur delete peut échouer et renvoyer false si le paramètre référence n’existe pas ou ne
      peut pas être effacé. Les objets et propriétés prédéfinis, et les variables déclarées avec var, ne
      peuvent pas être supprimés. Vous ne pouvez pas utiliser l’opérateur delete pour retirer des clips.
      Exemple
      L’exemple suivant crée un objet, l’utilise et le supprime une fois qu’il n’est plus nécessaire.
      compte = new Object();
      compte.nom = 'Jon';
      compte.solde = 10000;

      delete compte;

      Exemple
      L’exemple suivant supprime une propriété d’un objet.
      // créer l’objet "compte"
      compte = new Object();
      // affecter le nom de propriété au compte
      compte.nom = 'Jon';
      // supprimer la propriété
      delete compte.nom;

      Exemple
      L’exemple suivant illustre une autre façon de supprimer une propriété d’objet.
      // créer un objet Array de longueur 0
      monTableau = new Array();
      // monTableau.length est maintenant 1
      monTableau[0] = "abc";
      // ajouter un élément au tableau ; monTableau.length est maintenant 2
      monTableau[1] = "def";
      // ajouter un élément au tableau ; monTableau.length est maintenant 3
      monTableau[2] = "ghi";
      // monTableau[2] est supprimé, mais monTableau.length n’est pas changé
      delete monTableau[2];
      L’exemple suivant illustre le comportement de delete sur les références d’objets.
      // créer un objet et affecter la variable ref1
      // pour faire référence à l’objet
      ref1 = new Object();
      ref1.nom = "Jody";
      // copier la variable de référence dans une nouvelle variable
      // et supprimer ref1
      ref2 = ref1;
      delete ref1;




140
   Si ref1 n’avait pas été copié dans ref2, l’objet aurait été supprimé à la suppression de ref1, car il
   n’y aurait plus eu de référence à l’objet. Si vous supprimiez ref2, il n’y aurait plus de référence à
   l’objet, qui serait détruit et la mémoire qu’il utilisait serait à nouveau disponible.
   Voir aussi
   var

do while
   Disponibilité
   Flash Player 4.
   Usage
   do {
     instruction(s)
   } while (condition)

   Paramètres
   condition       La condition à évaluer.
   instruction(s)        La ou les instruction(s) à exécuter tant que le paramètre condition est évalué
   comme true.
   Renvoie
   Rien.
   Description
   Action ; exécute les instructions puis évalue la condition dans une boucle, tant que la condition
   est true.
   Voir aussi
   break, continue


duplicateMovieClip
   Disponibilité
   Flash Player 4.
   Usage
   duplicateMovieClip(cible, nouveauNom, profondeur)

   Paramètres
   cible    Le chemin cible de l’animation à dupliquer.
   nouveauNom        Un identifiant unique pour le clip dupliqué.
   profondeur      Un niveau de profondeur unique pour le clip dupliqué. Le niveau de profondeur
   est un ordre d’empilement des clips dupliqués. Cet ordre d’empilement est similaire à l’ordre
   d’empilement des calques dans le scénario, les clips de niveau de profondeur plus faible étant
   masqués sous des clips d’ordre d’empilement plus élevé. Vous devez affecter à chaque clip
   dupliqué un niveau de profondeur unique pour l’empêcher de remplacer des animations sur des
   profondeurs occupées.
   Renvoie
   Rien.


                                                                          Dictionnaire ActionScript   141
      Description
      Action ; crée une occurrence de clip pendant la lecture de l’animation. Dans les clips dupliqués, la
      tête de lecture commence toujours à l’image 1, quel que soit l’endroit où se trouve la tête de
      lecture dans le clip original (ou « parent »). Les variables du clip parent ne sont pas copiées dans le
      clip dupliqué. Si le clip parent est effacé, le clip dupliqué l’est également. Utilisez l’action ou la
      méthode removeMovieClip pour supprimer une occurrence de clip créée avec
      duplicateMovieClip.

      Exemple
      Cette instruction duplique l’occurrence de clip fleur dix fois. La variable i est utilisée pour créer
      un nouveau nom d’occurrence et une profondeur unique pour chaque clip dupliqué.
      on(release) {
        quantité = 10;
        while (quantité>0) {
           duplicateMovieClip (_root.fleur, "mc"+i, i);
           setProperty ("mc"+i, _x, random(275));
           setProperty ("mc"+i, _y, random(275));
           setProperty ("mc"+i, _alpha, random(275));
           setProperty ("mc"+i, _xscale, random(50));
           setProperty ("mc"+i, _yscale, random(50));
           i++;
           quantité--;
        }
      }

      Voir aussi
      MovieClip.duplicateMovieClip, removeMovieClip, MovieClip.removeMovieClip


else
      Disponibilité
      Flash Player 4.
      Usage
      else condition
      else {...instruction(s)...}

      Paramètres
      condition       Une expression évaluée comme true ou false.
      instruction(s)       Une série d’instructions à exécuter si la condition de l’instruction if est
      false.

      Renvoie
      Rien.
      Description
      Action ; spécifie les instructions à exécuter si la condition de l’instruction if renvoie false.
      Voir aussi
      if




142
else if
    Disponibilité
    Flash Player 4.
    Usage
    if (condition){
      instruction(s);
    } else if (condition){
      instruction(s);
    }

    Paramètres
    condition       Une expression évaluée comme true ou false.
    instruction(s)       Une série d’instructions à exécuter si la condition de l’instruction if est
    false.

    Renvoie
    Rien.
    Description
    Action ; évalue une condition et spécifie les instructions à exécuter si la condition de l’instruction
    if initiale renvoie false. Si la condition else if renvoie true, l’interprète de Flash exécute les
    instructions suivant la condition entre accolades ({}). Si la condition else if est false, Flash
    ignore les instructions entre accolades et exécute les instructions suivant les accolades. Utilisez
    l’action else if pour créer une logique de branchement dans vos scripts.
    Exemple
    L’exemple suivant utilise des actions else if pour vérifier si chaque côté d’un objet se trouve à
    l’intérieur d’une limite spécifique :
    // si l’objet sort des limites,
    // le renvoyer et inverser sa vitesse de déplacement
         if (this._x>limiteDroite) {
           this._x = limiteDroite;
           xInc = -xInc;
         } else if (this._x<limiteGauche) {
           this._x = limiteGauche;
           xInc = -xInc;
         } else if (this._y>limiteInf) {
           this._y = limiteInf;
           yInc = -yInc;
         } else if (this._y<limiteSup) {
           this._y = limiteSup;
           yInc = -yInc;
         }

    Voir aussi
    if




                                                                            Dictionnaire ActionScript 143
#endinitclip
      Disponibilité
      Flash Player 6.
      Usage
      #endinitclip

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Action ; indique la fin d’un bloc d’actions d’initialisation de composant.
      Exemple
      #initclip
      ...les actions d’initialisation de composant sont placées ici...
      #endinitclip

      Voir aussi
      #initclip

eq (égal à – spécifique aux chaînes)
      Disponibilité
      Flash Player 4. Cet opérateur est déconseillé dans Flash 5 et remplacé par l’opérateur ==
      (égalité).

      Usage
      expression1 eq expression2

      Paramètres
      expression1, expression2         Nombres, chaînes ou variables.
      Renvoie
      Voir ci-dessous.
      Description
      Opérateur de comparaison ; compare l’égalité de deux expressions et renvoie true si la
      représentation chaîne de expression1 est égale à la représentation chaîne de expression2 ;
      sinon, l’opération renvoie false.
      Voir aussi
      == (égalité)




144
escape
   Disponibilité
   Flash Player 5.
   Usage
   escape(expression)

   Paramètres
   expression        L’expression à convertir en chaîne et à coder dans un format de code URL.
   Renvoie
   Rien.
   Description
   Fonction ; convertit le paramètre en une chaîne et l’encode dans un format d’URL encodée où
   tous les caractères non-alphanumériques sont échappés avec des séquences % hexadécimales.
   Exemple
   L’exécution du code suivant donne le résultat Bonjour%7B%5BMonde%5D%7D.
   escape("Bonjour{[Monde]}");

   Voir aussi
   unescape

eval
   Disponibilité
   Flash Player 5 et versions suivantes pour une pleine utilisation de la fonctionnalité. Vous pouvez
   utiliser la fonction eval lors de l’exportation vers Flash Player 4, mais devez utiliser une notation
   à barre oblique et ne pouvez accéder qu’aux variables, pas aux propriétés ni aux objets.
   Usage
   eval(expression);

   Paramètres
   expression      Une chaîne contenant le nom d’une variable, d’une propriété, d’un objet ou d’un
   clip à récupérer.
   Renvoie
   Voir ci-dessous.
   Description
   Fonction ; accède aux variables, propriétés, objets ou clips par nom. Si l’expression est une
   variable ou une propriété, la valeur de la variable ou de la propriété est renvoyée. Si l’expression
   est un objet ou un clip, une référence à l’objet ou au clip est renvoyée. Si l’élément nommé dans
   expression est introuvable, undefined est renvoyé.

   Dans Flash 4, la fonction eval était utilisée pour simuler des tableaux ; dans Flash 5, il est
   recommandé d’utiliser l’objet Array pour simuler des tableaux.




                                                                          Dictionnaire ActionScript 145
      Vous pouvez également utiliser la fonction eval pour définir et récupérer dynamiquement la
      valeur d’une variable ou d’un nom d’occurrence. Cependant, vous pouvez également obtenir le
      même résultat avec l’opérateur d’accès tableau ([]).
      Remarque L’action ActionScript eval est différente de la fonction eval de JavaScript et ne peut pas être utilisée
      pour évaluer des instructions.

      Exemple
      L’exemple suivant utilise la fonction eval pour déterminer la valeur de l’expression "morceau" +
      x. Le résultat étant un nom de variable, morceau3, la fonction eval renvoie la valeur de la
      variable et l’affecte à y :
      morceau3 = "dangereux";
      x = 3;

      y = eval("morceau" + x);
      trace(y);

      // Résultat : dangereux

      Voir aussi
      Array (objet)

evaluate
      Disponibilité
      Flash Player 5.
      Usage
      instruction
      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Action ; crée une ligne vide et insère un point-virgule (;) pour entrer des instructions à évaluer
      dans le panneau Actions.

false
      Disponibilité
      Flash Player 5.
      Usage
      true

      Description
      Une valeur booléenne unique représentant l’opposé de true.
      Voir aussi
      true




146
FCheckBox (composant)
   Le composant CheckBox de l’environnement auteur de Flash fournit les fonctions glisser-déposer
   pour l’ajout de cases à cocher aux documents Flash, mais aussi une interface utilisateur de
   définition des paramètres de base. Les méthodes du composant FCheckBox vous permettent de
   contrôler les cases à cocher à l’exécution : vous pouvez créer des cases à cocher, contrôler des cases
   à cocher créées lors de la programmation, définir ou remplacer des paramètres de base, et définir
   des options supplémentaires à l’exécution. Il n’est pas nécessaire d’utiliser un constructeur pour
   accéder aux méthodes des composants.
   Le composant CheckBox est supporté par Flash Player 6.
   Les méthodes des composants n’effectuant pas de vérification d’erreur pour le type, au contraire
   des autres objets et actions ActionScript natifs, il est recommandé de valider les paramètres avant
   de les transmettre aux méthodes.
   Pour plus d’informations sur l’utilisation du composant CheckBox, la définition des paramètres
   au cours de la programmation et le changement de la couleur et de l’apparence des composants,
   consultez les sections Personnalisation de la couleur et du texte des composants et
   Personnalisation des enveloppes de composant du chapitre Utilisation des composants de
   Utilisation de Flash.

Méthodes du composant FCheckBox

   Méthode                               Description

   FCheckBox.getEnabled                  Renvoie true si la case à cocher est activée, false si elle est
                                         désactivée.

   FCheckBox.getLabel                    Renvoie l’étiquette appliquée à la case à cocher sous la forme d’une
                                         chaîne.

   FCheckBox.getValue                    Renvoie true si la case à cocher est sélectionnée, false si elle n’est
                                         pas sélectionnée.

   FCheckBox.registerSkinElement         Enregistre un élément d’enveloppe dans une propriété.

   FCheckBox.setChangeHandler            Spécifie un gestionnaire de changement à appeler lorsque la valeur de
                                         la case à cocher change.

   FCheckBox.setEnabled                  Détermine si la case à cocher est activée ou désactivée.

   FCheckBox.setLabel                    Spécifie le texte de l’étiquette de la case à cocher.

   FCheckBox.setLabelPlacement           Spécifie si l’étiquette apparaît à gauche ou à droite de la case à cocher.

   FCheckBox.setSize                     Définit la largeur de la case à cocher, en pixels, et la retrace.

   FCheckBox.setStyleProperty            Définit une propriété de style pour un composant.

   FCheckBox.setValue                    Sélectionne ou désélectionne la case à cocher et déclenche la fonction
                                         du gestionnaire de changement.




                                                                                  Dictionnaire ActionScript 147
FCheckBox.getEnabled
      Disponibilité
      Flash Player 6.
      Usage
      maCaseAcocher.getEnabled()

      Paramètres
      Aucun.
      Renvoie
      Une valeur booléenne indiquant si l’occurrence de case à cocher est activée (true) ou désactivée
      (false).
      Description
      Méthode ; indique si l’occurrence de case à cocher est activée ou désactivée.
      Exemple
      Le code suivant renvoie l’état d’activation de checkBox1 dans la fenêtre Sortie.
      trace(checkBox1.getEnabled());

      Voir aussi
      FCheckBox.setValue

FCheckBox.getLabel
      Disponibilité
      Flash Player 6.
      Usage
      maCaseAcocher.getLabel()

      Paramètres
      Aucun.
      Renvoie
      Une chaîne de texte.
      Description
      Méthode ; récupère le texte de l’étiquette de la case à cocher.
      Exemple
      Le code suivant renvoie l’étiquette de checkBox1.
      checkBox1.getLabel();

      Voir aussi
      FCheckBox.setLabel




148
FCheckBox.getValue
   Disponibilité
   Flash Player 6.
   Usage
   maCaseAcocher.getValue()

   Paramètres
   Aucun.
   Renvoie
   Une valeur booléenne indiquant si la case à cocher est sélectionnée (true) ou non (false).
   Description
   Méthode ; indique si la case à cocher est sélectionnée.
   Exemple
   Le code suivant renvoie la valeur sélectionnée de KowalczykBox dans la fenêtre Sortie.
   trace(KowalczykBox.getValue());

   Voir aussi
   FCheckBox.setValue

FCheckBox.registerSkinElement
   Disponibilité
   Flash Player 6.
   Usage
   maCaseAcocher.registerSkinElement(élément, propriétéDeStyle)

   Paramètres
   élément      Une occurrence de clip.
   propriétéDeStyle       Le nom d’une propriété FStyleFormat.
   Renvoie
   Rien.
   Description
   Méthode ; enregistre un élément d’enveloppe dans une propriété de style. Les éléments
   d’enveloppes sont enregistrés dans les propriétés de la première image du calque Lisez-moi de
   chaque enveloppe de la bibliothèque.
   Les composants sont constitués d’enveloppes, chaque enveloppe étant constituée de plusieurs
   éléments d’enveloppe, lesquels peuvent être enregistrés dans une propriété de l’objet
   FStyleFormat. Ces propriétés reçoivent des valeurs du format de style affecté à un composant. Par
   défaut, tous les composants d’interface Flash reçoivent l’objet globalStyleFormat, qui est une
   occurrence de l’objet FStyleFormat.
   Utilisez cette méthode pour enregistrer des éléments d’enveloppes et des propriétés personnalisés
   aux enveloppes de composant d’interface Flash ou personnalisées en modifiant le code dans la
   première image du calque Lisez-moi d’une enveloppe de la bibliothèque.



                                                                        Dictionnaire ActionScript 149
      Le composant FCheckBox utilise les enveloppes du dossier FCheckBox Skins une fois le
      composant ajouté au document Flash.
      Pour plus d’informations, consultez la section Personnalisation des enveloppes de composant du
      chapitre Utilisation des composants de Utilisation de Flash.
      Exemple
      Le code suivant enregistre l’élément d’enveloppe personnalisée customChk_mc avec la propriété
      check dans la première image du calque Lisez-moi de l’enveloppe fcb_check du dossier
      FCheckBox Skins de la bibliothèque.
      check1.registerSkinElement(customChk_mc, "check");

FCheckBox.setChangeHandler
      Disponibilité
      Flash Player 6.
      Usage
      maCaseAcocher.setChangeHandler(nomDeFonction, [emplacement])

      Paramètres
      nomDeFonction       Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque
      la valeur de la case à cocher change. Si le paramètre emplacement n’est pas spécifié, cette fonction
      doit se trouver dans le même scénario que l’occurrence de composant.
      emplacement Une référence de chemin à un objet de données, un clip ou scénario contenant la
      fonction spécifiée. Ce paramètre est facultatif et prend par défaut le scénario parent du
      composant.
      Renvoie
      Rien.
      Description
      Méthode ; spécifie un gestionnaire de changement à appeler lorsque la valeur de la case à cocher
      change. Vous pouvez spécifier la même fonction de gestionnaire de changement pour plusieurs
      composants, la fonction acceptant toujours l’occurrence du composant changé comme paramètre.
      L’appel de cette méthode annule la valeur du paramètre de gestionnaire de changement spécifiée
      au cours de la programmation.
      Pour plus d’informations, consultez la section Rédaction de fonctions de gestionnaire de
      changement pour les composants du chapitre Utilisation des composants de Utilisation de Flash.
      Exemple
      Le code suivant spécifie monGestionnaire comme fonction appelée lorsque la valeur de
      checkBox1 change. Le paramètre emplacement n’étant pas spécifié, monGestionnaire doit se
      trouver dans le scénario que l’occurrence de composant.




150
  Le paramètre composant de monGestionnaire est automatiquement rempli avec l’occurrence
  d’un composant (le composant qui a changé en résultat de la saisie utilisateur et qui spécifie
  monGestionnaire en tant que son gestionnaire de changement). Les actions définies dans
  monGestionnaire spécifient que, lorsque l’utilisateur sélectionne une case à cocher, le nom du
  composant et la mention « a été sélectionné » sont affichés dans la fenêtre Sortie.
  checkBox1.setChangeHandler("monGestionnaire");
  function monGestionnaire(composant){
  trace(composant._name + " a été sélectionné ");
  }
  Si, dans l’exemple précédent, monGestionnaire est une fonction située dans le scénario arrière-
  grand-parent du scénario du composant, la première ligne de code serait la suivante :
  check1.setChangeHandler("monGestionnaire", _parent._parent._parent);
  Le code suivant crée la fonction monGestionnaire dans une occurrence de monObjet (de classe
  Object), puis spécifie monGestionnaire comme fonction pour check1.
  monObjet = new Object();
  monObjet.monGestionnaire = function(composant){
  trace(composant._name + " a été sélectionné ");
  }
  check1.setChangeHandler("monGestionnaire", monObjet);

FCheckBox.setEnabled
  Disponibilité
  Flash Player 6.
  Usage
  maCaseAcocher.setEnabled(activerTrueFalse)

  Paramètres
  activerTrueFalse       Une valeur booléenne spécifiant si la case à cocher est activée (true) ou
  désactivée (false).
  Renvoie
  Rien.
  Description
  Méthode ; spécifie si la case à cocher est activée (true) ou désactivée (false). Une case à cocher
  désactivée n’accepte pas l’interaction souris ou clavier avec l’utilisateur. Si vous omettez ce
  paramètre, la méthode prend la valeur par défaut de true.
  Exemple
  Le code suivant désactive checkBox1.
  checkBox1.setEnabled(false);




                                                                        Dictionnaire ActionScript   151
FCheckBox.setLabel
      Disponibilité
      Flash Player 6.
      Usage
      maCaseAcocher.setLabel(étiquette)

      Paramètres
      étiquette       Une chaîne spécifiant l’étiquette de texte de la case à cocher.
      Renvoie
      Rien.
      Description
      Méthode ; spécifie l’étiquette de texte de la case à cocher. Par défaut, l’étiquette apparaît à droite
      de la case à cocher. L’appel de cette méthode annule le paramètre étiquette spécifié au cours de
      la programmation.
      Exemple
      Le code suivant applique l’étiquette Envoyer des informations à checkBox1.
      checkBox1.setLabel("Envoyer des informations");

      Voir aussi
      FCheckBox.getLabel, FCheckBox.setLabelPlacement


FCheckBox.setLabelPlacement
      Disponibilité
      Flash Player 6.
      Usage
      maCaseAcocher.setLabelPlacement(positionDeLétiquette)

      Paramètres
      positionDeLétiquette          Une chaîne de texte ; spécifiez "left" ou "right".
      Renvoie
      Rien.
      Description
      Méthode ; spécifie si l’étiquette apparaît à gauche ou à droite de la case à cocher. L’appel de cette
      méthode annule la valeur du paramètre de position d’étiquette spécifiée au cours de la
      programmation.
      Exemple
      Le code suivant place l’étiquette de checkBox1 à gauche de la case à cocher.
      checkBox1.setLabelPlacement("left");

      Voir aussi
      FCheckBox.setLabel




152
FCheckBox.setSize
   Disponibilité
   Flash Player 6.
   Usage
   maCaseAcocher.setSize(largeur)

   Paramètres
   largeur    Un entier spécifiant la largeur de la case à cocher, en pixels.
   Renvoie
   Rien.
   Description
   Méthode ; spécifie la largeur de la case à cocher et la retrace. Vous ne pouvez pas définir la hauteur
   des composants de case à cocher. L’appel de cette méthode annule la largeur appliquée au cours
   de la programmation.
   Pour plus d’informations, consultez la section Dimensions des composants CheckBox du chapitre
   Utilisation des composants de Utilisation de Flash.
   Exemple
   Le code suivant définit la largeur de checkBox1 sur 200 pixels.
   checkBox1.setSize(200);

FCheckBox.setStyleProperty
   Disponibilité
   Flash Player 6.
   Usage
   maCaseAcocher.setStyleProperty(propriétéDeStyle, valeur)

   Paramètres
   propriétéDeStyle       Une chaîne spécifiant une propriété de l’objet FStyleFormat.
   valeur    La valeur à définir pour la propriété.
   Renvoie
   Rien.
   Description
   Méthode ; définit une propriété FStyleFormat pour une occurrence de case à cocher. L’appel de
   cette méthode pour spécifier une propriété annule le paramètre de cette propriété dans le format
   de style affecté au composant. La transmission de undefined comme valeur de propriété
   supprime tous les styles pour cette propriété.
   Pour définir les propriétés FStyleFormat de plusieurs composants, vous créez un format de style
   personnalisé. Pour plus d’informations sur la création de formats de styles personnalisés, consultez
   la section Personnalisation de la couleur et du texte des composants du chapitre Utilisation des
   composants de Utilisation de Flash.




                                                                           Dictionnaire ActionScript 153
      Exemple
      Le code suivant donne à la propriété shadow de checkBox1 la valeur 0x000000 (noir).
      checkBox1.setStyleProperty("shadow", 0x000000);

      Voir aussi
      FStyleFormat (objet)

FCheckBox.setValue
      Disponibilité
      Flash Player 6.
      Usage
      maCaseAcocher.setValue(sélectionnerTrueFalse)

      Paramètres
      sélectionnerTrueFalse        Une valeur booléenne spécifiant si la case à cocher est sélectionnée
      (true) ou non (false).
      Renvoie
      Rien.
      Description
      Méthode ; sélectionne ou désélectionne maCaseAcocher et déclenche la fonction de gestionnaire
      de changement (si elle existe) spécifiée à l’exécution. La valeur par défaut est true.
      Bien que l’appel de cette méthode annule la valeur du paramètre de valeur initiale spécifié au
      cours de la programmation, mais vous ne devriez pas utiliser cette méthode à cette fin étant donné
      qu’elle déclenche également la fonction de gestionnaire de changement associée. Pour définir le
      paramètre de valeur initiale d’une case à cocher à l’exécution, utilisez
      FCheckBox.setStyleProperty.

      Exemple
      Le code suivant sélectionne l’occurrence de checkBox1 et déclenche toute fonction de
      gestionnaire de changement spécifiée.
      checkBox1.setValue(true);

      Voir aussi
      FCheckBox.getValue

FComboBox (composant)
      Le composant ComboBox de l’environnement auteur de Flash fournit les fonctions glisser-
      déposer pour l’ajout de listes déroulantes à une seule sélection aux documents Flash, mais aussi
      une interface utilisateur de définition des paramètres de base. Les méthodes du composant
      FComboBox vous permettent de contrôler les listes déroulantes à l’exécution : vous pouvez créer
      des listes déroulantes, contrôler des listes déroulantes créées lors de la programmation, définir ou
      remplacer des paramètres de base, et définir des options supplémentaires à l’exécution. Il n’est pas
      nécessaire d’utiliser un constructeur pour accéder aux méthodes des composants.




154
   Le composant ComboBox crée des listes déroulantes statiques ou modifiables. Une liste statique
   est une liste déroulante qui permet aux utilisateurs de sélectionner des éléments. Une liste
   modifiable est une liste déroulante en haut de laquelle se trouve un champ de texte. Vous pouvez
   permettre aux utilisateurs d’entrer du texte dans le champ de texte pour faire défiler la liste
   déroulante jusqu’à l’élément désiré, ou utiliser le champ de texte pour définir du texte affiché à
   l’exécution.
   La version statique et la version modifiable du composant ComboBox affichent toutes deux une
   liste d’éléments de haut en bas en utilisant un système d’indexation basé sur zéro. Si le nombre
   d’éléments de la liste déroulante crée une liste déroulante qui dépasse l’espace disponible en
   dessous du composant, la liste s’ouvre vers le haut au lieu de se dérouler vers le bas.
   Les méthodes des composants n’effectuant pas de vérification d’erreur pour le type, au contraire
   des autres objets et actions ActionScript natifs, il est recommandé de valider les paramètres avant
   de les transmettre aux méthodes.
   Le composant ComboBox est supporté par Flash Player 6 et les versions suivantes de Flash Player.
   Pour plus d’informations sur l’utilisation du composant ComboBox, la définition des paramètres
   au cours de la programmation et le changement de la couleur et de l’apparence des composants,
   consultez Personnalisation de la couleur et du texte des composants et Personnalisation des
   enveloppes de composant dans le chapitre Utilisation des composants de Utilisation de Flash.

Méthodes du composant FComboBox

   Méthode                               Description

   FComboBox.addItem                     Ajoute un élément à la fin de la liste déroulante.

   FComboBox.addItemAt                   Ajoute un élément à la liste déroulante, à l’index spécifié.

   FComboBox.getEnabled                  Renvoie true si la liste déroulante est activée, false si elle est
                                         désactivée.

   FComboBox.getItemAt                   Renvoie l’élément à l’index spécifié sous la forme d’un objet avec les
                                         propriétés label et data.

   FComboBox.getLength                   Renvoie le nombre d’éléments de la liste déroulante.

   FComboBox.getRowCount                 Renvoie le nombre de lignes visibles dans la liste déroulante.

   FComboBox.getScrollPosition           Renvoie l’index de l’élément affiché en haut de la liste déroulante.

   FComboBox.getSelectedIndex            Renvoie l’index de l’élément actuellement sélectionné.

   FComboBox.getSelectedItem             Renvoie l’objet sélectionné sous la forme d’un objet avec les
                                         propriétés label et data.

   FComboBox.getValue                    Renvoie le texte du champ d’entrée pour les listes déroulantes
                                         modifiables ; renvoie l’étiquette ou les données de l’élément
                                         sélectionné pour les listes déroulantes statiques.

   FComboBox.registerSkinElement         Enregistre un élément d’enveloppe dans une propriété.

   FComboBox.removeAll                   Supprime tous les éléments de la liste déroulante.

   FComboBox.removeItemAt                Supprime l’élément à l’index spécifié.

   FComboBox.replaceItemAt               Remplace l’étiquette et les données d’un élément à l’index spécifié.

   FComboBox.setChangeHandler            Affecte une fonction à appeler à chaque fois qu’un élément est
                                         sélectionné ou que l’utilisateur entre du texte dans le champ de texte.




                                                                               Dictionnaire ActionScript 155
      Méthode                                 Description

      FComboBox.setDataProvider               Enregistre un objet extérieur au composant en tant que source de
                                              données.

      FComboBox.setEditable                   Détermine si la liste est modifiable (true) ou statique (false).

      FComboBox.setEnabled                    Spécifie si la liste déroulante est activée (true) ou désactivée
                                              (false).

      FComboBox.setItemSymbol                 Enregistre un identifiant de liaison de symbole pour afficher les
                                              éléments de liste déroulante.

      FComboBox.setRowCount                   Détermine le nombre d’éléments affichés dans la liste déroulante sans
                                              barre de défilement.

      FComboBox.setSelectedIndex              Sélectionne l’élément à l’index spécifié.

      FComboBox.setSize                       Définit la largeur de la liste déroulante, en pixels.

      FComboBox.setStyleProperty              Définit une propriété de style pour une occurrence de composant.

      FComboBox.setValue                      Spécifie le texte affiché dans le champ de texte en haut d’une liste
                                              déroulante.

      FComboBox.sortItemsBy                   Trie les éléments de la zone de liste par ordre alphabétique ou
                                              numérique, par étiquette ou par données.


FComboBox.addItem
      Disponibilité
      Flash Player 6.
      Usage
      maListe.addItem(étiquette [,données])

      Paramètres
      étiquette     Une chaîne de texte à afficher dans la liste.
      données    La valeur à associer à l’élément de liste. Ce paramètre est facultatif.
      Renvoie
      Rien.
      Description
      Méthode ; ajoute un élément avec l’étiquette spécifiée et les données à la fin de la liste déroulante
      et met la liste à jour. Le paramètre données peut être un objet Flash, une chaîne, une valeur
      booléenne, un entier, un objet ou un clip.
      N’ajoutez pas plus de 400 éléments dans une seule image, et ce afin d’obtenir les meilleurs
      résultats de performance. Cela s’applique en fonction du fait que vous ajoutiez les éléments à une
      seule liste déroulante ou à plusieurs listes déroulantes.
      Exemple
      Le code suivant ajoute l’élément Kenny avec une valeur associée de Keen à la fin de la liste de la
      liste déroulante listeDesProfs.
      listeDesProfs.addItem("Kenny", Keen);




156
  Le code suivant ajoute le nombre maximum recommandé d’éléments dans une seule image (400
  éléments) à comboBox1 :
  for (i=0; i<400; i++) {
     comboBox1.addItem(i);
  }
  Le code suivant ajoute le nombre maximum recommandé d’éléments dans une seule image (400
  éléments) à listBox1 et comboBox2 :
  for (i=0; i<200; i++) {
     listBox1.addItem(i);
     comboBox2.addItem(i);
  }

  Voir aussi
  FComboBox.addItemAt, FComboBox.getItemAt, FComboBox.replaceItemAt,
  FComboBox.setDataProvider, FComboBox.sortItemsBy


FComboBox.addItemAt
  Disponibilité
  Flash Player 6.
  Usage
  maListe.addItemAt(index, étiquette [,données])

  Paramètres
  index   Un entier spécifiant la position à laquelle insérer l’élément.
  étiquette      Une chaîne identifiant l’élément de liste de la zone de liste.
  données      La valeur à associer à l’élément de liste. Ce paramètre est facultatif.
  Renvoie
  Rien.
  Description
  Méthode ; ajoute un élément avec l’étiquette spécifiée et les données associées (facultatif ) à la liste
  déroulante, à la position d’index spécifiée. Le paramètre données peut être un objet Flash, une
  chaîne, une valeur booléenne, un entier, un objet ou un clip. La liste est mise à jour et la barre de
  défilement est redimensionnée à mesure que chaque élément est ajouté.
  Le composant ComboBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut
  de la liste.
  N’ajoutez pas plus de 400 éléments dans une seule image, et ce afin d’obtenir les meilleurs
  résultats de performance. Cela s’applique en fonction du fait que vous ajoutez les éléments à une
  seule liste déroulante ou à plusieurs listes déroulantes.
  Exemple
  Le code suivant ajoute l’élément Justin avec une valeur associée de As comme cinquième
  élément de la liste de la liste déroulante Favoris.
  Favoris.addItemAt(4, "Justin", As);




                                                                            Dictionnaire ActionScript 157
      Vous trouverez des exemples de chargement d’un grand nombre d’éléments sous
      FComboBox.addItem.
      Voir aussi
      FComboBox.getItemAt, FComboBox.removeItemAt, FComboBox.replaceItemAt,
      FComboBox.setDataProvider, FComboBox.sortItemsBy


FComboBox.getEnabled
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getEnabled()

      Paramètres
      Aucun.
      Renvoie
      Une valeur booléenne indiquant si la liste déroulante est activée (true) ou désactivée (false).
      Description
      Méthode ; indique si la liste déroulante est activée.
      Exemple
      Le code suivant utilise getEnabled pour déterminer si comboBox1 est activée ou désactivée et
      affiche le résultat dans la fenêtre Sortie.
      trace(comboBox1.getEnabled());

      Voir aussi
      FComboBox.setEnabled

FComboBox.getItemAt
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getItemAt(index)

      Paramètres
      index    Un entier spécifiant la position d’un élément dans la liste déroulante.
      Renvoie
      Un objet.
      Description
      Méthode ; renvoie l’élément à l’index spécifié sous la forme d’un objet avec les propriétés label et
      data.

      Le composant ComboBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut
      de la liste.




158
  Exemple
  Le code suivant renvoie l’étiquette de l’élément à l’index 4 de comboBox1 sous la forme d’une
  chaîne.
  trace(comboBox1.getItemAt(4).label);
  Le code suivant renvoie les données associées à l’élément à l’index 4 de comboBox2. La valeur
  renvoyée dépend du type de données et peut être un objet, une chaîne, une référence à un clip ou
  une autre valeur.
  trace(comboBox2.getItemAt(4).data);
  Le code suivant renvoie un objet contenant l’étiquette et les données associées à l’élément à
  l’index 4 de comboBox3.
  trace(comboBox3.getItemAt(4));

  Voir aussi
  FComboBox.getSelectedItem

FComboBox.getLength
  Disponibilité
  Flash Player 6.
  Usage
  maListe.getLength()

  Paramètres
  Aucun.
  Renvoie
  Un entier.
  Description
  Méthode ; renvoie le nombre d’éléments de la liste déroulante.
  Exemple
  Le code suivant récupère le nombre d’éléments dans la liste de listePrincipale et l’enregistre
  dans la variable lon.
  var lon = listePrincipale.getLength();

  Voir aussi
  FComboBox.addItem, FComboBox.addItemAt


FComboBox.getRowCount
  Disponibilité
  Flash Player 6.
  Usage
  maListe.getRowCount()

  Paramètres
  Aucun.



                                                                        Dictionnaire ActionScript 159
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie le nombre de lignes visibles dans la liste déroulante.
      Exemple
      Le code suivant renvoie le nombre de lignes visibles dans listeDeJouets et définit la valeur avec
      la variable nombreDeLignes.
      var nombreDeLignes = listeDeJouets.getRowCount();

      Voir aussi
      FComboBox.setRowCount

FComboBox.getScrollPosition
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getScrollPosition()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie l’index de l’élément affiché en haut de la liste déroulante.
      Le composant ComboBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut
      de la liste.
      Exemple
      Le code suivant récupère l’index du premier élément de la liste de listeDeJouets et l’enregistre
      dans la variable posDéfilement.
      var posDéfilement = listeDeJouets.getScrollPosition();

      Voir aussi
      FComboBox.setSelectedIndex

FComboBox.getSelectedIndex
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getSelectedIndex()

      Paramètres
      Aucun.




160
  Renvoie
  Un entier ou undefined.
  Description
  Méthode ; renvoie l’index de l’élément actuellement sélectionné dans la liste déroulante ou
  renvoie undefined si aucun élément n’est sélectionné.
  Les éléments sont classés dans la liste déroulante de haut en bas, en utilisant un index basé sur
  zéro.
  Exemple
  Le code suivant récupère l’index de l’élément sélectionné dans listeDeJouets et l’enregistre dans
  la variable indexSél.
  var indexSél = listeDeJouets.getSelectedIndex();

  Voir aussi
  FComboBox.setSelectedIndex

FComboBox.getSelectedItem
  Disponibilité
  Flash Player 6.
  Usage
  maListe.getSelectedItem()

  Paramètres
  Aucun.
  Renvoie
  Un objet ou undefined.
  Description
  Méthode ; renvoie l’objet sélectionné sous la forme d’un objet avec les propriétés label et data,
  ou renvoie undefined si aucun élément n’est sélectionné.
  Exemple
  Le code suivant récupère l’étiquette et les données de l’élément sélectionné dans comboBox1.
  trace(comboBox1.getSelectedItem());
  Le code suivant récupère l’étiquette de l’élément sélectionné dans comboBox2.
  trace(comboBox2.getSelectedItem().label);
  Le code suivant récupère les données de l’élément sélectionné dans comboBox3.
  trace(comboBox3.getSelectedItem().data);

  Voir aussi
  FComboBox.setSelectedIndex




                                                                         Dictionnaire ActionScript    161
FComboBox.getValue
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getValue()

      Paramètres
      Aucun.
      Renvoie
      Une chaîne de texte.
      Description
      Méthode ; renvoie le texte du champ en haut de la liste si celle-ci est modifiable. Si la liste est
      statique (pas modifiable), cette méthode renvoie les données associées à l’élément sélectionné, ou
      l’étiquette de l’élément si aucune donnée n’y est associée.
      Exemple
      Le code suivant renvoie les données ou l’étiquette de l’élément sélectionné dans menuPrincipal.
      trace(menuPrincipal.getValue())

      Voir aussi
      FComboBox.setValue

FComboBox.registerSkinElement
      Disponibilité
      Flash Player 6.
      Usage
      maListe.registerSkinElement(élément, propriétéDeStyle)

      Paramètres
      élément      Une occurrence de clip.
      propriétéDeStyle       Le nom d’une propriété FStyleFormat.
      Renvoie
      Rien.
      Description
      Méthode ; enregistre un élément d’enveloppe dans une propriété de style. Les éléments
      d’enveloppes sont enregistrés dans les propriétés de la première image du calque Lisez-moi de
      chaque enveloppe de la bibliothèque.
      Les composants sont constitués d’enveloppes, chaque enveloppe étant constituée de plusieurs
      éléments d’enveloppe, lesquels peuvent être enregistrés dans une propriété de l’objet
      FStyleFormat. Ces propriétés reçoivent des valeurs du format de style affecté à un composant. Par
      défaut, tous les composants d’interface Flash reçoivent l’objet globalStyleFormat, qui est une
      occurrence de l’objet FStyleFormat.




162
  Utilisez cette méthode pour enregistrer des éléments d’enveloppes et des propriétés personnalisés
  aux enveloppes de composant d’interface Flash ou personnalisées en modifiant le code dans la
  première image du calque Lisez-moi d’une enveloppe de la bibliothèque.
  Le composant FComboBox utilise les enveloppes du dossier FComboBox Skins une fois le
  composant ajouté au document Flash.
  Pour plus d’informations, consultez la section Personnalisation des enveloppes de composant du
  chapitre Utilisation des composants de Utilisation de Flash.
  Exemple
  Le code suivant enregistre l’élément d’enveloppe personnalisée boundBox_mc avec la propriété
  background dans la première image du calque Lisez-moi de l’enveloppe FBoundingBox du
  dossier Global Skins.
  menuDeJouets.registerSkinElement(boundBox_mc, "background");

FComboBox.removeAll
  Disponibilité
  Flash Player 6.
  Usage
  maListe.removeAll()

  Paramètres
  Aucun.
  Renvoie
  Rien.
  Description
  Méthode ; supprime tous les éléments de liste déroulante, la met à jour, et redimensionne la barre
  de défilement. Les listes déroulantes sans élément sont affichées sans barre de défilement. Cette
  méthode ne peut pas être utilisée si la liste déroulante est désactivée.
  Exemple
  Le code suivant supprime tous les éléments de menuPrincipal.
  menuPrincipal.removeAll();

  Voir aussi
  FComboBox.removeItemAt

FComboBox.removeItemAt
  Disponibilité
  Flash Player 6.
  Usage
  maListe.removeItemAt(index)

  Paramètres
  index    Un entier spécifiant l’index de l’élément à supprimer.




                                                                       Dictionnaire ActionScript 163
      Renvoie
      Un objet contenant l’élément supprimé.
      Description
      Méthode ; renvoie l’élément supprimé à l’index spécifié et met la liste à jour. Lorsqu’un élément
      est retiré de la liste, les index des éléments suivants sont mis à jour pour refléter leur nouvelle
      position dans la liste. Si aucun élément n’existe à l’index spécifié, la méthode renvoie undefined.
      Le composant ComboBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut
      de la liste.
      Exemple
      Le code suivant supprime le cinquième élément de la liste de menuPrincipal.
      menuPrincipal.removeItemAt(4);

      Voir aussi
      FComboBox.removeAll

FComboBox.replaceItemAt
      Disponibilité
      Flash Player 6.
      Usage
      maListe.replaceItemAt(index, étiquette [,données])

      Paramètres
      index   Un entier spécifiant la position de l’élément de liste.
      étiquette     Une chaîne spécifiant une nouvelle étiquette pour l’élément de liste.
      données La nouvelle valeur à associer à l’élément de liste. Ce paramètre est facultatif. Si vous ne
      le spécifiez pas, les données spécifiées pour l’élément restent en place.
      Renvoie
      Rien.
      Description
      Méthode ; met à jour l’élément à l’index spécifié avec l’étiquette et les données spécifiées. Si
      l’élément à l’index spécifié est associé à une valeur de données et que vous ne spécifiez pas de
      valeur pour le paramètre data, la valeur de données de l’élément n’est pas modifiée.
      Le composant ComboBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut
      de la liste.
      Exemple
      Le code suivant met le cinquième élément de la liste déroulante Favoris à jour avec l’étiquette
      Nigel et la valeur 7439. Si aucune donnée n’a été spécifiée pour l’élément de la liste, Nigel prend
      la valeur de données de l’élément de liste existant.
      Favoris.replaceItemAt(4, "Nigel", "7439");

      Voir aussi
      FComboBox.addItemAt, FComboBox.getItemAt, FComboBox.setDataProvider,
      FComboBox.sortItemsBy




164
FComboBox.setChangeHandler
  Disponibilité
  Flash Player 6.
  Usage
  maListe.setChangeHandler(nomDeFonction, [emplacement])

  Paramètres
  nomDeFonction        Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque
  la sélection de la liste déroulante change. Si le paramètre emplacement n’est pas spécifié, cette
  fonction doit se trouver dans le même scénario que l’occurrence de composant.
  emplacement Une référence de chemin à un objet de données, un clip ou scénario contenant la
  fonction spécifiée. Ce paramètre est facultatif et prend par défaut le scénario parent du
  composant.
  Renvoie
  Rien.
  Description
  Méthode ; spécifie un gestionnaire de changement à appeler lorsque la sélection de la liste
  déroulante change. Vous pouvez spécifier la même fonction de gestionnaire de changement pour
  plusieurs composants, la fonction acceptant toujours l’occurrence du composant changé comme
  paramètre. L’appel de cette méthode annule la valeur du paramètre de gestionnaire de
  changement spécifiée au cours de la programmation.
  Pour plus d’informations, consultez la section Rédaction de fonctions de gestionnaire de
  changement pour les composants du chapitre Utilisation des composants de Utilisation de Flash.
  Exemple
  Le code suivant spécifie monGestionnaire comme fonction appelée lorsque la valeur de
  listeDeJouets change. Le paramètre emplacement n’étant pas spécifié, monGestionnaire doit
  se trouver dans le scénario que l’occurrence de composant.
  Le paramètre composant de monGestionnaire est automatiquement rempli avec l’occurrence
  d’un composant (le composant qui a changé en résultat de la saisie utilisateur et qui spécifie
  monGestionnaire en tant que son gestionnaire de changement). Les actions définies dans
  monGestionnaire spécifient que, lorsque l’utilisateur sélectionne un élément de la liste,
  l’étiquette de cet élément est affichée dans la fenêtre Sortie.
  listeDeJouets.setChangeHandler("monGestionnaire");
  function monGestionnaire(composant){
     trace(listeDeJouets.getSelectedItem().label);
  }
  Si, dans l’exemple précédent, monGestionnaire est une fonction située dans le scénario arrière-
  grand-parent du scénario du composant, la première ligne de code serait la suivante :
  listeDeJouets.setChangeHandler("monGestionnaire", _parent._parent._parent);




                                                                        Dictionnaire ActionScript 165
      Le code suivant crée la fonction monGestionnaire dans une occurrence de monObjet (de classe
      Object), puis spécifie monGestionnaire comme fonction pour listeDeJouets.
      monObjet = new Object();
      monObjet.monGestionnaire = function(composant){
      trace(listeDeJouets.getSelectedItem().label);
      }
      listeDeJouets.setChangeHandler("monGestionnaire", monObjet);

FComboBox.setDataProvider
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setDataProvider(fournisseurDeDonnées)

      Paramètres
      fournisseurDeDonnées       Un tableau de chaînes de texte contenant les éléments à ajouter, une
      occurrence de l’objet Array spécifiant les éléments à ajouter, ou une occurrence de la classe
      DataProvider.
      Renvoie
      Rien.
      Description
      Méthode ; enregistre un objet externe (fournisseurDeDonnées) comme source de données pour
      le composant de liste déroulante. Si fournisseurDeDonnées est une occurrence de l’objet Array,
      l’objet peut spécifier label, data, ou les deux, puisque les propriétés de l’objet et le contenu du
      tableau peuvent être copiés dans la liste déroulante comme étiquettes, données, ou les deux. Si
      fournisseurDeDonnées est une occurrence de la classe DataProvider, elle doit implémenter
      l’API DataProvider définie dans le symbole DataProvider du dossier FlashUIComponents/Core
      Assets/ClassTree de la bibliothèque. L’API DataProvider est destinée aux utilisateurs confirmés,
      les autres devant utiliser un tableau ou un objet Array.
      Exemple
      Le code suivant spécifie l’objet Array listeDeGens1 comme fournisseur de données pour
      comboBox1.
      comboBox1.setDataProvider(listeDeGens1);
      Le code suivant crée le tableau listeDeGens pour afficher les étiquettes des éléments affichés
      dans comboBox1.
      listeDeGens = new Array();
      listeDeGens[0] = "BHall";
      listeDeGens[1] = "CMoock";
      listeDeGens[2] = "MWobensmith";
      listeDeGens[3] = "MShepherd";




166
   Le code suivant crée le tableau listeDéléments1, qui spécifie l’étiquette et les données des
   éléments de la liste. Cet objet Array pourrait être utilisé comme autre fournisseur de données pour
   comboBox1.
   listeDéléments1 = new Array();
   for (i=0; i<10; i++) {
   // créer un élément
     var monElément = new Object();
     monElément.label = "Elément" + i;
     monElément.data = 75;
   // le placer dans le tableau
   listeDéléments1[i] = monElément;
   }
   Le code suivant spécifie donnéesDeListe, une occurrence de la classe DataProvider, comme
   fournisseur de données pour comboBox1.
   comboBox1.setDataProvider(donnéesDeListe);
   Le code suivant crée une occurrence de la classe DataProvider et ajoute ensuite les étiquettes des
   éléments à l’aide de la méthode addItem de DataProvider.
   Remarque La méthode addItem n’est qu’une des méthodes de la classe DataProvider. Les programmeurs
   intéressés par l’utilisation de la classe DataProvider pourront consulter le symbole DataProvider dans le dossier
   FlashUIComponents/CoreAssets/ClassTree de la bibliothèque avant d’essayer d’utiliser ces méthodes.

   donnéesDeListe = new DataProviderClass();

   donnéesDeListe.addItem("Devra");
   donnéesDeListe.addItem("Delia");
   donnéesDeListe.addItem("Vashti");
   donnéesDeListe.addItem("Alicia");

   Voir aussi
   FComboBox.addItem, FComboBox.replaceItemAt, FComboBox.sortItemsBy


FComboBox.setEditable
   Disponibilité
   Flash Player 6.
   Usage
   maListe.setEditable(modifiable)

   Paramètres
   modifiable Une valeur booléenne spécifiant si la zone de texte est modifiable (true) ou
   statique (false).
   Renvoie
   Rien.
   Description
   Méthode ; détermine si la liste est modifiable (true) ou statique (false). Une liste modifiable a
   un champ de texte et, lorsque l’utilisateur entre du texte, la liste déroulante défile jusqu’à
   l’élément comportant le même texte. Le champ de texte peut également être utilisé pour afficher
   du texte à l’aide de FComboBox.setValue. L’appel de cette méthode annule la valeur du
   paramètre éditable spécifiée au cours de la programmation.



                                                                                     Dictionnaire ActionScript 167
      Exemple
      Le code suivant active un champ de texte de saisie en haut de menuPrincipal.
      menuPrincipal.setEditable(true);

      Voir aussi
      FComboBox.setValue

FComboBox.setEnabled
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setEnabled(activerTrueFalse)

      Paramètres
      activerTrueFalse        Une valeur booléenne spécifiant si la zone de texte est activée (true) ou
      désactivée (false).
      Renvoie
      Rien.
      Description
      Méthode ; détermine si la liste déroulante est activée (true) ou désactivée (false). Une liste
      déroulante désactivée n’accepte pas l’interaction souris ou clavier avec l’utilisateur. Si vous
      omettez ce paramètre, la méthode prend la valeur par défaut de true.
      Exemple
      Le code suivant désactive menuPrincipal.
      menuPrincipal.setEnabled(false);

      Voir aussi
      FListBox.getEnabled

FComboBox.setItemSymbol
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setItemSymbol(idDeSymbole)

      Paramètres
      idDeSymbole       L’identifiant de liaison d’un symbole graphique pour afficher le contenu de la liste
      déroulante.
      Renvoie
      Rien.
      Description
      Méthode ; enregistre un symbole graphique pour afficher les éléments de liste déroulante. La
      valeur par défaut est le symbole FComboBoxItem dans la bibliothèque. Cette méthode est prévue
      pour les utilisateurs et programmeurs expérimentés.


168
FComboBox.setRowCount
  Disponibilité
  Flash Player 6.
  Usage
  maListe.setRowCount(lignes)

  Paramètres
  lignes    Le nombre maximum de lignes que la liste déroulante peut afficher sans défilement.
  Renvoie
  Rien.
  Description
  Méthode ; définit le nombre d’éléments qui peuvent être affichés dans la liste déroulante sans
  défilement. La valeur minimum pour le paramètre lignes est 3. L’appel de cette méthode annule
  la valeur du paramètre de nombre de lignes spécifiée au cours de la programmation.
  Exemple
  Le code suivant définit le nombre d’éléments affichés dans la liste déroulante de menuPrincipal
  sur 4.
  menuPrincipal.setRowCount(4);

  Voir aussi
  FComboBox.setSize



FComboBox.setSelectedIndex
  Disponibilité
  Flash Player 6.
  Usage
  maListe.setSelectedIndex(index)

  Paramètres
  index    Un entier spécifiant l’index de l’élément à sélectionner.
  Renvoie
  Rien.
  Description
  Méthode ; sélectionne l’élément spécifié et met la liste déroulante à jour pour afficher l’élément
  sélectionné. L’appel de cette méthode n’affecte pas l’état actuel (ouvert ou fermé) de la liste
  déroulante. Cette méthode ne peut pas être utilisée si la liste déroulante est désactivée.
  Le composant ComboBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut
  de la liste.




                                                                        Dictionnaire ActionScript 169
      Exemple
      Le code suivant sélectionne le quatrième élément de la liste de menuPrincipal.
      menuPrincipal.setSelectedIndex(3);

      Voir aussi
      FComboBox.setRowCount

FComboBox.setSize
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setSize(largeur)

      Paramètres
      largeur      Un entier spécifiant la largeur de la liste déroulante, en pixels.
      Renvoie
      Rien.
      Description
      Méthode ; redimensionne la liste déroulante à la largeur spécifiée. Vous ne pouvez pas définir la
      hauteur des composants de liste déroulante. Utilisez cette méthode pour redimensionner la liste
      déroulante et la mettre à jour à l’exécution.
      Exemple
      Le code suivant définit ou redimensionne la largeur de menuPrincipal sur 100 pixels.
      menuPrincipal.setSize(100);

      Voir aussi
      FComboBox.setRowCount

FComboBox.setStyleProperty
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setStyleProperty(propriétéDeStyle, valeur)

      Paramètres
      propriétéDeStyle         Une chaîne spécifiant une propriété de l’objet FStyleFormat.
      valeur    La valeur à définir pour la propriété.
      Renvoie
      Rien.




170
  Description
  Méthode ; définit une propriété FStyleFormat pour une occurrence de liste déroulante. L’appel
  de cette méthode pour spécifier une propriété annule le paramètre de cette propriété dans le
  format de style affecté au composant. La transmission de undefined comme valeur de propriété
  supprime tous les styles pour cette propriété.
  Pour définir les propriétés FStyleFormat de plusieurs composants, vous créez un format de style
  personnalisé. Pour plus d’informations sur la création de formats de styles personnalisés, consultez
  la section Personnalisation de la couleur et du texte des composants du chapitre Utilisation des
  composants de Utilisation de Flash.
  Exemple
  Le code suivant donne à la propriété arrow de comboBox1 la valeur 0x000000 (noir).
  comboBox1.setStyleProperty("arrow", 0x000000);

  Voir aussi
  FStyleFormat (objet)

FComboBox.setValue
  Disponibilité
  Flash Player 6.
  Usage
  maListe.setValue(texteModifiable)

  Paramètres
  texteModifiable       Une chaîne spécifiant le texte devant apparaître dans le champ de texte
  d’une liste déroulante.
  Renvoie
  Rien.
  Description
  Méthode ; spécifie le texte affiché dans le champ de saisie en haut d’une liste déroulante.
  L’utilisateur peut toujours saisir du texte dans le champ si vous appelez cette méthode.
  Cette méthode peut être utilisée uniquement avec des listes déroulantes modifiables. Avant
  d’appeler cette méthode, vous devez spécifier true pour le paramètre Editable (qui a par défaut la
  valeur false) au cours de la programmation ou utiliser FComboBox.setEditable pour donner
  au paramètre la valeur true.
  Exemple
  Le code suivant entre la chaîne Gabino dans le champ du haut de la liste déroulante menuDeNoms.
  menuDeNoms.setValue("Gabino");

  Voir aussi
  FComboBox.getValue




                                                                         Dictionnaire ActionScript   171
FComboBox.sortItemsBy
      Disponibilité
      Flash Player 6.
      Usage
      maListe.sortItemsBy(nomDeChamp, ordre)

      Paramètres
      nomDeChamp Une chaîne spécifiant le nom du champ utilisé pour le tri. Il s’agit normalement de
      "label" ou "data".

      ordre Une     chaîne spécifiant le tri des éléments par ordre croissant ("ASC") ou décroissant
      ("DESC").
      Renvoie
      Rien.
      Description
      Méthode ; trie les éléments de la liste déroulante par ordre alphabétique ou numérique, dans
      l’ordre spécifié, avec le nom de champ spécifié. Si les éléments nomDeChamp sont une combinaison
      de chaînes de texte et d’entiers, c’est les éléments entiers qui sont indiqués en premier. Le
      paramètre nomDeChamp est généralement label ou data, les programmeurs expérimentés
      pouvant spécifier toute primitive correspondant à leurs besoins.
      Exemple
      Le code suivant trie les éléments de la liste déroulante menuDeNoms par ordre croissant en utilisant
      leurs étiquettes.
      menuDeNoms.sortItemsBy("label", "ASC");

      Voir aussi
      FComboBox.addItemAt, FComboBox.replaceItemAt, FComboBox.setDataProvider


FListBox (composant)
      Le composant ListBox de l’environnement auteur de Flash fournit les fonctions glisser-déposer
      pour l’ajout de zones de liste à une seule ou plusieurs sélection aux documents Flash, mais aussi
      une interface utilisateur de définition des paramètres de base. Les méthodes du composant
      FListBox vous permettent de contrôler les zones de liste à l’exécution : vous pouvez créer des
      zones de liste, contrôler des zones de liste créées lors de la programmation, définir ou remplacer
      des paramètres de base, et définir des options supplémentaires à l’exécution. Il n’est pas nécessaire
      d’utiliser un constructeur pour accéder aux méthodes des composants.
      Les méthodes des composants n’effectuant pas de vérification d’erreur pour le type, au contraire
      des autres objets et actions ActionScript natifs, il est recommandé de valider les paramètres avant
      de les transmettre aux méthodes.
      Le composant ListBox est supporté par Flash Player 6 et les versions suivantes de Flash Player.
      Pour plus d’informations sur l’utilisation du composant ListBox, la définition des paramètres au
      cours de la programmation et le changement de la couleur et de l’apparence des composants,
      consultez les sections Personnalisation de la couleur et du texte des composants et
      Personnalisation des enveloppes de composant du chapitre Utilisation des composants de
      Utilisation de Flash.



172
Méthodes du composant FListBox

    Méthode                         Description

    FListBox.addItem                Ajoute un élément à la fin de la liste.

    FListBox.addItemAt              Ajoute un élément à la liste, à l’index spécifié.

    FListBox.getEnabled             Renvoie true si la zone de liste est activée, false si elle est
                                    désactivée.

    FListBox.getItemAt              Renvoie l’étiquette et la valeur de l’élément à l’index spécifié.

    FListBox.getLength              Renvoie le nombre d’éléments de la zone de liste.

    FListBox.getRowCount            Renvoie le nombre d’éléments visibles dans la zone de liste.

    FListBox.getScrollPosition      Renvoie l’index de l’élément affiché en haut de la zone de liste.

    FListBox.getSelectedIndex       Renvoie l’index du dernier élément sélectionné.

    FListBox.getSelectedIndices     Renvoie les index de plusieurs éléments sélectionnés.

    FListBox.getSelectedItem        Renvoie l’étiquette et la valeur de l’élément sélectionné.

    FListBox.getSelectedItems       Renvoie l’étiquette et la valeur de plusieurs éléments sélectionnés.

    FListBox.getSelectMultiple      Renvoie true si la sélection multiple est autorisée, false si la
                                    sélection unique est autorisée.

    FListBox.getValue               Renvoie l’étiquette de l’élément sélectionné ou toute information sur
                                    les données associées.

    FListBox.registerSkinElement    Enregistre un élément d’enveloppe dans une propriété.

    FListBox.removeAll              Supprime tous les éléments de la zone de liste.

    FListBox.removeItemAt           Supprime l’élément à l’index spécifié.

    FListBox.replaceItemAt          Remplace l’étiquette et les données d’un élément à un index spécifié
                                    par une nouvelle étiquette et de nouvelles données.

    FListBox.setAutoHideScrollBar   Détermine si une barre de défilement est masquée (true) ou affichée
                                    (false) lorsque le nombre d’éléments de la zone de liste ne nécessite
                                    pas de défilement.

    FListBox.setChangeHandler       Affecte une fonction à appeler à chaque fois que la sélection change.

    FListBox.setDataProvider        Associe un objet extérieur à la zone de liste.

    FListBox.setEnabled             Spécifie si la zone de liste est activée (true) ou désactivée (false).

    FListBox.setItemSymbol          Enregistre un identifiant de liaison de symbole pour afficher les
                                    éléments de zone de liste.

    FListBox.setRowCount            Détermine le nombre d’éléments affichés dans la zone de liste.

    FListBox.setScrollPosition      Entraîne le défilement de la liste pour afficher l’élément à l’index
                                    spécifié en haut de la liste.

    FListBox.setSelectedIndex       Sélectionne l’élément à l’index spécifié et met la zone de liste à jour.

    FListBox.setSelectedIndices     Sélectionne les éléments aux index spécifiés et met la zone de liste à
                                    jour.

    FListBox.setSelectMultiple      Détermine si l’utilisateur peut sélectionner plus d’un élément dans la
                                    liste (true) ou non (false).

    FListBox.setSize                Définit la largeur et la hauteur de la zone de liste, en pixels.

    FListBox.setStyleProperty       Définit une propriété de style pour un composant.




                                                                              Dictionnaire ActionScript 173
      Méthode                                  Description

      FListBox.setWidth                        Définit la largeur de la zone de liste, en pixels.

      FListBox.sortItemsBy                     Trie les éléments de la zone de liste par ordre alphabétique ou
                                               numérique, par étiquette ou par données.


FListBox.addItem
      Disponibilité
      Flash Player 6.
      Usage
      maListe.addItem(étiquette [, données])

      Paramètres
      étiquette       Une chaîne de texte spécifiant l’élément à ajouter à la liste.
      données      Une valeur associée à l’élément de liste. Ce paramètre est facultatif.
      Renvoie
      Rien.
      Description
      Méthode ; ajoute un élément avec l’étiquette spécifiée et les données associées (facultatif ) à la fin
      de la zone de liste, la met à jour et redimensionne la barre de défilement. Le paramètre données
      peut être un objet Flash, une chaîne, une valeur booléenne, un entier, un objet ou un clip.
      N’ajoutez pas plus de 400 éléments dans une seule image, et ce afin d’obtenir les meilleurs
      résultats de performance. Cela s’applique en fonction du fait que vous ajoutez les éléments à une
      seule zone de liste ou à plusieurs zones de liste.
      Exemple
      Le code suivant ajoute Lyvia à la liste des éléments affichés dans la zone de liste
      fillesGéniales.
      fillesGéniales.addItem("Lyvia");
      Le code suivant ajoute le nombre maximum recommandé d’éléments dans une seule image (400
      éléments) à listBox1 :
      for (i=0; i<400; i++) {
         listBox1.addItem(i);
      }
      Le code suivant ajoute le nombre maximum recommandé d’éléments dans une seule image (400
      éléments) à listBox1 et comboBox2 :
      for (i=0; i<200; i++) {
         listBox1.addItem(i);
         comboBox2.addItem(i);
      }

      Voir aussi
      FListBox.addItemAt, FListBox.getItemAt, FListBox.removeItemAt,
      FListBox.replaceItemAt, FListBox.sortItemsBy




174
FListBox.addItemAt
   Disponibilité
   Flash Player 6.
   Usage
   maListe.addItemAt(index, étiquette [, données])

   Paramètres
   index    Un entier spécifiant la position d’index à laquelle ajouter l’élément.
   étiquette       Une chaîne de texte spécifiant l’étiquette de l’élément.
   données      Une valeur associée à l’élément de liste. Ce paramètre est facultatif.
   Renvoie
   Rien.
   Description
   Méthode ; ajoute un élément avec l’étiquette spécifiée et les données associées (facultatif ) à l’index
   spécifié et met la zone de liste à jour. Le paramètre données peut être un objet Flash, une chaîne,
   une valeur booléenne, un entier, un objet ou un clip.
   Le composant ListBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut de la
   liste.
   N’ajoutez pas plus de 400 éléments dans une seule image, et ce afin d’obtenir les meilleurs
   résultats de performance. Cela s’applique en fonction du fait que vous ajoutez les éléments à une
   seule zone de liste ou à plusieurs zones de liste.
   Exemple
   Le code suivant ajoute l’élément Dave avec une valeur associée de ami comme cinquième élément
   de la zone de liste listeDeGens.
   listeDeGens.addItemAt(4, "Dave", ami);
   Vous trouverez des exemples de chargement d’un grand nombre d’éléments sous
   FListBox.addItem.
   Voir aussi
   FListBox.getSelectedItem, FListBox.removeItemAt, FListBox.replaceItemAt,
   FListBox.sortItemsBy


FListBox.getEnabled
   Disponibilité
   Flash Player 6.
   Usage
   maListe.getEnabled()

   Paramètres
   Aucun.
   Renvoie
   Une valeur booléenne indiquant si la liste est activée (true) ou désactivée (false).



                                                                              Dictionnaire ActionScript 175
      Description
      Méthode ; indique si la zone de liste est activée.
      Exemple
      Le code suivant utilise getEnabled pour déterminer si menuDeListe est activée ou désactivée et
      affiche le résultat dans la fenêtre Sortie.
      trace(menuDeListe.getEnabled());

      Voir aussi
      FListBox.setEnabled

FListBox.getItemAt
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getItemAt(index)

      Paramètres
      index   Un entier spécifiant l’index de l’élément à récupérer.
      Renvoie
      Un objet ou undefined.
      Description
      Méthode ; renvoie l’élément à l’index spécifié sous la forme d’un objet avec les propriétés label et
      data. Si aucun élément n’existe à l’index spécifié, la méthode renvoie undefined.

      Le composant ListBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut de la
      liste.
      Exemple
      Le code suivant renvoie l’étiquette de l’élément à l’index 4 de menuDeListe1 dans la fenêtre
      Sortie.
      trace(menuDeListe1.getItemAt(4).label);
      Le code suivant renvoie les données ou la valeur associées à l’élément à l’index 4 de menuDeListe2
      dans la fenêtre Sortie.
      trace(menuDeListe2.getItemAt(4).data);
      Le code suivant renvoie un objet contenant l’étiquette et les données associées à l’élément à
      l’index 4 de menuDeListe1 dans la fenêtre Sortie.
      trace(menuDeListe3.getItemAt(4));

      Voir aussi
      FListBox.getSelectedItem




176
FListBox.getLength
   Disponibilité
   Flash Player 6.
   Usage
   maListe.getLength()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie le nombre d’éléments de la zone de liste.
   Exemple
   Le code suivant renvoie le nombre d’éléments dans listeTéléphone.
   listeTéléphone.getLength();

   Voir aussi
   FListBox.setSize

FListBox.getRowCount
   Disponibilité
   Flash Player 6.
   Usage
   maListe.getRowCount()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie le nombre de lignes visibles dans la zone de liste. Cette méthode est utile pour
   déterminer le nombre de lignes affichées dans une zone de liste dimensionnée en pixels.
   Exemple
   Le code suivant renvoie le nombre de lignes visibles dans listeDeJouets et définit la valeur avec
   la variable nombreDeLignes.
   var nombreDeLignes = listeDeJouets.getRowCount();

   Voir aussi
   FListBox.setRowCount, FListBox.setSize




                                                                        Dictionnaire ActionScript 177
FListBox.getScrollPosition
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getScrollPosition()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie l’index de l’élément affiché en haut de la liste.
      Exemple
      Le code suivant renvoie l’index de l’élément en haut de listePersonnel.
      listePersonnel.getScrollPosition();

      Voir aussi
      FListBox.setScrollPosition

FListBox.getSelectedIndex
      Disponibilité
      Flash Player 5
      Usage
      maListe.getSelectedIndex()

      Paramètres
      Aucun.
      Renvoie
      Un entier ou undefined.
      Description
      Méthode ; renvoie l’index de l’élément actuellement sélectionné dans une zone de liste à une seule
      sélection, du dernier élément sélectionné dans une zone de liste à plusieurs sélections, ou
      undefined si aucun élément n’est sélectionné. Pour récupérer les index de tous les éléments
      sélectionnés dans une zone de liste à plusieurs sélections, utilisez
      FListBox.getSelectedIndices.

      Exemple
      Le code suivant renvoie l’index de l’élément sélectionné dans la zone de liste à une section
      listeNations.
      listeNations.getSelectedIndex();

      Voir aussi
      FListBox.setSelectedIndices, FListBox.setSelectMultiple




178
FListBox.getSelectedIndices
   Disponibilité
   Flash Player 6.
   Usage
   maListe.getSelectedIndices()

   Paramètres
   Aucun.
   Renvoie
   Un tableau ou undefined.
   Description
   Méthode ; renvoie les index des éléments actuellement sélectionnés dans une zone de liste à
   plusieurs sélections sous forme de tableau, ou renvoie undefined si aucun élément n’est
   sélectionné.
   Exemple
   Le code suivant renvoie les index des éléments sélectionnés dans la zone de liste à plusieurs
   sélections listeCourses sous la forme d’un tableau.
   listeCourses.getSelectedIndices();

   Voir aussi
   FListBox.getSelectedIndex, FListBox.setSelectMultiple


FListBox.getSelectedItem
   Disponibilité
   Flash Player 6.
   Usage
   maListe.getSelectedItem()

   Paramètres
   Aucun.
   Renvoie
   Un objet ou undefined.
   Description
   Méthode ; renvoie l’objet sélectionné sous la forme d’un objet avec les propriétés label et data.
   Si plusieurs éléments sont sélectionnés, la méthode renvoie le dernier élément sélectionné de la
   liste ; si aucun élément n’est sélectionné, la méthode renvoie undefined. Pour récupérer des
   informations sur tous les éléments sélectionnés dans une zone de liste à plusieurs sélections,
   utilisez FListBox.getSelectedItems.
   Exemple
   Le code suivant renvoie l’étiquette de l’élément sélectionné dans listBox1.
   trace(listBox1.getSelectedItem().label);




                                                                         Dictionnaire ActionScript 179
      Le code suivant renvoie les données ou la valeur associée à l’élément sélectionné dans listBox2.
      trace(listBox2.getSelectedItem().data);
      Le code suivant renvoie un objet contenant l’étiquette et les données associées à l’élément
      sélectionné dans listBox3.
      trace(listBox3.getSelectedItem());

      Voir aussi
      FListBox.getItemAt

FListBox.getSelectedItems
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getSelectedItems()

      Paramètres
      Aucun.
      Renvoie
      Un tableau ou undefined.
      Description
      Méthode ; renvoie l’objet sélectionné sous la forme d’un tableau d’objets avec les propriétés label
      et data, ou renvoie undefined si aucun élément n’est sélectionné. Cette méthode ne peut être
      utilisée que pour obtenir les éléments sélectionnés dans une zone de liste à plusieurs sélections.
      Pour récupérer des informations sur l’élément sélectionné dans une zone de liste à une seule
      sélection, utilisez FListBox.getSelectedItem.
      Exemple
      Le code suivant récupère les éléments sélectionnés dans listedeSouhaits et les enregistre dans la
      variable monObjetTableau.
      var monObjetTableau = listedeSouhaits.getSelectedItems();

      Voir aussi
      FListBox.getSelectedItem, FListBox.setSelectMultiple


FListBox.getSelectMultiple
      Disponibilité
      Flash Player 6.
      Usage
      maListe.getSelectMultiple()

      Paramètres
      Aucun.
      Renvoie
      Une valeur booléenne.



180
   Description
   Méthode ; indique si les utilisateurs peuvent sélectionner plusieurs éléments (true) ou un seul
   élément (false) de la liste.
   Exemple
   Le code suivant teste si listedeSouhaits permet une sélection multiple.
   if (listedeSouhaits.getSelectMultiple()) {
   }

   Voir aussi
   FListBox.setSelectMultiple

FListBox.getValue
   Disponibilité
   Flash Player 6.
   Usage
   maListe.getValue()

   Paramètres
   Aucun.
   Renvoie
   L’étiquette ou les données associées à un élément sélectionné.
   Description
   Méthode ; renvoie des informations concernant l’élément actuellement sélectionné de la zone de
   liste. Si l’élément n’a aucune donnée spécifiée, cette méthode renvoie l’étiquette de l’élément ; si
   des données sont associées à l’élément, cette méthode renvoie les données.
   Exemple
   Le code suivant renvoie l’étiquette de l’élément sélectionné dans listeNations.
   trace(listeNations.getValue());

   Voir aussi
   FListBox.getItemAt

FListBox.registerSkinElement
   Disponibilité
   Flash Player 6.
   Usage
   maListe.registerSkinElement(élément, propriétéDeStyle)

   Paramètres
   élément      Une occurrence de clip.
   propriétéDeStyle       Le nom d’une propriété FStyleFormat.
   Renvoie
   Rien.



                                                                          Dictionnaire ActionScript   181
      Description
      Méthode ; enregistre un élément d’enveloppe dans une propriété de style. Les éléments
      d’enveloppes sont enregistrés dans les propriétés de la première image du calque Lisez-moi de
      chaque enveloppe de la bibliothèque.
      Les composants sont constitués d’enveloppes, chaque enveloppe étant constituée de plusieurs
      éléments d’enveloppe, lesquels peuvent être enregistrés dans une propriété de l’objet
      FStyleFormat. Ces propriétés reçoivent des valeurs du format de style affecté à un composant. Par
      défaut, tous les composants d’interface Flash reçoivent l’objet globalStyleFormat, qui est une
      occurrence de l’objet FStyleFormat.
      Utilisez cette méthode pour enregistrer des éléments d’enveloppes et des propriétés personnalisés
      aux enveloppes de composant d’interface Flash ou personnalisées en modifiant le code dans la
      première image du calque Lisez-moi d’une enveloppe de la bibliothèque.
      Le composant FListBox utilise les enveloppes du dossier FListBox Skins une fois le composant
      ajouté au document Flash.
      Pour plus d’informations, consultez la section Personnalisation des enveloppes de composant du
      chapitre Utilisation des composants de Utilisation de Flash.
      Exemple
      Le code suivant enregistre l’élément d’enveloppe personnalisée boundBox_mc avec la propriété
      background dans la première image du calque Lisez-moi de l’enveloppe FBoundingBox du
      dossier Global Skins de la bibliothèque.
      menuDeJouets.registerSkinElement(boundBox_mc, "background");

      Voir aussi
      FStyleFormat (objet)

FListBox.removeAll
      Disponibilité
      Flash Player 6.
      Usage
      maListe.removeAll()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; supprime tous les éléments de la zone de liste, la met à jour, et redimensionne la barre
      de défilement.
      Exemple
      Le code suivant supprime tous les éléments de listedeSouhaits.
      listedeSouhaits.removeAll();

      Voir aussi
      FListBox.removeItemAt



182
FListBox.removeItemAt
   Disponibilité
   Flash Player 6.
   Usage
   maListe.removeItemAt(index)

   Paramètres
   index   Un entier spécifiant l’index de l’élément à supprimer.
   Renvoie
   Rien ou undefined.
   Description
   Méthode ; supprime l’élément à l’index spécifié, met à jour les index des éléments de la liste
   suivant l’élément supprimé pour refléter leur nouvelle position dans la liste, puis met la zone de
   liste à jour et redimensionne la barre de défilement. Si aucun élément n’existe à l’index spécifié, la
   méthode renvoie undefined.
   Le composant ListBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut de la
   liste.
   Exemple
   Le code suivant supprime le cinquième élément de la liste de listedeSouhaits.
   listedeSouhaits.removeItemAt(4);

   Voir aussi
   FListBox.addItemAt

FListBox.replaceItemAt
   Disponibilité
   Flash Player 6.
   Usage
   maListe.replaceItemAt(index, étiquette [,données])

   Paramètres
   index   Un entier spécifiant la position de l’élément de liste.
   étiquette     Une chaîne spécifiant une nouvelle étiquette pour l’élément de liste.
   données La nouvelle valeur à associer à l’élément de liste. Ce paramètre est facultatif. Si vous ne
   le spécifiez pas, les données associées à l’élément restent en place.
   Renvoie
   Rien.
   Description
   Méthode ; met à jour l’élément à l’index spécifié avec l’étiquette et les données spécifiées. Si
   l’élément à l’index spécifié est associé à une valeur de données et que vous ne spécifiez pas de
   valeur pour le paramètre Data, la valeur de données de l’élément n’est pas modifiée.




                                                                           Dictionnaire ActionScript 183
      Le composant ListBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut de la
      liste.
      Exemple
      Le code suivant met le cinquième élément de la zone de liste Favoris à jour avec l’étiquette
      Lucky et la valeur Chat. Si la valeur de donnée Chat n’était pas spécifiée et si la donnée associée
      au cinquième élément de la liste était Chien, la valeur de donnée pour Lucky serait Chien (ce qui
      serait erroné puisqu’il s’agit d’un chat).
      Favoris.replaceItemAt(4, "Lucky", "Chat");

      Voir aussi
      FListBox.addItemAt, FListBox.getItemAt


FListBox.setAutoHideScrollBar
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setAutoHideScrollBar(masquerDéfilement)

      Paramètres
      masquerDéfilement Une valeur booléenne spécifiant si la barre de défilement est masquée
      lorsqu’elle n’est pas nécessaire (true) ou toujours affichée (false).
      Renvoie
      Rien.
      Description
      Méthode ; spécifie si la barre de défilement est masquée lorsque le nombre d’éléments de la zone
      de liste peut être affiché sans barre de défilement (true) ou si la barre de défilement est toujours
      affichée (false). Si cette méthode est définie sur false et que le nombre d’éléments ne nécessite
      pas de barre de défilement, la barre de défilement est affichée comme étant désactivée (grisée).
      Exemple
      Le code suivant masque la barre de défilement de listedeSouhaits lorsque le nombre
      d’éléments de la zone de liste peut être affiché sans défilement.
      listedeSouhaits.setAutoHideScrollBar(true);

FListBox.setChangeHandler
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setChangeHandler(nomDeFonction, [emplacement])

      Paramètres
      nomDeFonction        Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque
      la sélection de la liste change. Si le paramètre emplacement n’est pas spécifié, cette fonction doit
      se trouver dans le même scénario que l’occurrence de composant.




184
emplacement Une référence de chemin à un objet de données, un clip ou scénario contenant la
fonction spécifiée. Ce paramètre est facultatif et prend par défaut le scénario parent du
composant.
Renvoie
Rien.
Description
Méthode ; spécifie un gestionnaire de changement à appeler lorsque la sélection de la zone de liste
change. Vous pouvez spécifier la même fonction de gestionnaire de changement pour plusieurs
composants, la fonction acceptant toujours l’occurrence du composant changé comme paramètre.
L’appel de cette méthode annule la valeur du paramètre de gestionnaire de changement spécifiée
au cours de la programmation.
Pour plus d’informations, consultez la section Rédaction de fonctions de gestionnaire de
changement pour les composants du chapitre Utilisation des composants de Utilisation de Flash.
Exemple
Le code suivant spécifie monGestionnaire comme fonction appelée lorsque la valeur de
listBox1 change. Le paramètre emplacement n’étant pas spécifié, monGestionnaire doit se
trouver dans le scénario que l’occurrence de composant.
Le paramètre composant de monGestionnaire est automatiquement rempli avec l’occurrence
d’un composant (le composant qui a changé en résultat de la saisie utilisateur et qui spécifie
monGestionnaire en tant que son gestionnaire de changement). Les actions définies dans
monGestionnaire spécifient que, lorsque l’utilisateur sélectionne un élément de la liste,
l’étiquette de cet élément est affichée dans la fenêtre Sortie.
listBox1.setChangeHandler("monGestionnaire");
function monGestionnaire(composant){
   trace(listBox1.getSelectedItem().label);
}
Si, dans l’exemple précédent, monGestionnaire est une fonction située dans le scénario arrière-
grand-parent du scénario du composant, la première ligne de code serait la suivante :
listBox1.setChangeHandler("monGestionnaire", _parent._parent._parent);
Le code suivant crée la fonction monGestionnaire dans une occurrence de monObjet (de classe
Object), puis spécifie monGestionnaire comme fonction pour listBox1.
monObjet = new Object();
monObjet.monGestionnaire = function(composant){
trace(listBox1.getSelectedItem().label);
}
listBox1.setChangeHandler("monGestionnaire", monObjet);




                                                                      Dictionnaire ActionScript 185
FListBox.setDataProvider
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setDataProvider(fournisseurDeDonnées)

      Paramètres
      fournisseurDeDonnées       Un tableau de chaînes de texte contenant les éléments à ajouter, une
      occurrence de l’objet Array spécifiant les éléments à ajouter, ou une occurrence de la classe
      DataProvider.
      Renvoie
      Rien.
      Description
      Méthode ; enregistre un objet externe (fournisseurDeDonnées) comme source de données pour
      le composant de zone de liste. Si fournisseurDeDonnées est une occurrence de l’objet Array,
      l’objet peut spécifier label, data, ou les deux, puisque les propriétés de l’objet et le contenu du
      tableau peuvent être copiés dans la zone de liste comme étiquettes, données, ou les deux. Si
      fournisseurDeDonnées est une occurrence de la classe DataProvider, elle doit implémenter
      l’API DataProvider définie dans le symbole DataProvider du dossier FlashUIComponents/
      CoreAssets/ClassTree de la bibliothèque. L’API DataProvider est destinée aux utilisateurs
      confirmés, les autres devant utiliser un tableau ou un objet Array.
      Exemple
      Le code suivant spécifie l’objet Array listeDeRédacteurs comme fournisseur de données pour
      listBox1.
      listBox1.setDataProvider(listeDeRédacteurs);
      Le code suivant crée le tableau listeDeRédacteurs pour afficher les étiquettes des éléments
      affichés dans fillesGéniales.
      listeDeRédacteurs = new Array();
      listeDeRédacteurs[0] = "Jody";
      listeDeRédacteurs[1] = "Mary";
      listeDeRédacteurs[2] = "Marcelle";
      listeDeRédacteurs[3] = "Dale";
      listeDeRédacteurs[4] = "Stephanie";
      listeDeRédacteurs[5] = "Barbara";
      Le code suivant crée le tableau listeDéléments1, qui spécifie l’étiquette et les données des
      éléments de la liste. Cet objet Array pourrait être utilisé comme autre fournisseur de données pour
      listBox1.
      listeDéléments1 = new Array();
      for (i=0; i<10; i++) {

      // créer un élément
        var monElément = new Object();
        monElément.label = "Elément" + i;
        monElément.data = 75;

      // le placer dans le tableau
      listeDéléments1[i] = monElément;
      }



186
   Le code suivant spécifie listeDesEditeurs, une occurrence de la classe DataProvider, comme
   fournisseur de données pour listBox1.
   listBox1.setDataProvider(listeDesEditeurs);
   Le code suivant crée une occurrence de la classe DataProvider et ajoute ensuite les étiquettes des
   éléments à l’aide de la méthode addItem de DataProvider.
   Remarque La méthode addItem n’est qu’une des méthodes de la classe DataProvider. Les programmeurs
   intéressés par l’utilisation de la classe DataProvider pourront consulter le symbole DataProvider dans le dossier
   FlashUIComponents/CoreAssets/ClassTree de la bibliothèque avant d’essayer d’utiliser ces méthodes.

   listeDesEditeurs = new DataProviderClass();
   listeDesEditeurs.addItem("Anne");
   listeDesEditeurs.addItem("Rosana");
   listeDesEditeurs.addItem("Lisa");
   listeDesEditeurs.addItem("Rebecca");

   Voir aussi
   FListBox.addItem, FListBox.replaceItemAt, FListBox.sortItemsBy


FListBox.setEnabled
   Disponibilité
   Flash Player 6.
   Usage
   maListe.setEnabled(activerTrueFalse)

   Paramètres
   activerTrueFalse           Une valeur booléenne spécifiant si la liste est activée (true) ou désactivée
   (false).
   Renvoie
   Rien.
   Description
   Méthode ; spécifie si la zone de liste est activée (true) ou désactivée (false). Une zone de liste
   désactivée n’accepte pas l’interaction souris ou clavier avec l’utilisateur. Si vous omettez ce
   paramètre, la méthode prend la valeur par défaut de true.
   Exemple
   Le code suivant désactive listeDintérêts.
   listeDintérêts.setEnabled(false);

   Voir aussi
   FListBox.getEnabled




                                                                                     Dictionnaire ActionScript 187
FListBox.setItemSymbol
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setItemSymbol(idDeSymbole)

      Paramètres
      idDeSymbole       L’identifiant de liaison d’un symbole graphique pour afficher le contenu de la
      zone de liste.
      Renvoie
      Rien.
      Description
      Méthode ; enregistre un symbole graphique pour afficher les éléments de zone de liste. La valeur
      par défaut est le symbole FListBoxItem dans la bibliothèque. Cette méthode est prévue pour les
      utilisateurs et programmeurs expérimentés.

FListBox.setRowCount
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setRowCount(lignes)

      Paramètres
      lignes    Le nombre maximum de lignes affichées dans la zone de liste.
      Renvoie
      Rien.
      Description
      Méthode ; spécifie le nombre d’éléments affichés dans la zone de liste. Si vous utilisez cette
      méthode, utilisez FListBox.setWidth, et non FListBox.setSize, pour définir la largeur de la
      zone de liste. L’appel de FListBox.setSize annule la valeur du paramètre de nombre de lignes
      définie au cours de la programmation. Si vous appelez cette méthode après avoir appelé
      FListBox.setRowCount, votre animation ne tient pas compte du paramètre nombreDeLignes et
      définit la hauteur de la zone de liste en pixels.
      Exemple
      Le code suivant définit le nombre d’éléments affichés dans listeDeJouets sur 4.
      listeDeJouets.setRowCount(4);

      Voir aussi
      FListBox.getRowCount, FListBox.setSize




188
FListBox.setScrollPosition
   Disponibilité
   Flash Player 6.
   Usage
   maListe.setScrollPosition(index)

   Paramètres
   index    Un entier spécifiant l’index de l’élément à afficher en haut de la liste.
   Renvoie
   Rien.
   Description
   Méthode ; entraîne le défilement de la zone de liste pour afficher l’élément spécifié en haut.
   Le composant ListBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut de la
   liste.
   Exemple
   Le code suivant affiche le cinquième élément de listeDeJouets en haut de la liste.
   listeDeJouets.setScrollPosition(4);

   Voir aussi
   FListBox.getScrollPosition

FListBox.setSelectedIndex
   Disponibilité
   Flash Player 6.
   Usage
   maListe.setSelectedIndex(index)

   Paramètres
   index   Un entier spécifiant l’index de l’élément à sélectionner dans la liste.
   Renvoie
   Rien.
   Description
   Méthode ; sélectionne l’élément à l’index spécifié et met la zone de liste à jour.
   Le composant ListBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut de la
   liste.
   Exemple
   Le code suivant sélectionne le cinquième élément de la zone de liste.
   listeDeJouets.setSelectedIndex(4);

   Voir aussi
   FListBox.getSelectedIndex, FListBox.getSelectedIndices




                                                                           Dictionnaire ActionScript 189
FListBox.setSelectedIndices
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setSelectedIndices(tableauDindex)

      Paramètres
      tableauDindex      Un tableau d’index d’éléments à sélectionner dans la zone de liste.
      Renvoie
      Rien.
      Description
      Méthode ; sélectionne les éléments spécifiés dans le tableau d’index et met la zone de liste à jour.
      Le composant ListBox utilise un index basé sur 0, où l’élément à l’index 0 est affiché en haut de la
      liste.
      Exemple
      Le code suivant crée un tableau appelé monTableau spécifiant les éléments à sélectionner dans
      listeDeJouets, puis transmet le tableau à la méthode setSelectedIndices.
      var monTableau = new Array (1,4,5,7);
      listeDeJouets.setSelectedIndices(monTableau);

      Voir aussi
      FListBox.getSelectedIndices

FListBox.setSelectMultiple
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setSelectMultiple(sélectionMultiple)

      Paramètres
      sélectionMultiple Une valeur booléenne spécifiant le mode de sélection multiple (true) ou
      le mode de sélection unique (false).
      Renvoie
      Rien.
      Description
      Méthode ; spécifie si les utilisateurs peuvent sélectionner plusieurs éléments (true) ou un seul
      élément (false) de la zone de liste. Le paramètre par défaut est false. L’appel de cette méthode
      annule la valeur du paramètre de sélection multiple spécifiée au cours de la programmation.
      Exemple
      Le code suivant active la sélection multiple pour listeDeJouets.
      listeDeJouets.setSelectMultiple(true);




190
FListBox.setSize
   Disponibilité
   Flash Player 6.
   Usage
   maListe.setSize(largeur, hauteur)

   Paramètres
   largeur      Un entier spécifiant la largeur de la liste, en pixels.
   hauteur      Un entier spécifiant la hauteur de la liste, en pixels.
   Renvoie
   Rien.
   Description
   Méthode ; redimensionne la zone de liste à l’exécution à la largeur et à la hauteur spécifiées.
   L’appel de cette méthode annule la valeur du paramètre de nombre de lignes spécifiée au cours de
   la programmation. Si vous appelez cette méthode après avoir appelé FListBox.setRowCount,
   votre animation définit la hauteur de la zone de liste en pixels et ne tient pas compte du paramètre
   nombreDeLignes. Pour définir la largeur d’une zone de liste lorsque vous utilisez setRowCount,
   utilisez FListBox.setWidth.
   Exemple
   Le code suivant redimensionne listeTéléphone à 200 pixels de largeur et 50 pixels de hauteur.
   listeTéléphone.setSize(200, 50);

   Voir aussi
   FListBox.setRowCount, FListBox.setWidth


FListBox.setStyleProperty
   Disponibilité
   Flash Player 6.
   Usage
   maListe.setStyleProperty(propriétéDeStyle, valeur)

   Paramètres
   propriétéDeStyle         Une chaîne spécifiant une propriété de l’objet FStyleFormat.
   valeur    La valeur à définir pour la propriété.
   Renvoie
   Rien.
   Description
   Méthode ; définit une propriété FStyleFormat pour une occurrence de zone de liste. L’appel de
   cette méthode pour spécifier une propriété annule le paramètre de cette propriété dans le format
   de style affecté au composant. La transmission de undefined comme valeur de propriété
   supprime tous les styles pour cette propriété.




                                                                          Dictionnaire ActionScript   191
      Pour définir les propriétés FStyleFormat de plusieurs composants, vous créez un format de style
      personnalisé. Pour plus d’informations sur la création de formats de styles personnalisés, consultez
      la section Personnalisation de la couleur et du texte des composants du chapitre Utilisation des
      composants de Utilisation de Flash.
      Exemple
      Le code suivant donne à la propriété shadow de listBox1 la valeur 0x000000 (noir).
      listBox1.setStyleProperty("shadow", 0x000000);

      Voir aussi
      FStyleFormat (objet)

FListBox.setWidth
      Disponibilité
      Flash Player 6.
      Usage
      maListe.setWidth(largeur)

      Paramètres
      largeur      Un entier spécifiant la largeur de la liste, en pixels.
      Renvoie
      Rien.
      Description
      Méthode ; spécifie la largeur de la zone de liste, en pixels. Cette méthode est utile pour définir la
      largeur de la zone de liste lorsque FListBox.setRowCount est utilisé pour déterminer la hauteur.
      Exemple
      Le code suivant définit la largeur de la zone de liste listeDeJouets sur 500 pixels.
      listeDeJouets.setWidth(500);

      Voir aussi
      FListBox.setSize

FListBox.sortItemsBy
      Disponibilité
      Flash Player 6.
      Usage
      maListe.sortItemsBy(nomDeChamp, ordre)

      Paramètres
      nomDeChamp Une chaîne spécifiant le nom du champ utilisé pour le tri. Il s’agit normalement de
      "label" ou "data".

      ordre Une      chaîne spécifiant le tri des éléments par ordre croissant ("ASC") ou décroissant
      ("DESC").




192
      Renvoie
      Rien.
      Description
      Méthode ; trie les éléments de la zone de liste par ordre alphabétique ou numérique, dans l’ordre
      spécifié, avec le nom de champ spécifié. Si les éléments nomDeChamp sont une combinaison de
      chaînes de texte et d’entiers, c’est les éléments entiers qui sont indiqués en premier. Le paramètre
      nomDeChamp est généralement "label" ou "data", les programmeurs expérimentés pouvant
      spécifier toute primitive correspondant à leurs besoins.
      Exemple
      Le code suivant trie les éléments de la zone de liste menuDeNoms par ordre croissant en utilisant
      leurs étiquettes.
      menuDeNoms.sortItemsBy("label", "ASC");

      Voir aussi
      FListBox.addItemAt, FListBox.replaceItemAt


_focusrect
      Disponibilité
      Flash Player 4.
      Usage
      _focusrect = booléen;

      Description
      Propriété (globale) ; spécifie si un rectangle jaune apparaît autour du bouton avec focus clavier. La
      valeur par défaut, true, affiche un rectangle jaune autour du bouton ou du champ de texte avec
      focus au fur et à mesure que l’utilisateur appuie sur la touche de tabulation pour naviguer dans les
      objets de l’animation. Spécifiez false si vous ne voulez pas afficher le rectangle jaune. Il s’agit
      d’une propriété globale qui peut être annulée dans des cas spécifiques.
      Voir aussi
      Button._focusrect

for
      Disponibilité
      Flash Player 5.
      Usage
      for(init; condition; suivant) {
        instruction(s);
      }

      Paramètres
      init   Une expression à évaluer avant de commencer la séquence de boucle, généralement une
      expression d’affectation. Une instruction var est également autorisée pour ce paramètre.
      condition     Une expression évaluée comme true ou false. La condition est évaluée avant
      chaque itération de boucle ; la boucle sort lorsque la condition est évaluée comme false.




                                                                             Dictionnaire ActionScript 193
      suivant    Une expression à évaluer après chaque itération de boucle ; généralement une
      expression d’affectation utilisant les opérateurs ++ (incrémentation) ou -- (décrémentation).
      instruction(s)       Une instruction ou des instructions à exécuter à l’intérieur du corps de la
      boucle.
      Description
      Action ; une construction de boucle qui évalue l’expression init (initialiser) une fois, puis
      commence une séquence de boucle par laquelle, aussi longtemps que condition est évaluée
      comme true, instruction est exécutée et l’expression suivante évaluée.
      Certaines propriétés ne peuvent pas être énumérées par les actions for ou for..in. Par exemple,
      les méthodes intégrées de l’objet Array (Array.sort et Array.reverse) ne sont pas comprises
      dans l’énumération d’un objet Array, et les propriétés de clip telles que _x et _y ne sont pas
      énumérées.
      Exemple
      L’exemple suivant utilise for pour additionner les éléments d’un tableau :
      for(i=0; i<10; i++) {
        array [i] = (i + 5)*10;
        trace(array[i]);
      }
      Le résultat suivant est affiché dans la fenêtre Sortie :
      50
      60
      70
      80
      90
      100
      110
      120
      130
      140
      L’exemple suivant utilise for pour effectuer la même action de façon répétée. Dans le code ci-
      dessous, la boucle for additionne les nombres de 1 à 100 :
      var somme = 0;
        for (var i=1; i<=100; i++) {
           somme = somme + i;
        }

      Voir aussi
      ++ (incrémentation), –– (décrémentation), for..in, var


for..in
      Disponibilité
      Flash Player 5.
      Usage
      for(itérantDeVariable in objet){
        instruction(s);
      }




194
Paramètres
itérantDeVariable       Le nom d’une variable agissant comme itérant, référençant chaque
propriété d’un objet ou chaque élément d’un tableau.
objet    Le nom d’un objet devant être répété.
instruction(s)       Une instruction à exécuter pour chaque itération.
Renvoie
Rien.
Description
Action ; effectue une boucle sur les propriétés d’un objet ou sur les éléments d’un tableau et
exécute instruction pour chaque propriété d’un objet.
Certaines propriétés ne peuvent pas être énumérées par les actions for ou for..in. Par exemple,
les méthodes intégrées de l’objet Array (Array.sort et Array.reverse) ne sont pas comprises
dans l’énumération d’un objet Array, et les propriétés de clip telles que _x et _y ne sont pas
énumérées.
La construction for..in itère sur les propriétés des objets dans la chaîne prototype de l’objet
itéré. Si le prototype de l’enfant est parent, l’itération sur les propriétés de l’enfant avec for..in
itérera également sur les propriétés de parent.
L’action for..in énumère tous les objets de la chaîne prototype d’un objet. Les propriétés de
l’objet sont énumérées en premier, puis les propriétés de son prototype immédiat, puis les
propriétés du prototype du prototype, et ainsi de suite. L’action for..in n’énumère pas deux fois
le même nom de propriété. Si l’objet child a le prototype parent et que tous deux contiennent
la propriété prop, l’action for..in appelée pour child énumère prop de child mais ignore celle
de parent.
Exemple
L’exemple suivant utilise for..in pour itérer sur les propriétés d’un objet :
monObjet = { nom:'Tara', age:27, ville:'San Francisco' };
for (nom dans monObjet) {
  trace ("monObjet." + nom + " = " + monObjet[nom]);
}
Le résultat de cet exemple est le suivant :
monObjet.nom = Tara
monObjet.age = 27
monObjet.ville = San Francisco
L’exemple suivant utilise l’opérateur typeof avec for..in pour itérer sur un enfant particulier :
for (nom dans monClip) {
  if (typeof (monClip[nom]) = "clip") {
     trace ("J’ai un clip appelé " + nom);
  }
}
L’exemple suivant énumère les enfants d’un clip et envoie chacun dans l’image 2 de leurs
scénarios respectifs. Le clip GroupeDeBoutonsRadio est un parent de plusieurs enfants,
_BoutonRadioRouge_, _BoutonRadioVert_ et _BoutonRadioBleu.
for (nom de variable dans GroupeDeBoutonsRadio) {
  GroupeDeBoutonsRadio[nom].gotoAndStop(2);
}




                                                                        Dictionnaire ActionScript 195
FPushButton (composant)
      Le composant PushButton de l’environnement auteur de Flash fournit les fonctions glisser-
      déposer pour l’ajout de boutons aux documents Flash, mais aussi une interface utilisateur de
      définition des paramètres de base. Les méthodes du composant FPushButton vous permettent de
      contrôler les boutons à l’exécution : vous pouvez créer des boutons, contrôler des boutons créés
      lors de la programmation, définir ou remplacer des paramètres de base, et définir des options
      supplémentaires à l’exécution. Il n’est pas nécessaire d’utiliser un constructeur pour accéder aux
      méthodes des composants.
      Le composant PushButton accepte toutes les interactions standard avec la souris et le clavier.
      Vous pouvez utiliser les méthodes FPushButton pour spécifier une fonction de gestionnaire pour
      les boutons-poussoirs, désactiver ou activer les boutons, et les redimensionner sans distorsion à
      l’exécution.
      Les méthodes des composants n’effectuant pas de vérification d’erreur pour le type, au contraire
      des autres objets et actions ActionScript natifs, il est recommandé de valider les paramètres avant
      de les transmettre aux méthodes.
      Le composant PushButton est supporté par Flash Player 6 et les versions suivantes de Flash
      Player.
      Pour plus d’informations sur l’utilisation du composant PushButton, la définition des paramètres
      au cours de la programmation et le changement de la couleur et de l’apparence des composants,
      consultez les sections Personnalisation de la couleur et du texte des composants et
      Personnalisation des enveloppes de composant du chapitre Utilisation des composants de
      Utilisation de Flash.

Méthodes du composant FPushButton

      Méthode                               Description

      FPushButton.getEnabled                Renvoie true si le bouton est activé, false s’il est désactivé.

      FPushButton.getLabel                  Renvoie l’étiquette du bouton sous la forme d’une chaîne.

      FPushButton.registerSkinElement       Enregistre un élément d’enveloppe dans une propriété.

      FPushButton.setClickHandler           Spécifie la fonction appelée lorsque l’utilisateur relâche le bouton.

      FPushButton.setEnabled                Détermine si le bouton est activé ou désactivé.

      FPushButton.setLabel                  Définit l’étiquette du bouton à l’exécution.

      FPushButton.setSize                   Définit la hauteur et la largeur du bouton, en pixels.

      FPushButton.setStyleProperty          Définit une propriété de style pour un composant.


FPushButton.getEnabled
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonPoussoir.getEnabled()

      Paramètres
      Aucun.



196
   Renvoie
   Une valeur booléenne.
   Description
   Méthode ; renvoie true si le bouton-poussoir est activé, false s’il est désactivé.
   Exemple
   Le code suivant renvoie l’état d’activation du bouton-poussoir envoyer dans la fenêtre Sortie.
   trace(envoyer.getEnabled());

   Voir aussi
   FPushButton.setEnabled

FPushButton.getLabel
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonPoussoir.getLabel()

   Paramètres
   Aucun.
   Renvoie
   Une chaîne.
   Description
   Méthode ; renvoie l’étiquette de texte du bouton-poussoir sous la forme d’une chaîne.
   Exemple
   Le code suivant renvoie l’étiquette du bouton-poussoir boutonPage1 dans la fenêtre Sortie.
   trace(boutonPage1.getLabel());

   Voir aussi
   FPushButton.setLabel

FPushButton.registerSkinElement
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonPoussoir.registerSkinElement(élément, propriétéDeStyle)

   Paramètres
   élément      Une occurrence de clip.
   propriétéDeStyle       Le nom d’une propriété FStyleFormat.
   Renvoie
   Rien.




                                                                         Dictionnaire ActionScript 197
      Description
      Méthode ; enregistre un élément d’enveloppe dans une propriété de style. Les éléments
      d’enveloppes sont enregistrés dans les propriétés de la première image du calque Lisez-moi de
      chaque enveloppe de la bibliothèque.
      Les composants sont constitués d’enveloppes, chaque enveloppe étant constituée de plusieurs
      éléments d’enveloppe, lesquels peuvent être enregistrés dans une propriété de l’objet
      FStyleFormat. Ces propriétés reçoivent des valeurs du format de style affecté à un composant. Par
      défaut, tous les composants d’interface Flash reçoivent l’objet globalStyleFormat, qui est une
      occurrence de l’objet FStyleFormat.
      Utilisez cette méthode pour enregistrer des éléments d’enveloppes et des propriétés personnalisés
      aux enveloppes de composant d’interface Flash ou personnalisées en modifiant le code dans la
      première image du calque Lisez-moi d’une enveloppe de la bibliothèque.
      Le composant FPushButton utilise les enveloppes du dossier FPushButton Skins et l’enveloppe
      FLabel dossier Global Skins une fois le composant ajouté au document Flash.
      Pour plus d’informations, consultez la section Personnalisation des enveloppes de composant du
      chapitre Utilisation des composants de Utilisation de Flash.
      Exemple
      Le code suivant enregistre l’élément d’enveloppe personnalisée nouvelleFace_mc avec la
      propriété face dans la première image du calque Lisez-moi de l’enveloppe FLabel. L’enveloppe
      FLabel se trouve dans le dossier Component Skins/Global Skins de la bibliothèque.
      boutonDenvoi.registerSkinElement(nouvelleFace_mc, "face");

      Voir aussi
      FStyleFormat (objet)

FPushButton.setClickHandler
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonPoussoir.setClickHandler(nomDeFonction, [emplacement])

      Paramètres
      nomDeFonction       Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque
      l’utilisateur relâche le bouton-poussoir. Si le paramètre emplacement n’est pas spécifié, cette
      fonction doit se trouver dans le même scénario que l’occurrence de composant.
      emplacement Une référence de chemin à un objet de données, un clip ou scénario contenant la
      fonction spécifiée. Ce paramètre est facultatif et prend par défaut le scénario parent du
      composant.
      Renvoie
      Rien.




198
   Description
   Méthode ; spécifie une fonction de gestionnaire à appeler lorsque l’utilisateur relâche le bouton-
   poussoir. Vous pouvez spécifier la même fonction de gestionnaire de changement pour plusieurs
   composants, la fonction acceptant toujours l’occurrence du composant changé comme paramètre.
   L’appel de cette méthode annule la valeur du paramètre de gestionnaire de clic spécifiée au cours
   de la programmation.
   Pour plus d’informations, consultez la section Rédaction de fonctions de gestionnaire de
   changement pour les composants du chapitre Utilisation des composants de Utilisation de Flash.
   Exemple
   Le code suivant spécifie onClick comme fonction appelée lorsque la valeur de bouton1 change.
   Le paramètre emplacement n’étant pas spécifié, onClick doit se trouver dans le scénario que
   l’occurrence de composant. Le paramètre composant de onClick est automatiquement rempli
   avec l’occurrence d’un composant (le composant qui a changé en résultat de la saisie utilisateur et
   qui spécifie onClick en tant que son gestionnaire de changement). Les actions définies dans
   onClick spécifient que, lorsque l’utilisateur relâche un bouton, l’étiquette du bouton est affichée
   dans la fenêtre Sortie.
   bouton1.setClickHandler("onClick");
   function onClick(composant){
   trace(composant._name);
   }
   Si, dans l’exemple précédent, onClick est une fonction située dans le scénario arrière-grand-
   parent du scénario du composant, la première ligne de code serait la suivante :
   bouton1.setChangeHandler("onClick", _parent._parent._parent);
   Le code suivant crée la fonction onClick dans une occurrence de monObjet (de classe Object),
   puis spécifie onClick comme fonction pour bouton1.
   monObjet = new Object();
   monObjet.onClick = function(composant){
   trace(composant._name);
   }
   bouton1.setChangeHandler("onClick", monObjet);

FPushButton.setEnabled
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonPoussoir.setEnabled(activerTrueFalse)

   Paramètres
   activerTrueFalse       Une valeur booléenne spécifiant si le bouton-poussoir est activé (true) ou
   désactivée (false).
   Renvoie
   Rien.




                                                                         Dictionnaire ActionScript 199
      Description
      Méthode ; détermine si le bouton-poussoir est activé. Un bouton-poussoir désactivé n’accepte pas
      l’interaction souris ou clavier avec l’utilisateur et son texte apparaît en gris. L’omission du
      paramètre donne le même résultat qu’une transmission de la valeur true.
      Exemple
      Le code suivant désactive bouton1.
      bouton1.setEnabled(false);

      Voir aussi
      FPushButton.getEnabled

FPushButton.setLabel
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonPoussoir.setLabel(étiquette)

      Paramètres
      étiquette      Une chaîne contenant le texte devant apparaître sur le bouton-poussoir.
      Renvoie
      Rien.
      Description
      Méthode ; applique une étiquette au bouton-poussoir à l’exécution. L’appel de cette méthode
      annule la valeur du paramètre label spécifiée au cours de la programmation.
      Exemple
      Le code suivant applique l’étiquette Vive moi ! à boutonDeVote.
      boutonDeVote.setLabel("Vive moi !");

      Voir aussi
      FPushButton.getLabel

FPushButton.setSize
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonPoussoir.setSize(largeur, hauteur)

      Paramètres
      largeur      Un entier spécifiant la largeur du bouton-poussoir, en pixels.
      hauteur      Un entier spécifiant la hauteur du bouton-poussoir, en pixels.
      Renvoie
      Rien.




200
   Description
   Méthode ; définit la largeur et la hauteur du bouton-poussoir à l’exécution. L’appel de cette
   méthode annule l’échelle et les dimensions appliquées au cours de la programmation. Pour plus
   d’informations, consultez la section Dimensions des composants PushButton du chapitre
   Utilisation des composants de Utilisation de Flash.
   Exemple
   Le code suivant redimensionne boutonDenvoi à 100 x 50 pixels à l’exécution.
   boutonDenvoi.setSize(100, 50);

FPushButton.setStyleProperty
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonPoussoir.setStyleProperty(propriétéDeStyle, valeur)

   Paramètres
   propriétéDeStyle       Une chaîne spécifiant une propriété de l’objet FStyleFormat.
   valeur    La valeur à définir pour la propriété.
   Renvoie
   Rien.
   Description
   Méthode ; définit une propriété FStyleFormat pour une occurrence de bouton-poussoir. L’appel
   de cette méthode pour spécifier une propriété annule le paramètre de cette propriété dans le
   format de style affecté au composant. La transmission de undefined comme valeur de propriété
   supprime tous les styles pour cette propriété.
   Pour définir les propriétés FStyleFormat de plusieurs composants, vous créez un format de style
   personnalisé. Pour plus d’informations sur la création de formats de styles personnalisés, consultez
   la section Personnalisation de la couleur et du texte des composants du chapitre Utilisation des
   composants de Utilisation de Flash.
   Exemple
   Le code suivant donne à la propriété face de boutonDenvoi la valeur 0xffffff (blanc).
   boutonDenvoi.setStyleProperty("face", 0xffffff);

   Voir aussi
   FStyleFormat (objet)




                                                                          Dictionnaire ActionScript 201
FRadioButton (composant)
      Les boutons radio sont des groupes de boutons sélectionnables dans lesquels un seul bouton peut
      être sélectionné à la fois. Le composant RadioButton de l’environnement auteur de Flash fournit
      les fonctions glisser-déposer pour l’ajout de groupes de boutons radio aux documents Flash, mais
      aussi une interface utilisateur de définition des paramètres de base. Les méthodes du composant
      FRadioButton vous permettent de contrôler les boutons radio à l’exécution : vous pouvez créer
      des boutons radio, contrôler des boutons radio créés lors de la programmation, définir ou
      remplacer des paramètres de base, et définir des options supplémentaires à l’exécution. Il n’est pas
      nécessaire d’utiliser un constructeur pour accéder aux méthodes des composants.
      Le composant RadioButton est supporté par Flash Player 6 et les versions suivantes de Flash
      Player.
      Les méthodes des composants n’effectuant pas de vérification d’erreur pour le type, au contraire
      des autres objets et actions ActionScript natifs, il est recommandé de valider les paramètres avant
      de les transmettre aux méthodes.
      Pour plus d’informations sur l’utilisation du composant RadioButton, la définition des
      paramètres au cours de la programmation et le changement de la couleur et de l’apparence des
      composants, consultez les sections Personnalisation de la couleur et du texte des composants et
      Personnalisation des enveloppes de composant du chapitre Utilisation des composants de
      Utilisation de Flash.

Méthodes du composant FRadioButton

      Méthode                                    Description

      FRadioButton.getData                       Renvoie une valeur de données pour une occurrence de bouton
                                                 radio.

      FRadioButton.getEnabled                    Renvoie true si le bouton radio est activé, false s’il est
                                                 désactivé.

      FRadioButton.getLabel                      Renvoie l’étiquette du bouton radio sous la forme d’une chaîne.

      FRadioButton.getState                      Renvoie l’état sélectionné de l’occurrence de bouton radio.

      FRadioButton.getValue                      Renvoie la valeur de données du bouton radio sélectionné dans
                                                 un groupe, ou renvoie l’étiquette si aucune donnée n’est
                                                 spécifiée.

      FRadioButton.registerSkinElement           Enregistre un élément d’enveloppe dans une propriété de style.

      FRadioButton.setChangeHandler              Spécifie une fonction à appeler lorsque la sélection du bouton
                                                 radio change.

      FRadioButton.setData                       Définit les données associées à une occurrence de bouton radio.

      FRadioButton.setEnabled                    Détermine si le bouton radio est activé ou désactivé.

      FRadioButton.setGroupName                  Spécifie un nom de groupe pour une occurrence de bouton radio,
                                                 ou définit un nouveau nom pour un groupe de boutons radio.

      FRadioButton.setLabel                      Applique une étiquette au bouton radio à l’exécution.

      FRadioButton.setLabelPlacement             Spécifie si l’étiquette apparaît à gauche ou à droite du bouton
                                                 radio.

      FRadioButton.setSize                       Définit la largeur du bouton radio, en pixels.

      FRadioButton.setState                      Définit l’état sélectionné de l’occurrence de bouton radio.




202
   Méthode                                  Description

   FRadioButton.setStyleProperty            Définit une propriété de style pour une occurrence de
                                            composant.

   FRadioButton.setValue                    Sélectionne un bouton radio d’un groupe de boutons radio à
                                            l’exécution.


FRadioButton.getData
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonRadio.getData()

   Paramètres
   Aucun.
   Renvoie
   Une chaîne.
   Description
   Méthode ; renvoie les données associées à l’occurrence de bouton radio spécifiée. Utilisez
   FRadioButton.getValue pour obtenir les données associées au bouton radio sélectionné d’un
   groupe de boutons radio.
   Exemple
   Le code suivant renvoie les données associées au bouton radio flashRadio dans la fenêtre Sortie.
   trace(flashRadio.getData());

   Voir aussi
   FRadioButton.setData

FRadioButton.getEnabled
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonRadio.getEnabled()
   monGroupeDeBoutonsRadio.getEnabled()

   Paramètres
   Aucun.
   Renvoie
   Une valeur booléenne ou undefined.
   Description
   Méthode ; indique si une occurrence de bouton radio ou un groupe de boutons radio est activé.
   Usage 1. Indique si monBoutonRadio est activé (true) ou désactivé (false).




                                                                           Dictionnaire ActionScript 203
      Usage 2. Indique si les boutons de monGroupeDeBoutonsRadio sont activés (true) ou désactivés
      (false). Si certains des boutons du groupe sont activés et que d’autres sont désactivés, la méthode
      renvoie undefined.
      Exemple
      Le code suivant renvoie l’état d’activation de radio1 dans la fenêtre Sortie.
      trace(radio1.getEnabled());

      Voir aussi
      FRadioButton.setEnabled

FRadioButton.getLabel
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonRadio.getLabel()

      Paramètres
      Aucun.
      Renvoie
      Une chaîne.
      Description
      Méthode ; renvoie l’étiquette du bouton radio spécifié sous la forme d’une chaîne. Vous ne
      pouvez pas utiliser cette méthode pour récupérer les étiquettes de groupes de boutons radio ; la
      syntaxe GroupeDeBoutonsRadio.getLabel n’étant pas valide.
      Exemple
      Le code suivant renvoie l’étiquette de l’occurrence radio2 dans la fenêtre Sortie.
      trace(radio2.getLabel());

      Voir aussi
      FRadioButton.setLabel

FRadioButton.getState
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonRadio.getState()

      Paramètres
      Aucun.
      Renvoie
      Une valeur booléenne indiquant l’état sélectionné du bouton radio.




204
   Description
   Méthode ; renvoie une valeur booléenne indiquant si monBoutonRadio est sélectionné (true) ou
   non (false).
   Exemple
   Le code suivant renvoie l’état de sélection du bouton radio radio1 dans la fenêtre Sortie.
   trace(radio1.getState());

   Voir aussi
   FRadioButton.setState

FRadioButton.getValue
   Disponibilité
   Flash Player 6.
   Usage
   monGroupeDeBoutonsRadio.getValue()

   Paramètres
   Aucun.
   Renvoie
   Une chaîne ou undefined.
   Description
   Méthode ; renvoie les données associées au bouton radio sélectionné dans
   monGroupeDeBoutonsRadio, ou l’étiquette du bouton radio si aucune donnée n’est spécifiée. Si
   aucun bouton n’est sélectionné, la méthode renvoie undefined.
   Exemple
   Le code suivant renvoie les données associées au bouton radio sélectionné du groupe
   groupeBoutonsRadio1 dans la fenêtre Sortie.
   trace(groupeBoutonsRadio1.getValue());

   Voir aussi
   FRadioButton.setValue

FRadioButton.registerSkinElement
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonRadio.registerSkinElement(élément, propriétéDeStyle)

   Paramètres
   élément      Une occurrence de clip.
   propriétéDeStyle       Le nom d’une propriété FStyleFormat.
   Renvoie
   Rien.



                                                                        Dictionnaire ActionScript 205
      Description
      Méthode ; enregistre un élément d’enveloppe dans une propriété de style. Les éléments
      d’enveloppes sont enregistrés dans les propriétés de la première image du calque Lisez-moi de
      chaque enveloppe de la bibliothèque.
      Les composants sont constitués d’enveloppes, chaque enveloppe étant constituée de plusieurs
      éléments d’enveloppe, lesquels peuvent être enregistrés dans une propriété de l’objet
      FStyleFormat. Ces propriétés reçoivent des valeurs du format de style affecté à un composant. Par
      défaut, tous les composants d’interface Flash reçoivent l’objet globalStyleFormat, qui est une
      occurrence de l’objet FStyleFormat.
      Utilisez cette méthode pour enregistrer des éléments d’enveloppes et des propriétés personnalisés
      aux enveloppes de composant d’interface Flash ou personnalisées en modifiant le code dans la
      première image du calque Lisez-moi d’une enveloppe de la bibliothèque.
      Le composant FRadioButton utilise les enveloppes du dossier FRadioButton Skins et l’enveloppe
      FLabel dossier Global Skins une fois le composant ajouté au document Flash.
      Pour plus d’informations, consultez la section Personnalisation des enveloppes de composant du
      chapitre Utilisation des composants de Utilisation de Flash.
      Exemple
      Le code suivant enregistre l’élément d’enveloppe personnalisée monPoint_mc avec la propriété
      FStyleFormat radioDot dans le fichier Lisez-moi de l’enveloppe frb_dot du dossier
      FRadioButton Skins de la bibliothèque.
      radio1.registerSkinElement(monPoint_mc, "radioDot");

      Voir aussi
      FStyleFormat (objet)

FRadioButton.setChangeHandler
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonRadio.setChangeHandler(nomDeFonction, [emplacement])
      monGroupeDeBoutonsRadio.setChangeHandler(nomDeFonction, [emplacement])

      Paramètres
      nomDeFonction      Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque
      la valeur d’un bouton radio change. Si le paramètre emplacement n’est pas spécifié, cette fonction
      doit se trouver dans le même scénario que l’occurrence de composant.
      emplacement     Une référence à un objet de données, un clip ou scénario contenant la fonction
      spécifiée. Ce paramètre est facultatif et prend par défaut le scénario parent du composant.
      Renvoie
      Rien.




206
Description
Méthode ; spécifie une fonction de gestionnaire de changement à appeler lorsque la sélection du
bouton radio change. Vous pouvez spécifier la même fonction de gestionnaire de changement
pour plusieurs composants, la fonction acceptant toujours l’occurrence du composant changé
comme paramètre. L’appel de cette méthode annule la valeur du paramètre de gestionnaire de
changement spécifiée au cours de la programmation.
Usage 1. Spécifie la fonction à appeler si l’occurrence de bouton radio monBoutonRadio est
sélectionnée ou désélectionnée.
Usage 2. Spécifie la fonction à appeler si le bouton radio sélectionné dans le groupe
GroupeDeBoutonsRadio change. La spécification d’une fonction pour un groupe de boutons
radio revient à spécifier la même fonction individuellement pour tous les boutons radio de ce
groupe avec monBoutonRadio.setChangeHandler.
Pour plus d’informations, consultez la section Rédaction de fonctions de gestionnaire de
changement pour les composants du chapitre Utilisation des composants de Utilisation de Flash.
Exemple
Usage 1. Le code suivant spécifie monGestionnaire comme fonction appelée lorsque radio1 est
sélectionné.
radio1.setChangeHandler("monGestionnaire");
Usage 2. Le code suivant spécifie onChange comme fonction appelée lorsqu’un bouton radio du
groupe groupeBoutonsRadio1 est sélectionné.
groupeBoutonsRadio1.setChangeHandler("onChange");
Le code suivant spécifie onChange comme fonction appelée lorsque l’utilisateur sélectionne un
bouton radio de groupeBoutonsRadio1. Le paramètre emplacement n’étant pas spécifié,
onChange doit se trouver dans le scénario que l’occurrence de composant. Le paramètre
composant de onChange est automatiquement rempli avec le composant (le composant qui a
changé en résultat de la saisie utilisateur et qui spécifie onChange en tant que son gestionnaire de
changement), dans ce cas, un bouton radio d’un groupe. Les actions définies dans onChange
spécifient que, lorsque l’utilisateur sélectionne un bouton radio, le nom d’occurrence est affiché
dans la fenêtre Sortie.
groupeBoutonsRadio1.setChangeHandler("onChange");
function onChange(composant){
trace(composant._name);
}
Si, dans l’exemple précédent, onChange est une fonction située dans le scénario arrière-grand-
parent du scénario du composant, la première ligne de code serait la suivante :
groupeBoutonsRadio1.setChangeHandler("onChange", _parent._parent._parent);
Le code suivant crée la fonction onChange dans une occurrence de monObjet (de classe Object),
puis spécifie onChange comme fonction pour groupeBoutonsRadio1.
monObjet = new Object();
monObjet.onChange = function(composant){
trace(composant._name);
}
groupeBoutonsRadio1.setChangeHandler("onChange", monObjet);




                                                                       Dictionnaire ActionScript 207
FRadioButton.setData
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonRadio.setData("données")

      Paramètres
      données      Les données à associer à l’occurrence de bouton radio.
      Renvoie
      Rien.
      Description
      Méthode ; spécifie les données à associer à l’occurrence de bouton radio. L’appel de cette méthode
      annule la valeur du paramètre de données spécifiée au cours de la programmation.
      Exemple
      Le code suivant spécifie les données ActionScript pour l’occurrence de bouton radio
      flashRadio.
      flashRadio.setData("ActionScript");

      Voir aussi
      FRadioButton.getData, FRadioButton.setValue


FRadioButton.setEnabled
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonRadio.setEnabled(activerTrueFalse)
      monGroupeDeBoutonsRadio.setEnabled(activerTrueFalse)

      Paramètres
      activerTrueFalse     Une valeur booléenne spécifiant si un seul bouton radio ou tous les boutons
      radio d’un groupe sont activés (true) ou non (false).
      Renvoie
      Rien.
      Description
      Méthode ; active et désactive les boutons radio à l’exécution.
      Usage 1. Spécifie si monBoutonRadio est activé (true) ou désactivé (false).
      Usage 2. Spécifie si tous les boutons radio avec le nom de groupe GroupeDeBoutonsRadio sont
      activés (true) ou désactivés (false). L’appel de cette méthode sans transmettre de paramètre
      revient au même que de transmettre le paramètre true.




208
  Exemple
  Usage 1. Le code suivant désactive le bouton radio radio1 sans désactiver les autres boutons du
  groupe.
  radio1.setEnabled(false);
  Usage 2. Le code suivant désactive tous les boutons radio du groupe groupeBoutonsRadio1.
  groupeBoutonsRadio1.setEnabled(false);

  Voir aussi
  FRadioButton.getEnabled

FRadioButton.setGroupName
  Disponibilité
  Flash Player 6.
  Usage
  monBoutonRadio.setGroupName(nomDeGroupe)
  monGroupeDeBoutonsRadio.setGroupName(nomDeGroupe)

  Paramètres
  nomDeGroupe       Une chaîne spécifiant le nom d’un groupe de boutons radio.
  Renvoie
  Rien.
  Description
  Méthode ; applique un nom de groupe à l’occurrence de bouton radio ou groupe de boutons
  radio à l’exécution. L’appel de cette méthode annule la valeur du paramètre de nom de groupe
  spécifiée au cours de la programmation.
  Usage 1. Spécifie monBoutonRadio comme membre du groupe de boutons radio nomDeGroupe.
  Usage 2. Spécifie un nouveau nom de groupe pour tous les boutons radio de
  monGroupeDeBoutonsRadio.

  Exemple
  Usage 1. Le code suivant spécifie Couleurs comme nom de groupe pour l’occurrence de bouton
  radio radioRouge.
  radioRouge.setGroupName("Couleurs");
  Usage 2. Le code suivant spécifie groupeBoutonsRadioJouets comme nouveau nom de groupe
  pour tous les boutons radio de groupeBoutonsRadioJeux.
  groupeBoutonsRadioJeux.setGroupName("groupeBoutonsRadioJouets");




                                                                      Dictionnaire ActionScript 209
FRadioButton.setLabel
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonRadio.setLabel(étiquette)

      Paramètres
      étiquette     Une chaîne spécifiant l’étiquette qui apparaît à droite du bouton radio.
      Renvoie
      Rien.
      Description
      Méthode ; applique une étiquette à l’occurrence de bouton radio monBoutonRadio à l’exécution.
      L’appel de cette méthode annule la valeur du paramètre label spécifiée au cours de la
      programmation. Vous ne pouvez pas utiliser cette méthode pour définir les étiquettes de groupes
      de boutons radio ; la syntaxe GroupeDeBoutonsRadio.setLabel n’est pas valide.
      Exemple
      Le code suivant applique l’étiquette Yeux bleus à radio1.
      radio1.setLabel("Yeux bleus");

      Voir aussi
      FRadioButton.getLabel

FRadioButton.setLabelPlacement
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonRadio.setLabelPlacement(positionDeLétiquette)
      monGroupeDeBoutonsRadio.setLabelPlacement(positionDeLétiquette)

      Paramètres
      positionDeLétiquette        Une chaîne de texte ; spécifiez "left" ou "right".
      Description
      Méthode ; spécifie si l’étiquette apparaît à gauche ou à droite du bouton radio. L’appel de cette
      méthode annule la valeur du paramètre de position d’étiquette spécifiée au cours de la
      programmation.
      Usage 1. Spécifie l’emplacement de l’étiquette d’un bouton radio.
      Usage 2. Spécifie l’emplacement des étiquettes de tous les boutons radio d’un groupe.
      Exemple
      Usage 1. Le code suivant place l’étiquette de radio1 à gauche du bouton radio.
      radio1.setLabelPlacement("left");




210
   Usage 2. Le code suivant place les étiquettes des boutons radio du groupe Couleurs à droite des
   boutons.
   Couleurs.setLabelPlacement("right");

   Voir aussi
   FRadioButton.setLabel, FRadioButton.setLabelPlacement


FRadioButton.setSize
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonRadio.setSize(largeur)
   monGroupeDeBoutonsRadio.setSize(largeur)

   Paramètres
   largeur      Un entier spécifiant la taille du bouton radio, en pixels.
   Renvoie
   Rien.
   Description
   Méthode ; spécifie la largeur du bouton radio, en pixels, et le retrace. Vous ne pouvez pas définir
   la hauteur des composants bouton radio. L’appel de cette méthode annule la largeur appliquée au
   cours de la programmation.
   Usage 1. Définit la taille d’un bouton radio.
   Usage 2. Définit la taille de tous les boutons radio d’un groupe.
   Pour plus d’informations, consultez la section Dimensions des composants RadioButton du
   chapitre Utilisation des composants de Utilisation de Flash.
   Exemple
   Le code suivant définit la largeur de radio1 sur 200 pixels.
   radio1.setSize(200);

FRadioButton.setState
   Disponibilité
   Flash Player 6.
   Usage
   monBoutonRadio.setState("sélectionnerTrueFalse")

   Paramètres
   sélectionnerTrueFalse          Une valeur booléenne indiquant si le bouton radio est sélectionné
   (true) ou non (false).
   Renvoie
   Rien.




                                                                             Dictionnaire ActionScript   211
      Description
      Méthode ; spécifie si monBoutonRadio est sélectionné (true) ou non (false). Un seul bouton
      radio d’un groupe (ayant tous le même paramètre de nom de groupe) peut avoir un état initial de
      true (sélectionné). Si true est spécifié pour ce paramètre pour plusieurs boutons radio, le dernier
      bouton radio avec un paramètre d’état initial de true est sélectionné. La valeur par défaut de ce
      paramètre est false.
      L’appel de cette méthode annule la valeur du paramètre d’état initial spécifiée au cours de la
      programmation. Si vous appelez cette méthode et appelez également FRadioButton.setValue
      pour sélectionner un bouton radio à l’exécution, et que les boutons radio sont différents boutons
      du même groupe, le bouton radio spécifié dans la dernière méthode appelée est sélectionné.
      Exemple
      Le code suivant sélectionne le bouton radio radio1 à l’exécution.
      radio1.setState(true);

      Voir aussi
      FRadioButton.getState, FRadioButton.getValue, FRadioButton.setValue


FRadioButton.setStyleProperty
      Disponibilité
      Flash Player 6.
      Usage
      monBoutonRadio.setStyleProperty(propriétéDeStyle, valeur)
      monGroupeDeBoutonsRadio.setStyleProperty(propriétéDeStyle, valeur)

      Paramètres
      propriétéDeStyle       Une chaîne spécifiant une propriété de l’objet FStyleFormat.
      valeur    La valeur à définir pour la propriété.
      Renvoie
      Rien.
      Description
      Méthode ; définit une propriété FStyleFormat pour une occurrence de bouton radio. L’appel de
      cette méthode pour spécifier une propriété annule le paramètre de cette propriété dans le format
      de style affecté au composant. La transmission de undefined comme valeur de propriété
      supprime tous les styles pour cette propriété.
      Pour définir les propriétés FStyleFormat de plusieurs composants, vous créez un format de style
      personnalisé. Pour plus d’informations sur la création de formats de style personnalisé, consultez
      la section Personnalisation de la couleur et du texte des composants du chapitre Utilisation des
      composants de Utilisation de Flash.
      Exemple
      Le code suivant donne à la propriété radioDot de radioButton1 la valeur 0xFF12AC (rose).
      radioButton1.setStyleProperty("radioDot", 0xFF12AC);




212
   Le code suivant donne à la propriété radioDot de tous les boutons de groupeBoutonsRadio1 la
   valeur 0xFF12AC (rose).
   groupeBoutonsRadio1.setStyleProperty("radioDot", 0xFF12AC);

   Voir aussi
   FStyleFormat (objet)

FRadioButton.setValue
   Disponibilité
   Flash Player 6.
   Usage
   monGroupeDeBoutonsRadio.setValue("données")

   Paramètres
   données      Les données associées au bouton radio à sélectionner.
   Renvoie
   Rien.
   Description
   Méthode ; sélectionne le bouton radio associé aux données spécifiées et désélectionne tout bouton
   actuellement sélectionné du même groupe.
   L’appel de cette méthode annule la valeur du paramètre de valeur initiale spécifiée au cours de la
   programmation. Si vous appelez cette méthode et appelez également FRadioButton.setState pour
   sélectionner un bouton radio à l’exécution, et que les boutons radio sont différents boutons du
   même groupe, le bouton radio spécifié dans la dernière méthode appelée est sélectionné.
   Exemple
   Le code suivant sélectionne le bouton radio avec les données associées red du groupe de boutons
   radio Couleurs.
   Couleurs.setValue("red");

   Voir aussi
   FRadioButton.getData, FRadioButton.getValue, FRadioButton.setState


FScrollBar (composant)
   Le composant ScrollBar de l’environnement auteur de Flash fournit les fonctions glisser-déposer
   pour l’ajout de barres de défilement aux champs de texte dynamique et de saisie aux documents
   Flash, mais aussi une interface utilisateur de définition des paramètres de base. Les méthodes du
   composant FScrollBar vous permettent de contrôler les barres de défilement à l’exécution : vous
   pouvez créer des barres de défilement, contrôler des barres de défilement créées lors de la
   programmation, définir ou remplacer des paramètres de base, et définir des options
   supplémentaires à l’exécution. Il n’est pas nécessaire d’utiliser un constructeur pour accéder aux
   méthodes des composants. Certaines méthodes du composant FScrollBar sont déconseillées pour
   les barres de défilement jointes à des champs de texte. Consultez les entrées des différentes
   méthodes pour plus d’informations.
   Les programmeurs et utilisateurs expérimentés peuvent utiliser le composant ScrollBar avec
   d’autres éléments Flash pour créer des interfaces utilisateur personnalisées.


                                                                        Dictionnaire ActionScript 213
      Les méthodes des composants n’effectuant pas de vérification d’erreur pour le type, au contraire
      des autres objets et actions ActionScript natifs, il est recommandé de valider les paramètres avant
      de les transmettre aux méthodes.
      Le composant ScrollBar est supporté par Flash Player 6 et les versions suivantes de Flash Player.
      Pour plus d’informations sur l’utilisation du composant ScrollBar, la définition des paramètres au
      cours de la programmation et le changement de la couleur et de l’apparence des composants,
      consultez les sections Personnalisation de la couleur et du texte des composants et
      Personnalisation des enveloppes de composant du chapitre Utilisation des composants de
      Utilisation de Flash.

Méthodes du composant FScrollBar

      Méthode                                   Description

      FScrollBar.getEnabled                     Renvoie true si la barre de défilement est activée, false si elle
                                                est désactivée.

      FScrollBar.getScrollPosition              Renvoie un entier représentant la position actuelle de la boîte de
                                                défilement (curseur).

      FScrollBar.registerSkinElement            Enregistre un élément d’enveloppe dans une propriété définie
                                                pour une enveloppe dans le calque Lisez-moi, la première image
                                                d’un clip d’enveloppe de la bibliothèque.

      FScrollBar.setChangeHandler               Spécifie une fonction à appeler à chaque fois que la position de
                                                défilement change. Vous ne pouvez pas utiliser cette méthode
                                                avec les champs de texte.

      FScrollBar.setEnabled                     Spécifie si la barre de défilement est activée (true) ou
                                                désactivée (false).

      FScrollBar.setHorizontal                  Spécifie si la barre de défilement est horizontale (true) ou
                                                verticale (false).

      FScrollBar.setLargeScroll                 Spécifie le nombre de positions auxquelles défiler lorsque
                                                l’utilisateur clique sur le rail de défilement.

      FScrollBar.setScrollContent               Spécifie l’occurrence de champ de texte à laquelle s’applique la
                                                barre de défilement.

      FScrollBar.setScrollPosition              Définit la position du curseur de défilement comme un entier
                                                compris entre minPos et maxPos.

      FScrollBar.setScrollProperties            Définit les propriétés pageSize, minPos et maxPos de la barre de
                                                défilement. Vous ne pouvez pas utiliser cette méthode avec les
                                                champs de texte.

      FScrollBar.setScrollTarget                Spécifie un champ de texte comme cible pour la barre de
                                                défilement.

      FScrollBar.setSize                        Définit la longueur de la barre de défilement, en pixels.

      FScrollBar.setSmallScroll                 Spécifie le nombre de positions auxquelles défiler lorsque
                                                l’utilisateur clique sur une flèche de défilement.

      FScrollBar.setStyleProperty               Définit une propriété de style pour un composant.




214
FScrollBar.getEnabled
   Disponibilité
   Flash Player 6.
   Usage
   maBarreDeDéfilement.getEnabled()

   Paramètres
   Aucun.
   Renvoie
   Une valeur booléenne.
   Description
   Méthode ; indique si la barre de défilement est activée (true) ou désactivée (false).
   Exemple
   Le code suivant renvoie une valeur à la fenêtre Sortie, indiquant si défilement1 est activé (true)
   ou désactivé (false).
   trace(défilement1.getEnabled());

   Voir aussi
   FScrollBar.setEnabled

FScrollBar.getScrollPosition
   Disponibilité
   Flash Player 6.
   Usage
   maBarreDeDéfilement.getScrollPosition()

   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie un entier spécifiant la position de la boîte de défilement (curseur). La valeur
   renvoyée est dans la plage définie par les propriétés minPos et maxPos, qui déterminent les limites
   de défilement de la barre de défilement. Pour définir les paramètres minPos et maxPos, utilisez
   FScrollBar.setScrollProperties.

   Exemple
   Le code suivant renvoie la position du curseur de la barre de défilement défilement2 dans la
   fenêtre Sortie. Si défilement2 a un paramètre minPos de 2 et un paramètre maxPos de 25, une
   valeur renvoyée de 12 indique que le curseur de défilement se trouve au milieu de la barre de
   défilement.
   trace(défilement2.getPosition());




                                                                         Dictionnaire ActionScript 215
      Consultez FScrollBar.setChangeHandler pour un autre exemple d’utilisation de cette méthode.
      Voir aussi
      FScrollBar.setChangeHandler, FScrollBar.setScrollPosition


FScrollBar.registerSkinElement
      Disponibilité
      Flash Player 6.
      Usage
      maBarreDeDéfilement.registerSkinElement(élément, propriétéDeStyle)

      Paramètres
      élément      Une occurrence de clip.
      propriétéDeStyle       Une chaîne spécifiant une propriété FStyleFormat.
      Renvoie
      Rien.
      Description
      Méthode ; enregistre un élément d’enveloppe dans une propriété de style. Les éléments
      d’enveloppes sont enregistrés dans les propriétés de la première image du calque Lisez-moi de
      chaque enveloppe de la bibliothèque.
      Les composants sont constitués d’enveloppes, chaque enveloppe étant constituée de plusieurs
      éléments d’enveloppe, lesquels peuvent être enregistrés dans une propriété de l’objet
      FStyleFormat. Ces propriétés reçoivent des valeurs du format de style affecté à un composant. Par
      défaut, tous les composants d’interface Flash reçoivent l’objet globalStyleFormat, qui est une
      occurrence de l’objet FStyleFormat.
      Utilisez cette méthode pour enregistrer des éléments d’enveloppes et des propriétés personnalisés
      aux enveloppes de composant d’interface Flash ou personnalisées en modifiant le code dans la
      première image du calque Lisez-moi d’une enveloppe de la bibliothèque.
      Le composant FScrollBar utilise les enveloppes du dossier FScrollBar Skins et l’enveloppe FLabel
      du dossier Global Skins une fois le composant ajouté au document Flash. La modification des
      enveloppes du dossier FScrollBar Skins affecte tous les composants utilisant des barres de
      défilement (ComboBox, ListBox, ScrollBar et ScrollPane).
      Pour plus d’informations, consultez la section Personnalisation des enveloppes de composant du
      chapitre Utilisation des composants de Utilisation de Flash.
      Exemple
      Le code suivant enregistre l’élément d’enveloppe personnalisée NouvelleFlèche_mc avec la
      propriété arrow dans la première image du calque Lisez-moi de l’enveloppe fsb_downArrow du
      dossier FScrollBar Skins de la bibliothèque.
      Scroll1.registerSkinElement(NouvelleFlèche_mc, "arrow");

      Voir aussi
      FStyleFormat (objet)




216
FScrollBar.setChangeHandler
   Disponibilité
   Flash Player 6.
   Usage
   maBarreDeDéfilement.setChangeHandler(nomDeFonction, [emplacement])

   Paramètres
   nomDeFonction       Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter lorsque
   l’utilisateur déplace la glissière de défilement. Si le paramètre emplacement n’est pas spécifié, cette
   fonction doit se trouver dans le même scénario que l’occurrence de composant.
   emplacement Une référence de chemin à un objet de données, un clip ou scénario contenant la
   fonction spécifiée. Ce paramètre est facultatif et prend par défaut le scénario parent du
   composant.
   Renvoie
   Rien.
   Description
   Méthode ; spécifie un gestionnaire de changement à appeler lorsque l’utilisateur déplace l’élément
   de la barre de défilement. Vous pouvez spécifier la même fonction de gestionnaire de changement
   pour plusieurs composants, la fonction acceptant toujours l’occurrence du composant changé
   comme paramètre. L’appel de cette méthode annule la valeur du paramètre de gestionnaire de
   changement spécifiée au cours de la programmation.
   Cette méthode est destinée aux programmeurs et utilisateurs expérimentés qui créent des
   applications et des composants personnalisés à l’aide du composant d’interface Flash ScrollBar et
   ne peut pas être utilisée lorsque des barres de défilement sont associées à des champs de texte.




                                                                            Dictionnaire ActionScript 217
      Exemple
      Le code suivant crée une boîte remplie sur la scène, puis applique une barre de défilement
      horizontale, définit les propriétés de défilement et spécifie la fonction mover en tant que
      gestionnaire de changement. Le gestionnaire de changement mover utilise la position de
      défilement de la barre de défilement pour changer la position _x du clip entre 50 et 250.
      root.createEmptyMovieClip("carré", 1);
      _root.carré._x = 50;
      _root.carré._y = 50;
      with (_root.carré) {
          moveTo(0, 0);
          beginFill(0x0066CC);
          lineTo(20, 0);
          lineTo(20, 20);
          lineTo(0, 20);
          lineTo(0, 0);
          endFill();
      }
      barreDeDéfilement._x = 50;
      barreDeDéfilement.setHorizontal (true);
      barreDeDéfilement.setScrollProperties (1, 50, 250);
      barreDeDéfilement.setChangeHandler ("mover");
      function mover () {
          _root.carré._x = barreDeDéfilement.getScrollPosition();
      }
      Le code suivant spécifie une fonction de gestionnaire de changement pour une occurrence du
      composant de barre de défilement associé à un composant de zone de liste personnalisé. Le
      gestionnaire de changement utilise défilement1 pour obtenir la position de défilement actuelle à
      l’aide de FScrollBar.getScrollPosition, puis listePersonnalisée utilise
      FScrollBar.setScrollPosition pour réinitialiser la position de défilement, afin d’afficher
      l’élément à la position de défilement actuelle en haut de la zone de liste personnalisée. Le
      paramètre composant est automatiquement rempli avec l’occurrence d’un composant (le
      composant qui a changé en résultat de la saisie utilisateur et qui spécifie monGestionnaire en
      tant que son gestionnaire de changement).
      défilement1.setChangeHandler("monGestionnaire");
      function monGestionnaire(composant)
      {
        listePersonnalisée.setScrollPosition(composant.getScrollPosition());
      }
      Si, dans l’exemple précédent, monGestionnaire est une fonction située dans le scénario arrière-
      grand-parent du scénario du composant, la première ligne de code serait la suivante :
      défilement1.setChangeHandler("monGestionnaire", _parent._parent._parent);




218
   Le code suivant crée la fonction monGestionnaire dans une occurrence de monObjet (de classe
   Object), puis spécifie monGestionnaire comme fonction pour défilement1.
   monObjet = new Object();
   monObjet.monGestionnaire = function(composant){
   listePersonnalisée.setScrollPosition(composant.getScrollPosition());
   }
   défilement1.setChangeHandler("monGestionnaire", monObjet);

   Voir aussi
   FScrollBar.getScrollPosition, FScrollBar.setScrollPosition,
   FScrollBar.setScrollProperties


FScrollBar.setEnabled
   Disponibilité
   Flash Player 6.
   Usage
   maBarreDeDéfilement.setEnabled(activerTrueFalse)

   Paramètres
   activerTrueFalse Une        valeur booléenne spécifiant si la barre de défilement est activée (true)
   ou désactivée (false).
   Renvoie
   Rien.
   Description
   Méthode ; détermine si la barre de défilement est activée (true) ou désactivée (false). Une barre
   de défilement désactivée n’accepte pas l’interaction souris ou clavier avec l’utilisateur et ne peut
   pas être sélectionnée (elle apparaît en gris). L’appel de cette méthode sans transmettre de
   paramètre revient au même que de transmettre le paramètre true.
   Exemple
   Le code suivant désactive la barre de défilement défilement2.
   défilement2.setEnabled(false);

   Voir aussi
   FScrollBar.getEnabled

FScrollBar.setHorizontal
   Disponibilité
   Flash Player 6.
   Usage
   maBarreDeDéfilement.setHorizontal(défilementHorizontal)

   Paramètres
   défilementHorizontal Une valeur booléenne spécifiant si la zone de texte est horizontale
   (true) ou verticale (false).




                                                                          Dictionnaire ActionScript 219
      Renvoie
      Rien.
      Description
      Méthode ; spécifie si la barre de défilement est appliquée à la cible horizontalement (true) ou
      verticalement (false). La valeur par défaut de cette méthode est false.
      Exemple
      Le code suivant spécifie que la barre de défilement texteDéfilant est appliquée horizontalement
      à sa cible.
      texteDéfilant.setHorizontal(true);

      Voir aussi
      FScrollBar.setSize

FScrollBar.setLargeScroll
      Disponibilité
      Flash Player 6.
      Usage
      maBarreDeDéfilement.setLargeScroll(grandDéfilement)

      Paramètres
      grandDéfilement        Un entier spécifiant le nombre de positions auxquelles défiler lorsque
      l’utilisateur clique une fois sur la piste. La valeur par défaut est la valeur définie pour pageSize
      avec FScrollBar.setScrollProperties.
      Renvoie
      Rien.
      Description
      Méthode ; définit la propriété largeScroll de l’occurrence de barre de défilement à l’exécution.
      Lorsque l’utilisateur clique une fois sur le rail de la barre de défilement, le curseur de défilement se
      déplace de la distance spécifiée pour un mouvement largeScroll.
      Exemple
      Le code suivant spécifie que, lorsque l’utilisateur clique sur le rail, texteDéfilant1 se déplace de
      20 positions.
      texteDéfilant1.setLargeScroll(20);

      Voir aussi
      FScrollBar.setSmallScroll




220
FScrollBar.setScrollContent
   Disponibilité
   Flash Player 6.
   Usage
   maBarreDeDéfilement.setScrollContent(cible)

   Paramètres
   cible   Une référence au champ de texte dans la barre de défilement.
   Renvoie
   Rien.
   Description
   Méthode ; spécifie l’occurrence de champ de texte à laquelle s’applique la barre de défilement.
   Cette occurrence doit être définie dans le même scénario et sur le même niveau que la barre de
   défilement. L’appel de cette méthode annule la valeur du paramètre de champ de texte cible
   spécifiée au cours de la programmation. L’affectation de la valeur undefined au paramètre cible
   dissocie la barre de défilement du champ de texte.
   Exemple
   Le code suivant associe texteDéfilant1 au champ de texte portant le nom d’occurrence
   champDeTexte1.
   texteDéfilant1.setScrollContent("champDeTexte1");

FScrollBar.setScrollPosition
   Disponibilité
   Flash Player 6.
   Usage
   maBarreDeDéfilement.setScrollPosition(position)

   Paramètres
   position    Un entier compris entre les paramètres minPos et maxPos de la barre de défilement.
   Consultez FScrollBar.setScrollProperties pour plus d’informations sur la définition des
   propriétés minPos et maxPos.
   Renvoie
   Rien.
   Description
   Méthode ; spécifie la position du curseur de défilement sur la barre de défilement et exécute la
   fonction de gestionnaire de changement spécifiée par FScrollBar.setChangeHandler.
   Exemple
   Le code suivant définit la position de la boîte défilante de texteDéfilant1 sur 5.
   texteDéfilant1.setScrollPosition(5);




                                                                         Dictionnaire ActionScript 221
      Consultez FScrollBar.setChangeHandler pour un autre exemple d’utilisation de cette méthode.
      Voir aussi
      FScrollBar.setChangeHandler, FScrollBar.setScrollProperties


FScrollBar.setScrollProperties
      Disponibilité
      Flash Player 6.
      Usage
      maBarreDeDéfilement.setScrollProperties(positions, posMin, posMax)

      Paramètres
      positions     Un entier représentant le nombre de positions affichées dans le mode page.
      posMin    Un entier représentant la position de défilement minimum.
      posMax    Un entier représentant la position de défilement maximum.
      Renvoie
      Rien.
      Description
      Méthode ; spécifie les propriétés positions, posMin et posMax de la barre de défilement et
      définit la taille correcte pour le curseur de défilement de la barre de défilement.
      Cette méthode est destinée aux programmeurs et utilisateurs expérimentés qui créent des
      composants personnalisés et ne peut pas être utilisée lorsque des barres de défilement sont
      associées à des champs de texte. Lorsqu’une barre de défilement est associée à un champ de texte,
      les propriétés de défilement sont automatiquement définies en fonction des propriétés du champ
      de texte et l’appel de cette méthode dissocie la barre de défilement du champ de texte.
      Exemple
      Le code suivant définit les propriétés positions, posMin et posMax pour une barre de défilement
      associée à un composant de zone de liste personnalisé. La zone de liste a 5 lignes visibles et un
      total de 20 éléments dans la liste. La boîte étant indexée de 0 à 19, la propriété maxPos est le
      nombre total d’éléments de la boîte moins le nombre d’éléments visibles.
      barreDeDéfilement.setScrollProperties (5, 0, 15);

      Voir aussi
      FScrollBar.setScrollPosition

FScrollBar.setScrollTarget
      Disponibilité
      Flash Player 6.
      Usage
      maBarreDeDéfilement.setScrollTarget(cible)

      Paramètres
      cible    Une référence au champ de texte dans la barre de défilement.




222
   Renvoie
   Rien.
   Description
   Méthode ; spécifie l’occurrence de champ de texte à laquelle s’applique la barre de défilement.
   Cette occurrence doit être définie dans le même scénario et sur le même niveau que la barre de
   défilement. L’appel de cette méthode annule la valeur du paramètre de champ de texte cible
   spécifiée au cours de la programmation. L’affectation de la valeur undefined au paramètre cible
   dissocie la barre de défilement du champ de texte.
   Exemple
   Le code suivant associe texteDéfilant1 au champ de texte portant le nom d’occurrence
   champDeTexte1.
   texteDéfilant1.setScrollTarget("champDeTexte1");

FScrollBar.setSize
   Disponibilité
   Flash Player 6.
   Usage
   maBarreDeDéfilement.setSize(longueur)

   Paramètres
   longueur    Un entier spécifiant la longueur de la barre de défilement, en pixels.
   Renvoie
   Rien.
   Description
   Méthode ; définit la longueur, en pixels, de la barre de défilement à l’exécution. Vous ne pouvez
   pas définir la largeur des composants barre de défilement. L’appel de cette méthode annule
   l’échelle et les dimensions appliquées au cours de la programmation.
   Cette méthode ne doit pas être utilisée lorsque des barres de défilement sont associées à des
   champs de texte, la barre de défilement adoptant automatiquement la taille du champ de texte au
   cours de la programmation.
   Pour plus d’informations, consultez la section Dimensions des composants ScrollBar du chapitre
   Utilisation des composants de Utilisation de Flash.
   Exemple
   Le code suivant définit la longueur de texteDéfilant1 sur 200 pixels.
   texteDéfilant1.setSize(200);




                                                                         Dictionnaire ActionScript 223
FScrollBar.setSmallScroll
      Disponibilité
      Flash Player 6.
      Usage
      maBarreDeDéfilement.setSmallScroll(petitDéfilement)

      Paramètres
      petitDéfilement        Un entier spécifiant le nombre de positions auxquelles défiler lorsque
      l’utilisateur clique sur une flèche de défilement. La valeur par défaut est 1.
      Renvoie
      Rien.
      Description
      Méthode ; définit la propriété smallScroll de l’occurrence de barre de défilement à l’exécution,
      si le champ de texte a le focus. Lorsque l’utilisateur clique sur les flèches de la barre de défilement,
      ou sur une touche fléchée du clavier, le curseur de défilement se déplace de la distance spécifiée
      pour un mouvement petitDéfilement.
      Exemple
      Le code suivant spécifie que, lorsque l’utilisateur clique sur une flèche de défilement,
      texteDéfilant1 se déplace de 5 positions.
      texteDéfilant1.setSmallScroll(5);

      Voir aussi
      FScrollBar.setLargeScroll

FScrollBar.setStyleProperty
      Disponibilité
      Flash Player 6.
      Usage
      maBarreDeDéfilement.setStyleProperty(propriétéDeStyle, valeur)

      Paramètres
      propriétéDeStyle       Une chaîne spécifiant une propriété de l’objet FStyleFormat.
      valeur    La valeur à définir pour la propriété.
      Renvoie
      Rien.
      Description
      Méthode ; définit une propriété FStyleFormat pour une occurrence de barre de défilement.
      L’appel de cette méthode pour spécifier une propriété annule le paramètre de cette propriété dans
      le format de style affecté au composant. La transmission de undefined comme valeur de
      propriété supprime tous les styles pour cette propriété.




224
   Pour définir les propriétés FStyleFormat de plusieurs composants, vous créez un format de style
   personnalisé. Pour plus d’informations sur la création de formats de styles personnalisés, consultez
   la section Personnalisation de la couleur et du texte des composants du chapitre Utilisation des
   composants de Utilisation de Flash.
   Exemple
   Le code suivant donne à la propriété arrow de barreDeDéfilement1 la valeur 0x000000 (noir).
   barreDeDéfilement1.setStyleProperty("arrow", 0x000000);

   Voir aussi
   FStyleFormat (objet)

FScrollPane (composant)
   Le composant ScrollPane de l’environnement auteur de Flash fournit les fonctions glisser-déposer
   pour l’ajout de panneaux défilants d’affichage de clips dans les documents Flash, mais aussi une
   interface utilisateur de définition des paramètres de base. Les méthodes du composant
   FScrollPane vous permettent de contrôler les panneaux défilants à l’exécution : vous pouvez créer
   des panneaux de défilement, contrôler des panneaux de défilement créées lors de la
   programmation, définir ou remplacer des paramètres de base, et définir des options
   supplémentaires à l’exécution. Il n’est pas nécessaire d’utiliser un constructeur pour accéder aux
   méthodes des composants.
   Le composant ScrollPane fournit des barres de défilement vertical et horizontal qui permettent
   d’afficher des clips de grande taille sans prendre trop d’espace sur la scène. Les contrôles de souris
   et de clavier standard sont intégrés.
   Remarque Le composant ScrollPane n’affiche que les clips ; pour ajouter des barres de défilement aux champs de
   texte dynamique et de saisie, utilisez le composant ScrollBar. Le composant ScrollPane ne peut pas afficher le
   contenu utilisant des polices de périphérique.

   Les méthodes des composants n’effectuant pas de vérification d’erreur pour le type, au contraire
   des autres objets et actions ActionScript natifs, il est recommandé de valider les paramètres avant
   de les transmettre aux méthodes.
   Le composant ScrollPane est supporté par Flash Player 6 et les versions suivantes de Flash Player.
   Pour plus d’informations sur l’utilisation du composant ScrollPane, la définition des paramètres
   au cours de la programmation et le changement de la couleur et de l’apparence des composants,
   consultez les sections Personnalisation de la couleur et du texte des composants et
   Personnalisation des enveloppes de composant du chapitre Utilisation des composants de
   Utilisation de Flash.

Méthodes du composant FScrollPane

    Méthode                                           Description

    FScrollPane.getPaneHeight                         Renvoie la hauteur du panneau défilant.

    FScrollPane.getPaneWidth                          Renvoie la largeur du panneau défilant.

    FScrollPane.getScrollContent                      Renvoie une occurrence du contenu affiché dans le panneau
                                                      défilant.

    FScrollPane.getScrollPosition                     Renvoie les coordonnées x et y de la position de défilement
                                                      actuelle.

    FScrollPane.loadScrollContent                     Charge un fichier SWF ou JPEG dans le panneau défilant.




                                                                                 Dictionnaire ActionScript 225
      Méthode                                       Description

      FScrollPane.refreshPane                       Redimensionne les barres de défilement du panneau défilant
                                                    lorsque le contenu change de taille.

      FScrollPane.registerSkinElement               Enregistre un élément d’enveloppe dans une propriété
                                                    définie pour une enveloppe dans le calque Lisez-moi, la
                                                    première image d’un clip d’enveloppe de la bibliothèque.

      FScrollPane.setDragContent                    Définit le contenu du panneau défilant comme déplaçable.

      FScrollPane.setHScroll                        Définit le style de défilement horizontal du panneau défilant.

      FScrollPane.setScrollContent                  Définit un clip comme cible du panneau défilant.

      FScrollPane.setScrollPosition                 Fait défiler le panneau jusqu’aux coordonnées x, y spécifiées.

      FScrollPane.setSize                           Définit la largeur et la hauteur du panneau défilant, en pixels.

      FScrollPane.setStyleProperty                  Définit une propriété de style pour un composant.

      FScrollPane.setVScroll                        Définit le style de défilement vertical du panneau défilant.


FScrollPane.getPaneHeight
      Disponibilité
      Flash Player 6.
      Usage
      monPanneauDéfilant.getPaneHeight()

      Paramètres
      Aucun.
      Renvoie
      Un entier spécifiant la hauteur du panneau défilant.
      Description
      Méthode ; renvoie la hauteur du panneau défilant. Vous ne pouvez utiliser cette méthode que
      pour récupérer la hauteur d’un panneau défilant établie avec FScrollPane.setSize. Cette
      méthode ne fonctionne que si le panneau défilant a été dimensionné avec
      FScrollPane.setSize, pas si vous avez utilisé les propriétés _width et _height.

      Exemple
      Le code suivant récupère la hauteur et la largeur du panneau défilant panneau1 et utilise les
      valeurs envoyées pour le redimensionner avec FScrollPane.setSize.
      var h = panneau1.getPaneHeight();
      var l = panneau1.getPaneWidth();
      panneau1.setSize(l+10, h+10);

      Voir aussi
      FScrollPane.getPaneWidth, FScrollPane.setSize




226
FScrollPane.getPaneWidth
   Disponibilité
   Flash Player 6.
   Usage
   monPanneauDéfilant.getPaneWidth()

   Paramètres
   Aucun.
   Renvoie
   Un entier spécifiant la largeur du panneau défilant.
   Description
   Méthode ; renvoie la largeur du panneau défilant. Vous ne pouvez utiliser cette méthode que
   pour récupérer la largeur d’un panneau défilant établie avec FScrollPane.setSize. Cette
   méthode ne fonctionne que si le panneau défilant a été dimensionné avec
   FScrollPane.setSize, pas si vous avez utilisé les propriétés _width et _height.

   Exemple
   Le code suivant récupère la hauteur et la largeur du panneau défilant panneau1 et utilise les
   valeurs envoyées pour le redimensionner avec FScrollPane.setSize.
   var h = panneau1.getPaneHeight();
   var l = panneau1.getPaneWidth();
   panneau1.setSize(l+10, h+10);

   Voir aussi
   FScrollPane.getPaneHeight, FScrollPane.setSize


FScrollPane.getScrollContent
   Disponibilité
   Flash Player 6.
   Usage
   monPanneauDéfilant.getScrollContent()

   Paramètres
   Aucun.
   Renvoie
   Une référence au clip dans le panneau défilant.
   Description
   Méthode ; renvoie une occurrence du contenu affiché dans le panneau défilant.




                                                                        Dictionnaire ActionScript 227
      Exemple
      Le code suivant récupère une référence au clip de panneau1, l’enregistre dans une variable, puis
      envoie le clip à l’image 4.
      var contenu = panneau1.getScrollContent();
      contenu.gotoAndStop(4);

      Voir aussi
      FScrollPane.setScrollContent

FScrollPane.getScrollPosition
      Disponibilité
      Flash Player 6.
      Usage
      monPanneauDéfilant.getScrollPosition()

      Paramètres
      Aucun.
      Renvoie
      Un objet.
      Description
      Méthode ; renvoie un objet avec les champs .x ou .y spécifiant la position de défilement
      verticale ou horizontale actuelle du panneau défilant.
      Exemple
      Le code suivant renvoie la position du panneau défilant défilement2 dans la fenêtre Sortie.
      trace(défilement2.getScrollPosition());

      Voir aussi
      FScrollPane.setScrollPosition

FScrollPane.loadScrollContent
      Disponibilité
      Flash Player 6.
      Usage
      monPanneauDéfilant.loadScrollContent(URL [, nomDeFonction, emplacement])

      Paramètres
      URL   Une chaîne spécifiant l’URL d’un fichier SWF ou JPEG à charger dans le panneau défilant.
      nomDeFonction Une chaîne spécifiant le nom de la fonction de gestionnaire à exécuter au
      chargement du panneau défilant. Si le paramètre emplacement n’est pas spécifié, cette fonction
      doit se trouver dans le même scénario que l’occurrence de composant.
      emplacement Une référence de chemin à un objet de données, un clip ou scénario contenant la
      fonction spécifiée. Ce paramètre est facultatif et prend par défaut le scénario parent du
      composant.




228
   Renvoie
   Rien.
   Description
   Méthode ; spécifie l’URL d’un fichier SWF ou JPEG à afficher dans le panneau défilant. Les
   paramètres facultatifs nomDeFonction et emplacement vous permettent de spécifier une fonction
   de gestionnaire de changement à appeler au chargement du contenu.
   L’URL doit se trouver dans le même sous-domaine que l’URL à laquelle l’animation Flash réside.
   Pour utiliser les fichiers SWF ou JPEG dans Flash Player ou pour tester l’animation dans
   l’environnement auteur de Flash, tous les fichiers SWF ou JPEG doivent être stockés dans le
   même dossier et les noms de fichiers ne doivent pas inclure de spécifications de dossier ni d’unité
   de disque.
   L’appel de cette méthode annule la valeur du paramètre de contenu défilant spécifiée au cours de
   la programmation.
   Consultez FScrollBar.setChangeHandler pour plus d’informations et d’exemples sur
   l’utilisation de fonctions de gestionnaire de changement.
   Exemple
   Le code suivant charge un fichier JPEG à partir d’un serveur dans panneau1.
   panneau1.loadScrollContent("http://www.votreServeurWeb.fr/sympa.jpg");
   Le code suivant charge un fichier JPEG à partir d’un serveur et spécifie la fonction de gestionnaire
   de changement load située dans le scénario grand-parent du composant panneau1.
   panneau1.loadScrollContent("http://www.votreServeurWeb.fr/sympa.jpg" , "load"
     , _parent._parent);
   function load(composant){
       // le contenu est chargé
       composant.setScrollPostion(10,10);
   }

   Voir aussi
   FScrollPane.getPaneHeight, FScrollPane.setScrollContent


FScrollPane.refreshPane
   Disponibilité
   Flash Player 6.
   Usage
   monPanneauDéfilant.refreshPane()

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Méthode ; redimensionne les barres de défilement du panneau défilant lorsque le contenu du
   panneau défilant change. Appelez cette méthode si vous redimensionnez le contenu de la fenêtre
   du panneau défilant à l’aide de _width ou _height.


                                                                          Dictionnaire ActionScript 229
      Exemple
      Le code suivant met à jour les barres de défilement de panneau après une augmentation de la
      taille du clip monContenu dans le panneau défilant.
      var monContenu = panneau.getScrollContent();
      monContenu._width = 400;
      panneau.refreshPane();

      Voir aussi
      FScrollPane.getScrollContent

FScrollPane.registerSkinElement
      Disponibilité
      Flash Player 6.
      Usage
      monPanneauDéfilant.registerSkinElement(élément, propriétéDeStyle)

      Paramètres
      élément      Une occurrence de clip.
      propriétéDeStyle       Le nom d’une propriété FStyleFormat.
      Renvoie
      Rien.
      Description
      Méthode ; enregistre un élément d’enveloppe dans une propriété de style. Les éléments
      d’enveloppes sont enregistrés dans les propriétés de la première image du calque Lisez-moi de
      chaque enveloppe de la bibliothèque.
      Les composants sont constitués d’enveloppes, chaque enveloppe étant constituée de plusieurs
      éléments d’enveloppe, lesquels peuvent être enregistrés dans une propriété de l’objet
      FStyleFormat. Ces propriétés reçoivent des valeurs du format de style affecté à un composant. Par
      défaut, tous les composants d’interface Flash reçoivent l’objet globalStyleFormat, qui est une
      occurrence de l’objet FStyleFormat.
      Utilisez cette méthode pour enregistrer des éléments d’enveloppes et des propriétés personnalisés
      aux enveloppes de composant d’interface Flash ou personnalisées en modifiant le code dans la
      première image du calque Lisez-moi d’une enveloppe de la bibliothèque.
      Le composant FScrollPane utilise les enveloppes du dossier FScrollPane Skins et l’enveloppe
      FLabel dossier Global Skins une fois le composant ajouté au document Flash. La modification des
      enveloppes du dossier FScrollBar Skins affecte tous les composants utilisant des barres de
      défilement (ComboBox, ListBox, ScrollBar et ScrollPane).
      Pour plus d’informations, consultez la section Personnalisation des enveloppes de composant du
      chapitre Utilisation des composants de Utilisation de Flash.




230
   Exemple
   Le code suivant enregistre l’élément d’enveloppe personnalisée NouvelleFlèche_mc avec la
   propriété arrow dans la première image du calque Lisez-moi de l’enveloppe fsb_downArrow du
   dossier FScrollBar Skins de la bibliothèque.
   panneau1.registerSkinElement(NouvelleFlèche_mc, "arrow");

   Voir aussi
   FStyleFormat (objet)

FScrollPane.setDragContent
   Disponibilité
   Flash Player 6.
   Usage
   monPanneauDéfilant.setDragContent(glisser)

   Paramètres
   glisser     Une valeur booléenne ; true spécifie que l’utilisateur peut changer l’affichage en
   déplaçant le contenu dans le panneau défilant ; false spécifie qu’il ne peut changer l’affichage
   qu’en utilisant les barres de défilement.
   Renvoie
   Rien.
   Description
   Méthode ; spécifie si l’utilisateur peut, en plus d’utiliser les barres de défilement, faire glisser le
   contenu du panneau défilant pour en changer l’affichage. L’appel de cette méthode annule la
   valeur du paramètre de contenu déplaçable spécifiée au cours de la programmation.
   Exemple
   L’exemple suivant spécifie que le contenu du panneau défilant panneau1 peut être déplacé.
   panneau1.setDragContent(true);

FScrollPane.setHScroll
   Disponibilité
   Flash Player 6.
   Usage
   monPanneauDéfilant.setHScroll(afficher)

   Paramètres
   afficher     Une valeur booléenne spécifiant si la barre de défilement est toujours affichée (true)
   ou jamais affichée (false), ou une chaîne spécifiant l’affichage uniquement lorsque nécessaire
   ("auto").
   L’appel de cette méthode annule la valeur du paramètre de défilement horizontal spécifiée au
   cours de la programmation.
   Renvoie
   Rien.



                                                                              Dictionnaire ActionScript 231
      Description
      Méthode, détermine si une barre de défilement horizontale est toujours affichée (true), jamais
      affichée (false), ou seulement lorsque nécessaire ("auto"). La valeur par défaut est auto.
      Exemple
      Le code suivant masque la barre de défilement horizontale pour panneau1.
      panneau1.setHScroll(false);

      Voir aussi
      FScrollPane.setVScroll

FScrollPane.setScrollContent
      Disponibilité
      Flash Player 6.
      Usage
      monPanneauDéfilant.setScrollContent(cible)

      Paramètres
      cible Une chaîne de texte spécifiant l’identifiant de liaison de symbole d’un clip dans la
      bibliothèque ou une occurrence d’un clip.
      Renvoie
      Rien.
      Description
      Méthode ; spécifie un clip à afficher dans le panneau défilant. L’appel de cette méthode annule la
      valeur du paramètre de contenu défilant spécifiée au cours de la programmation.
      Exemple
      L’exemple suivant spécifie l’occurrence de clip BetsyTacy comme cible pour panneau1.
      panneau1.setScrollContent("BetsyTacy");

      Voir aussi
      FScrollPane.getPaneHeight, FScrollPane.loadScrollContent


FScrollPane.setScrollPosition
      Disponibilité
      Flash Player 6.
      Usage
      monPanneauDéfilant.setScrollPosition(x, y)

      Paramètres
      x   Un entier spécifiant le nombre de pixels (de 0) du défilement vers la droite.
      y   Un entier spécifiant le nombre de pixels (de 0) du défilement vers le bas.
      Renvoie
      Rien.




232
   Description
   Méthode ; définit la position de défilement aux coordonnées x, y spécifiées.
   Exemple
   L’exemple suivant fait défiler le contenu de panneau1 de 14 pixels vers le bas et de 40 pixels vers
   la droite.
   panneau1.setScrollPosition(14,40);

   Voir aussi
   FScrollPane.getScrollPosition

FScrollPane.setSize
   Disponibilité
   Flash Player 6.
   Usage
   monPanneauDéfilant.setSize(largeur, hauteur)

   Paramètres
   largeur      Un entier spécifiant la largeur du panneau défilant, en pixels.
   hauteur      Un entier spécifiant la hauteur du panneau défilant, en pixels.
   Renvoie
   Rien.
   Description
   Méthode ; définit la largeur et la hauteur, en pixels, du panneau déroulant à l’exécution. L’appel
   de cette méthode annule les dimensions appliquées au cours de la programmation.
   Pour plus d’informations, consultez la section Personnalisation des enveloppes de composant du
   chapitre Utilisation des composants de Utilisation de Flash.
   Exemple
   Le code suivant définit la largeur et la hauteur de panneau1 sur 500 x 300 pixels.
   panneau1.setSize(500, 300);

   Voir aussi
   FScrollPane.getPaneHeight, FScrollPane.getPaneWidth


FScrollPane.setStyleProperty
   Disponibilité
   Flash Player 6.
   Usage
   monPanneauDéfilant.setStyleProperty(propriétéDeStyle, valeur)

   Paramètres
   propriétéDeStyle        Une chaîne spécifiant une propriété de l’objet FStyleFormat.
   valeur    La valeur à définir pour la propriété.




                                                                           Dictionnaire ActionScript 233
      Renvoie
      Rien.
      Description
      Méthode ; définit une propriété FStyleFormat pour une occurrence de panneau défilant. L’appel
      de cette méthode pour spécifier une propriété annule le paramètre de cette propriété dans le
      format de style affecté au composant. La transmission de undefined comme valeur de propriété
      supprime tous les styles pour cette propriété.
      Pour définir les propriétés FStyleFormat de plusieurs composants, vous créez un format de style
      personnalisé. Pour plus d’informations sur la création de formats de styles personnalisés, consultez
      la section Personnalisation de la couleur et du texte des composants du chapitre Utilisation des
      composants de Utilisation de Flash.
      Exemple
      Le code suivant donne à la propriété arrow de PanneauDéfilant2 la valeur 0x000000 (noir).
      PanneauDéfilant2.setStyleProperty("arrow", 0x000000);

      Voir aussi
      FStyleFormat (objet)

FScrollPane.setVScroll
      Disponibilité
      Flash Player 6.
      Usage
      maBarreDeDéfilement.setVScroll(afficher)

      Paramètres
      afficher Une valeur booléenne spécifiant si la barre de défilement vertical est toujours affichée
      (true) ou jamais affichée (false), ou une chaîne spécifiant l’affichage uniquement lorsque
      nécessaire ("auto").
      Renvoie
      Rien.
      Description
      Méthode, détermine si une barre de défilement verticale est toujours affichée (true), jamais
      affichée (false), ou seulement lorsque nécessaire ("auto"). La valeur par défaut est auto.
      L’appel de cette méthode annule la valeur du paramètre de défilement vertical spécifiée au cours
      de la programmation.
      Exemple
      Le code suivant spécifie que la barre de défilement verticale pour panneau1 est toujours affichée.
      panneau1.setVScroll(true);

      Voir aussi
      FScrollPane.setHScroll




234
FStyleFormat (objet)
   L’objet FStyleFormat vous permet de définir ou de changer des propriétés du format de style
   global affecté par défaut à tous les composants d’interface Flash, ou de créer de nouveaux formats
   de styles personnalisés à utiliser avec des composants d’interface Flash ou des composants
   personnalisés que vous créez ou acquérez d’autres sources. Le format de style global, ou objet
   globalStyleFormat, est une occurrence de l’objet FStyleFormat qui définit les propriétés de
   couleur et de formatage de texte utilisées pour afficher tous les composants d’interface Flash.
   Pour créer un nouveau format de style personnalisé, vous créez une nouvelle occurrence de l’objet
   FStyleFormat à l’aide du constructeur new FStyleFormat(), définissez les propriétés
   FStyleFormat que vous voulez inclure dans votre format de style, puis utilisez la méthode
   FStyleFormat.addListener pour enregistrer des occurrences de composants dans le nouveau
   format de style. Une occurrence de composant peut « écouter » plusieurs formats de styles, mais
   peut seulement prendre la valeur d’un format de style pour une propriété spécifique. Si vous
   ajoutez un composant en tant qu’écouteur d’un format de style, il utilise le nouveau format de
   style pour les propriétés spécifiées dans le format et l’ancien format de style pour toutes les autres
   propriétés.
   Vous n’avez pas besoin d’utiliser le constructeur FStyleFormat pour ajouter ou retirer des
   écouteurs ou définir ou changer des propriétés dans le format de style global, l’objet
   globalStyleFormat existant dès qu’un composant d’interface Flash est placé sur la scène.
   Vous pouvez définir n’importe lesquelles des propriétés FStyleFormat pour une occurrence
   unique d’un composant en utilisant la méthode setStyleProperty disponible pour tous les
   composants d’interface Flash. L’emploi de setStyleProperty vous permet de définir une
   propriété pour un composant sans créer d’occurrence de l’objet FStyleFormat. L’emploi de
   setStyleProperty annule le paramètre d’une propriété de format de style spécifique affectée au
   composant sans changer les autres paramètres de propriété. Pour plus d’informations, consultez
   les entrées setStyleProperty pour chaque composant.
   Lors de l’affectation d’une valeur de couleur à une propriété FStyleFormat, spécifiez une couleur
   RVB selon le format 0xRRVVBB.
   Pour plus d’informations sur le format de style global et la création de formats de styles
   personnalisés, consultez la section Personnalisation de la couleur et du texte des composants du
   chapitre Utilisation des composants de Utilisation de Flash.

Méthodes de l’objet FStyleFormat

    Méthode                              Description

    FStyleFormat.addListener             Enregistre un composant dans un format de style.

    FStyleFormat.applyChanges            Applique les changements apportés aux valeurs des propriétés dans un
                                         format de style.

    FStyleFormat.removeListener          Supprime un composant enregistré comme écouteur d’un format de
                                         style.




                                                                             Dictionnaire ActionScript 235
Propriétés de l’objet FStyleFormat
      Le tableau suivant récapitule les propriétés de l’objet FStyleFormat.

      Propriété                            Description

      FStyleFormat.arrow                   La couleur de la flèche utilisée dans les barres de défilement et les listes
                                           déroulantes.

      FStyleFormat.background              La couleur de la portion d’arrière-plan d’un composant.

      FStyleFormat.backgroundDisabled      La couleur de la portion d’arrière-plan d’un composant désactivé.

      FStyleFormat.check                   La couleur de la coche d’une case à cocher sélectionnée.

      FStyleFormat.darkshadow              La couleur de la bordure intérieure ou de la portion ombrée la plus
                                           sombre d’un composant.

      FStyleFormat.face                    La couleur principale d’un composant.

      FStyleFormat.foregroundDisabled      La couleur de premier plan d’un composant désactivé.

      FStyleFormat.highlight               La couleur de la bordure intérieure ou de la portion ombrée sombre
                                           d’un composant sélectionné.

      FStyleFormat.highlight3D             La couleur de la bordure extérieure ou de la portion ombrée claire d’un
                                           composant sélectionné.

      FStyleFormat.radioDot                La couleur du point d’un bouton radio sélectionné.

      FStyleFormat.scrollTrack             La couleur du rail d’une barre de défilement.

      FStyleFormat.selection               La couleur de la barre de sélection utilisée pour sélectionner un élément
                                           de liste dans un composant.

      FStyleFormat.selectionDisabled       La couleur de la barre de sélection utilisée pour sélectionner un élément
                                           de liste dans un composant désactivé.

      FStyleFormat.selectionUnfocused      La couleur de la barre de sélection lorsque le composant n’a pas le
                                           focus clavier.

      FStyleFormat.shadow                  La couleur de la bordure extérieure ou de la portion ombrée claire d’un
                                           composant.

      FStyleFormat.textAlign               L’alignement (à gauche, à droite ou au centre) pour le texte affiché dans
                                           ou sur un composant.

      FStyleFormat.textBold                Spécifie si le texte apparaît en gras (true) ou non (false).

      FStyleFormat.textColor               la couleur de texte par défaut dans tous les composants affectés au
                                           format de style.

      FStyleFormat.textDisabled            La couleur du texte d’un composant désactivé.

      FStyleFormat.textFont                Le nom de la police utilisée pour afficher le texte.

      FStyleFormat.textIndent              L’indentation du texte, de la marge gauche au premier caractère du
                                           texte, en pixels.

      FStyleFormat.textItalic              Spécifie si le texte apparaît en italique (true) ou non (false).

      FStyleFormat.textLeftMargin          La marge gauche du paragraphe, en pixels.

      FStyleFormat.textRightMargin         La marge droite du paragraphe, en pixels.

      FStyleFormat.textSelected            La couleur d’un élément sélectionné dans un composant.

      FStyleFormat.textSize                La taille du texte, en points.

      FStyleFormat.textUnderline           Spécifie si le texte est souligné (true) ou non (false).




236
Constructeur de l’objet FStyleFormat
    Disponibilité
    Flash Player 6.
    Usage
    new FStyleFormat()

    Paramètres
    Aucun.
    Renvoie
    Une occurrence de l’objet FStyleFormat.
    Description
    Méthode ; crée un objet FStyleFormat. Vous créez de nouveaux objets FStyleFormat pour définir
    des propriétés de texte et de couleur pour les formats de styles personnalisés utilisés avec des
    composants personnalisés ou avec les composants d’interface Flash. Tous les composants
    d’interface Flash sont affectés par défaut à globalStyleFormat, qui est une occurrence de l’objet
    FStyleFormat. Vous n’avez pas besoin de créer de nouvelle occurrence de l’objet FStyleFormat
    pour changer des propriétés dans le format de style global, parce qu’elle existe déjà. Vous pouvez
    également utiliser setStyleProperty pour changer des propriétés pour des occurrences de
    composants spécifiques sans utiliser de constructeur.
    Pour plus d’informations, consultez la méthode setStyleProperty disponible pour chaque
    composant – FCheckBox.setStyleProperty, FComboBox.setStyleProperty, etc. Consultez
    également la section Personnalisation de la couleur et du texte des composants du chapitre
    Utilisation des composants de Utilisation de Flash.
    Exemple
    L’exemple suivant crée le format de style formatStyleFormulaire.
    formatStyleFormulaire = new StyleFormat();

FStyleFormat.addListener
    Disponibilité
    Flash Player 6.
    Usage
    monFormatDeStyle.addListener(composant1 [, composant2, ...composantN])

    Paramètres
    composant1 ... composantN         Les occurrences de composants à enregistrer auprès de
    monFormatDeStyle.

    Renvoie
    Rien.




                                                                         Dictionnaire ActionScript 237
      Description
      Méthode ; enregistre les composants spécifiés dans monFormatDeStyle. Utilisez cette méthode
      pour enregistrer des occurrences de composants d’interface Flash ou de composants personnalisés
      dans un format de style personnalisé. Vous pouvez également utiliser cette méthode avec la
      syntaxe suivante pour enregistrer un composant personnalisé auprès du format du style global
      utilisé par défaut par tous les composants d’interface Flash :
      globalStyleFormat.addListener(composantPersonnalisé);

      Exemple
      Le code suivant enregistre formatStyleFormulaire avec les composants maListBox,
      maComboBox et maScrollBar.
      formatStyleFormulaire.addListener(maListBox, maComboBox, maScrollBar);

      Voir aussi
      FStyleFormat.applyChanges, FStyleFormat.removeListener


FStyleFormat.applyChanges
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.applyChanges([nomDePropriété1, ...nomDePropriétéN])
      monFormatDeStyle.applyChanges()

      Paramètres
      nomDePropriété1...nomDePropriétéN Une série de chaînes de texte spécifiant les propriétés à
      mettre à jour pour tous les composants affectés à monFormatDeStyle.
      Renvoie
      Rien.
      Description
      Méthode ; met à jour l’occurrence de l’objet de format de style spécifié et applique les
      changements à tous les composants affectés au format. Vous devez appeler cette méthode pour
      ajouter ou supprimer des écouteurs et pour définir ou changer des propriétés. Lors de la mise à
      jour de propriétés, il est recommandé d’utiliser le premier type de syntaxe pour mettre à jour
      uniquement les propriétés pour lesquelles vous spécifiez une nouvelle valeur.
      Usage 1. Met à jour uniquement les propriétés spécifiées dans les paramètres.
      Usage 2. Met à jour toutes les informations du format de style (c’est-à-dire, composants et
      propriétés affectés), qu’elles aient changé ou non.
      Exemple
      Usage 1. L’exemple suivant met à jour les propriétés arrow et background, mais pas les propriétés
      check et highlight, dans formatStyleFormulaire.
      formatStyleFormulaire.arrow = 0x00ffaa;
      formatStyleFormulaire.background = 0xaabbcc;
      formatStyleFormulaire.check = 0x000000;
      formatStyleFormulaire.highlight = 0xffffff;
      formatStyleFormulaire.applyChanges("arrow", "background");




238
   Usage 2. L’exemple suivant met à jour toutes les propriétés de formatStyleFormulaire : arrow,
   background, check et highlight.
   formatStyleFormulaire.arrow = 0x00ffaa;
   formatStyleFormulaire.background = 0xaabbcc;
   formatStyleFormulaire.check = 0x000000;
   formatStyleFormulaire.highlight = 0xffffff;
   formatStyleFormulaire.applyChanges();

   Voir aussi
   FStyleFormat.addListener, FStyleFormat.removeListener


FStyleFormat.arrow
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.arrow

   Description
   Propriété ; la valeur chromatique RVB de la propriété arrow utilisée dans les barres de défilement
   et les listes déroulantes dans des composants tels que les barres de défilement, zones de liste et
   listes déroulantes. La valeur de couleur doit être au format 0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant affecte une valeur de 0x800080 à la propriété arrow de
   formatStyleFormulaire, ce qui produit une flèche rouge.
   formatStyleFormulaire.arrow = 0x800080;

FStyleFormat.background
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.background

   Description
   Propriété ; la valeur chromatique RVB pour la portion d’arrière-plan d’un composant. Par
   exemple, dans un bouton radio ou une case à cocher, la portion d’arrière-plan est l’espace à
   l’intérieur de la zone de sélection ; dans une zone de liste ou une liste déroulante, la portion
   d’arrière-plan est la zone d’affichage. La valeur de couleur doit être au format 0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.




                                                                           Dictionnaire ActionScript 239
      Exemple
      Le code suivant affecte une valeur de 0xFFE4E1 à la propriété background de
      formatStyleFormulaire, ce qui produit un arrière-plan rose pâle lorsque le composant est
      activé.
      formatStyleFormulaire.background = 0xFFE4E1;

      Voir aussi
      FStyleFormat.face

FStyleFormat.backgroundDisabled
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.backgroundDisabled

      Description
      Propriété ; la valeur chromatique RVB pour la portion d’arrière-plan d’un composant désactivé.
      La couleur d’arrière-plan des éléments désactivés d’interface utilisateur est généralement un gris
      clair. La valeur de couleur doit être au format 0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant affecte une valeur de 0x808080 à la propriété backgroundDisabled de
      formatStyleFormulaire, ce qui produit un arrière-plan gris lorsque le composant est désactivé.
      formatStyleFormulaire.backgroundDisabled = 0x808080;

      Voir aussi
      FStyleFormat.foregroundDisabled

FStyleFormat.check
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.check

      Description
      Propriété ; la valeur chromatique RVB pour la coche d’une case à cocher sélectionnée. La valeur
      de couleur doit être au format 0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant affecte une valeur de 0x228B22 à la propriété check de
      formatStyleFormulaire, ce qui produit une flèche verte sombre.
      formatStyleFormulaire.check = 0x228B22;




240
FStyleFormat.darkshadow
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.darkshadow

   Description
   Propriété ; la valeur chromatique RVB de la bordure intérieure ou de la portion ombrée la plus
   sombre d’un composant – par exemple, le bord intérieur du cercle d’un bouton radio ou d’une
   case à cocher non sélectionnés. La valeur de couleur doit être au format 0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant affecte une valeur de 0x0000CD à la propriété darkshadow de
   formatStyleFormulaire, ce qui produit une bordure intérieure de couleur bleue.
   formatStyleFormulaire.darkshadow = 0x0000CD;

   Voir aussi
   FStyleFormat.highlight, FStyleFormat.shadow


FStyleFormat.face
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.face

   Description
   Propriété ; la valeur chromatique RVB de la principale couleur d’un composant – par exemple, le
   gris utilisé pour les composants PushButton ou ScrollBar. La valeur de couleur doit être au format
   0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant affecte une valeur de 0x32CD32 à la propriété face de formatStyleFormulaire,
   ce qui produit des boutons et des barres de défilement vert citron.
   formatStyleFormulaire.face = 0x32CD32;




                                                                        Dictionnaire ActionScript 241
FStyleFormat.foregroundDisabled
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.foregroundDisabled

      Description
      Propriété ; la valeur chromatique RVB pour la portion de premier plan d’un composant désactivé.
      La couleur de premier plan des éléments désactivés d’interface utilisateur est généralement un gris
      moyen. La valeur de couleur doit être au format 0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant affecte une valeur de 0x708090 à la propriété foregroundDisabled de
      formatStyleFormulaire, ce qui produit un premier plan gris pour les composants désactivés.
      formatStyleFormulaire.foregroundDisabled = 0x708090;

      Voir aussi
      FStyleFormat.backgroundDisabled

FStyleFormat.highlight
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.highlight

      Description
      Propriété ; la valeur chromatique RVB de la bordure intérieure ou de la portion ombrée la plus
      sombre d’un composant sélectionné – par exemple, le bord intérieur du cercle d’un bouton radio
      ou d’une case à cocher. La valeur de couleur doit être au format 0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant affecte une valeur de 0xFF00FF à la propriété highlight de
      formatStyleFormulaire, ce qui produit une bordure intérieure jaune lorsque le composant est
      sélectionné.
      formatStyleFormulaire.highlight = 0xFF00FF;

      Voir aussi
      FStyleFormat.darkshadow




242
FStyleFormat.highlight3D
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.highlight3D

   Description
   Propriété ; la valeur chromatique RVB de la bordure extérieure ou de la portion ombrée la plus
   claire d’un composant sélectionné – par exemple, le bord extérieur du cercle d’un bouton radio ou
   d’une case à cocher. La valeur de couleur doit être au format 0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant affecte une valeur de 0x40E0D0 à la propriété highlight3D de
   formatStyleFormulaire, ce qui produit une bordure extérieure turquoise lorsque le composant
   est sélectionné.
   formatStyleFormulaire.highlight3D = 0x40E0D0;

   Voir aussi
   FStyleFormat.shadow

FStyleFormat.radioDot
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.radioDot

   Description
   Propriété ; la valeur chromatique RVB du point de sélection d’un bouton radio dans un
   composant. La valeur de couleur doit être au format 0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant affecte une valeur de 0xFF12AC à la propriété radioDot de
   formatStyleFormulaire, ce qui produit un point de sélection rose.
   formatStyleFormulaire.radioDot = 0xFF12AC;




                                                                       Dictionnaire ActionScript 243
FStyleFormat.removeListener
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.removeListener(composant)

      Paramètres
      composant       Le composant à retirer du format de style.
      Description
      Méthode ; retire un composant affecté au format de style.
      • Si vous retirez un composant d’interface Flash comme écouteur du format de style global et
        que vous ne l’affectez pas (en l’ajoutant comme écouteur) à un format de style personnalisé, les
        clips d’élément d’enveloppe sont affichés tels qu’ils ont été programmés à l’origine par l’auteur
        du composant sans valeur de propriété affectée.
      • Si vous retirez un composant d’interface Flash comme écouteur d’un format de style
        personnalisé, le composant n’utilise plus les valeurs de la propriété du format de style
        personnalisé mais utilise les valeurs spécifiées pour ces propriétés dans l’objet de format de style
        global.
      • Si vous retirez un composant personnalisé comme écouteur d’un format de style personnalisé
        sans l’ajouter à un nouveau format de style personnalisé, le composant utilise dans la mesure du
        possible les valeurs définies pour les propriétés dans le format de style global, et affiche sinon
        les éléments d’enveloppe sans valeur de propriété.
      Exemple
      L’exemple suivant supprime le composant check1 de globalStyleFormat.
      globalStyleFormat.removeListener(check1);

      Voir aussi
      FStyleFormat.addListener, FStyleFormat.applyChanges


FStyleFormat.scrollTrack
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.scrollTrack

      Description
      Propriété ; la valeur chromatique RVB pour la portion de rail d’une barre de défilement. Le
      composant ScrollBar est utilisé par les composants ScrollPane, ListBox et ComboBox, et le fait de
      changer la valeur de la propriété scrollTrack dans le format de style global change la couleur du
      rail dans tous les composants utilisant des barres de défilement. La valeur de couleur doit être au
      format 0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.




244
   Exemple
   Le code suivant affecte une valeur de 0xA0522D à la propriété scrollTrack de
   formatStyleFormulaire, ce qui produit un rail de défilement marron.
   formatStyleFormulaire.scrollTrack = 0xA0522D;

FStyleFormat.selection
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.selection

   Description
   Propriété ; la valeur chromatique RVB de la barre utilisée pour mettre en surbrillance l’élément
   sélectionné d’une liste de composant. Cette propriété fonctionne avec la propriété
   FStyleFormat.textSelected pour afficher des éléments sélectionnés, et vous devriez
   coordonner les couleurs pour faciliter la lecture du texte. Par exemple, le format de style global
   affecte la couleur bleue à la propriété selection utilisée pour afficher la barre de sélection dans
   les composants ListBox et ComboBox et affecte la couleur blanche à la propriété textSelected,
   ce qui produit une combinaison permettant de facilement consulter le texte sélectionné. La valeur
   de couleur doit être au format 0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant affecte une valeur de 0x87CEEB à la propriété selection de
   formatStyleFormulaire, ce qui produit une barre de sélection bleu ciel.
   formatStyleFormulaire.selection = 0x87CEEB;

   Voir aussi
   FStyleFormat.textSelected

FStyleFormat.selectionDisabled
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.selectionDisabled

   Description
   Propriété ; la valeur chromatique RVB de la barre de sélection utilisée pour sélectionner un
   élément de liste dans un composant désactivé. La valeur de couleur doit être au format
   0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.




                                                                         Dictionnaire ActionScript 245
      Exemple
      Le code suivant affecte une valeur de 0x708090 à la propriété selectionDisabled de
      formatStyleFormulaire, ce qui produit une barre de sélection grise lorsque le composant est
      désactivé.
      formatStyleFormulaire.selectionDisabled = 0x708090;

      Voir aussi
      FStyleFormat.selection

FStyleFormat.selectionUnfocused
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.selectionUnfocused

      Description
      Propriété ; la valeur chromatique RVB de la barre de sélection (surbrillance) dans une liste de
      composant lorsque le composant n’a pas le focus du clavier. La valeur de couleur doit être au
      format 0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant affecte une valeur de 0xaabbcc à la propriété selectionUnfocused de
      formatStyleFormulaire.
      formatStyleFormulaire.selectionUnfocused = 0xaabbcc;

      Voir aussi
      FStyleFormat.selection

FStyleFormat.shadow
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.shadow

      Description
      Propriété ; la valeur chromatique RVB de la bordure extérieure ou de la portion ombrée la plus
      claire d’un composant – par exemple, le bord extérieur du cercle d’un bouton radio ou d’une case
      à cocher non sélectionnés. La valeur de couleur doit être au format 0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.




246
   Exemple
   Le code suivant affecte une valeur de 0x008080 à la propriété shadow de
   formatStyleFormulaire, ce qui donne une bordure extérieure de couleur bleu sarcelle aux
   boutons radio et cases à cocher non sélectionnés.
   formatStyleFormulaire.shadow = 0x008080;

   Voir aussi
   FStyleFormat.check

FStyleFormat.textAlign
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.textAlign

   Description
   Propriété ; une chaîne de texte spécifiant l’alignement à droite, à gauche ou au centre pour le texte
   affiché dans les composants affectés au format de style. Le paramètre par défaut est left.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant aligne tout le texte des composants à droite avec formatStyleFormulaire.
   formatStyleFormulaire.textAlign = "right";

   Voir aussi
   FStyleFormat.textIndent, FStyleFormat.textLeftMargin,
   FStyleFormat.textRightMargin


FStyleFormat.textBold
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.textBold

   Description
   Propriété ; une valeur booléenne spécifiant si tout le texte affiché dans les composants utilisant le
   format de style apparaît en caractères gras (true) ou non (false). Le paramètre par défaut est
   false.

   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.




                                                                          Dictionnaire ActionScript 247
      Exemple
      Le code suivant spécifie que tout le texte affiché dans les composants affectés à
      formatStyleFormulaire est en caractères gras.
      formatStyleFormulaire.textBold = true;

      Voir aussi
      FStyleFormat.textItalic, FStyleFormat.textUnderline


FStyleFormat.textColor
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.textColor

      Description
      Propriété ; la valeur RVB spécifiant la couleur de texte par défaut dans tous les composants
      affectés au format de style. La valeur de couleur doit être au format 0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant affecte une valeur de 0x000000 à la propriété textColor de
      formatStyleFormulaire, ce qui produit du texte noir.
      formatStyleFormulaire.textColor = 0x000000;

      Voir aussi
      FStyleFormat.textDisabled, FStyleFormat.textSelected


FStyleFormat.textDisabled
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.textDisabled

      Description
      Propriété ; la valeur RVB spécifiant la couleur de texte par défaut utilisée pour afficher le texte
      dans les composants désactivés affectés au format de style. La valeur de couleur doit être au format
      0xRRVVBB.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.




248
   Exemple
   Le code suivant affecte une valeur de 0xCOCOC0 à la propriété textDisabled de
   formatStyleFormulaire, ce qui produit du texte gris lorsque le composant est désactivé.
   formatStyleFormulaire.textDisabled = 0xCOCOC0;

   Voir aussi
   FStyleFormat.textAlign, FStyleFormat.textSelected


FStyleFormat.textFont
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.textFont

   Description
   Propriété ; une chaîne de texte spécifiant la police utilisée pour afficher le texte dans les
   composants affectés au format de style.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant affecte une valeur de Arial à la propriété textFont de
   formatStyleFormulaire.
   formatStyleFormulaire.textFont = "Arial";

FStyleFormat.textIndent
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.textIndent

   Description
   Propriété ; un entier spécifiant l’indentation, en pixels, de la marge gauche au premier caractère
   pour tout le texte affiché utilisant le format de style.
   Exemple
   Le code suivant indente tout le texte affiché par formatStyleFormulaire de 5 pixels.
   formatStyleFormulaire.textIndent = 5;

   Voir aussi
   FStyleFormat.textAlign, FStyleFormat.textLeftMargin




                                                                            Dictionnaire ActionScript 249
FStyleFormat.textItalic
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.textItalic

      Description
      Propriété ; une valeur booléenne spécifiant si tout le texte affiché dans les composants utilisant le
      format de style apparaît en italique (true) ou non (false). Le paramètre par défaut est false.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant spécifie que tout le texte affiché dans les composants affectés à
      formatStyleFormulaire est en italique.
      formatStyleFormulaire.textItalic = true;

      Voir aussi
      FStyleFormat.textBold

FStyleFormat.textLeftMargin
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.textLeftMargin

      Description
      Propriété ; un entier spécifiant la marge de paragraphe gauche, en pixels, pour tout le texte affiché
      dans les composants affectés au format de style.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant spécifie une valeur de 4 pixels pour la propriété textLeftMargin de
      formatStyleFormulaire.
      formatStyleFormulaire.textLeftMargin = 4;

      Voir aussi
      FStyleFormat.textRightMargin




250
FStyleFormat.textRightMargin
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.textRightMargin
   Propriété ; un entier spécifiant la marge de paragraphe droite, en pixels, pour tout le texte affiché
   dans les composants affectés au format de style.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant spécifie une valeur de 4 pixels pour la propriété textRightMargin de
   formatStyleFormulaire.
   formatStyleFormulaire.textRightMargin = 4;

   Voir aussi
   FStyleFormat.textLeftMargin

FStyleFormat.textSelected
   Disponibilité
   Flash Player 6.
   Usage
   monFormatDeStyle.textSelected

   Description
   Propriété ; une valeur RVB spécifiant la couleur du texte sélectionné dans les composants affectés
   au format de style. Cette propriété fonctionne avec la propriété FStyleFormat.selection pour
   afficher des éléments sélectionnés, et vous devriez coordonner les couleurs pour faciliter la lecture
   du texte. Par exemple, le format de style global affecte la couleur bleue à la propriété selection
   utilisée pour afficher la barre de sélection dans les composants ListBox et ComboBox et affecte la
   couleur blanche à la propriété textSelected, ce qui produit une combinaison permettant de
   facilement consulter le texte sélectionné. La valeur de couleur doit être au format 0xRRVVBB.
   Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
   nouvelle valeur.
   Exemple
   Le code suivant affecte une valeur de 0xffffff à la propriété textSelected de
   formatStyleFormulaire, ce qui produit du texte blanc lorsque le composant est sélectionné.
   formatStyleFormulaire.textSelected = 0xffffff;

   Voir aussi
   FStyleFormat.selection, FStyleFormat.textDisabled




                                                                          Dictionnaire ActionScript 251
FStyleFormat.textSize
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.textSize

      Description
      Propriété ; un entier spécifiant la taille du texte, en points, affiché dans les composants affectés au
      format de style. Le paramètre par défaut pour cette propriété est une taille de 12 points.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant spécifie une taille de 10 points pour tous les composants affectés au style
      formatStyleFormulaire.
      formatStyleFormulaire.textSize = 10;

      Voir aussi
      FStyleFormat.textFont

FStyleFormat.textUnderline
      Disponibilité
      Flash Player 6.
      Usage
      monFormatDeStyle.textUnderline

      Description
      Propriété ; spécifie si le texte affiché dans les composants utilisant le format de style est souligné
      (true) ou non (false). Le paramètre par défaut est false.
      Vous devez utiliser FStyleFormat.applyChanges pour la mise à jour des propriétés avec une
      nouvelle valeur.
      Exemple
      Le code suivant spécifie que tout le texte affiché dans les composants affectés à
      formatStyleFormulaire est souligné.
      formatStyleFormulaire.textUnderline = true;

      Voir aussi
      FStyleFormat.textBold, FStyleFormat.textItalic




252
Function (objet)
    L’objet Function est disponible dans Flash MX.

Propriétés de l’objet Function

    Propriété                        Description

    Function.prototype               Fait référence à un objet qui est le prototype d’une classe.


Méthodes de l’objet Function

    Méthode                          Description

    Function.apply                   Active l’appel d’une fonction par le code ActionScript.

    Function.call                    Invoque la fonction représentée par un objet Function.


Function.apply
    Disponibilité
    Flash Player 6.
    Usage
    maFonction.apply(cetObjet, objetArguments)

    Paramètres
    cetObjet      L’objet auquel est appliqué maFonction.
    objetArguments       Un tableau dont les éléments sont transmis à maFonction en tant que
    paramètres.
    Renvoie
    Toute valeur spécifiée par la fonction appelée.
    Description
    Méthode ; spécifie la valeur de this comme devant être utilisée avec toute fonction appelée par
    ActionScript. Cette méthode spécifie également les paramètres à transmettre à toute fonction
    appelée. La méthode apply étant une méthode de l’objet Function, c’est également une méthode
    de chaque objet de fonction dans ActionScript.
    Les paramètres sont spécifiés sous forme d’objet Array. Ceci est souvent utile lorsque le nombre
    de paramètres à transmettre n’est pas connu avant l’exécution du script.
    Exemple
    Les invocations de fonction suivantes sont équivalentes :
    Math.atan2(1, 0)
    Math.atan2.apply(null, [1, 0])
    Vous pourriez construire une animation Flash contenant des champs de saisie de texte qui
    permettent à l’utilisateur d’entrer le nom d’une fonction à invoquer, et zéro ou plusieurs
    paramètres à transmettre à la fonction. Une pression sur un bouton d’appel utiliserait alors la
    méthode apply pour appeler la fonction spécifiant les paramètres.




                                                                                 Dictionnaire ActionScript 253
      Dans cet exemple, l’utilisateur spécifie le nom d’une fonction dans un champ de saisie de texte
      appelé nomDeFonction. Le nombre de paramètres est spécifié dans un champ de saisie de texte
      appelé nombreParamètres. Jusqu’à 10 paramètres sont spécifiés dans des champs de texte appelés
      paramètre1, paramètre2, jusqu’à paramètre10.
      on(release) {
        callTheFunction();
      }
      ...
      function callTheFunction()
      {
          var laFonction = eval(nomDeFonction.text);
          var n = Number(nombreParamètres);
          var paramètres = [];
          for (var i = 0; i < n; i++) {
             paramètres.push(eval("paramètre" + i));
          }
          laFonction.apply(null, paramètres);
      }

Function.call
      Disponibilité
      Flash Player 6.
      Usage
      maFonction.call(cetObjet, paramètre1, ..., paramètreN)

      Paramètres
      cetObjet     Spécifie la valeur de this dans le corps de la fonction.
      paramètre1     Un paramètre à transmettre à maFonction. Vous pouvez spécifier zéro ou
      plusieurs paramètres.
      paramètreN

      Renvoie
      Rien.
      Description
      Méthode ; invoque la fonction représentée par un objet Function. Chaque fonction ActionScript
      est représentée par un objet Function, toutes les fonctions supportant donc la méthode call.
      Dans presque tous les cas, l’opérateur d’appel de fonction (()) peut être utilisé au lieu de la
      méthode call. L’opérateur d’appel de fonction permet de rédiger le code de façon concise et
      lisible. La méthode call est surtout utile lorsque le paramètre this de l’invocation de fonction
      doit être explicitement contrôlé. Normalement, si une fonction est invoquée en tant que méthode
      d’un objet, dans le corps de la fonction, this est défini sur monObjet, comme dans l’exemple
      suivant :
      monObjet.maMéthode(1, 2, 3);
      Dans certaines situations, vous pourrez vouloir que this désigne autre chose ; par exemple, si une
      fonction doit être invoquée en tant que méthode d’un objet, mais n’est pas effectivement stockée
      comme méthode de cet objet.
      monObjet.maMéthode.call(monAutreObjet, 1, 2, 3);




254
   Vous pouvez transmettre la valeur null pour le paramètre cetObjet pour invoquer une fonction
   en tant que fonction ordinaire et pas en tant que méthode d’un objet. Par exemple, les
   invocations de fonction suivantes sont équivalentes :
   Math.sin(Math.PI / 4)
   Math.sin.call(null, Math.PI / 4)
   Exemple
   Cet exemple utilise la méthode call pour imposer à une fonction de se comporter comme une
   méthode d’un autre objet, sans stocker la fonction dans l’objet.
   function MonObjet() {
   }
   function MaMéthode(obj) {
     trace("this == obj? " + (this == obj));
   }
   var obj = new MonObjet();
   MaMéthode.call(obj, obj);
   L’action trace envoie le code suivant à la fenêtre Sortie :
   this == obj? true

Function.prototype
   Disponibilité
   Flash Player 6.
   Usage
   maFonction.prototype

   Description
   Propriété ; dans une fonction constructeur, la propriété prototype fait référence à un objet qui
   est le prototype de la classe construite. Chaque occurrence de la classe qui est créée par la fonction
   constructeur hérite de toutes les propriétés et méthodes de l’objet prototype.

fscommand
   Disponibilité
   Flash Player 3.
   Usage
   fscommand("commande", "paramètres")

   Paramètres
   commande     Une chaîne transmise à l’application hôte pour toute utilisation ou une commande
   transmise à Flash Player.
   paramètres     Une chaîne transmise à l’application hôte pour toute utilisation ou une valeur
   transmise à Flash Player.
   Renvoie
   Rien.




                                                                           Dictionnaire ActionScript 255
      Description
      Action ; permet à l’animation Flash de communiquer avec Flash Player ou avec le programme
      hébergeant Flash Player, tel qu’un navigateur web. Vous pouvez également utiliser l’action
      fscommand pour transmettre des messages à Macromedia Director, ou à Visual Basic, Visual C++
      et tout autre programme capable d’héberger les contrôles ActiveX.
      Usage 1. Pour envoyer un message à Flash Player, vous devez utiliser des commandes et
      paramètres prédéfinis. Le tableau suivant indique les valeurs que vous pouvez spécifier pour les
      paramètres commande et paramètres de l’action fscommand pour contrôler une animation lue
      dans le lecteur Flash autonome (y compris les projections) :

      Commande          Paramètres        Objectif

      quit              Aucun             Ferme la projection.

      fullscreen        true ou false     La spécification de true définit Flash Player en mode plein écran. La
                                          spécification de false renvoie le lecteur en affichage normal du menu.

      allowscale        true ou false     La spécification de false définit le lecteur de sorte qu’il soit toujours
                                          affiché dans sa taille originale et jamais redimensionné. La spécification
                                          de true oblige l’animation à adopter 100 % de l’échelle du lecteur.

      showmenu          true ou false     La spécification de true active le jeu complet des éléments de menu
                                          contextuel. La spécification de false masque tous les éléments de menu
                                          contextuel, à l’exception de A propos de Flash Player.

      exec              chemin vers       Exécute une application depuis la projection.
                        l’application

      trapallkeys       true ou false     La spécification de true envoie tous les éléments de touche, y compris
                                          les raccourcis, au gestionnaire onClipEvent(keyDown/keyUp) de Flash
                                          Player.


      Usage 2. Pour utiliser l’action fscommand pour envoyer un message à un langage de
      programmation tel que JavaScript dans un navigateur web, vous pouvez transmettre deux
      paramètres quelconques dans les paramètres commande et paramètres. Ces paramètres peuvent
      être des chaînes ou des expressions et sont utilisés dans une fonction JavaScript qui traite l’action
      fscommand.

      Dans un navigateur web, l’action fscommand appelle la fonction JavaScript
      moviename_DoFScommand      dans la page HTML contenant l’animation Flash. moviename est le
      nom de Flash Player, tel qu’affecté par l’attribut NAME de la balise EMBED ou la propriété ID de la
      balise OBJECT. Si le nom monAnimation a été affecté à Flash Player, la fonction JavaScript appelée
      est monAnimation_DoFScommand.
      Usage 3. L’action fscommand peut envoyer des messages à Macromedia Director qui sont
      interprétés par Lingo comme des chaînes, des événements ou un code exécutable Lingo. Si le
      message est une chaîne ou un événement, vous devez rédiger le code Lingo pour le recevoir depuis
      l’action fscommand et entraîner une action dans Director.
      Usage 4. En Visual Basic, Visual C++, et dans d’autres programmes pouvant héberger les
      contrôles ActiveX, fscommand envoie un événement VB avec deux chaînes qui peut être traité
      dans l’environnement du langage de programmation. Pour plus d’informations, utilisez les mots-
      clés méthode Flash pour effectuer une recherche sur le centre de support de Flash.




256
   Exemple
   Usage 1. Dans l’exemple suivant, l’action fscommand définit Flash Player pour qu’il affiche
   l’animation en taille plein écran lorsque le bouton est relâché.
   on(release) {
     fscommand("fullscreen", true);
   }
   Usage 2. L’exemple suivant utilise l’action fscommand appliquée à un bouton dans Flash pour
   ouvrir une boîte de message JavaScript dans une page HTML. Le message même est envoyé à
   JavaScript en tant que paramètre de fscommand.
   Vous devez ajouter une fonction à la page HTML contenant l’animation Flash. Cette fonction,
   monAnimation_DoFSCommand, réside dans la page HTML et attend une action fscommand dans
   Flash. Lorsqu’une action fscommand est déclenchée dans Flash (par exemple, lorsqu’un utilisateur
   clique sur le bouton), les chaînes commande et paramètres sont transmises à la fonction
   monAnimation_DoFSCommand. Vous pouvez utiliser les chaînes transmises dans votre code
   JavaScript ou VBScript comme vous l’entendez. Dans cet exemple, la fonction contient une
   instruction conditionnelle if qui vérifie si la chaîne de commande est "boîteDeMessage". Le cas
   échéant, une boîte d’alerte JavaScript s’ouvre et affiche le contenu de la chaîne paramètres.
   function monAnimation_DoFSCommand(commande, paramètres) {
     if (command == "boîteDeMessage") {
        alert(paramètres);
     }
   }
   Dans le document Flash, ajoutez l’action fscommand à un bouton :
   fscommand("boîteDeMessage", "Ceci est une boîte appelée depuis Flash.")
   Vous pouvez également utiliser des expressions pour l’action et les paramètres fscommand, comme
   dans l’exemple suivant :
   fscommand("boîteDeMessage", "Bonjour, " + nom + ", bienvenue sur notre site
     web!")
   Pour tester l’animation, choisissez Fichier > Aperçu avant publication > HTML.
   Remarque Si vous publiez votre animation avec le modèle Flash et FSCommand dans les paramètres de
   publication HTML, la fonction monAnimation_DoFSCommand est insérée automatiquement. Les attributs NAME et
   ID de l’animation seront le nom du fichier. Par exemple, pour le fichier monAnimation.fla, les attributs seraient
   définis avec monAnimation.


function
   Disponibilité
   Flash Player 5.
   Usage
   function nomDeFonction ([paramètre0, paramètre1,...paramètreN]){
     instruction(s)
   }
   function ([paramètre0, paramètre1,...paramètreN]){
     instruction(s)
   }

   Paramètres
   nomDeFonction          Le nom de la nouvelle fonction.



                                                                                    Dictionnaire ActionScript 257
      paramètre Un identifiant représentant un paramètre à transmettre à la fonction. Ces
      paramètres sont facultatifs.
      instruction(s)      Toute instruction ActionScript que vous avez définie pour le corps de la
      function.

      Renvoie
      Rien.
      Description
      Action ; un jeu d’instructions que vous définissez pour effectuer une certaine tâche. Vous pouvez
      déclarer, ou définir, une fonction à un emplacement et l’appeler, ou l’invoquer, depuis différents
      scripts dans une animation. Lorsque vous définissez une fonction, vous pouvez également
      spécifier ses paramètres. Les paramètres sont des supports pour les valeurs sur lesquelles la
      fonction opère. Vous pouvez transmettre différents paramètres à une fonction à chaque fois que
      vous l’appelez. Ceci vous permet de réutiliser une fonction dans de nombreuses situations
      différentes.
      Utilisez l’action return dans les instruction(s) d’une fonction pour obliger une fonction à
      renvoyer, ou générer, une valeur.
      Usage 1. Déclare une function avec les nomDeFonction, paramètres et instruction(s)
      spécifiés. Lorsqu’une fonction est appelée, la déclaration de la fonction est invoquée. La référence
      en aval est autorisée ; au sein d’une même liste d’actions, une fonction peut être déclarée après
      avoir été appelée. Une déclaration de fonction remplace toute déclaration précédente de cette
      même fonction. Vous pouvez utiliser cette syntaxe partout où une instruction est autorisée.
      Usage 2. Crée une fonction anonyme et la renvoie. Cette syntaxe est utilisée dans les expressions
      et est particulièrement utile pour installer des méthodes dans des objets.
      Exemple
      Usage 1. L’exemple suivant définit la fonction sqr, qui accepte un argument et renvoie la valeur
      square(x*x) du paramètre. Notez que si la fonction est déclarée et utilisée dans le même script,
      la déclaration de la fonction doit apparaître après l’utilisation de la fonction.
      y=sqr(3);

      function sqr(x) {
        return x*x;
      }
      Usage 2. La fonction suivante définit un objet Cercle :
      function Cercle(radius) {
        this.radius = radius;
      }
      L’instruction suivante définit une fonction anonyme qui calcule l’aire d’un cercle et l’associe à
      l’objet Cercle comme méthode :
      Cercle.prototype.area = function () {return Math.PI * this.radius *
        this.radius}




258
ge (supérieur ou égal à – spécifique aux chaînes)
   Disponibilité
   Flash Player 4. Cet opérateur est déconseillé dans Flash 5 et remplacé par l’opérateur >=
   (supérieur ou égal à).
   Usage
   expression1 ge expression2

   Paramètres
   expression1, expression2         Nombres, chaînes ou variables.
   Renvoie
   Rien.
   Description
   Opérateur (comparaison) ; compare la représentation chaîne de expression1 avec la
   représentation chaîne de expression2 et renvoie true si expression1 est supérieure ou égale à
   expression2 ; sinon, renvoie false.

   Voir aussi
   >= (supérieur ou égal à)

getProperty
   Disponibilité
   Flash Player 4.
   Usage
   getProperty(nomDoccurrence , propriété)

   Paramètres
   nomDoccurrence         Le nom d’occurrence d’un clip dont la propriété est récupérée.
   propriété       Une propriété d’un clip.
   Renvoie
   Rien.
   Description
   Fonction ; renvoie la valeur de la propriété spécifiée pour l’occurrence nomDoccurrence de
   clip.
   Exemple
   L’exemple suivant récupère la coordonnée de l’axe horizontal (_x) pour le clip monAnimation et
   l’affecte à la variable monAnimationX :
   monAnimationX = getProperty(_root.monAnimation, _x);




                                                                         Dictionnaire ActionScript 259
getTimer
      Disponibilité
      Flash Player 4.
      Usage
      getTimer()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Fonction ; renvoie le nombre de millisecondes écoulées depuis le démarrage de la lecture de
      l’animation.

getURL
      Disponibilité
      Flash 2. Les options GET et POST ne sont disponibles que dans Flash Player 4 et les versions
      suivantes du Player.
      Usage
      getURL(url [, fenêtre [, "variables"]])

      Paramètres
      url     L’URL où se trouve le document à obtenir.
      fenêtre    Un paramètre facultatif spécifiant la fenêtre ou le cadre HTML dans lequel le
      document doit être chargé. Vous pouvez entrer le nom d’une fenêtre spécifique ou choisir parmi
      les noms cibles réservés suivants :
      •   _self   spécifie l’image courante dans la fenêtre courante.
      •   _blank   spécifie une nouvelle fenêtre.
      •   _parent   spécifie le parent de l’image courante.
      •   _top   spécifie l’image de premier niveau dans la fenêtre courante.
      variables Une méthode GET ou POST pour envoyer des variables. Omettez ce paramètre s’il
      n’y a aucune variable. La méthode GET ajoute les variables à la fin de l’URL et est utilisée pour des
      petits nombres de variables. La méthode POST envoie les variables dans un en-tête HTTP distinct
      et est utilisée pour les longues chaînes de variables.
      Renvoie
      Rien.
      Description
      Action ; charge un document depuis une URL spécifique dans une fenêtre ou transmet les
      variables à une autre application à une URL définie. Pour tester cette action, assurez-vous que le
      fichier à charger se trouve à l’emplacement spécifié. Pour utiliser une URL absolue (par exemple,
      http://www.monServeur.fr), il vous faut une connexion de réseau.




260
   Exemple
   Cet exemple charge une nouvelle URL dans une fenêtre de navigateur vide. L’action getURL cible
   la variable publicité comme paramètre url de sorte que vous pouvez changer l’URL chargée
   sans avoir à modifier l’animation Flash. La valeur de la variable publicité est transmise à Flash
   plus tôt dans l’animation avec une action loadVariables.
   on(release) {
     getURL(publicité, "_blank");
   }

   Voir aussi
   loadVariables, XML.send, XML.sendAndLoad, XMLSocket.send


getVersion
   Disponibilité
   Flash Player 5.
   Usage
   getVersion()

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Fonction ; renvoie une chaîne contenant la version de Flash Player et les informations de plate-
   forme.
   La fonction getVersion renvoie uniquement les informations pour Flash Player 5 ou les versions
   ultérieures.
   Exemple
   L’exemple suivant illustre une chaîne renvoyée par la fonction getVersion.
   WIN 5,0,17,0
   Ceci indique que la plate-forme est Windows et que le numéro de version de Flash Player est 5,
   avec un sous-numéro de 17(5.0r17).

_global
   Disponibilité
   Flash Player 6.
   Usage
   _global.identifiant
   Paramètres
   Aucun.




                                                                        Dictionnaire ActionScript 261
      Renvoie
      Une référence à l’objet global contenant les classes ActionScript principales, telles que String,
      Object, Math et Array.
      Description
      Identifiant ; crée des variables, des objets ou des classes globaux. Par exemple, vous pourriez créer
      une bibliothèque exposée comme objet ActionScript global, comme l’objet Math ou Date. A
      l’inverse des variables et fonctions déclarées dans un scénario ou déclarées localement, les variables
      et fonctions globales sont visibles dans chaque scénario et plage de l’animation Flash, à condition
      qu’elles ne soient pas masquées par des identifiants portant le même nom dans des plages internes.
      Exemple
      L’exemple suivant crée une fonction de haut niveau, factorial, qui est disponible à chaque
      scénario et plage d’une animation Flash :
      _global.factorial = function (n) {
        if (n <= 1) {
          return 1;
        } else {
          return n * factorial(n-1);
        }
      }

      Voir aussi
      var, set variable

globalStyleFormat
      Disponibilité
      Flash Player 6.
      Usage
      globalStyleFormat.propriétéDeStyle

      Paramètres
      propriétéDeStyle       Une propriété de l’objet FStyleFormat.
      Renvoie
      Rien.
      Description
      Occurrence d’objet ; une occurrence de l’objet FStyleFormat qui définit les propriétés des formats
      de styles pour les composants d’interface Flash. L’occurrence globalStyleFormat est disponible
      une fois que le composant d’interface Flash est placé sur la scène. Vous définissez ou changez les
      propriétés des formats de styles pour les composants d’interface Flash en modifiant les propriétés
      de l’occurrence d’objet globalStyleFormat. Pour plus d’informations, consultez la section
      Personnalisation de la couleur et du texte des composants du chapitre Utilisation des composants
      de Utilisation de Flash.




262
  Exemple
  Le code suivant définit la propriété arrow de la propriété FStyleFormat pour l’occurrence
  globalStyleFormat.
  globalStyleFormat.arrow = 0x800080;

  Voir aussi
  FStyleFormat (objet)

gotoAndPlay
  Disponibilité
  Flash 2.
  Usage
  gotoAndPlay(séquence, image)

  Paramètres
  séquence      Le nom de la séquence à laquelle la tête de lecture est envoyée.
  image      Le numéro ou l’étiquette de l’image à laquelle la tête de lecture est envoyée.
  Renvoie
  Rien.
  Description
  Action ; envoie la tête de lecture à l’image spécifiée d’une séquence et lit à 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 courante.
  Exemple
  Lorsque l’utilisateur clique sur un bouton auquel l’action gotoAndPlay est affectée, la tête de
  lecture est envoyée à l’image 16 et commence à lire.
  on(release) {
    gotoAndPlay(16);
  }

gotoAndStop
  Disponibilité
  Flash 2.
  Usage
  gotoAndStop(séquence, image)

  Paramètres
  séquence      Le nom de la séquence à laquelle la tête de lecture est envoyée.
  image      Le numéro ou l’étiquette de l’image à laquelle la tête de lecture est envoyée.
  Renvoie
  Rien.
  Description
  Action ; envoie la tête de lecture à 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 spécifiée de la séquence courante.


                                                                           Dictionnaire ActionScript 263
      Exemple
      Lorsque l’utilisateur clique sur un bouton auquel l’action gotoAndStop est affectée, la tête de
      lecture est envoyée à l’image 5 et la lecture de l’animation cesse.
      on(release) {
        gotoAndStop(5);
      }

gt (supérieur à — spécifique aux chaînes)
      Disponibilité
      Flash Player 4. Cet opérateur est déconseillé dans Flash 5 et remplacé par le nouvel opérateur >
      (supérieur à).
      Usage
      expression1 gt expression2

      Paramètres
      expression1, expression2           Nombres, chaînes ou variables.
      Description
      Opérateur (comparaison) ; compare la représentation chaîne de expression1 avec la
      représentation chaîne de expression2 et renvoie true si expression1 est supérieure à
      expression2 ; sinon, renvoie false.

      Voir aussi
      > (supérieur à)

_highquality
      Disponibilité
      Flash Player 4.
      Usage
      _highquality

      Description
      Propriété (globale) ; spécifie le niveau d’anti-alias appliqué à l’animation en cours. Spécifiez 2
      (qualité maximum) pour appliquer une qualité élevée avec le lissage bitmap toujours actif.
      Spécifiez 1 (qualité élevée) pour appliquer l’anti-alias ; cela lissera les bitmaps si le clip ne contient
      pas d’animation. Spécifiez 0 (faible qualité) pour empêcher l’anti-alias.
      Exemple
      _highquality = 1;

      Voir aussi
      _quality, toggleHighQuality




264
if
     Disponibilité
     Flash Player 4.
     Usage
     if(condition) {
       instruction(s);
     }

     Paramètres
     condition       Une expression évaluée comme true ou false.
     instruction(s)       Les instructions à exécuter si, ou quand, la condition est évaluée comme
     true.

     Renvoie
     Rien.
     Description
     Action ; évalue une condition pour déterminer la prochaine action dans une animation. Si la
     condition est true, Flash exécute les instructions suivant la condition entre accolades ({}). Si la
     condition est false, Flash ignore les instructions entre accolades et exécute les instructions
     suivant les accolades. Utilisez l’action if pour créer une logique de branchement dans vos scripts.
     Exemple
     Dans l’exemple suivant, la condition entre parenthèses évalue la variable nom pour déterminer si
     elle a la valeur littérale "Erica". Le cas échéant, l’action play entre accolades est exécutée.
     if(nom == "Erica"){
       play();
     }




                                                                           Dictionnaire ActionScript 265
      Exemple
      L’exemple suivant utilise une action if pour évaluer le moment auquel un objet déplaçable de
      l’animation est relâché par l’utilisateur. Si l’objet est relâché moins de 300 millisecondes après
      avoir été déplacé, la condition est évaluée comme true et les instructions entre accolades sont
      exécutées. Ces instructions définissent des variables pour stocker le nouvel emplacement de
      l’objet, la force avec laquelle il a été lancé et la vitesse à laquelle il a été lancé. La variable
      tempsEnfoncé est également réinitialisée. Si l’objet est relâché plus de 300 millisecondes après
      avoir été déplacé, la condition est évaluée comme false et aucune des instructions n’est exécutée.
      if (getTimer()<tempsEnfoncé+300) {
           // si la condition est true,
           // l’objet a été relâché.
           // quelle est la nouvelle position de l’objet ?
           xNouvEmpl = this._x;
           yNouvEmpl = this._y;
           // avec quelle force a-t-il été relâché ?
           xDéplac = xNouvEmpl-xEmpl;
           yDéplac = yNouvEmpl-yEmpl;
           // la définition de la vitesse de l’objet dépend de
           // la distance de son déplacement
           xInc = xDéplac/2;
           yInc = yDéplac/2;
           tempsEnfoncé = 0;
        }

      Voir aussi
      else

ifFrameLoaded
      Disponibilité
      Flash Player 3. L’action ifFrameLoaded est déconseillée dans Flash 5 ; l’utilisation de l’action
      MovieClip._framesloaded est recommandée.

      Usage
      ifFrameLoaded(séquence, image) {
        instruction;
      }
      ifFrameLoaded(image) {
        instruction;
      }

      Paramètres
      séquence     La séquence devant être chargée.
      image    Le numéro ou l’étiquette de l’image à charger avant l’exécution de la prochaine
      instruction.
      instruction(s) Les instructions à exécuter si la séquence, ou la séquence et l’image,
      spécifiée(s) sont chargées.
      Renvoie
      Rien.




266
    Description
    Action ; vérifie si le contenu d’une image est disponible localement. Utilisez ifFrameLoaded
    pour commencer la lecture d’une animation simple pendant que le reste de l’animation est
    téléchargé sur l’ordinateur local. La différence entre l’utilisation de _framesloaded et de
    ifFrameLoaded est que _framesloaded vous permet d’ajouter vos propres instructions if ou
    else.

    Voir aussi
    MovieClip._framesloaded

#include
    Disponibilité
    Sans objet
    Usage
    #include "nomDeFichier.as"

    Paramètres
    nomDeFichier.as    Le nom de fichier pour le script à ajouter au panneau Actions, .as étant
    l’extension recommandée.
    Renvoie
    Rien.
    Description
    Action ; inclut le contenu du fichier spécifié dans le paramètre lorsque l’animation est testée,
    publiée ou exportée. L’action #include est invoquée lorsque vous testez, publiez ou exportez.
    L’action #include est vérifiée lorsqu’un contrôle de syntaxe a lieu.

#initclip
    Disponibilité
    Flash Player 6.
    Usage
    #initclip ordre

    Paramètres
    ordre Un entier qui spécifie l’ordre d’exécution de blocs de code #initclip. Ce paramètre est
    facultatif.
    Description
    Action ; indique le début d’un bloc d’actions d’initialisation de composant. Lorsque plusieurs
    clips sont initialisés en même temps, vous pouvez utiliser le paramètre ordre pour spécifier
    l’initialisation ayant lieu en premier. Les actions d’initialisation de composant sont exécutées
    lorsque qu’un symbole de clip est défini. Si le clip est un symbole exporté, les actions
    d’initialisation de composant sont exécutées avant les actions de l’image 1 du fichier SWF. Sinon,
    elles sont exécutées immédiatement avant les actions s’appliquant à l’image qui contient la
    première occurrence du symbole de clip associé.




                                                                          Dictionnaire ActionScript 267
      Les actions d’initialisation de composant sont exécutées une fois seulement lors de la lecture d’une
      animation, et vous devriez les utiliser en tant qu’initialisations ponctuelles, par exemple pour la
      définition et l’enregistrement de classe.
      Exemple
      L’exemple de code suivant est affecté à la première image d’une animation, qui est un composant
      de case à cocher. Les actions #initclip et #endinitclip désignent le bloc d’instructions qu’elles
      contiennent comme actions d’initialisation de composant. Les instructions contenues enregistrent
      la classe et stockent des méthodes dans un objet prototype.
      #initclip
      if (typeof(CheckBox) == "undefined") {
        // définir un constructeur pour (et donc définir) la classe CheckBox
        function CheckBox() {
           // définir les liaisons de données
           this.watch ('value', function (id, ancienneVal, nouvelleVal) { ... };
           this.watch ('label', function (id, ancienneVal, nouvelleVal) { ... };
        }
        // définir la chaîne de prototype CheckBox héritant de MovieClip
        CheckBox.prototype = new MovieClip();
        // enregistrer CheckBox comme classe pour le symbole "Check Box"
        Object.registerClass("Check Box", CheckBox);
        // définir certaines méthodes
        CheckBox.prototype.enable = function () { ... };
        CheckBox.prototype.show = function () { ... };
        CheckBox.prototype.hide = function () { ... };
        // définir une fonction pour
        // instancier les cases à cocher
        CheckBox.create = function (ClipParent, nomDoccurrence, profondeur) {
           ClipParent.attachMovie("CheckBox", nomDoccurrence, profondeur);
        };
      }
      #endinitclip
      Remarque Si vous copiez et collez ce code dans le panneau Actions, il générera une erreur au moment de la
      compilation du script, ceci à cause des fonctions indéfinies ({...}).

      Voir aussi
      #endinitclip

instanceof
      Disponibilité
      Flash Player 6.
      Usage
      objet instanceof classe

      Paramètres
      objet     Un objet ActionScript.
      classe     Une référence à une fonction constructeur ActionScript, telle que String ou Date.
      Renvoie
      Si objet est une occurrence de classe, instanceof renvoie true ; sinon, instanceof renvoie
      false.




268
      Description
      Opérateur ; détermine si un objet appartient à une classe spécifiée. Teste si objet est une
      occurrence de classe.
      Un objet ActionScript est considéré comme une occurrence d’une classe si l’objet prototype de la
      fonction constructeur se trouve dans la chaîne prototype de l’objet ActionScript.
      L’opérateur instanceof ne convertit pas les types primitifs en objets enveloppes. Par exemple, le
      code suivant renvoie true :
      new String("Bonjour") instanceof String
      Le code suivant renvoie false :
      "Bonjour" instanceof String

      Exemple
      Pour illustrer l’algorithme de l’opérateur instanceof, l’exemple suivant montre à quoi pourrait
      ressembler l’opérateur instanceof s’il était codé en tant que fonction ActionScript.
      function instanceof (Lobjet, laClasse){
        while ((Lobjet = Lobjet.__proto__) != null) {
                 if (Lobjet == laClasse.prototype) {
                        return true;
                 }
        }
        return false;
      }

      Voir aussi
      typeof

int
      Disponibilité
      Flash Player 4. Cette fonction est déconseillée dans Flash 5 et remplacée par la méthode
      Math.round.

      Usage
      int(valeur)

      Paramètres
      valeur    Un nombre devant être arrondi à un entier.
      Renvoie
      Rien.
      Description
      Fonction ; convertit un nombre décimal à la valeur de l’entier le plus proche.
      Voir aussi
      Math.floor




                                                                            Dictionnaire ActionScript 269
isFinite
      Disponibilité
      Flash Player 5.
      Usage
      isFinite(expression)

      Paramètres
      expression        Une valeur booléenne, une variable ou une autre expression à évaluer.
      Renvoie
      Rien.
      Description
      Fonction de haut niveau ; évalue expression et renvoie true s’il s’agit d’un nombre fini et
      false s’il s’agit d’infini ou d’infini négatif. La présence d’infini, ou d’infini négatif, indique une
      condition d’erreur mathématique (une division par 0, par exemple).
      Exemple
      Les exemples suivants sont des exemples de valeurs renvoyées pour isFinite :
      isFinite(56)
      // renvoie true

      isFinite(Number.POSITIVE_INFINITY)
      // renvoie false

isNaN
      Disponibilité
      Flash Player 5.
      Usage
      isNaN(expression)

      Paramètres
      expression        Une valeur booléenne, une variable ou une autre expression à évaluer.
      Renvoie
      Rien.
      Description
      Fonction de haut niveau ; évalue le paramètre et renvoie true si la valeur n’est pas un nombre
      (NaN), indiquant la présence d’erreurs mathématiques.




270
    Exemple
    Le code suivant illustre les valeurs renvoyées pour la fonction isNan :
    isNan("Tree")
    // renvoie true

    isNan(56)
    // renvoie false

    isNaN(Number.POSITIVE_INFINITY)
    // renvoie false

Key (objet)
    L’objet Key est un objet de haut niveau auquel vous pouvez accéder sans utiliser de constructeur.
    Utilisez les méthodes de l’objet Key pour construire une interface qui pourra être contrôlée par un
    utilisateur possédant un clavier standard. Les propriétés de l’objet Key sont des constantes
    représentant les touches les plus souvent utilisées pour contrôler les jeux. Une liste complète des
    valeurs de codes de touches est publiée dans l’annexe C, Touches du clavier et valeurs de code
    correspondantes, de Utilisation de Flash.
    Exemple
    Le script suivant utilise l’objet Key pour identifier des touches sur n’importe quel clavier afin de
    permettre à l’utilisateur de contrôler un clip.
    onClipEvent (enterFrame) {
      if(Key.isDown(Key.RIGHT)) {
         this._x=_x+10;
      } else if (Key.isDown(Key.DOWN)) {
         this._y=_y+10;
      }
    }

Méthodes de l’objet Key

    Méthode                 Description

    Key.addListener         Enregistre un objet pour la réception de notification lorsque les méthodes onKeyDown et
                            onKeyUp sont invoquées.

    Key.getAscii            Renvoie la valeur ASCII de la dernière touche enfoncée.

    Key.getCode             Renvoie le code virtuel de la dernière touche enfoncée.

    Key.isDown              Renvoie true si la touche spécifiée dans le paramètre est enfoncée.

    Key.isToggled           Renvoie true si les touches Verr Num ou Verr Maj sont activées.

    Key.removeListener      Supprime un objet enregistré avec addListener.




                                                                                  Dictionnaire ActionScript 271
Propriétés de l’objet Key
      Toutes les propriétés de l’objet Key sont des constantes.

      Propriété            Description

      Key.BACKSPACE        Constante associée à la valeur de code de touche pour la touche Rappel arrière (8).

      Key.CAPSLOCK         Constante associée à la valeur de code de touche pour la touche Verrouillage des
                           majuscules (20).

      Key.CONTROL          Constante associée à la valeur de code de touche pour la touche Ctrl (17).

      Key.DELETEKEY        Constante associée à la valeur de code de touche pour la touche Suppression (46).

      Key.DOWN             Constante associée à la valeur de code de touche pour la touche Flèche vers le bas (40).

      Key.END              Constante associée à la valeur de code de touche pour la touche Fin (35).

      Key.ENTER            Constante associée à la valeur de code de touche pour la touche Entrée (13).

      Key.ESCAPE           Constante associée à la valeur de code de touche pour la touche Echappement (27).

      Key.HOME             Constante associée à la valeur de code de touche pour la touche Origine (36).

      Key.INSERT           Constante associée à la valeur de code de touche pour la touche Insertion (45).

      Key.LEFT             Constante associée à la valeur de code de touche pour la touche Flèche vers la gauche
                           (37).

      Key.PGDN             Constante associée à la valeur de code de touche pour la touche Page suivante (34).

      Key.PGUP             Constante associée à la valeur de code de touche pour la touche Page précédente (33).

      Key.RIGHT            Constante associée à la valeur de code de touche pour la touche Flèche la droite (39).

      Key.SHIFT            Constante associée à la valeur de code de touche pour la touche Maj (16).

      Key.SPACE            Constante associée à la valeur de code de touche pour la touche Barre d’espacement
                           (32).

      Key.TAB              Constante associée à la valeur de code de touche pour la touche Tab (9).

      Key.UP               Constante associée à la valeur de code de touche pour la touche Flèche vers le haut (38).


Ecouteurs de l’objet Key

      Méthode                Description

      Key.onKeyDown          Notifié lorsqu’une touche est enfoncée.

      Key.onKeyUp            Notifié lorsqu’une touche est relâchée.


Key.addListener
      Disponibilité
      Flash Player 6.
      Usage
      Key.addListener (nouvelEcouteur)
      Paramètres
      nouvelEcouteur      Un objet avec les méthodes onKeyDown et onKeyUp.




272
  Renvoie
  Rien.
  Description
  Méthode ; enregistre un objet pour la réception de notifications onKeyDown et onKeyUp.
  Lorsqu’une touche est enfoncée ou relâchée, quel que soit le focus de saisie, la méthode
  onKeyDown ou onKeyUp de tous les objets écouteurs enregistrés avec addListener est invoquée.
  Plusieurs objets peuvent attendre des notifications de clavier. Si l’écouteur nouvelEcouteur est
  déjà enregistré, aucun changement n’a lieu.
  Exemple
  Cet exemple crée un objet d’écoute et définit une fonction pour onKeyDown et onKeyUp. La
  dernière ligne utilise la méthode addListener pour enregistrer l’écouteur avec l’objet Key, afin
  qu’il puisse recevoir une notification des événements de touche enfoncée et de touche relâchée.
  monEcouteur = new Object();
  monEcouteur.onKeyDown = function () {
    trace ("Vous avez appuyé sur une touche.");
  }
  monEcouteur.onKeyUp = function () {
    trace ("Vous avez relâché une touche.");
  }
  Key.addListener(monEcouteur);

Key.BACKSPACE
  Disponibilité
  Flash Player 5.
  Usage
  Key.BACKSPACE
  Description
  Propriété ; associée à la valeur de code de touche pour la touche Retour arrière (8).

Key.CAPSLOCK
  Disponibilité
  Flash Player 5.
  Usage
  Key.CAPSLOCK
  Description
  Propriété ; associée à la valeur de code de touche pour la touche Verr Maj (20).




                                                                        Dictionnaire ActionScript 273
Key.CONTROL
      Disponibilité
      Flash Player 5.
      Usage
      Key.CONTROL

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Ctrl (17).

Key.DELETEKEY
      Disponibilité
      Flash Player 5.
      Usage
      Key.DELETEKEY

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Suppr (46).

Key.DOWN
      Disponibilité
      Flash Player 5.
      Usage
      Key.DOWN

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Flèche vers le bas (40).

Key.END
      Disponibilité
      Flash Player 5.
      Usage
      Key.END

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Fin (35).




274
Key.ENTER
   Disponibilité
   Flash Player 5.
   Usage
   Key.ENTER

   Description
   Propriété ; associée à la valeur de code de touche pour la touche Entrée (13).

Key.ESCAPE
   Disponibilité
   Flash Player 5.
   Usage
   Key.ESCAPE

   Description
   Propriété ; associée à la valeur de code de touche pour la touche Echap (27).

Key.getAscii
   Disponibilité
   Flash Player 5.
   Usage
   Key.getAscii();

   Paramètres
   Aucun.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; renvoie le code ASCII de la dernière touche enfoncée ou relâchée. Les valeurs ASCII
   renvoyées sont les valeurs du clavier anglais. Par exemple, si vous appuyez sur Maj+2,
   Key.getAscii renvoie @ sur un clavier japonais, de la même façon que sur un clavier anglais.


Key.getCode
   Disponibilité
   Flash Player 5.
   Usage
   Key.getCode();

   Paramètres
   Aucun.




                                                                         Dictionnaire ActionScript 275
      Renvoie
      Voir ci-dessous.
      Description
      Méthode ; renvoie la valeur de code de la dernière touche enfoncée. Pour établir une
      correspondance entre la valeur de code de touche renvoyée et le code virtuel sur un clavier
      standard, utilisez les informations qui figurent dans l’annexe C, Touches du clavier et valeurs de
      code correspondantes, de Utilisation de Flash.

Key.HOME
      Disponibilité
      Flash Player 5.
      Usage
      Key.HOME

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Origine (36).

Key.INSERT
      Disponibilité
      Flash Player 5.
      Usage
      Key.INSERT

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Insertion (45).

Key.isDown
      Disponibilité
      Flash Player 5.
      Usage
      Key.isDown(codeDeTouche);

      Paramètres
      codeDeTouche       La valeur de code affectée à une touche spécifique ou une propriété d’objet Key
      associée à une touche spécifique. Une liste de tous les codes associés aux touches d’un clavier
      standard est publiée dans l’annexe C, Touches du clavier et valeurs de code correspondantes, de
      Utilisation de Flash.
      Renvoie
      Voir ci-dessous.
      Description
      Méthode ; renvoie true si la touche spécifiée dans codeDeTouche est enfoncée. Sur Macintosh,
      les valeurs de codes des touches Verr Maj et Verr Num sont identiques.




276
Key.isToggled
   Disponibilité
   Flash Player 5.
   Usage
   Key.isToggled(codeDeTouche)

   Paramètres
   codeDeTouche       Le code de touche Verr Maj (20) ou Verr Num (144).
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; renvoie true si la touche Verr Maj ou Verr Num est activée (basculée). Sur
   Macintosh, les valeurs de codes de ces touches sont identiques.

Key.LEFT
   Disponibilité
   Flash Player 5.
   Usage
   Key.LEFT

   Description
   Propriété ; associée à la valeur de code de touche pour la touche Flèche vers la gauche (37).

Key.onKeyDown
   Disponibilité
   Flash Player 6.
   Usage
   unEcouteur.onKeyDown

   Description
   Ecouteur ; notifié lorsqu’une touche est enfoncée. Pour utiliser onKeyDown, vous devez créer un
   objet d’écoute. Vous pouvez alors définir une fonction pour onKeyDown et utiliser la méthode
   addListener pour enregistrer l’écouteur avec l’objet Key, comme dans l’exemple suivant :
   unEcouteur = new Object();
   unEcouteur.onKeyDown = function () { ... };
   Key.addListener(unEcouteur);
   Les écouteurs permettent à différents morceaux de code de coopérer étant donné que plusieurs
   écouteurs peuvent recevoir une notification concernant un seul événement.
   Voir aussi
   Key.addListener




                                                                         Dictionnaire ActionScript 277
Key.onKeyUp
      Disponibilité
      Flash Player 6.
      Usage
      unEcouteur.onKeyUp

      Description
      Ecouteur ; notifié lorsqu’une touche est relâchée. Pour utiliser onKeyUp, vous devez créer un objet
      d’écoute. Vous pouvez alors définir une fonction pour onKeyUp et utiliser la méthode
      addListener pour enregistrer l’écouteur avec l’objet Key, comme dans l’exemple suivant :
      unEcouteur = new Object();
      unEcouteur.onKeyUp = function () { ... };
      Key.addListener(unEcouteur);
      Les écouteurs permettent à différents morceaux de code de coopérer étant donné que plusieurs
      écouteurs peuvent recevoir une notification concernant un seul événement.
      Voir aussi
      Key.addListener

Key.PGDN
      Disponibilité
      Flash Player 5.
      Usage
      Key.PGDN

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Page suivante (34).

Key.PGUP
      Disponibilité
      Flash Player 5.
      Usage
      Key.PGUP

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Page vers le haut (33).

Key.removeListener
      Disponibilité
      Flash Player 6.
      Usage
      Key.removeListener (écouteur)
      Paramètres
      écouteur     Un objet.


278
  Renvoie
  Si l’écouteur a été correctement retiré de la méthode renvoie true. Si l’écouteur n’a pas été
  correctement retiré, par exemple si l’écouteur n’apparaissait pas dans la liste des écouteurs de
  l’objet Key, la méthode renvoie false.
  Description
  Méthode ; retire un objet précédemment enregistré avec la méthode addListener.

Key.RIGHT
  Disponibilité
  Flash Player 5.
  Usage
  Key.RIGHT

  Description
  Propriété ; associée à la valeur de code de touche pour la touche Flèche vers la droite (39).

Key.SHIFT
  Disponibilité
  Flash Player 5.
  Usage
  Key.SHIFT

  Description
  Propriété ; associée à la valeur de code de touche pour la touche Maj (16).

Key.SPACE
  Disponibilité
  Flash Player 5.
  Usage
  Key.SPACE

  Description
  Propriété ; associée à la valeur de code de touche pour la touche Barre d’espacement (32).

Key.TAB
  Disponibilité
  Flash Player 5.
  Usage
  Key.TAB

  Description
  Propriété ; associée à la valeur de code de touche pour la touche Tab (9).




                                                                         Dictionnaire ActionScript 279
Key.UP
      Disponibilité
      Flash Player 5.
      Usage
      Key.UP

      Description
      Propriété ; associée à la valeur de code de touche pour la touche Flèche vers le haut (38).

le (inférieur ou égal à — spécifique aux chaînes)
      Disponibilité
      Flash Player 4. Cet opérateur est déconseillé dans Flash 5 et remplacé par l’opérateur <=
      (inférieur ou égal à).

      Usage
      expression1 le expression2

      Paramètres
      expression1,expression2         Nombres, chaînes ou variables.
      Renvoie
      Voir ci-dessous.
      Description
      Opérateur (comparaison) ; compare expression1 avec expression2 et renvoie true si
      expression1 est inférieure ou égale à expression2 ; sinon, renvoie false.

      Voir aussi
      <= (inférieur ou égal à)

length
      Disponibilité
      Flash Player 4. Cette fonction, ainsi que toutes les fonctions de chaîne, est déconseillée dans
      Flash 5. Il est recommandé d’utiliser les méthodes et la propriété length de l’objet String pour
      effectuer les mêmes opérations.
      Usage
      length(expression)
      length(variable)

      Paramètres
      expression        Une chaîne.
      variable     Le nom d’une variable.
      Renvoie
      Voir ci-dessous.
      Description
      Fonction de chaîne ; renvoie la longueur de la chaîne ou variable spécifiée.


280
   Exemple
   L’exemple suivant renvoie la valeur de la chaîne "Bonjour".
   length("Bonjour");
   Le résultat est 5.
   Voir aussi
   " " (délimiteur de chaîne), String.length


_level
   Disponibilité
   Flash Player 4.
   Usage
   _levelN

   Description
   Propriété ; une référence au scénario de l’animation principale de _levelN. Vous devez utiliser
   l’action loadMovieNum pour charger les animations dans Flash Player avant d’utiliser la propriété
   _level pour les cibler. Vous pouvez également utiliser _levelN pour cibler une animation
   chargée au niveau affecté par N.
   L’animation initiale qui est chargée dans une occurrence de Flash Player est automatiquement
   chargée dans _level0. L’animation du _level0 définit la cadence, la couleur d’arrière-plan et la
   taille des images pour toutes les autres animations chargées. Les animations sont ensuite empilées
   dans des niveaux situés au-dessus de l’animation de _level0.
   Vous devez affecter un niveau à chaque animation que vous chargez dans Flash Player à l’aide de
   l’action loadMovieNum. Vous pouvez affecter des niveaux dans n’importe quel ordre. Si vous
   affectez un niveau qui contient déjà un fichier SWF (y compris _level0), l’animation qui se
   trouve à ce niveau est purgée et remplacée par la nouvelle animation.
   Exemple
   L’exemple suivant arrête la tête de lecture du scénario principal de l’animation du _level9.
   _level9.stop();
   L’exemple suivant envoie la tête de lecture du scénario principal de l’animation du _level4 à
   l’image 5. L’animation du _level4 doit avoir été chargée avec une action loadMovieNum.
   _level4.gotoAndStop(5);

   Voir aussi
   loadMovie, MovieClip.swapDepths




                                                                        Dictionnaire ActionScript 281
loadMovie
      Disponibilité
      Flash Player 3.
      Usage
      loadMovie("url",niveau/cible[, variables])

      Paramètres
      url     L’URL absolue ou relative du fichier SWF ou JPEG à charger. Un chemin relatif doit être
      relatif au fichier SWF au niveau 0. L’URL doit se trouver dans le même sous-domaine que l’URL
      à laquelle l’animation réside actuellement. Pour une utilisation dans Flash Player ou pour un test
      en mode test d’animation dans l’application de programmation de 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 ni de disque.
      cible Un chemin pointant vers un clip cible. Le clip cible sera remplacé par l’animation ou
      l’image chargée. Vous devez spécifier un clip cible ou un niveau d’une animation cible (vous ne
      pouvez pas spécifier les deux).
      niveau Un entier spécifiant le niveau Flash Player auquel l’animation sera chargée. Lorsque
      vous chargez une animation ou image dans un niveau au lieu d’une cible, l’action loadMovie du
      panneau Actions en mode Normal devient loadMovieNum. En mode Expert, vous devez spécifier
      loadMovieNum ou la choisir dans la boîte à outils Actions.

      variables Un paramètre facultatif spécifiant une méthode HTTP d’envoi des variables. Le
      paramètre doit être la chaîne GET ou POST. Omettez ce paramètre si aucune variable ne doit être
      envoyée. La méthode GET ajoute les variables à la fin de l’URL et est utilisée pour des petits
      nombres de variables. La méthode POST envoie les variables dans un en-tête HTTP distinct et est
      utilisée pour les longues chaînes de variables.
      Renvoie
      Rien.
      Description
      Action ; charge un fichier SWF ou JPEG dans Flash Player en cours de lecture de l’animation
      d’origine. L’action loadMovie vous permet d’afficher plusieurs animations en une fois et de
      basculer entre des animations sans charger un autre document HTML. Sans l’action loadMovie,
      Flash Player affiche une seule animation (fichier SWF) avant de quitter.
      Lorsque vous utilisez l’action loadMovie, vous devez spécifier un niveau de Flash Player ou un
      clip cible, dans lequel charger l’animation. Si vous spécifiez un niveau, l’action devient
      loadMovieNum. Si une animation est chargée dans un clip cible, vous pouvez utiliser le chemin
      cible de ce clip pour cibler l’animation chargée.
      Une animation ou image chargée dans une cible hérite de ses propriétés de position, rotation et
      échelle. Le coin supérieur gauche de l’image ou de l’animation chargée s’aligne avec le point
      d’alignement du clip ciblé. Ou bien, si la cible est le scénario _root, le coin supérieur gauche de
      l’image ou de l’animation s’aligne avec le coin supérieur gauche de la scène.
      Utilisez l’action unloadMovie pour retirer les animations chargées avec l’action loadMovie.




282
  Exemple
  L’instruction loadMovie suivante est associée à un bouton de navigation intitulé Produits. Un
  clip invisible se trouve sur la scène et porte le nom d’occurrence zoneCible. L’action loadMovie
  utilise ce clip comme paramètre cible pour charger les produits du fichier SWF à la position
  correcte sur la scène.
  on(release) {
    loadMovie("produits.swf",_root.zoneCible);
  }
  L’exemple suivant charge une image JPEG du même répertoire que le fichier SWF qui appelle
  l’action loadMovie :
  loadMovie("image45.jpeg", "notreClip");

  Voir aussi
  loadMovieNum, unloadMovie, unloadMovieNum, _level


loadMovieNum
  Disponibilité
  Flash Player 4. Les fichiers Flash 4 ouverts sous Flash 5 doivent être convertis pour utiliser la
  syntaxe correcte.
  Usage
  loadMovieNum("url",niveau[, variables])

  Paramètres
  url     L’URL absolue ou relative du fichier SWF ou JPEG à charger. Un chemin relatif doit être
  relatif au fichier SWF au niveau 0. L’URL doit se trouver dans le même sous-domaine que l’URL
  à laquelle l’animation réside actuellement. Pour une utilisation dans Flash Player ou pour un test
  en mode test d’animation dans l’application de programmation de 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 ni de disque.
  niveau    Un entier spécifiant le niveau Flash Player auquel l’animation sera chargée.
  variables Un paramètre facultatif spécifiant une méthode HTTP d’envoi des variables. Le
  paramètre doit être la chaîne GET ou POST. Omettez ce paramètre si aucune variable ne doit être
  envoyée. La méthode GET ajoute les variables à la fin de l’URL et est utilisée pour des petits
  nombres de variables. La méthode POST envoie les variables dans un en-tête HTTP distinct et est
  utilisée pour les longues chaînes de variables.
  Renvoie
  Rien.
  Description
  Action ; charge un fichier SWF ou JPEG dans un niveau de Flash Player en cours de lecture de
  l’animation d’origine. Lorsque vous chargez une animation dans un niveau au lieu d’une cible,
  l’action loadMovie du panneau Actions en mode Normal devient loadMovieNum. En mode
  Expert, vous devez spécifier loadMovieNum ou la choisir dans la boîte à outils Actions.
  Normalement, Flash Player affiche une seule animation Flash Player (fichier SWF) avant de
  quitter. L’action loadMovieNum vous permet d’afficher plusieurs animations en une fois et de
  basculer entre des animations sans charger un autre document HTML.




                                                                          Dictionnaire ActionScript 283
      Flash Player a un ordre d’empilement des niveaux qui commence au niveau 0. Ces niveaux sont
      comme des calques : ils sont transparents, à l’exception des objets qui se trouvent sur chaque
      niveau. Lorsque vous utilisez l’action loadMovieNum, vous devez spécifier un niveau de Flash
      Player dans lequel charger l’animation. Une fois une animation chargée dans un niveau, vous
      pouvez utiliser la syntaxe _levelN, où N est le numéro du niveau, pour cibler l’animation.
      Lorsque vous chargez une animation, vous pouvez spécifier n’importe quel numéro de niveau et
      pouvez également charger des animations dans un niveau dans lequel est déjà chargé un fichier
      SWF. Si vous le faites, la nouvelle animation remplacera le fichier SWF existant. Si vous chargez
      une animation dans le niveau 0, tous les niveaux de Flash Player sont vidés et le niveau 0 est
      remplacé par le nouveau fichier. L’animation du _level0 définit la cadence, la couleur d’arrière-
      plan et la taille des images pour toutes les autres animations chargées.
      L’action loadMovieNum vous permet également de charger des fichiers JPEG dans une animation
      en cours de lecture. Le coin supérieur gauche de l’image s’aligne, aussi bien pour les images que
      pour les fichiers SWF, avec le coin supérieur gauche de la scène lors du chargement du fichier. De
      plus, dans les deux cas, le fichier chargé hérite de la rotation et de l’échelle, le contenu original
      étant écrasé.
      Utilisez l’action unloadMovieNum pour retirer les animations ou images chargées avec l’action
      loadMovieNum.

      Exemple
      Cet exemple charge l’image JPEG image45.jpg dans le niveau 2 de Flash Player.
      loadMovieNum("http://www.blag.com/image45.jpg", 2); //

      Voir aussi
      loadMovie, unloadMovie, unloadMovieNum, _level


loadVariables
      Disponibilité
      Flash Player 4.
      Usage
      loadVariables ("url" ,niveau/"cible" [, variables])

      Paramètres
      url   Une URL absolue ou relative où se trouvent les variables. Si vous accédez à l’animation avec
      un navigateur web, l’hôte de l’URL doit se trouver dans le même sous-domaine que l’animation
      même.
      niveau Un entier spécifiant le niveau Flash Player de réception des variables. Lorsque vous
      chargez des variables dans un niveau, l’action du panneau Actions en mode Normal devient
      loadVariablesNum. En mode Expert, vous devez spécifier loadVariablesNum ou la choisir dans
      la boîte à outils Actions.
      cible     Le chemin cible d’un clip qui reçoit les variables chargées. Vous devez spécifier un clip
      cible   ou un niveau de Flash Player (vous ne pouvez pas spécifier les deux).




284
   variables Un paramètre facultatif spécifiant une méthode HTTP d’envoi des variables. Le
   paramètre doit être la chaîne GET ou POST. Omettez ce paramètre si aucune variable ne doit être
   envoyée. La méthode GET ajoute les variables à la fin de l’URL et est utilisée pour des petits
   nombres de variables. La méthode POST envoie les variables dans un en-tête HTTP distinct et est
   utilisée pour les longues chaînes de variables.
   Renvoie
   Rien.
   Description
   Action ; lit des données depuis un fichier externe, tel qu’un fichier texte ou du texte généré par un
   script CGI, ASP, PHP ou Perl, et définit les valeurs des variables dans un niveau Flash Player ou
   un clip cible. Cette action peut également être utilisée pour mettre à jour les variables de
   l’animation active avec des nouvelles valeurs.
   Le texte de l’URL spécifiée doit être au format standard MIME application/x-www-form-
   urlencoded (un format standard utilisé par les scripts CGI). L’animation et les variables à
   charger doivent se trouver dans le même sous-domaine. Tout nombre de variables peut être
   spécifié. Par exemple, la séquence ci-dessous définit plusieurs variables :
   company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103
   La première animation ouverte dans une occurrence de Flash Player est chargée dans le niveau
   inférieur (identifié par _level0). Lorsque vous utilisez l’action loadMovie ou loadMovieNum
   pour charger d’autre animation dans Flash Player, vous devez spécifier un niveau de Flash Player
   ou un clip cible, dans lequel charger chaque animation. Lorsque vous utilisez l’action
   loadVariables, vous devez spécifier un niveau de Flash Player ou un clip cible, dans lequel
   charger les variables.
   Exemple
   Cet exemple charge des informations depuis un fichier texte vers des champs de texte dans le clip
   varCible du scénario principal. Les noms de variables des champs de texte doivent correspondre
   aux noms de variables du fichier données.txt.
   on(release) {
     loadVariables("données.txt", "_root.varCible");
   }

   Voir aussi
   loadVariablesNum, loadMovie, loadMovieNum, getURL, MovieClip.loadMovie,
   MovieClip.loadVariables


loadVariablesNum
   Disponibilité
   Flash Player 4. Les fichiers Flash 4 ouverts sous Flash 5 doivent être convertis pour utiliser la
   syntaxe correcte.
   Usage
   loadVariables ("url" ,niveau [, variables])

   Paramètres
   url  Une URL absolue ou relative où se trouvent les variables. Si vous accédez à l’animation avec
   un navigateur web, l’hôte de l’URL doit se trouver dans le même sous-domaine que l’animation
   même.


                                                                           Dictionnaire ActionScript 285
      niveau       Un entier spécifiant le niveau Flash Player de réception des variables.
      variables Un paramètre facultatif spécifiant une méthode HTTP d’envoi des variables. Le
      paramètre doit être la chaîne GET ou POST. Omettez ce paramètre si aucune variable ne doit être
      envoyée. La méthode GET ajoute les variables à la fin de l’URL et est utilisée pour des petits
      nombres de variables. La méthode POST envoie les variables dans un en-tête HTTP distinct et est
      utilisée pour les longues chaînes de variables.
      Renvoie
      Rien.
      Description
      Action ; lit des données depuis un fichier externe, tel qu’un fichier texte ou du texte généré par un
      script CGI, ASP, PHP ou Perl, et définit les valeurs des variables dans un niveau Flash Player.
      Cette action peut également être utilisée pour mettre à jour les variables de l’animation active avec
      des nouvelles valeurs. Lorsque vous chargez des variables dans un niveau, l’action du panneau
      Actions en mode Normal devient loadVariablesNum. En mode Expert, vous devez spécifier
      loadVariablesNum ou la choisir dans la boîte à outils Actions.

      Le texte de l’URL spécifiée doit être au format standard MIME application/x-www-form-
      urlencoded     (un format standard utilisé par les scripts CGI). L’animation et les variables à
      charger doivent se trouver dans le même sous-domaine. Tout nombre de variables peut être
      spécifié. Par exemple, la séquence ci-dessous définit plusieurs variables :
      company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103
      La première animation ouverte dans une occurrence de Flash Player est chargée dans le niveau
      inférieur (identifié par _level0). Lorsque vous utilisez l’action loadMovie ou loadMovieNum
      pour charger d’autre animation dans Flash Player, vous devez spécifier un niveau de Flash Player
      ou un clip cible, dans lequel charger chaque animation. Lorsque vous utilisez l’action
      loadVariablesNum, vous devez spécifier un niveau de Flash Player dans lequel charger les
      variables.
      Exemple
      Cet exemple charge des informations depuis un fichier texte vers des champs de texte dans le
      scénario principal (niveau 0) de Flash Player. Les noms de variables des champs de texte doivent
      correspondre aux noms de variables du fichier données.txt.
      on(release) {
        loadVariablesNum("données.txt", 0);
      }

      Voir aussi
      getURL, loadMovie, loadMovieNum, loadVariables, MovieClip.loadMovie,
      MovieClip.loadVariables




286
LoadVars (objet)
    L’objet LoadVars constitue une alternative à l’action loadVariables pour transférer des variables
    entre une animation Flash et un serveur.
    Vous pouvez utiliser l’objet LoadVars pour obtenir des informations sur des erreurs et des
    indications de progression, ainsi que pour lire des données en flux continu pendant le
    téléchargement. L’objet LoadVars fonctionne de manière semblable à l’objet XML : il utilise les
    méthodes load, send et sendAndLoad pour communiquer avec un serveur. La principale
    différence entre l’objet LoadVars et l’objet XML est que LoadVars transfère des paires nom et
    valeur ActionScript, au lieu de l’arborescence DOM XML stockée dans l’objet XML.
    L’objet LoadVars est soumis aux mêmes restrictions de sécurité que l’objet XML.
    Vous devez utiliser le constructeur new LoadVars() pour créer une occurrence de l’objet
    LoadVars avant d’en appeler les méthodes.
    L’objet LoadVars est supporté par Flash Player 6 et les versions suivantes.

Méthodes de l’objet LoadVars

    Méthode                      Description

    LoadVars.load                Télécharge des variables à partir d’une URL spécifiée.

    LoadVars.getBytesTotal       Renvoie le nombre d’octets chargés depuis une méthode load ou
                                 sendAndLoad.

    LoadVars.getBytesTotal       Renvoie le nombre total d’octets téléchargés par une opération load ou une
                                 méthode sendAndLoad.

    LoadVars.send                Publie des variables d’un objet LoadVars à une URL.

    LoadVars.sendAndLoad         Publie les variables d’un objet LoadVars à une URL et télécharge la réponse du
                                 serveur vers un objet cible.

    LoadVars.toString            Renvoie une chaîne encodée dans une URL qui contient toutes les variables
                                 énumérables de l’objet LoadVars.


Propriétés de l’objet LoadVars
    Toutes les propriétés de l’objet LoadVars sont des constantes.

    Propriété               Description

    LoadVars.contentType Indique le type MIME des données.

    LoadVars.load           Une valeur booléenne indiquant si une opération load ou sendAndLoad est
                            terminée.


Evénements de l’objet LoadVars

    Méthode                Description

    LoadVars.onLoad        Invoqué lorsqu’une opération load ou sendAndLoad est terminée.




                                                                                Dictionnaire ActionScript 287
Constructeur pour l’objet LoadVars
      Disponibilité
      Flash Player 6.
      Usage
      new LoadVars()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Constructeur ; crée une occurrence de l’objet LoadVars. Vous pouvez ensuite utiliser les
      méthodes de cet objet LoadVars pour envoyer et charger des données.
      Exemple
      L’exemple suivant crée une occurrence de l’objet LoadVars appelé monObjetLoadVars :
      monObjetLoadVars = new LoadVars();

LoadVars.contentType
      Disponibilité
      Flash Player 6.
      Usage
      monObjetLoadVars.contentType
      Description
      Propriété ; le type MIME envoyé au serveur lorsque vous appelez la méthode LoadVars.send ou
      LoadVars.sendAndLoad. La valeur par défaut est application/x-www-urlform-encoded.

      Voir aussi
      LoadVars.send, LoadVars.sendAndLoad


LoadVars.getBytesLoaded
      Disponibilité
      Flash Player 6.
      Usage
      monObjetLoadVars.getBytesLoaded()
      Paramètres
      Aucun.




288
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie le nombre d’octets téléchargés par une méthode load ou sendAndLoad. La
   méthode getBytesLoaded renvoie undefined si aucune opération load n’est en cours ou si une
   opération load n’a pas encore été initiée.

LoadVars.getBytesTotal
   Disponibilité
   Flash Player 6.
   Usage
   monObjetLoadVars.getBytesTotal()
   Paramètres
   Aucun.
   Renvoie
   Un entier.
   Description
   Méthode ; renvoie le nombre total d’octets téléchargés par une opération load ou sendAndLoad.
   La méthode getBytesTotal renvoie undefined si aucune opération load n’est en cours ou si
   une opération load n’a pas encore été initiée. La méthode getBytesTotal renvoie également
   undefined si le nombre total d’octets ne peut pas être déterminé (par exemple, si le
   téléchargement a été initié mais que le serveur n’a pas transmis de longueur de contenu HTTP).

LoadVars.load
   Disponibilité
   Flash Player 6.
   Usage
   monObjetLoadVars.load(url)
   Paramètres
   url   L’URL où se trouve les variables à télécharger.
   Renvoie
   Une chaîne.
   Description
   Méthode ; télécharge des variables depuis l’URL spécifiée, analyse les données et place les
   variables résultantes dans monObjetLoadVars. Les propriétés de monObjetLoadVars avec les
   mêmes noms que les variables téléchargées sont supprimées. Les propriétés de monObjetLoadVars
   avec des noms différents des variables téléchargées ne sont pas supprimées. Il s’agit d’une action
   asynchrone.
   Les données téléchargées doivent être au format de contenu MIME application/x-www-urlform-
   encoded. Il s’agit du même format que celui utilisé par loadVariables.
   Cette méthode est similaire à la méthode XML.load de l’objet XML.


                                                                        Dictionnaire ActionScript 289
LoadVars.loaded
      Disponibilité
      Flash Player 6.
      Usage
      monObjetLoadVars.loaded
      Description
      Propriété ; undefined par défaut. Lorsque l’opération load ou sendAndLoad est démarrée, la
      propriété loaded est définie sur false. Lorsque l’opération load ou sendAndLoad est terminée,
      la propriété loaded est définie sur true. Si une opération de chargement n’est pas encore
      terminée ou a échoué avec une erreur, la propriété loaded reste définie sur false.
      La propriété LoadVars.loaded est similaire à la propriété XML.loaded de l’objet XML.

LoadVars.onLoad
      Disponibilité
      Flash Player 6.
      Usage
      monObjetLoadVars.onLoad(succès)
      Paramètres
      succès Le paramètre       indique si l’opération de chargement s’est déroulée avec succès (true) ou
      non (false).
      Renvoie
      Une valeur booléenne.
      Description
      Gestionnaire d’événement ; invoqué lorsqu’une opération load ou sendAndLoad est terminée. Si
      l’opération a réussi, le monObjetLoadVars est rempli avec les variables téléchargées par l’opération
      load ou sendAndLoad, ces variables étant alors disponibles lorsque onLoad est invoqué.
      Cette méthode est undefined par défaut ; vous pouvez la définir en lui affectant une fonction de
      rappel.
      Cette méthode est similaire à la méthode XML.onLoad de l’objet XML.

LoadVars.send
      Disponibilité
      Flash Player 6.
      Usage
      monObjetLoadVars.send(url [,cible, méthode] )

      Paramètres
      monObjetLoadVars        L’objet LoadVars duquel télécharger les variables.
      url     L’URL à laquelle télécharger les variables.
      cible     La fenêtre du navigateur dans laquelle les réponses seront affichées.



290
  méthode      La méthode"GET" ou "POST" du protocole HTTP.
  Renvoie
  Une chaîne.
  Description
  Méthode ; envoie les variables de l’objet monObjetLoadVars à l’URL spécifiée. Toutes les
  variables énumérables de l’objet monObjetLoadVars sont concaténées en une chaîne au format
  application/x-www-urlform-encoded par défaut, et la chaîne est publiée à l’URL avec la méthode
  POST de HTTP. Il s’agit du même format que celui utilisé par l’action loadVariables. Le type
  de contenu MIME envoyé dans les en-têtes de requête HTTP est la valeur de
  monObjetLoadVars.contentType ou la valeur par défaut application/x-www-urlform-encoded. La
  méthode "POST" est utilisée si "GET" n’est pas spécifiée.
  Si le paramètre cible n’est pas spécifié, la réponse du serveur est affichée dans la fenêtre nommée
  cible   du navigateur. Si le paramètre cible est omis, la réponse du serveur n’est pas prise en
  compte.
  Cette méthode est similaire à la méthode XML.send de l’objet XML.

LoadVars.sendAndLoad
  Disponibilité
  Flash Player 6.
  Usage
  monObjetLoadVars.sendAndLoad(url, objetCible[,méthode])

  Paramètres
  monObjetLoadVars         L’objet LoadVars duquel télécharger les variables.
  url     L’URL à laquelle télécharger les variables.
  objetCible        L’objet LoadVars qui reçoit les variables téléchargées.
  méthode      La méthode"GET" ou "POST" du protocole HTTP.
  Renvoie
  Une chaîne.
  Description
  Méthode ; publie les variables de l’objet monObjetLoadVars à l’URL spécifiée. La réponse du
  serveur est téléchargée, analysée en tant que données de variables, et les variables résultantes sont
  placées dans l’objet objetCible.
  Les variables sont publiées de la même façon qu’avec LoadVars.send. Les variables sont
  téléchargées dans objetCible de la même façon qu’avec LoadVars.load.
  Cette méthode est similaire à la méthode XML.sendAndLoad de l’objet XML.




                                                                              Dictionnaire ActionScript 291
LoadVars.toString
      Disponibilité
      Flash Player 6.
      Usage
      monObjetLoadVars.toString()
      Paramètres
      None.

      Renvoie
      Une chaîne.
      Description
      Méthode ; renvoie une chaîne contenant toutes les variables énumérables de l’objet LoadVars, en
      code de contenu MIME application/x-www-urlform-encoded.
      Exemple
      var mesVars = new LoadVars();
      mesVars.nom = "Gary";
      mesVars.age = 26;
      trace (mesVars.toString());

      Résultat :
      nom=Gary&age=26

lt (inférieur à — spécifique aux chaînes)
      Disponibilité
      Flash Player 4. Cet opérateur est déconseillé dans Flash 5 et remplacé par le nouvel opérateur <
      (inférieur à).
      Usage
      expression1 lt expression2

      Paramètres
      expression1, expression2       Nombres, chaînes ou variables.
      Description
      Opérateur (comparaison) ; compare expression1 avec expression2 et renvoie true si
      expression1 est inférieure à expression2 ; sinon, renvoie false.

      Voir aussi
      < (inférieur à)




292
Math (objet)
   L’objet Math est un objet de haut niveau auquel vous pouvez accéder sans utiliser de
   constructeur.
   Utilisez les méthodes et propriétés de cet objet pour accéder aux constantes et aux fonctions
   mathématiques, et pour les manipuler. Toutes les propriétés et méthodes de l’objet Math sont
   statiques et doivent être appelées en utilisant la syntaxe Math.méthode(paramètre) ou
   Math.constante. Dans ActionScript, les constantes sont définies avec le maximum de précision
   des nombres à virgule flottante double précision IEEE-754.
   Plusieurs méthodes de l’objet Math utilisent le radian d’un angle comme paramètre. Vous pouvez
   utiliser l’équation ci-dessous pour calculer les valeurs en radians, ou simplement transmettre
   l’équation (en entrant une valeur pour les degrés) pour le paramètre de radian.
   Pour calculer une valeur en radians, utilisez cette formule :
   radian = Math.PI/180 * degree
   L’exemple suivant illustre la transmission de l’équation comme paramètre pour calculer le sinus
   d’un angle de 45 degrés :
   Math.SIN(Math.PI/180 * 45)           est identique à Math.SIN(.7854)
   L’objet Math est pleinement supporté par Flash Player 5. Dans Flash Player 4, les méthodes de
   l’objet Math fonctionnent, mais sont émulées avec des approximations et peuvent ne pas être
   aussi précises que les fonctions mathématiques non émulées supportées par Flash Player 5.

Méthodes de l’objet Math

    Méthode              Description

    Math.abs             Calcule une valeur absolue.

    Math.acos            Calcule le cosinus d’un arc.

    Math.asin            Calcule le sinus d’un arc.

    Math.atan            Calcule la tangente d’un arc.

    Math.atan2           Calcule un angle depuis l’axe des x jusqu’au point.

    Math.ceil            Arrondit un nombre à l’entier supérieur le plus proche.

    Math.cos             Calcule un cosinus.

    Math.exp             Calcule une valeur exponentielle.

    Math.floor           Arrondit un nombre à l’entier inférieur le plus proche.

    Math.log             Calcule un logarithme naturel.

    Math.max             Renvoie le plus grand des deux entiers.

    Math.min             Renvoie le plus petit des deux entiers.

    Math.pow             Calcule x élevé à la puissance y.

    Math.random          Renvoie un nombre pseudo-aléatoire entre 0.0 et 1.0.

    Math.round           Arrondit à l’entier le plus proche.

    Math.sin             Calcule un sinus.




                                                                                   Dictionnaire ActionScript 293
      Méthode              Description

      Math.sqrt            Calcule une racine carrée.

      Math.tan             Calcule une tangente.


Propriétés de l’objet Math
      Toutes les propriétés de l’objet Math sont des constantes.

      Propriété            Description

      Math.E               Constante d’Euler et base des logarithmes naturels (approximativement 2,718).

      Math.LN2             Le logarithme naturel de 2 (approximativement 0.693).

      Math.LOG2E           Le logarithme de base 2 de e (approximativement 1.442).

      Math.LN10            Le logarithme naturel de 10 (approximativement 2.302).

      Math.LOG10E          Le logarithme de base 10 de e (approximativement 0.434).

      Math.PI              Le rapport de la circonférence d’un cercle à son diamètre (approximativement 3.14159).

      Math.SQRT1_2         La réciproque de la racine carrée de 1/2 (approximativement 0.707).

      Math.SQRT2           La racine carrée de 2 (approximativement 1.414).


Math.abs
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.abs(x)

      Paramètres
      x   Un nombre.
      Renvoie
      Un nombre.
      Description
      Méthode ; calcule et renvoie une valeur absolue pour le nombre spécifié par le paramètre x.

Math.acos
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.acos(x)




294
   Paramètres
   x   Un nombre entre -1.0 et 1.0.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; calcule et renvoie le cosinus de l’arc du nombre spécifié par le paramètre x, en radians.

Math.asin
   Disponibilité
   Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
   des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
   émulées supportées par Flash Player 5.
   Usage
   Math.asin(x);

   Paramètres
   x   Un nombre entre -1.0 et 1.0.
   Renvoie
   Un nombre.
   Description
   Méthode ; calcule et renvoie le sinus de l’arc du nombre spécifié par le paramètre x, en radians.

Math.atan
   Disponibilité
   Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
   des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
   émulées supportées par Flash Player 5.
   Usage
   Math.atan(x)

   Paramètres
   x   Un nombre.
   Renvoie
   Un nombre.
   Description
   Méthode ; calcule et renvoie la tangente de l’arc pour le nombre spécifié par le paramètre x. La
   valeur renvoyée se situe entre pi négatif divisé par 2 et pi positif divisé par 2.




                                                                         Dictionnaire ActionScript 295
Math.atan2
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.atan2(y, x)

      Paramètres
      x   Un nombre spécifiant la coordonnée x du point.
      y   Un nombre spécifiant la coordonnée y du point.
      Renvoie
      Un nombre.
      Description
      Méthode ; calcule et renvoie la tangente de l’arc y/x, en radians. La valeur renvoyée représente
      l’angle opposé d’un triangle droit, où x est la longueur du côté adjacent et y est la longueur du
      côté opposé.

Math.ceil
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.ceil(x)

      Paramètres
      x   Un nombre ou une expression.
      Renvoie
      Un nombre.
      Description
      Méthode ; renvoie le plafond du nombre ou de l’expression spécifiés. Le plafond d’un nombre est
      l’entier le plus proche supérieur ou égal à ce nombre.

Math.cos
      Usage
      Math.cos(x)

      Paramètres
      x   Un angle mesuré en radians.




296
  Renvoie
  Un nombre.
  Description
  Méthode ; renvoie le cosinus (une valeur entre -1.0 et 1.0) de l’angle spécifié par le paramètre x.
  L’angle x doit être spécifié en radians. Utilisez les informations indiquées dans l’introduction de
  l’objet Math pour calculer un radian.

Math.E
  Disponibilité
  Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
  des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
  émulées supportées par Flash Player 5.
  Usage
  Math.E

  Paramètres
  Aucun.
  Renvoie
  Rien.
  Description
  Constante ; une constante mathématique pour la base des logarithmes naturels, exprimée sous la
  forme e. La valeur approximative de e est 2.71828.

Math.exp
  Disponibilité
  Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
  des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
  émulées supportées par Flash Player 5.
  Usage
  Math.exp(x)

  Paramètres
  x   L’exposant ; un nombre ou une expression.
  Renvoie
  Un nombre.
  Description
  Méthode ; renvoie la valeur de la base du logarithme naturel (e), à la puissance de l’exposant
  spécifié dans le paramètre x. La constante Math.E peut fournir la valeur de e.




                                                                         Dictionnaire ActionScript 297
Math.floor
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.floor(x)

      Paramètres
      x   Un nombre ou une expression.
      Renvoie
      Un nombre.
      Description
      Méthode ; renvoie le plancher du nombre ou de l’expression spécifiés dans le paramètre x. Le
      plancher est l’entier le plus proche inférieur ou égal au nombre ou à l’expression spécifiés.
      Exemple
      Le code suivant renvoie une valeur de 12 :
      Math.floor(12.5);

Math.log
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.log(x)

      Paramètres
      x   Un nombre ou une expression avec une valeur supérieure à 0.
      Renvoie
      Un nombre.
      Description
      Méthode ; renvoie le logarithme naturel du paramètre x.

Math.LOG2E
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.LOG2E




298
  Paramètres
  Aucun.
  Renvoie
  Rien.
  Description
  Constante ; une constante mathématique pour le logarithme de base 2 de la constante e (Math.E),
  exprimée sous la forme loge2, avec une valeur approximative de 1.442695040888963387.

Math.LOG10E
  Disponibilité
  Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
  des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
  émulées supportées par Flash Player 5.
  Usage
  Math.LOG10E

  Paramètres
  Aucun.
  Renvoie
  Rien.
  Description
  Constante ; une constante mathématique pour le logarithme de base 10 de la constante e
  (Math.E), exprimée sous la forme log10e, avec une valeur approximative de
  0.43429448190325181667.

Math.LN2
  Disponibilité
  Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
  des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
  émulées supportées par Flash Player 5.
  Usage
  Math.LN2

  Paramètres
  Aucun.
  Renvoie
  Rien.
  Description
  Constante ; une constante mathématique pour le logarithme naturel de 2, exprimée sous la forme
  loge2, avec une valeur approximative de 0.69314718055994528623.




                                                                       Dictionnaire ActionScript 299
Math.LN10
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.LN10

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Constante ; une constante mathématique pour le logarithme naturel de 10, exprimée sous la
      forme loge10, avec une valeur approximative de 2.3025850929940459011.

Math.max
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.max(x , y)

      Paramètres
      x   Un nombre ou une expression.
      y   Un nombre ou une expression.
      Renvoie
      Un nombre.
      Description
      Méthode ; évalue x et y et renvoie la valeur la plus grande.

Math.min
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.min(x , y)

      Paramètres
      x   Un nombre ou une expression.



300
   y   Un nombre ou une expression.
   Renvoie
   Rien.
   Description
   Méthode ; évalue x et y et renvoie la valeur la plus petite.

Math.PI
   Disponibilité
   Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
   des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
   émulées supportées par Flash Player 5.
   Usage
   Math.PI

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Constante ; une constante mathématique pour le rapport de la circonférence d’un cercle à son
   diamètre, exprimée sous la forme pi, avec une valeur de 3.14159265358979.

Math.pow
   Disponibilité
   Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
   des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
   émulées supportées par Flash Player 5.
   Usage
   Math.pow(x , y)

   Paramètres
   x   Un nombre devant être élevé à une puissance.
   y   Un nombre spécifiant la puissance à laquelle le paramètre x est élevé.
   Renvoie
   Un nombre.
   Description
   Méthode ; calcule et renvoie x à la puissance de y, xy.




                                                                         Dictionnaire ActionScript 301
Math.random
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.random()

      Paramètres
      Aucun.
      Renvoie
      Un nombre.
      Description
      Méthode ; renvoie n, où 0 <= n < 1.
      Voir aussi
      random

Math.round
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.round(x)

      Paramètres
      x   Un nombre.
      Renvoie
      Un nombre.
      Description
      Méthode ; arrondit la valeur du paramètre x à l’entier inférieur ou supérieur le plus proche et
      renvoie la valeur.

Math.sin
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.sin(x)




302
   Paramètres
   x   Un angle mesuré en radians.
   Renvoie
   Rien.
   Description
   Méthode ; calcule et renvoie le sinus de l’angle spécifié, en radians. Utilisez les informations
   indiquées dans l’introduction de l’objet Math pour calculer un radian.

Math.sqrt
   Disponibilité
   Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
   des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
   émulées supportées par Flash Player 5.
   Usage
   Math.sqrt(x)

   Paramètres
   x   Un nombre ou une expression supérieur ou égal à 0.
   Renvoie
   Un nombre.
   Description
   Méthode ; calcule et renvoie la racine carrée du nombre spécifié.

Math.SQRT1_2
   Disponibilité
   Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
   des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
   émulées supportées par Flash Player 5.
   Usage
   Math.SQRT1_2

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Constante ; une constante mathématique pour la réciproque de la racine carrée de un-demi (1/2),
   avec une valeur approximative de 0.707106781186.




                                                                           Dictionnaire ActionScript 303
Math.SQRT2
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.SQRT2

      Paramètres
      Aucun.
      Description
      Constante ; une constante mathématique pour la racine carrée de 2, avec une valeur
      approximative de 1.414213562373.

Math.tan
      Disponibilité
      Flash Player 5. Dans Flash Player 4, les méthodes et propriétés de l’objet Math sont émulées avec
      des approximations et peuvent ne pas être aussi précises que les fonctions mathématiques non
      émulées supportées par Flash Player 5.
      Usage
      Math.tan(x)

      Paramètres
      x   Un angle mesuré en radians.
      Renvoie
      Un nombre.
      Description
      Méthode ; calcule et renvoie la tangente de l’angle spécifié. Pour calculer un radian, utilisez les
      informations indiquées dans l’introduction de Math (objet).

maxscroll
      Disponibilité
      Flash Player 4.
      Usage
      nomDeVariable.maxscroll

      Description
      Propriété (lecture seule) ; une propriété déconseillée qui indique le numéro de ligne de la
      première ligne de texte visible dans un champ de texte lorsque la dernière ligne du champ est
      également visible. La propriété maxscroll fonctionne avec la propriété scroll pour contrôler
      l’affichage des informations dans un champ de texte. Cette propriété peut être récupérée mais pas
      modifiée.
      Voir aussi
      TextField.maxscroll, TextField.scroll


304
mbchr
  Disponibilité
  Flash Player 4. Cette fonction est déconseillée et remplacée par la méthode
  String.fromCharCode.

  Usage
  mbchr(nombre)

  Paramètres
  nombre    Le nombre à convertir en caractère multioctet.
  Renvoie
  Une chaîne.
  Description
  Fonction de chaîne ; convertit un code ASCII en caractère multioctet.
  Voir aussi
  String.fromCharCode

mblength
  Disponibilité
  Flash Player 4. Cette fonction est déconseillée et remplacée par String (objet).
  Usage
  mblength(chaîne)

  Paramètres
  chaîne    Une chaîne.
  Renvoie
  Un nombre.
  Description
  Fonction de chaîne ; renvoie la longueur de la chaîne de caractères multioctet.

mbord
  Disponibilité
  Flash Player 4. Cette fonction est déconseillée dans Flash 5 et remplacée par la méthode
  String.charCodeAt.

  Usage
  mbord(caractère)

  Paramètres
  caractère       Le caractère à convertir en nombre multioctet.
  Renvoie
  Un nombre.




                                                                         Dictionnaire ActionScript 305
      Description
      Fonction de chaîne ; convertit le caractère spécifié en nombre multioctet.
      Voir aussi
      String.fromCharCode

mbsubstring
      Disponibilité
      Flash Player 4. Cette fonction est déconseillée dans Flash 5 et remplacée par la méthode
      String.substr.

      Usage
      mbsubstring(valeur, index, nombre)

      Paramètres
      valeur     La chaîne multioctet de laquelle extraire une nouvelle chaîne multioctet.
      index     Le numéro du premier caractère à extraire.
      nombre     Le nombre de caractères à inclure dans la chaîne extraite, excluant le caractère d’index.
      Renvoie
      Une chaîne.
      Description
      Fonction de chaîne ; extrait une nouvelle chaîne de caractères multioctet d’une chaîne de
      caractères multioctet.
      Voir aussi
      String.substr

method
      Disponibilité
      Flash Player 6.
      Usage
      objet.méthode = function ([paramètres]) {
         ...corps de la fonction...
      };

      Paramètres
      objet     Un identifiant pour un objet.
      méthode      Un identifiant pour une méthode.
      paramètres        Paramètres à transmettre à la fonction. Un paramètre facultatif.
      Renvoie
      Rien.
      Description
      Action (mode Normal uniquement) ; permet de définir des méthodes pour des objets à l’aide du
      panneau Actions en mode Normal. Pour plus d’informations sur la définition des méthodes des
      objets, consultez Rédaction de scripts avec ActionScript, dans Utilisation de Flash.


306
Mouse (objet)
    L’objet Mouse est un objet de haut niveau auquel vous pouvez accéder sans utiliser de
    constructeur. Vous pouvez utiliser les méthodes de l’objet Mouse pour masquer et afficher le
    curseur dans l’animation. Le pointeur est visible par défaut, mais vous pouvez le masquer et
    implémenter un pointeur personnalisé que vous créez avec un clip.

Méthodes de l’objet Mouse

    Méthode                      Description

    Mouse.addListener            Enregistre un objet pour la réception de notifications onMouseDown,
                                 onMouseMove et onMouseUp.

    Mouse.hide                   Masque le pointeur de la souris dans l’animation.

    Mouse.removeListener         Retire un objet enregistré avec la méthode addListener.

    Mouse.show                   Affiche le pointeur de la souris dans l’animation.


Ecouteurs de l’objet Mouse

    Méthode                      Description

    MovieClip.onMouseDown        Notifié lorsque le bouton de la souris est enfoncé.

    MovieClip.onMouseMove        Notifié lorsque la souris est déplacée.

    MovieClip.onMouseUp          Notifié lorsque le bouton de la souris est relâché.


Mouse.addListener
    Disponibilité
    Flash Player 6.
    Usage
    Mouse.addListener (nouvelEcouteur)
    Paramètres
    nouvelEcouteur      Un objet.
    Renvoie
    Rien.
    Description
    Méthode ; enregistre un objet pour la réception de notifications de gestionnaires de rappel
    onMouseDown, onMouseMove et onMouseUp.

    Le paramètre nouvelEcouteur devrait contenir un objet avec des méthodes définies pour les
    événements onMouseDown, onMouseMove et onMouseUp.
    Lorsque le bouton de la souris est enfoncé, que la souris est déplacée ou que le bouton de la souris
    est relâché, quel que soit le focus de saisie, la méthode onMouseDown, onMouseMove ou
    onMouseUp de tous les objets écouteurs enregistrés avec addListener est invoquée. Plusieurs
    objets peuvent attendre des notifications de clavier. Si l’écouteur nouvelEcouteur est déjà
    enregistré, aucun changement n’a lieu.




                                                                                      Dictionnaire ActionScript 307
Mouse.hide
      Disponibilité
      Flash Player 5.
      Usage
      Mouse.hide()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; masque le curseur dans une animation. Le curseur est visible par défaut.
      Exemple
      Le code suivant, associé à un clip du scénario principal, masque le curseur standard et définit les
      positions x et y de l’occurrence de clip CurseurPersoMC aux positions x et y de la souris dans le
      scénario principal.
      onClipEvent (enterFrame) {
        Mouse.hide();
        CurseurPersoMC._x = _root._xmouse;
        CurseurPersoMC._y = _root._ymouse;
      }

      Voir aussi
      Mouse.show, MovieClip._xmouse, MovieClip._ymouse


Mouse.onMouseDown
      Disponibilité
      Flash Player 6.
      Usage
      unEcouteur.onMouseDown

      Description
      Ecouteur ; notifié lorsque le bouton de la souris est enfoncé. Pour utiliser l’écouteur
      onMouseDown, vous devez créer un objet d’écoute. Vous pouvez alors définir une fonction pour
      onMouseDown et utiliser la méthode addListener pour enregistrer l’écouteur avec l’objet Mouse,
      comme dans l’exemple suivant :
      unEcouteur = new Object();
      unEcouteur.onMouseDown = function () { ... };
      Mouse.addListener(unEcouteur);
      Les écouteurs permettent à différents morceaux de code de coopérer étant donné que plusieurs
      écouteurs peuvent recevoir une notification concernant un seul événement.
      Voir aussi
      Mouse.addListener




308
Mouse.onMouseMove
  Disponibilité
  Flash Player 6.
  Usage
  unEcouteur.onMouseMove

  Description
  Ecouteur ; notifié lorsque la souris se déplace. Pour utiliser l’écouteur onMouseMove, vous devez
  créer un objet d’écoute. Vous pouvez alors définir une fonction pour onMouseMove et utiliser la
  méthode addListener pour enregistrer l’écouteur avec l’objet Mouse, comme dans l’exemple
  suivant :
  unEcouteur = new Object();
  unEcouteur.onMouseMove = function () { ... };
  Mouse.addListener(unEcouteur);
  Les écouteurs permettent à différents morceaux de code de coopérer étant donné que plusieurs
  écouteurs peuvent recevoir une notification concernant un seul événement.
  Voir aussi
  Mouse.addListener

Mouse.onMouseUp
  Disponibilité
  Flash Player 6.
  Usage
  unEcouteur.onMouseUp

  Description
  Ecouteur ; notifié lorsque le bouton de la souris est relâché. Pour utiliser l’écouteur onMouseUp,
  vous devez créer un objet d’écoute. Vous pouvez alors définir une fonction pour onMouseUp et
  utiliser la méthode addListener pour enregistrer l’écouteur avec l’objet Mouse, comme dans
  l’exemple suivant :
  unEcouteur = new Object();
  unEcouteur.onMouseUp = function () { ... };
  Mouse.addListener(unEcouteur);
  Les écouteurs permettent à différents morceaux de code de coopérer étant donné que plusieurs
  écouteurs peuvent recevoir une notification concernant un seul événement.
  Voir aussi
  Mouse.addListener




                                                                        Dictionnaire ActionScript 309
Mouse.removeListener
      Disponibilité
      Flash Player 6.
      Usage
      Mouse.removeListener (écouteur)
      Paramètres
      écouteur     Un objet.
      Renvoie
      Si l’objet écouteur a été correctement retiré, la méthode renvoie true. Si écouteur n’a pas été
      correctement retiré, par exemple si écouteur n’apparaissait pas dans la liste des écouteurs de
      l’objet Mouse, la méthode renvoie false.
      Description
      Méthode ; retire un objet précédemment enregistré avec la méthode addListener.

Mouse.show
      Disponibilité
      Flash Player 5.
      Usage
      Mouse.show()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; affiche le pointeur dans une animation. Le curseur est visible par défaut.
      Voir aussi
      Mouse.show, MovieClip._xmouse, MovieClip._ymouse


MovieClip (objet)
      Les méthodes de l’objet MovieClip fournissent la même fonctionnalité que les actions ciblant les
      clips. Il existe également des méthodes supplémentaires qui n’ont pas d’action équivalente dans la
      boîte à outils Actions du panneau Actions.
      Il n’est pas nécessaire d’utiliser une méthode constructeur pour appeler les méthodes de l’objet
      MovieClip : vous faites référence aux occurrences de clips par leurs noms, avec la syntaxe
      suivante :
      monClip.play();
      monClip.gotoAndPlay(3);




310
Méthodes de l’objet MovieClip

    Méthode                          Description

    MovieClip.attachMovie            Associe une animation dans la bibliothèque.

    MovieClip.createEmptyMovieClip   Crée un clip vide.

    MovieClip.createTextField        Crée un champ de texte vide.

    MovieClip.duplicateMovieClip     Duplique le clip spécifié.

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

    MovieClip.getBytesLoaded         Renvoie le nombre d’octets chargés pour le clip spécifié.

    MovieClip.getBytesTotal          Renvoie la taille du clip, en octets.

    MovieClip.getDepth               Renvoie la profondeur d’un clip.

    MovieClip.getURL                 Récupère un document d’une URL.

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

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

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

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

    MovieClip.loadMovie              Charge l’animation spécifiée dans le clip.

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

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

    MovieClip.nextFrame              Envoie la tête de lecture à l’image suivante du clip.

    MovieClip.play                   Exécute le clip spécifié.

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

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

    MovieClip.setMask                Spécifie un clip comme masque d’un autre clip.

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

    MovieClip.stop                   Arrête la lecture de l’animation courante.

    MovieClip.stopDrag               Arrête le déplacement d’un clip en cours de déplacement.

    MovieClip.swapDepths             Permute le niveau de deux animations.

    MovieClip.unloadMovie            Supprime une animation chargée avec l’action loadMovie.




                                                                              Dictionnaire ActionScript      311
Méthodes de dessin de l’objet MovieClip

      Méthode                       Description

      MovieClip.beginFill           Commence à tracer un remplissage sur la scène.

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

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

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

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

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

      MovieClip.lineTo              Dessine une ligne avec le style de trait actuel.

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


Propriétés de l’objet MovieClip

      Propriété                     Description

      MovieClip._alpha              La valeur de transparence d’une occurrence de clip.

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

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

      MovieClip.enabled             Indique si un clip de bouton est activé.

      MovieClip.focusEnabled        Active un clip pour qu’il puisse recevoir le focus.

      MovieClip._focusrect          Indique si un clip avec focus est encadré d’un rectangle jaune.

      MovieClip._framesloaded       Le nombre d’images chargées depuis une animation lue en flux continu.

      MovieClip._height             La hauteur d’une occurrence de clip, en pixels.

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

      MovieClip._highquality        Définit la qualité de rendu d’une animation

      MovieClip._name               Le nom d’occurrence d’une occurrence de clip.

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

      MovieClip._rotation           Le degré de rotation d’une occurrence de clip.

      MovieClip._soundbuftime       Le nombre de secondes avant d’un son ne démarre en lecture continue.

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

      MovieClip.tabEnabled          Indique si un clip est inclus dans l’ordre de tabulation.

      MovieClip.tabIndex            Indique l’ordre de tabulation d’un objet.

      MovieClip._target             Le chemin cible d’une occurrence de clip.

      MovieClip._totalframes        Le nombre total d’images d’une occurrence de clip.

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




312
    Propriété                    Description

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

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

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

    MovieClip._width             La largeur d’une occurrence de clip, en pixels.

    MovieClip._x                 La coordonnée x d’une occurrence de clip.

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

    MovieClip._xscale            La valeur spécifiant le pourcentage de redimensionnement horizontal
                                 d’un clip.

    MovieClip._y                 La coordonnée y d’une occurrence de clip.

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

    MovieClip._yscale            La valeur spécifiant le pourcentage de redimensionnement vertical d’un
                                 clip.


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

    Propriété                    Description

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

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

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

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

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

    MovieClip.onKeyUp            Invoqué lorsqu’une touche est relâchée.

    MovieClip.onKillFocus        Invoqué lorsque le focus est retiré d’un bouton.

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

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

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

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

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

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

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




                                                                         Dictionnaire ActionScript 313
      Propriété                             Description

      MovieClip.onRollOut                   Invoqué lorsque le pointeur passe à l’extérieur d’un bouton.

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

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

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


MovieClip._alpha
      Disponibilité
      Flash Player 4.
      Usage
      monClip._alpha

      Description
      Propriété ; définit et récupère la transparence alpha (valeur) du clip spécifié par monClip. Les
      valeurs valides vont de 0 (transparence complète) à 100 (opacité complète). Les objets d’un clip
      avec _alpha défini sur 0 sont actifs, même s’ils sont invisibles. Par exemple, vous pouvez cliquer
      sur un bouton dans un clip dont la propriété _alpha est définie sur 0.
      Exemple
      Les instructions suivantes définissent la propriété _alpha d’un clip nommé étoile sur 30 %
      lorsque le bouton est enfoncé.
      on(release) {
        étoile._alpha = 30;
      }

MovieClip.attachMovie
      Disponibilité
      Flash Player 5.
      Usage
      monClip.attachMovie( nomIdentifiant, nouveauNom, profondeur [, objetInit] )

      Paramètres
      nomIdentifiant Le nom de liaison du symbole de clip de la bibliothèque à associer à un clip
      sur la scène. Il s’agit du nom entré dans le champ Identifiant de la boîte de dialogue Propriétés de
      liaison de symbole.
      nouveauNom        Un nom d’occurrence unique pour le clip en cours d’association au clip.
      profondeur        Un entier spécifiant le niveau de profondeur auquel associer l’animation.
      objetInit Un objet contenant les propriétés avec lesquelles remplir le clip nouvellement
      associé. Ce paramètre permet aux clips créés dynamiquement de recevoir des paramètres. Si
      objetInit n’est pas un objet, il est ignoré. Toutes les propriétés de objetInit sont copiées dans
      la nouvelle occurrence. Les propriétés spécifiées avec objetInit peuvent être utilisées par la
      fonction constructeur. Ce paramètre est facultatif.



314
   Renvoie
   Rien.
   Description
   Méthode ; prend un symbole de la bibliothèque et l’associe à l’animation spécifiée par monClip
   sur la scène. Utilisez l’action ou méthode removeMovieClip ou unloadMovie pour supprimer
   une animation associée avec attachMovie.
   Exemple
   L’exemple suivant associe le symbole avec « cercle » comme identifiant de liaison à l’occurrence de
   clip qui se trouve sur la scène.
   on(release) {
       truc.attachMovie( "cercle", "cercle1", 2 );
   }

   Voir aussi
   MovieClip.removeMovieClip, MovieClip.unloadMovie, Object.registerClass,
   removeMovieClip


MovieClip.beginFill
   Disponibilité
   Flash Player 6.
   Usage
   monClip.beginFill ([rvb[, alpha]])

   Paramètre
   rvb   Une valeur chromatique hexadécimale (par exemple, le rouge est 0xFF0000, le bleu est
   0x0000FF, etc.). Si cette valeur n’est pas fournie ou si elle est indéfinie, aucun remplissage n’est
   créé.
   alpha Un entier compris entre 0–100 spécifiant la valeur alpha du remplissage. Si cette valeur
   n’est pas indiquée, 100 (uni) est utilisé. Si la valeur est inférieure à 0, Flash utilise 0. Si la valeur
   est supérieure à 100, Flash utilise 100.
   Renvoie
   Rien.
   Description
   Méthode ; indique le début d’un nouveau trajet de dessin. Si un chemin ouvert existe, c’est-à-dire
   si la position de dessin actuelle n’est pas égale à la position précédente spécifiée dans une méthode
   moveTo, et qu’un remplissage y est associé, ce chemin est fermé avec un trait, puis rempli. Cela est
   semblable à ce qui se produit à l’appel de la méthode endFill.
   Voir aussi
   MovieClip.beginGradientFill, MovieClip.endFill




                                                                              Dictionnaire ActionScript 315
MovieClip.beginGradientFill
      Disponibilité
      Flash Player 6.
      Usage
      monClip.beginGradientFill (typeDeRemplissage, couleurs, alphas, rapports,
      matrice)
      Paramètre
      typeDeRemplissage         Soit la chaîne "linear" ou la chaîne "radial".
      couleurs    Un tableau des valeurs hexadécimales RVB à utiliser dans le dégradé (par exemple, le
      rouge est 0xFF0000, le bleu est 0x0000FF, etc.).
      alphas     Un tableau de valeurs alpha pour les couleurs correspondantes du tableau couleurs, les
      valeurs valides étant 0–100. Si la valeur est inférieure à 0, Flash utilise 0. Si la valeur est supérieure
      à 100, Flash utilise 100.
      rapports     Un tableau de rapports de distribution des couleurs, les valeurs valides étant 0–255.
      Cette valeur définit le pourcentage de la largeur où la couleur est échantillonnée à 100 %.
      matrice     Une matrice de transformation qui est un objet avec l’un des deux ensembles de
      propriétés suivants.
      • a, b, c, d, e, f, g, h, i, qui peuvent être utilisés pour décrire une matrice 3x3 au format
         suivant :
         a b c
         d e f
         g h i

         L’exemple suivant utilise une méthode beginGradientFill avec un paramètre matrice, qui
         est un objet avec ces propriétés.
         _root.createEmptyMovieClip( "dégradé", 1 );
                       with ( _root.dégradé )

                            {

                           couleurs     =   [ 0xFF0000, 0x0000FF ];
                           alphas =     [   100, 100 ];
                           rapports     =   [ 0, 0xFF ];
                          matrice =     {   a:200, b:0, c:0, d:0, e:200, f:0, g:200, h:200, i:1
            };
                            beginGradientFill( "linear", couleurs, alphas, rapports,
            matrice );
                            moveto(100,100);
                            lineto(100,300);
                            lineto(300,300);
                            lineto(300,100);
                            lineto(100,100);
                            endFill();

                            }




316
Si une propriété typeDeMatrice n’existe pas, les autres paramètres sont tous requis (la fonction
échoue s’ils ne sont pas tous présents). Cette matrice redimensionne, translate, pivote et incline le
gradient unitaire qui est défini à (-1,-1) et (1,1).<




•   typeDeMatrice, x, y, l, h, r.

    Les propriétés indiquent : typeDeMatrice est la chaîne "box", x est la position horizontale
    relative au point d’alignement du clip parent pour le coin supérieur gauche du dégradé, y est la
    position verticale relative au point d’alignement du clip parent pour le coin supérieur gauche
    du dégradé, l est la largeur du gradient, h est la hauteur du dégradé et r est la rotation du
    dégradé, en radians.
    L’exemple suivant utilise une méthode beginGradientFill avec un paramètre matrice, qui
    est un objet avec ces propriétés.
    _root.createEmptyMovieClip( "dégradé", 1 );
                  with ( _root.dégradé )

                     {

                  couleurs = [ 0xFF0000, 0x0000FF ];
                  alphas = [ 100, 100 ];
                  rapports = [ 0, 0xFF ];
                  matrice = { typeDeMatrice:"box", x:100, y:100, l:200, h:200,
      r:(45/180)*Math.PI };
                  beginGradientFill( "linear", couleurs, alphas, rapports,
      matrice );
                  moveto(100,100);
                  lineto(100,300);
                  lineto(300,300);
                  lineto(300,100);
                  lineto(100,100);
                  endFill();
                  }




                                                                       Dictionnaire ActionScript 317
      Si une propriété typeDeMatrice existe, elle doit être égale à "box" et les autres paramètres sont
      tous obligatoires. La fonction échoue si une ou plusieurs de ces conditions ne sont pas remplies.




      Renvoie
      Rien.
      Description
      Méthode ; indique le début d’un nouveau trajet de dessin. Si le premier paramètre est undefined,
      ou si aucun paramètre n’est transmis, le trajet n’a aucun remplissage. Si un chemin ouvert existe,
      c’est-à-dire si la position de dessin actuelle n’est pas égale à la position précédente spécifiée dans
      une méthode moveTo, et qu’un remplissage y est associé, ce chemin est fermé avec un trait, puis
      rempli. Cela est semblable à ce qui se produit à l’appel de la méthode endFill.
      Cette méthode échoue si une ou plusieurs des conditions suivantes existent :
      • Le nombre d’éléments dans les paramètres couleurs, alphas et rapports n’est pas le même.
      • Le paramètre typeDeRemplissage n’est ni "linear" ni "radial".
      • Un ou plusieurs des champs de l’objet pour le paramètre matrice sont absents ou invalides.




318
Exemple
Le code suivant utilise les deux méthodes pour tracer deux rectangles empilés avec un remplissage
dégradé rouge-bleu et un trait vert de 5 points.
_root.createEmptyMovieClip("goober",1);
with ( _root.goober )
{
  couleurs = [ 0xFF0000, 0x0000FF ];
  alphas = [ 100, 100 ];
  rapports = [ 0, 0xFF ];
  lineStyle( 5, 0x00ff00 );
  matrice = { a:500,b:0,c:0,d:0,e:200,f:0,g:350,h:200,i:1};
  beginGradientFill( "linear", couleurs, alphas, rapports, matrice );
  moveto(100,100);
  lineto(100,300);
  lineto(600,300);
  lineto(600,100);
  lineto(100,100);
  endFill();
  matrice = { typeDeMatrice:"box", x:100, y:310, l:500, h:200, r:(0/
  180)*Math.PI };
  beginGradientFill( "linear", couleurs, alphas, rapports, matrice );
  moveto(100,310);
  lineto(100,510);
  lineto(600,510);
  lineto(600,310);
  lineto(100,310);
  endFill();
}




Voir aussi
MovieClip.beginFill, MovieClip.endFill, MovieClip.lineStyle, MovieClip.lineTo,
MovieClip.moveTo




                                                                    Dictionnaire ActionScript 319
MovieClip.clear
      Disponibilité
      Flash Player 6.
      Usage
      monClip.clear()
      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; supprime toutes les commandes de dessin associées à un clip. Les formes et les lignes
      qui sont dessinées avec les outils de dessin Flash ne sont pas affectées. L’appel de la méthode
      clear supprime également le style de trait actuel.

      Voir aussi
      MovieClip.lineStyle

MovieClip.createEmptyMovieClip
      Disponibilité
      Flash Player 6.
      Usage
      monClip.createEmptyMovieClip (nomDoccurrence, profondeur)
      Paramètre
      nomDoccurrence        Une chaîne identifiant le nom d’occurrence du nouveau clip.
      profondeur        Un entier spécifiant la profondeur du nouveau clip.
      Renvoie
      Rien.
      Description
      Méthode ; crée un clip vide comme enfant d’un clip existant. Cette méthode se comporte de
      façon semblable à la méthode attachMovie, mais vous n’avez pas besoin de fournir un nom de
      liaison externe pour le nouveau clip. Le point d’alignement d’un clip vide nouvellement créé se
      situe dans le coin supérieur gauche. Cette méthode échoue si un ou plusieurs des paramètres sont
      absents.
      Voir aussi
      MovieClip.attachMovie




320
MovieClip.createTextField
   Disponibilité
   Flash Player 6.
   Usage
   monClip.createTextField (nomDoccurrence, profondeur, x, y, largeur, hauteur)

   Paramètres
   nomDoccurrence        Une chaîne identifiant le nom d’occurrence du nouveau champ de texte.
   profondeur        Un entier positif spécifiant la profondeur du nouveau champ de texte.
   x   Un entier spécifiant la coordonnée x du nouveau champ de texte.
   y   Un entier spécifiant la coordonnée y du nouveau champ de texte.
   largeur    Un entier positif spécifiant la largeur du nouveau champ de texte.
   hauteur    Un entier positif spécifiant la hauteur du nouveau champ de texte.
   Renvoie
   Rien.
   Description
   Méthode ; crée un champ de texte vide comme enfant du clip spécifié par le paramètre monClip.
   Vous pouvez utiliser la méthode createTextField pour créer des champs de texte pendant la
   lecture de l’animation. Le champ de texte est placé à (x, y) avec les dimensions largeur x
   hauteur. Les paramètres x et y sont relatifs au clip container et correspondent aux propriétés _x
   et _y du champ de texte. Les paramètres largeur et hauteur correspondent aux propriétés
   _width et _height du champ de texte.
   Les propriétés par défaut d’un champ de texte sont les suivantes :
   type = "dynamic",
   border = false,
   background = false,
   password = false,
   multiline = false,
   html = false,
   embedFonts = false,
   variable = null,
   maxChars = null




                                                                         Dictionnaire ActionScript 321
      Un champ de texte créé avec createTextField reçoit l’objet TextFormat par défaut suivant :
      font = "Times New Roman"
      size = 12
      textColor = 0x000000
      bold = false
      italic = false,
      underline = false
      url = ""
      target = ""
      align = "left"
      leftMargin = 0
      rightMargin = 0
      indent = 0
      leading = 0
      bullet = false
      tabStops = [] (tableau vide)

      Exemple
      L’exemple suivant crée un champ de texte avec une largeur de 300, une hauteur de 100, une
      coordonnée x de 100, une coordonnée y de 100, aucune bordure, texte rouge et souligné.
      _root.createTextField("monTexte",1,100,100,300,100);
      monTexte.multiline = true;
      monTexte.wordWrap = true;
      monTexte.border = false;

      monFormat = new TextFormat();
      monFormat.color = 0xff0000;
      monFormat.bullet = false;
      monFormat.underline = true;

      monTexte.text = "Ceci est mon premier test de texte d’objet de champ de texte";
      monTexte.setTextFormat(monFormat);

      Voir aussi
      TextFormat (objet)

MovieClip._currentframe
      Disponibilité
      Flash Player 4.
      Usage
      monClip._currentframe

      Description
      Propriété (lecture seule) ; renvoie le numéro de l’image où se trouve actuellement la tête de lecture
      dans le scénario spécifié par monClip.
      Exemple
      L’exemple suivant utilise la propriété _currentframe pour faire avancer la tête de lecture du clip
      actionClip de cinq images par rapport à son emplacement actuel.
      actionClip.gotoAndStop(_currentframe + 5);




322
MovieClip.curveTo
   Disponibilité
   Flash Player 6.
   Usage
   monClip.curveTo (contrôleX, contrôleY, ancreX, ancreY)

   Paramètres
   contrôleX Un entier spécifiant une position horizontale par rapport au point d’alignement du
   clip parent du point de contrôle.
   contrôleY Un entier spécifiant une position verticale par rapport au point d’alignement du
   clip parent du point de contrôle.
   ancreX Un entier spécifiant une position horizontale par rapport au point d’alignement du clip
   parent du point d’ancrage suivant.
   ancreY Un entier spécifiant une position verticale par rapport au point d’alignement du clip
   parent du point d’ancrage suivant.
   Renvoie
   Rien.
   Description
   Méthode ; dessine une courbe avec le style de trait courant de la position de dessin actuelle à
   (ancreX, ancreY), utilisant le point spécifié par (contrôleX, contrôleY). La position de dessin
   actuelle est alors définie sur (ancreX, ancreY). Si le clip dans lequel vous dessinez contient un
   contenu créé avec les outils de dessin Flash, les appels à curveTo sont dessinés en dessous de ce
   contenu. Si vous appelez curveTo avant tout appel à moveTo, la position de dessin actuelle est par
   défaut (0, 0). Cette méthode échoue lorsque des paramètres sont absents et la position de dessin
   courante n’est pas changée.
   Exemple
   L’exemple suivant dessine un cercle avec un trait bleu très fin et un remplissage uni rouge.
   _root.createEmptyMovieClip( "cercle", 1 );
   with ( _root.cercle )
   {
     lineStyle( 0, 0x0000FF, 100 );
     beginFill( 0xFF0000 );
     moveTo( 500, 500 );
     curveTo( 600, 500, 600, 400 );
     curveTo( 600, 300, 500, 300 );
     curveTo( 400, 300, 400, 400 );
     curveTo( 400, 500, 500, 500 );
     endFill();
   }

   Voir aussi
   MovieClip.beginFill, MovieClip.createEmptyMovieClip, MovieClip.endFill,
   MovieClip.lineStyle, MovieClip.lineTo, MovieClip.moveTo




                                                                         Dictionnaire ActionScript 323
MovieClip._droptarget
      Disponibilité
      Flash Player 4.
      Usage
      monClip._droptarget

      Description
      Propriété (lecture seule) ; renvoie le chemin absolu (avec la syntaxe à barre oblique) de
      l’occurrence de clip sur laquelle monClip a été déposé. La propriété _droptarget renvoie
      toujours un chemin commençant par une barre oblique (/). Pour comparer la propriété
      _droptarget d’une occurrence avec une référence, utilisez la fonction eval pour convertir la
      valeur renvoyée de la syntaxe à barre oblique à la syntaxe à point.
      Exemple
      L’exemple suivant évalue la propriété _droptarget de l’occurrence de clip tasDeTrucs et utilise
      eval pour la convertir d’une syntaxe à barre oblique en une référence avec syntaxe à point. La
      référence tasDeTrucs est ensuite comparée avec la référence à l’occurrence de clip poubelle. Si
      les deux références sont équivalentes, la visibilité de tasDeTrucs est définie sur false. Si elles ne
      sont pas équivalentes, l’occurrence tasDeTrucs est redéfinie sur sa position d’origine.
      if (eval(tasDeTrucs._droptarget) == _root.poubelle) {
        tasDeTrucs._visible = false;
      } else {
        tasDeTrucs._x = x_pos;
        tasDeTrucs._y = y_pos;
      }
      Les variables x_pos et y_pos sont définies dans l’image 1 de l’animation avec le script suivant :
      x_pos = tasDeTrucs._x;
      y_pos = tasDeTrucs._y;

      Voir aussi
      startDrag

MovieClip.duplicateMovieClip
      Disponibilité
      Flash Player 5.
      Usage
      monClip.duplicateMovieClip(nouveauNom, profondeur [,objetInit])

      Paramètres
      nouveauNom        Un identifiant unique pour le clip dupliqué.
      profondeur        Un nombre unique spécifiant la profondeur à laquelle l’animation spécifiée doit
      être placée.
      objetInit Un objet contenant les propriétés avec lesquelles remplir le clip dupliqué. Ce
      paramètre permet aux clips créés dynamiquement de recevoir des paramètres. Si objetInit n’est
      pas un objet, il est ignoré. Toutes les propriétés de objetInit sont copiées dans la nouvelle
      occurrence. Les propriétés spécifiées avec objetInit peuvent être utilisées par la fonction
      constructeur. Ce paramètre est facultatif.



324
   Renvoie
   Rien.
   Description
   Méthode ; crée une occurrence du clip spécifié pendant la lecture de l’animation. Les clips
   dupliqués commencent toujours à partir de l’image 1, quelle que soit l’image sur laquelle se
   trouve l’animation originale lorsque la méthode duplicateMovieClip est appelée. Les variables
   du clip parent ne sont pas copiées dans le clip dupliqué. Les clips qui ont été créés avec la méthode
   duplicateMovieClip ne sont pas dupliqués si vous appelez la méthode duplicateMovieMethod
   pour leur parent. Si le clip parent est effacé, le clip dupliqué l’est également. Les clips ajoutés avec
   duplicateMovieClip peuvent être effacés avec l’action ou la méthode removeMovieClip.

   Voir aussi
   duplicateMovieClip, MovieClip.removeMovieClip, removeMovieClip


MovieClip.enabled
   Disponibilité
   Flash Player 6.
   Usage
   monClip.enabled
   Description
   Propriété ; une valeur booléenne indiquant si un clip de bouton est activé. La valeur par défaut de
   enabled est true. Si enabled est défini sur false, les méthodes de rappel et les événements
   d’action on du clip de bouton ne sont plus invoqués et les images Dessus, Abaissé et Haut sont
   désactivées. La propriété enabled n’affecte pas le scénario du clip de bouton ; si un clip est en
   cours de lecture, cette lecture se poursuit. Le clip continue à recevoir des événements de clip (par
   exemple, mouseDown, mouseUp, keyDown et keyUp).
   La propriété enabled régit uniquement les propriétés de type bouton d’un clip de bouton. Vous
   pouvez changer la propriété enabled à tout moment, le clip de bouton modifié étant
   immédiatement activé ou désactivé. La propriété enabled peut être lue à partir d’un objet
   prototype. Si enabled est défini sur false, l’objet n’est pas inclus dans l’ordre de tabulation
   automatique.

MovieClip.endFill
   Disponibilité
   Flash Player 6.
   Usage
   monClip.endFill()

   Paramètres
   Aucun.
   Renvoie
   Rien.




                                                                            Dictionnaire ActionScript 325
      Description
      Méthode ; applique un remplissage aux traits et courbes ajoutés depuis le dernier appel de la
      méthode beginFill ou beginGradientFill. Flash utilise le remplissage spécifié lors de l’appel
      précédent à beginFill ou beginGradientFill. Si la position de dessin actuelle n’est pas égale à
      la position précédente spécifiée dans une méthode moveTo et qu’un remplissage est défini, le trajet
      est fermé avec un trait, puis rempli.

MovieClip.focusEnabled
      Disponibilité
      Flash Player 6.
      Usage
      monClip.focusEnabled
      Description
      Propriété ; si la valeur est undefined ou false, un clip ne peut pas recevoir le focus de saisie, à
      moins qu’il ne s’agisse d’un clip de bouton. Si la propriété focusEnabled a pour valeur true, un
      clip peut recevoir le focus de saisie, même s’il ne s’agit pas d’un clip de bouton.

MovieClip._focusrect
      Disponibilité
      Flash Player 6.
      Usage
      monClip._focusrect

      Description
      Propriété ; une valeur booléenne spécifiant si un rectangle jaune apparaît autour du clip avec
      focus clavier. Cette propriété peut annuler la propriété _focusrect globale.

MovieClip._framesloaded
      Disponibilité
      Flash Player 4.
      Usage
      monClip._framesloaded

      Description
      Propriété (lecture seule) ; le nombre d’images chargées depuis une animation lue en flux continu.
      Cette propriété est utile pour déterminer si le contenu d’une image spécifique, et de toutes les
      images avant elle, a été chargé et est disponible localement dans le navigateur. Cette propriété est
      utile pour contrôler le processus de téléchargement d’animations volumineuses. Par exemple, vous
      pourriez souhaiter afficher un message aux utilisateurs leur indiquant que l’animation est en
      chargement jusqu’à ce qu’une image spécifique dans l’animation soit chargée.




326
   Exemple
   L’exemple suivant utilise la propriété _framesloaded pour démarrer une animation lorsque
   toutes les images sont chargées. Si toutes les images ne sont pas chargées, la propriété _xscale de
   l’occurrence de clip loader est accrue proportionnellement pour créer une barre de progrès.
   if (_framesloaded >= _totalframes) {
     gotoAndPlay ("séquence 1", "start");
   } else {
     _root.loader._xscale = (_framesloaded/_totalframes)*100);
   }

MovieClip.getBounds
   Disponibilité
   Flash Player 5.
   Usage
   monClip.getBounds(espaceDeCoordonnéesCible)

   Paramètres
   espaceDeCoordonnéesCible Le chemin cible du scénario dont vous voulez utiliser le système
   de coordonnées comme point de référence.
   Renvoie
   Un objet avec les propriétés xMin, xMax, yMin et yMax.
   Description
   Méthode ; renvoie des propriétés qui sont les valeurs des coordonnées x et y minimum et
   maximum de l’occurrence spécifiée par monClip pour le paramètre
   espaceDeCoordonnéesCible.

   Remarque Utilisez les méthodes localToGlobal et globalToLocal de l’objet MovieClip pour convertir les
   coordonnées locales du clip en coordonnées de scène ou les coordonnées de scène en coordonnées locales,
   respectivement.

   Exemple
   Dans l’exemple suivant, l’objet que renvoie la méthode getBounds est affecté à l’identifiant
   limitesDeClip. Vous pouvez alors accéder aux valeurs de chaque propriété et les utiliser dans un
   script. Dans ce script, une autre occurrence de clip, clip2, est placée à côté de clip.
   limitesDeClip = clip.getBounds(_root);
   clip2._x = limitesDeClip.xMax;

   Voir aussi
   MovieClip.globalToLocal, MovieClip.localToGlobal


MovieClip.getBytesLoaded
   Disponibilité
   Flash Player 6.
   Usage
   monClip.getBytesLoaded()

   Paramètres
   Aucun.


                                                                               Dictionnaire ActionScript 327
      Renvoie
      Un entier indiquant le nombre d’octets chargés.
      Description
      Méthode ; renvoie le nombre d’octets chargés (en flux continu) pour l’objet MovieClip spécifié.
      Vous pouvez comparer la valeur de la méthode getBytesLoaded avec celle de la méthode
      getBytesTotal pour déterminer le pourcentage d’un clip qui a été chargé.

      Voir aussi
      MovieClip.getBytesTotal

MovieClip.getBytesTotal
      Disponibilité
      Flash Player 5.
      Usage
      monClip.getBytesTotal()

      Paramètres
      Aucun.
      Renvoie
      Un entier indiquant la taille totale, en octets, de l’objet MovieClip spécifié.
      Description
      Méthode ; renvoie la taille, en octets, de l’objet MovieClip spécifié. Pour les clips externes
      (l’animation racine ou un clip chargé dans une cible ou un niveau), la valeur renvoyée correspond
      à la taille du fichier SWF.
      Voir aussi
      MovieClip.getBytesLoaded

MovieClip.getDepth
      Disponibilité
      Flash Player 6.
      Usage
      monClip.getDepth

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie la profondeur d’une occurrence de clip.




328
MovieClip.getURL
   Disponibilité
   Flash Player 5.
   Usage
   monClip.getURL(URL [,fenêtre, variables])

   Paramètres
   URL     L’URL où se trouve le document à obtenir.
   fenêtre     Un paramètre facultatif spécifiant le nom, l’image ou l’expression spécifiant la fenêtre
   ou le cadre HTML dans lequel le document est chargé. Vous pouvez également utiliser un des
   noms cible réservés suivants : _self spécifie l’image courante dans la fenêtre courante, _blank
   spécifie une nouvelle fenêtre, _parent spécifie le parent de l’image courante, _top spécifie l’image
   de premier niveau dans la fenêtre courante.
   variables Un paramètre facultatif spécifiant une méthode d’envoi des variables associées à
   l’animation à charger. S’il n’y a pas de variables, omettez ce paramètre ; sinon, spécifiez si les
   variables doivent être chargées avec une méthode GET ou POST. GET ajoute les variables à la fin de
   l’URL et est utilisée pour des petits nombres de variables. POST envoie les variables dans un en-
   tête HTTP distinct et est utilisée pour les longues chaînes de variables.
   Renvoie
   Rien.
   Description
   Méthode ; charge un document depuis une URL spécifiée dans la fenêtre spécifiée. La méthode
   getURL peut également être utilisée pour transmettre des variables à une autre application définie
   à l’URL avec une méthode GET ou POST.
   Voir aussi
   getURL

MovieClip.globalToLocal
   Disponibilité
   Flash Player 5.
   Usage
   monClip.globalToLocal(point)

   Paramètres
   point Le nom ou l’identifiant d’un objet créé avec l’objet générique Object, spécifiant les
   coordonnées x et y comme propriétés.
   Renvoie
   Rien.
   Description
   Méthode ; convertit les coordonnées de scène (globales) de l’objet point en coordonnées de clip
   (locales).




                                                                          Dictionnaire ActionScript 329
      Exemple
      L’exemple suivant convertit les coordonnées x et y de l’objet point en coordonnées locales du
      clip.
      onClipEvent(mouseMove) {
        point = new object();
        point.x = _root._xmouse;
        point.y = _root._ymouse;
        globalToLocal(point);
        trace(_root._xmouse + " " + _root._ymouse);
        trace(point.x + " " + point.y);
        updateAfterEvent();
      }

      Voir aussi
      MovieClip.getBounds, MovieClip.localToGlobal


MovieClip.gotoAndPlay
      Disponibilité
      Flash Player 5.
      Usage
      monClip.gotoAndPlay(image)

      Paramètres
      image    Le numéro de l’image à laquelle la tête de lecture est envoyée.
      Renvoie
      Rien.
      Description
      Méthode ; démarre la lecture de l’animation à partir de l’image spécifiée.
      Voir aussi
      gotoAndPlay

MovieClip.gotoAndStop
      Disponibilité
      Flash Player 5.
      Usage
      monClip.gotoAndStop(image)

      Paramètres
      image    Le numéro de l’image à laquelle la tête de lecture est envoyée.
      Renvoie
      Rien.
      Description
      Méthode ; envoie la tête de lecture à l’image spécifiée de ce clip et l’arrête.
      Voir aussi
      gotoAndStop



330
MovieClip._height
   Disponibilité
   Flash Player 4.
   Usage
   monClip._height

   Description
   Propriété ; définit et récupère la hauteur du clip, en pixels.
   Exemple
   L’exemple de code suivant définit la hauteur et la largeur d’un clip lorsque l’utilisateur clique sur
   la souris.
   onClipEvent(mouseDown) {
     _width=200;
     _height=200;
   }

MovieClip._highquality
   Disponibilité
   Flash Player 6.
   Usage
   monClip._highquality

   Description
   Propriété (globale) ; spécifie le niveau d’anti-alias appliqué à l’animation en cours. Spécifiez 2
   (qualité maximum) pour appliquer une qualité élevée avec le lissage bitmap toujours actif.
   Spécifiez 1 (qualité élevée) pour appliquer l’anti-alias ; cela lissera les bitmaps si le clip ne contient
   pas d’animation. Spécifiez 0 (faible qualité) pour empêcher l’anti-alias. Cette propriété peut
   supplanter la propriété _highquality globale.
   Exemple
   monClip._highquality = 1;

   Voir aussi
   _quality, toggleHighQuality


MovieClip.hitArea
   Disponibilité
   Flash Player 6.
   Usage
   monClip.hitArea
   Renvoie
   Une référence à un clip.




                                                                              Dictionnaire ActionScript 331
      Description
      Propriété ; désigne un autre clip qui servira de zone active pour un clip de bouton. Si la propriété
      hitArea n’existe pas ou est null ou undefined, le clip de bouton même est utilisé en tant que
      zone active. La valeur de la propriété hitArea peut être une référence à un objet de clip.
      Vous pouvez changer la propriété hitArea à tout moment, le clip de bouton modifié prenant
      immédiatement le nouveau comportement. Le clip désigné comme zone active n’a pas besoin
      d’être visible, sa forme graphique, bien que non visible, étant soumise à un test d’accès. La
      propriété hitArea peut être lue à partir d’un objet prototype.

MovieClip.hitTest
      Disponibilité
      Flash Player 5.
      Usage
      monClip.hitTest(x, y, baliseDeForme)
      monClip.hitTest(cible)

      Paramètres
      x   La coordonnée x de la zone d’accès sur la scène.
      y   La coordonnée y de la zone d’accès sur la scène.
      Les coordonnées x et y sont définies dans l’espace de coordonnées global.
      cible Le chemin cible de la zone active pouvant croiser ou chevaucher l’occurrence spécifiée
      par monClip. Le paramètre cible représente généralement un bouton ou un champ de saisie de
      texte.
      baliseDeForme Une valeur booléenne spécifiant s’il faut évaluer la forme entière de
      l’occurrence spécifiée (true) ou seulement le cadre de délimitation (false). Ce paramètre ne
      peut être spécifié que si la zone sensible est identifiée avec les paramètres de coordonnées x et y.
      Renvoie
      Rien.
      Description
      Méthode ; évalue l’occurrence spécifiée par monClip pour voir si elle recouvre ou croise la zone
      identifiée par cible ou les paramètres de coordonnées x et y.
      Usage 1. Compare les coordonnées x et y avec la forme ou le cadre de délimitation de l’occurrence
      spécifiée, en fonction du paramètre baliseDeForme. Si baliseDeForme est défini sur true, seule
      la zone occupée actuellement par l’occurrence sur la scène est évaluée, et si x et y se recouvrent,
      une valeur true est renvoyée. Cela est utile pour déterminer si le clip se trouve dans une zone
      sensible spécifiée.
      Usage 2. Evalue les cadres de délimitation de cible et de l’occurrence spécifiée et renvoie true
      s’ils se croisent ou se recouvrent en un point.
      Exemple
      L’exemple suivant utilise hitTest avec les propriétés x_mouse et y_mouse pour déterminer si la
      souris se trouve sur le cadre de délimitation de la cible :
      if (hitTest( _root._xmouse, _root._ymouse, false));




332
   L’exemple suivant utilise hitTest pour déterminer si le clip balle recouvre ou croise le clip
   carré :
   if(_root.balle, hittest(_root.carré)){
     trace("balle croise carré");
   }

   Voir aussi
   MovieClip.getBounds, MovieClip.globalToLocal, MovieClip.localToGlobal


MovieClip.lineStyle
   Disponibilité
   Flash Player 6.
   Usage
   monClip.lineStyle ([épaisseur[, rvb[, alpha]]])

   Paramètres
   épaisseur Un entier qui indique l’épaisseur du trait en points, les valeurs valides allant de 0 à
   255. Si aucun nombre n’est spécifié, ou si le paramètre est undefined, aucune ligne n’est tracée.
   Si une valeur inférieure à 0 est transmise, Flash utilise 0. La valeur 0 indique une épaisseur très
   fine, l’épaisseur maximum étant 255. Si une valeur supérieure à 255 est transmise, l’interprète de
   Flash utilise 255.
   rvb  Une valeur chromatique hexadécimale (par exemple, le rouge est 0xFF0000, le bleu est
   0x0000FF, etc.) de la ligne. Si aucune valeur n’est indiquée, Flash utilise 0x000000 (noir).
   alpha Un entier indiquant la valeur alpha de la couleur du trait (les valeurs valides sont 0–100).
   Lorsque aucune valeur n’est indiquée, Flash utilise 100 (uni). Si la valeur est inférieure à 0, Flash
   utilise 0. Si la valeur est supérieure à 100, Flash utilise 100.
   Renvoie
   Rien.
   Description
   Méthode ; spécifie un style de trait que Flash utilise pour les appels ultérieurs aux méthodes
   lineTo et curveTo, jusqu’à ce que vous appeliez lineStyle avec des paramètres différents. Vous
   pouvez appeler la méthode lineStyle au milieu d’une opération de dessin d’un trajet pour
   spécifier différents styles pour différents segments de ligne au sein d’un trajet.
   Remarque Les appels de clear réinitialisent la méthode lineStyle à undefined.




                                                                             Dictionnaire ActionScript 333
      Exemple
      Le code suivant trace un triangle avec un trait magenta de 5 points et aucun remplissage.
      _root.createEmptyMovieClip( "triangle", 1 );
      with ( _root.triangle )
      {
      lineStyle( 5, 0xff00ff, 100 );
      moveTo(200, 200);
      lineTo( 300,300 );
      lineTo(100, 300);
      lineTo(200, 200);
      }

      Voir aussi
      MovieClip.beginFill, MovieClip.beginGradientFill, MovieClip.clear,
      MovieClip.curveTo, MovieClip.lineTo, MovieClip.moveTo,


MovieClip.lineTo
      Disponibilité
      Flash Player 6.
      Usage
      monClip.lineTo (x, y)

      Paramètres
      x   Un entier indiquant la position horizontale par rapport au point d’alignement du clip parent.
      y   Un entier indiquant la position verticale par rapport au point d’alignement du clip parent.
      Renvoie
      Rien.
      Description
      Méthode ; dessine une ligne avec le style de trait courant de la position actuelle à (x, y), la
      position de dessin actuelle étant alors définie à (x, y). Si le clip dans lequel vous dessinez contient
      un contenu créé avec les outils de dessin de Flash, les appels à lineTo sont dessinés en dessous de
      ce contenu. Si vous appelez la méthode lineTo avant tout appel à la méthode moveTo, la position
      de dessin actuelle est par défaut (0, 0). Cette méthode échoue lorsque des paramètres sont absents
      et la position de dessin courante n’est pas changée.




334
   Exemple
   L’exemple suivant trace un triangle sans trait et avec un remplissage bleu partiellement
   transparent.
   _root.createEmptyMovieClip( "triangle", 1 );
     with (_root.triangle){
        beginFill (0x0000FF, 50);
        lineStyle (5, 0xFF00FF, 100);
        moveTo( 200, 200 );
        lineTo (300, 300);
        lineTo (100, 300);
        lineTo (200, 200);
        endFill();
   }

   Voir aussi
   MovieClip.beginFill, MovieClip.createEmptyMovieClip, MovieClip.endFill,
   MovieClip.lineStyle, MovieClip.moveTo


MovieClip.loadMovie
   Disponibilité
   Flash Player 5.
   Usage
   monClip.loadMovie("url" [,variables])

   Paramètres
   url    Une URL absolue ou relative du fichier SWF ou JPEG à charger. Un chemin relatif doit
   être relatif au fichier SWF à _level0. L’URL doit se trouver dans le même sous-domaine que
   l’URL à laquelle l’animation réside. Pour une utilisation dans Flash Player ou pour un test en
   mode test d’animation dans l’application de programmation de 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 ni de disque.
   variables Un paramètre facultatif spécifiant une méthode HTTP d’envoi ou de chargement
   des variables. Le paramètre doit être la chaîne GET ou POST. Omettez ce paramètre si aucune
   variable ne doit être envoyée. La méthode GET ajoute les variables à la fin de l’URL et est utilisée
   pour des petits nombres de variables. La méthode POST envoie les variables dans un en-tête
   HTTP distinct et est utilisée pour les longues chaînes de variables.
   Renvoie
   Rien.
   Description
   Méthode ; charge des fichiers SWF ou JPEG dans un clip dans Flash Player en cours de lecture de
   l’animation d’origine. Sans la méthode loadMovie, Flash Player affiche une seule animation
   (fichier SWF) avant de quitter. La méthode loadMovie vous permet d’afficher plusieurs
   animations en une fois et de basculer entre des animations sans charger un autre document
   HTML.
   Une animation ou image chargée dans un clip hérite de ses propriétés de position, rotation et
   échelle. Vous pouvez utiliser le chemin cible du clip pour cibler l’animation chargée.




                                                                          Dictionnaire ActionScript 335
      Utilisez la méthode unloadMovie pour retirer les animations ou images chargées avec la méthode
      loadMovie. Utilisez la méthode loadVariables pour garder l’animation active et mettre les
      variables à jour avec de nouvelles valeurs.
      Voir aussi
      loadMovie, loadMovieNum, MovieClip.loadVariables, MovieClip.unloadMovie,
      unloadMovie, unloadMovieNum


MovieClip.loadVariables
      Disponibilité
      Flash Player 5.
      Usage
      monClip.loadVariables("url", variables)

      Paramètres
      url   L’URL absolue ou relative pour le fichier externe contenant les variables à charger. L’hôte
      de l’URL doit se trouver dans le même sous-domaine que le clip.
      variables Un paramètre facultatif spécifiant une méthode HTTP d’envoi des variables. Le
      paramètre doit être la chaîne GET ou POST. Omettez ce paramètre si aucune variable ne doit être
      envoyée. La méthode GET ajoute les variables à la fin de l’URL et est utilisée pour des petits
      nombres de variables. La méthode POST envoie les variables dans un en-tête HTTP distinct et est
      utilisée pour les longues chaînes de variables.
      Renvoie
      Rien.
      Description
      Méthode ; lit les données depuis un fichier externe et définit les valeurs pour les variables de
      monClip. Le fichier externe peut être un fichier texte généré par un script CGI, ASP ou PHP, et
      peut contenir n’importe quel nombre de variables.
      Cette méthode peut également être utilisée pour mettre à jour des variables dans le clip actif avec
      de nouvelles valeurs.
      Cette méthode nécessite que le texte de l’URL soit au format standard MIME : application/x-
      www-form-urlencoded    (format script CGI).
      Voir aussi
      loadMovie, loadVariables, loadVariablesNum, MovieClip.unloadMovie


MovieClip.localToGlobal
      Disponibilité
      Flash Player 5.
      Usage
      monClip.localToGlobal(point)

      Paramètres
      point   Le nom ou l’identifiant d’un objet créé avec l’objet Object, spécifiant les coordonnées x
      et y comme propriétés.


336
  Renvoie
  Rien.
  Description
  Méthode ; convertit les coordonnées du clip (locales) de l’objet point en coordonnées de scène
  (globales).
  Exemple
  L’exemple suivant convertit les coordonnées x et y de l’objet point, des coordonnées du clip
  (locales) en coordonnées de scène (globales). Les coordonnées locales x et y sont spécifiées en
  utilisant les propriétés _xmouse et _ymouse pour récupérer les coordonnées x et y de la position
  de la souris.
  onClipEvent(mouseMove) {
    point = new object();
    point.x = _xmouse;
    point.y = _ymouse;
    _root.out3 = point.x + " === " + point.y;
    _root.out = _root._xmouse + " === " + _root._ymouse;
    localToGlobal(point);
    _root.out2 = point.x + " === " + point.y;
    updateAfterEvent();
  }

  Voir aussi
  MovieClip.globalToLocal

MovieClip.moveTo
  Disponibilité
  Flash Player 6.
  Usage
  monClip.moveTo (x, y)

  Paramètres
  x   Un entier indiquant la position horizontale par rapport au point d’alignement du clip parent.
  y   Un entier indiquant la position verticale par rapport au point d’alignement du clip parent.
  Renvoie
  Rien.
  Description
  Méthode ; place la position de dessin actuelle à (x, y). Cette méthode échoue lorsque des
  paramètres sont absents et la position de dessin courante n’est pas changée.




                                                                       Dictionnaire ActionScript 337
      Exemple
      Cet exemple trace un triangle avec un trait magenta de 5 points et aucun remplissage. La première
      ligne crée un clip vide pour commencer le dessin. Un type de trait est défini, à l’intérieur de
      l’instruction with, puis la position de dessin de début est indiquée par la méthode moveTo.
      _root.createEmptyMovieClip( "triangle", 1 );
      with ( _root.triangle )
      {
      lineStyle( 5, 0xff00ff, 100 );
      moveTo(200, 200);
      lineTo( 300,300 );
      lineTo(100, 300);
      lineTo(200, 200);
      }

      Voir aussi
      MovieClip.createEmptyMovieClip, MovieClip.lineStyle, MovieClip.lineTo


MovieClip._name
      Disponibilité
      Flash Player 4.
      Usage
      monClip._name

      Description
      Propriété ; renvoie le nom d’occurrence du clip spécifié par monClip.

MovieClip.nextFrame
      Disponibilité
      Flash Player 5.
      Usage
      monClip.nextFrame()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; envoie la tête de lecture à l’image suivante et l’arrête.
      Voir aussi
      nextFrame




338
MovieClip.onData
   Disponibilité
   Flash Player 6.
   Usage
   monClip.onData

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsqu’un clip reçoit des données d’un appel loadVariables
   ou loadMovie.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
   Exemple
   L’exemple suivant définit une fonction pour la méthode onData qui envoie une action trace à la
   fenêtre Sortie.
   monClip.onData = function () {
      trace ("onData appelé");
   };

MovieClip.onDragOut
   Disponibilité
   Flash Player 6.
   Usage
   monClip.onDragOver

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque le pointeur est enfoncé et sorti avant d’être ramené
   au-dessus du clip.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.




                                                                       Dictionnaire ActionScript 339
      Exemple
      L’exemple suivant définit une fonction pour la méthode onDragOut qui envoie une action trace
      à la fenêtre Sortie.
      monClip.onDragOut = function () {
         trace ("onDragOut appelé");
      };

      Voir aussi
      MovieClip.onDragOver

MovieClip.onDragOver
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onDragOver

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsque le pointeur est enfoncé et sorti avant d’être ramené
      au-dessus du clip.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onDragOut qui envoie une action trace
      à la fenêtre Sortie.
      monClip.onDragOver = function () {
         trace ("onDragOver appelé");
      };

      Voir aussi
      MovieClip.onDragOut

MovieClip.onEnterFrame
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onEnterFrame

      Paramètres
      Aucun.
      Renvoie
      Rien.




340
  Description
  Gestionnaire d’événement ; invoqué continuellement à la cadence de l’animation. Les actions
  associées à l’événement de clip enterFrame sont traitées avant les actions associées aux images
  affectées.
  Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
  Exemple
  L’exemple suivant définit une fonction pour la méthode onEnterFrame qui envoie un trace à la
  fenêtre Sortie.
  monClip.onEnterFrame = function () {
     trace ("onEnterFrame appelé");
  };

MovieClip.onKeyDown
  Disponibilité
  Flash Player 6.
  Usage
  monClip.onKeyDown

  Paramètres
  Aucun.
  Renvoie
  Rien.
  Description
  Gestionnaire d’événement ; invoqué lorsqu’un clip a le focus de saisie et qu’une touche est
  enfoncée. L’événement onKeyDown est invoqué sans paramètres. Vous pouvez utiliser les
  méthodes Key.getAscii et Key.getCode pour prendre connaissance de la touche enfoncée.
  Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
  Exemple
  L’exemple suivant définit une fonction pour la méthode onKeyDown qui envoie une action trace
  à la fenêtre Sortie :
  monClip.onKeyDown = function () {
     trace ("onKeyDown appelé");
  };

  Voir aussi
  MovieClip.onKeyUp




                                                                       Dictionnaire ActionScript 341
MovieClip.onKeyUp
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onKeyUp

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Evénement ; invoqué lorsqu’une touche est relâchée. L’événement onKeyUp est invoqué sans
      paramètres. Vous pouvez utiliser les méthodes Key.getAscii et Key.getCode pour prendre
      connaissance de la touche enfoncée.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onKeyPress qui envoie une action
      trace à la fenêtre Sortie.
      monClip.onKeyUp = function () {
         trace ("onKeyUp appelé");
      };

MovieClip.onKillFocus
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onKillFocus = function (nouveauFocus) {
      instructions;
      };
      Paramètres
      nouveauFocus      L’objet recevant le focus clavier.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; un événement invoqué lorsqu’un clip perd le focus clavier. La
      méthode onKillFocus reçoit un paramètre, nouveauFocus, qui est un objet représentant le
      nouvel objet recevant le focus. Si aucun objet ne reçoit le focus, nouveauFocus contient la valeur
      null.




342
MovieClip.onLoad
   Disponibilité
   Flash Player 6.
   Usage
   monClip.onLoad

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque le clip est instancié et apparaît dans le scénario.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
   Exemple
   L’exemple suivant définit une fonction pour la méthode onLoad qui envoie une action trace à la
   fenêtre Sortie :
   monClip.onLoad = function () {
      trace ("onLoad appelé");
   };

MovieClip.onMouseDown
   Disponibilité
   Flash Player 6.
   Usage
   monClip.onMouseDown

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque le bouton de la souris est enfoncé.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
   Exemple
   L’exemple suivant définit une fonction pour la méthode onMouseDown qui envoie une action
   trace à la fenêtre Sortie :
   monClip.onMouseDown = function () {
     trace ("onMouseDown appelé");
   }




                                                                         Dictionnaire ActionScript 343
MovieClip.onMouseMove
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onMouseMove

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsque la souris se déplace.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onMouseMove qui envoie une action
      trace à la fenêtre Sortie.
      monClip.onMouseMove = function () {
         trace ("onMouseMove appelé");
      };

MovieClip.onMouseUp
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onMouseUp

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsque la souris est relâchée.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onMouseUp qui envoie une action trace
      à la fenêtre Sortie.
      monClip.onMouseUp = function () {
        trace ("onMouseUp appelé");
      };




344
MovieClip.onPress
   Disponibilité
   Flash Player 6.
   Usage
   monClip.onPress

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque le bouton de la souris est enfoncé alors que le
   pointeur au-dessus d'un clip.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
   Exemple
   L’exemple suivant définit une fonction pour la méthode onPress qui envoie une action trace à
   la fenêtre Sortie.
   monClip.onPress = function () {
      trace ("onPress appelé");
   };

MovieClip.onRelease
   Disponibilité
   Flash Player 6.
   Usage
   monClip.onRelease

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsqu’un clip de bouton est relâché.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
   Exemple
   L’exemple suivant définit une fonction pour la méthode onPress qui envoie une action trace à
   la fenêtre Sortie.
   monClip.onRelease = function () {
      trace ("onRelease appelé");
   };




                                                                       Dictionnaire ActionScript 345
MovieClip.onReleaseOutside
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onReleaseOutside

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsque la souris est relâchée pendant que le pointeur se
      trouve au dehors du clip après l’enfoncement du bouton pendant que le pointeur est à l’intérieur
      du clip.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onReleaseOutside qui envoie une
      action trace à la fenêtre Sortie.
      monClip.onReleaseOutside = function () {
         trace ("onReleaseOutside appelé");
      };

MovieClip.onRollOut
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onRollOut

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué lorsque le pointeur passe à l’extérieur d’un clip.
      Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onRollOut qui envoie une action trace
      à la fenêtre Sortie.
      monClip.onRollOut = function () {
         trace ("onRollOut appelé");
      };




346
MovieClip.onRollOver
   Disponibilité
   Flash Player 6.
   Usage
   monClip.onRollOver

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque le pointeur passe au-dessus d’un clip.
   Vous devez définir une fonction exécutée lorsque l’événement est invoqué.
   Exemple
   L’exemple suivant définit une fonction pour la méthode onRollOver qui envoie une action
   trace à la fenêtre Sortie.
   monClip.onRollOver = function () {
      trace ("onRollOver appelé");
   };

MovieClip.onSetFocus
   Disponibilité
   Flash Player 6.
   Usage
   monClip.onSetFocus = function(ancienFocus){
   instructions;
   };

   Paramètres
   ancienFocus       L’objet devant perdre le focus.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsqu’un clip reçoit le focus clavier. Le paramètre
   ancienFocus est l’objet perdant le focus. Par exemple, si l’utilisateur appuie sur la touche Tab
   pour faire passer le focus de saisie d’un clip à un champ de texte, ancienFocus contient
   l’occurrence de clip.
   Si aucun objet n’a précédemment reçu le focus, ancienFocus contient une valeur null.




                                                                         Dictionnaire ActionScript 347
MovieClip.onUnload
      Disponibilité
      Flash Player 6.
      Usage
      monClip.onUnload

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; invoqué dans la première image après la suppression du clip du
      scénario. Les actions associées à l’événement onUnload sont traitées avant que des actions soient
      associées à l’image affectée. Vous devez définir une fonction exécutée lorsque l’événement est
      invoqué.
      Exemple
      L’exemple suivant définit une fonction pour la méthode onUnload qui envoie une action trace à
      la fenêtre Sortie.
      monClip.onUnload = function () {
         trace ("onUnload appelé");
      };

MovieClip._parent
      Disponibilité
      Flash Player 6.
      Usage
      monClip._parent.propriété
      _parent._parent.propriété

      Description
      Propriété ; spécifie ou renvoie une référence au clip ou objet contenant le clip ou objet courant.
      L’objet courant est l’objet contenant le code ActionScript faisant référence à _parent. Utilisez la
      propriété _parent pour spécifier un chemin relatif aux clips ou objets qui se trouvent au-dessus
      du clip ou objet actuel.
      Voir aussi
      _root, targetPath




348
MovieClip.play
   Disponibilité
   Flash Player 5.
   Usage
   monClip.play()

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Méthode ; déplace la tête de lecture dans le clip.
   Voir aussi
   play

MovieClip.prevFrame
   Disponibilité
   Flash Player 5.
   Usage
   monClip.prevFrame()

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Méthode ; envoie la tête de lecture à l’image précédente et l’arrête.
   Voir aussi
   prevFrame

MovieClip.removeMovieClip
   Disponibilité
   Flash Player 5.
   Usage
   monClip.removeMovieClip()

   Paramètres
   Aucun.
   Renvoie
   Rien.




                                                                           Dictionnaire ActionScript 349
      Description
      Méthode ; supprime une occurrence de clip créée avec l’action duplicateMovieclip ou avec les
      méthodes duplicateMovieClip ou attachMovie de l’objet MovieClip.
      Voir aussi
      MovieClip.attachMovie, MovieClip.attachMovie, removeMovieClip,
      MovieClip.attachMovie


MovieClip._rotation
      Disponibilité
      Flash Player 4.
      Usage
      monClip._rotation

      Description
      Propriété ; spécifie la rotation du clip, en degrés.

MovieClip.setMask
      Disponibilité
      Flash Player 6.
      Usage
      monClip.setMask (clipDeMasque)
      Paramètres
      monClip      Le nom d’occurrence d’un clip devant être masqué.
      clipDeMasque      Le nom d’occurrence d’un clip devant être un masque.
      Renvoie
      Rien.
      Description
      Méthode ; transforme le clip du paramètre clipDeMasque en masque révélant le clip spécifié par
      le paramètre monClip.
      La méthode setMask permet à des clips multi-images, avec un contenu complexe multi-calques,
      d’agir en tant que masques. Vous pouvez activer et désactiver les masques à l’exécution.
      Cependant, vous ne pouvez pas utiliser le même masque pour masquer plusieurs objets (ce qui est
      possible en utilisant des calques de masque). Les polices de périphérique présentes dans un clip
      masqué sont tracées mais pas masquées. Vous ne pouvez pas définir un clip comme étant son
      propre masque, par exemple mc.setMask(mc).
      Si vous créez un calque de masque qui contient un clip, puis que vous lui appliquez la méthode
      setMask, l’appel setMask est prioritaire et son effet est irréversible. Par exemple, vous pourriez
      avoir un clip dans un calque de masque appelé MasqueUI qui masque un autre calque contenant
      un autre clip appelé MasquéUI. Si, à la lecture de l’animation, vous appelez
      MasqueUI.setMask(MasquéUI), à partir de ce moment-là, MasqueUI est masqué par MasquéUI.




350
   Pour annuler un masque créé avec ActionScript, transmettez la valeur null à la méthode
   setMask. Le code suivant annule le masque sans affecter le calque de masque dans le scénario.
   MasqueUI.setMask(null)

   Exemple
   L’exemple de code suivant utilise le clip masqueCercle pour masquer le clip leMasqué.
   leMasqué.setMask(masqueCercle);

MovieClip._soundbuftime
   Disponibilité
   Flash Player 6.
   Usage
   monClip._soundbuftime

   Description
   Propriété (globale) ; un entier spécifiant le nombre de secondes de mise en tampon d’un son avant
   sa lecture en flux continu.

MovieClip.startDrag
   Disponibilité
   Flash Player 5.
   Usage
   monClip.startDrag([verrouiller, [gauche, haut, droite, bas]])

   Paramètres
   verrouiller      Une valeur booléenne spécifiant si le clip glissable est verrouillé au centre de la
   position de la souris (true) ou verrouillé sur le point auquel l’utilisateur a cliqué sur le clip
   (false). Ce paramètre est facultatif.
   gauche, haut, droite, bas Valeurs relatives aux coordonnées du parent du clip spécifiant un
   rectangle de contrainte pour le clip. Ces paramètres sont facultatifs.
   Renvoie
   Rien.
   Description
   Méthode ; permet à l’utilisateur de faire glisser le clip spécifié. L’animation reste déplaçable
   jusqu’à ce qu’elle soit explicitement arrêtée par l’appel de la méthode stopDrag ou jusqu’à ce
   qu’un autre clip devienne déplaçable. On ne peut faire glisser qu’un seul clip à la fois.
   Voir aussi
   MovieClip._droptarget, MovieClip.startDrag, MovieClip.stopDrag




                                                                           Dictionnaire ActionScript 351
MovieClip.stop
      Disponibilité
      Flash Player 5.
      Usage
      monClip.stop()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; arrête la lecture du clip courant.
      Voir aussi
      stop

MovieClip.stopDrag
      Disponibilité
      Flash Player 5.
      Usage
      monClip.stopDrag()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; envoie une méthode startDrag. Une animation rendue déplaçable avec la méthode
      startDrag reste déplaçable jusqu’à l’ajout d’une méthode stopDrag ou jusqu’à ce qu’une autre
      animation devienne déplaçable. On ne peut faire glisser qu’un seul clip à la fois.
      Voir aussi
      MovieClip._droptarget, MovieClip.startDrag, stopDrag




352
MovieClip.swapDepths
   Disponibilité
   Flash Player 5.
   Usage
   monClip.swapDepths(profondeur)
   monClip.swapDepths(cible)

   Paramètres
   cible L’occurrence de clip dont la profondeur est permutée avec      l’occurrence spécifiée par
   monClip. Les deux occurrences doivent avoir le même clip parent.

   profondeur        Un nombre spécifiant le niveau de profondeur auquel monClip doit être placé.
   Renvoie
   Rien.
   Description
   Méthode ; permute l’ordre d’empilement, ou « ordre z » (niveau de profondeur), de l’occurrence
   spécifiée (monClip) avec l’animation spécifiée par le paramètre cible, ou avec l’animation
   occupant actuellement le niveau spécifié dans le paramètre profondeur. Les deux animations
   doivent avoir le même clip parent. La permutation du niveau de profondeur des clips a pour effet
   de déplacer une animation devant ou derrière l’autre. Si une animation est en cours
   d’interpolation lorsque cette méthode est appelée, l’interpolation est arrêtée.
   Voir aussi
   _level

MovieClip.tabChildren
   Disponibilité
   Flash Player 6.
   Usage
   monClip.tabChildren

   Description
   Propriété ; undefined par défaut. Si tabChildren est undefined ou true, les enfants du clip
   sont inclus dans l’ordre de tabulation automatique. Si la valeur de tabChildren est false, les
   enfants du clip ne sont pas inclus dans l’ordre de tabulation automatique.
   Exemple
   Un objet d’interface de zone de liste construit en tant que clip contient plusieurs éléments. Il est
   possible de cliquer sur chaque élément pour le sélectionner, chaque élément étant donc un
   bouton. Cependant, seule la zone de liste même devrait être un arrêt de tabulation. Les éléments à
   l’intérieur de la zone de liste devraient être exclus de l’ordre de tabulation. Pour ce faire, la
   propriété tabChildren de la zone de liste devrait être définie sur false.




                                                                          Dictionnaire ActionScript 353
      La propriété tabChildren n’a aucun effet si la propriété tabIndex est utilisée et n’affecte que
      l’ordre de tabulation automatique.
      Voir aussi
      Button.tabIndex, TextField.tabIndex


MovieClip.tabEnabled
      Disponibilité
      Flash Player 6.
      Usage
      monClip.tabEnabled
      Description
      Propriété ; peut être définie pour une occurrence des objets MovieClip, Button ou TextField.
      Valeur undefined par défaut.
      Si la propriété tabEnabled est undefined ou true, l’objet est inclus dans l’ordre de tabulation
      automatique. Si la propriété tabIndex est également définie avec une valeur, l’objet est également
      inclus dans l’ordre de tabulation automatique. Si tabEnabled est false, l’objet n’est pas inclus
      dans l’ordre de tabulation automatique. Pour un clip, si tabEnabled est false, les enfants du clip
      peuvent toujours être inclus dans l’ordre de tabulation automatique, à moins que la propriété
      tabChildren ait également été définie sur false.

      Voir aussi
      MovieClip.tabChildren, MovieClip.tabIndex


MovieClip.tabIndex
      Disponibilité
      Flash Player 6.
      Usage
      monClip.tabIndex
      Description
      Propriété ; permet de définir l’ordre de tabulation automatique des objets d’une animation. La
      propriété tabIndex est undefined par défaut. Vous pouvez définir tabIndex pour une
      occurrence de bouton, de clip ou de champ de texte.
      Si un objet de l’animation Flash contient une propriété tabIndex, l’ordre de tabulation
      automatique est désactivé, et l’ordre de tabulation est calculé en fonction des propriétés tabIndex
      des objets de l’animation. L’ordre de tabulation personnalisé n’inclut que les objets possédant des
      propriétés tabIndex.
      La propriété tabIndex doit être un entier positif. Les objets sont placés dans l’ordre
      correspondant à leurs propriétés tabIndex, dans un ordre croissant. Un objet avec une propriété
      tabIndex dont la valeur est 1 précède un objet avec une valeur tabIndex de 2. L’ordre de
      tabulation personnalisé ignore les relations hiérarchiques entre les objets d’une animation Flash.
      Tous les objets de l’animation Flash munis de propriétés tabIndex sont placés dans l’ordre de
      tabulation. Vous ne devriez pas utiliser la même valeur tabIndex pour plusieurs objets.




354
MovieClip._target
   Disponibilité
   Flash Player 4.
   Usage
   monClip._target

   Description
   Propriété (lecture seule) ; renvoie le chemin cible de l’occurrence de clip spécifiée dans le
   paramètre monClip.

MovieClip._totalframes
   Disponibilité
   Flash Player 4.
   Usage
   monClip._totalframes

   Description
   Propriété (lecture seule) ; renvoie le nombre total d’images de l’occurrence de clip spécifiée dans le
   paramètre monClip.

MovieClip.trackAsMenu
   Disponibilité
   Flash Player 6.
   Usage
   monClip.trackAsMenu
   Description
   Propriété ; une propriété booléenne qui indique si d’autres boutons ou clips peuvent recevoir des
   événements de relâchement de bouton de souris Cela vous permet de créer des menus. Vous
   pouvez définir la propriété trackAsMenu pour n’importe quel objet de bouton ou clip. Si la
   propriété trackAsMenu n’existe pas, le comportement par défaut est false.
   Vous pouvez changer la propriété trackAsMenu à tout moment, le clip de bouton modifié
   prenant immédiatement le nouveau comportement.
   Voir aussi
   Button.trackAsMenu

MovieClip.unloadMovie
   Disponibilité
   Flash Player 5.
   Usage
   monClip.unloadMovie()

   Paramètres
   Aucun.


                                                                           Dictionnaire ActionScript 355
      Renvoie
      Rien.
      Description
      Méthode ; supprime un clip chargé avec les méthodes loadMovie ou attachMovie de l’objet
      MovieClip.
      Voir aussi
      MovieClip.attachMovie, MovieClip.loadMovie, unloadMovie, unloadMovieNum


MovieClip._url
      Disponibilité
      Flash Player 4.
      Usage
      monClip._url

      Description
      Propriété (lecture seule) ; récupère l’URL du fichier SWF d’où le clip a été téléchargé.

MovieClip.useHandCursor
      Disponibilité
      Flash Player 6.
      Usage
      monClip.useHandCursor
      Description
      Propriété ; une valeur booléenne indiquant si le curseur de main est affiché lorsque la souris passe
      au-dessus d’un clip de bouton. La valeur par défaut de useHandCursor est true. Si
      useHandCursor est défini sur true, le curseur de main standard utilisé pour les boutons est
      affiché lorsque la souris passe au-dessus d’un clip de bouton. Si useHandCursor est false, c’est le
      curseur de flèche qui est utilisé.
      Vous pouvez changer la propriété useHandCursor à tout moment, le clip de bouton modifié
      prenant immédiatement le nouveau comportement. La propriété useHandCursor peut être lue à
      partir d’un objet prototype.

MovieClip._visible
      Disponibilité
      Flash Player 4.
      Usage
      monClip._visible

      Description
      Propriété ; une valeur booléenne indiquant si l’animation spécifiée par le paramètre monClip est
      visible. Les clips qui ne sont pas visibles (propriété _visible définie sur false) sont désactivés.
      Par exemple, un bouton d’un clip dont la propriété _visible est définie sur false ne peut pas
      être cliqué.


356
MovieClip._width
   Disponibilité
   Flash Player 4 en tant que propriété en lecture seule.
   Usage
   monClip._width

   Description
   Propriété ; définit et récupère la largeur du clip, en pixels.
   Exemple
   L’exemple suivant définit les propriétés de hauteur et de largeur d’un clip lorsque l’utilisateur
   clique sur la souris.
   onclipEvent(mouseDown) {
     _width=200;
     _height=200;
   }

   Voir aussi
   MovieClip._height

MovieClip._x
   Disponibilité
   Flash Player 3.
   Usage
   monClip._x

   Description
   Propriété ; un entier définissant la coordonnée x de l’animation par rapport aux coordonnées
   locales du clip parent. Si un clip se trouve dans le scénario principal, son système de coordonnées
   fait référence au coin supérieur gauche de la scène comme (0, 0). Si le clip se trouve dans un clip
   qui a subi des transformations, le clip est dans le système de coordonnées locales du clip
   imbriquant. Donc, pour un clip ayant pivoté de 90° dans le sens inverse des aiguilles d’une
   montre, les enfants de ce clip héritent d’un système de coordonnées qui a pivoté de 90° dans le
   sens inverse des aiguilles d’une montre. Les coordonnées du clip font référence à la position du
   point d’alignement.
   Voir aussi
   MovieClip._xscale, MovieClip._y, MovieClip._yscale


MovieClip._xmouse
   Disponibilité
   Flash Player 5.
   Usage
   monClip._xmouse




                                                                           Dictionnaire ActionScript 357
      Description
      Propriété (lecture seule) ; renvoie la coordonnée x de la position de la souris.
      Voir aussi
      Mouse (objet), MovieClip._ymouse

MovieClip._xscale
      Disponibilité
      Flash Player 4.
      Usage
      monClip._xscale

      Description
      Propriété ; détermine l’échelle horizontale (pourcentage) du clip telle qu’appliquée à partir du
      point d’alignement du clip. Le point d’alignement par défaut est (0,0).
      Le redimensionnement du système de coordonnées locales affecte les paramètres de propriété _x
      et _y, définis en pixels entiers. Par exemple, si le clip parent est dimensionné à 50 %, la définition
      de la propriété _x bouge un objet du clip de la moitié du nombre de pixels d’une animation à
      100 %.
      Voir aussi
      MovieClip._x, MovieClip._y, MovieClip._yscale


MovieClip._y
      Disponibilité
      Flash Player 3.
      Usage
      monClip._y

      Description
      Propriété ; définit la coordonnée y de l’animation par rapport aux coordonnées locales du clip
      parent. Si un clip se trouve dans le scénario principal, son système de coordonnées fait référence
      au coin supérieur gauche de la scène comme (0, 0). Si le clip se trouve dans un clip qui a subi des
      transformations, le clip est dans le système de coordonnées locales du clip imbriquant. Donc,
      pour un clip ayant pivoté de 90° dans le sens inverse des aiguilles d’une montre, les enfants de ce
      clip héritent d’un système de coordonnées qui a pivoté de 90° dans le sens inverse des aiguilles
      d’une montre. Les coordonnées du clip font référence à la position du point d’alignement.
      Voir aussi
      MovieClip._x, MovieClip._xscale, MovieClip._yscale




358
MovieClip._ymouse
   Disponibilité
   Flash Player 5.
   Usage
   monClip._ymouse

   Description
   Propriété (lecture seule) ; indique la coordonnée y de la position de la souris.
   Voir aussi
   Mouse (objet), MovieClip._xmouse

MovieClip._yscale
   Disponibilité
   Flash Player 4.
   Usage
   monClip._yscale

   Description
   Propriété ; définit l’échelle verticale (pourcentage) du clip telle qu’appliquée à partir du point
   d’alignement du clip. Le point d’alignement par défaut est (0,0).
   Le redimensionnement du système de coordonnées locales affecte les paramètres de propriété _x
   et _y, définis en pixels entiers. Par exemple, si le clip parent est dimensionné à 50 %, la définition
   de la propriété _x bouge un objet du clip de la moitié du nombre de pixels d’une animation à
   100 %.
   Voir aussi
   MovieClip._x, MovieClip._xscale, MovieClip._y


NaN
   Disponibilité
   Flash Player 5.
   Usage
   NaN

   Description
   Variable ; une variable prédéfinie avec la valeur IEEE-754 pour NaN (Not a Number).




                                                                           Dictionnaire ActionScript 359
ne (pas égal à — spécifique aux chaînes)
      Disponibilité
      Flash Player 4. Cet opérateur est déconseillé et remplacé par l’opérateur != (inégalité).
      Usage
      expression1 ne expression2

      Paramètres
      expression1, expression2         Nombres, chaînes ou variables.
      Renvoie
      Rien.
      Description
      Opérateur (comparaison) ; compare expression1 avec expression2 et renvoie true si
      expression1 n’est pas égale à expression2 ; sinon, renvoie false.

      Voir aussi
      != (inégalité)

new
      Disponibilité
      Flash Player 5.
      Usage
      new constructeur()

      Paramètres
      constructeur     Une fonction suivie par tout paramètre facultatif entre parenthèses. La fonction
      est généralement le nom du type de l’objet (par exemple, Array, Math, Number ou Object) à
      construire.
      Renvoie
      Rien.
      Description
      Opérateur ; crée un nouvel objet, initialement anonyme, et appelle la fonction identifiée par le
      paramètre constructeur. L’opérateur new transmet à la fonction les paramètres facultatifs entre
      parenthèses, ainsi que l’objet nouvellement créé, auquel il est fait référence à l’aide du mot-clé
      this. La fonction constructeur peut ensuite utiliser this pour définir les variables de l’objet.
      La propriété prototype de l’objet de la fonction constructeur est copiée dans la propriété
      __proto__   du nouvel objet. En conséquence, le nouvel objet supporte toutes les méthodes et
      propriétés spécifiées dans l’objet Prototype de la fonction constructeur.




360
   Exemple
   L’exemple suivant crée la fonction Livre, puis utilise l’opérateur new pour créer les objets livre1
   et livre2.
   function Livre(nom, prix){
     this.nom = nom;
     this.prix = prix;
   }

   livre1 = new Livre("Château de ma mère", 19,99);
   livre2 = new Livre("La rigolade", 10,99);

   Exemple
   L’exemple suivant utilise le nouvel opérateur pour créer une occurrence de l’objet Array avec
   18 éléments :
   parcoursGolf = new Array(18);

   Voir aussi
   [] (accès tableau), {} (initialisateur d’objet)

   La section de méthode constructeur de l’entrée de chaque objet.

newline
   Disponibilité
   Flash Player 4.
   Usage
   newline

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Constante ; insère un caractère de retour chariot () insérant une ligne vide dans le code
   ActionScript. Utilisez newline pour faire de la place aux informations récupérées par une
   fonction ou une action de votre code.

nextFrame
   Disponibilité
   Flash 2.
   Usage
   nextFrame()

   Paramètres
   Aucun.
   Renvoie
   Rien.



                                                                         Dictionnaire ActionScript 361
      Description
      Action ; envoie la tête de lecture à l’image suivante et l’arrête.
      Exemple
      Dans cet exemple, lorsqu’un utilisateur clique sur le bouton, la tête de lecture passe à l’image
      suivante et s’arrête.
      on(release) {
        nextFrame();
      }

nextScene
      Disponibilité
      Flash 2.
      Usage
      nextScene()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Action ; envoie la tête de lecture à l’image 1 de la séquence suivante et l’arrête.
      Exemple
      Dans cet exemple, lorsqu’un utilisateur relâche le bouton, la tête de lecture est envoyée à l’image 1
      de la séquence suivante.
      on(release) {
        nextScene();
      }

      Voir aussi
      prevScene

not
      Disponibilité
      Flash Player 4. Cet opérateur est déconseillé et remplacé par l’opérateur ! (NOT logique).
      Usage
      not expression

      Paramètres
      expression      Toute variable ou expression convertie en valeur booléenne.
      Description
      Opérateur ; effectue une opération NOT logique dans Flash Player 4.
      Voir aussi
      ! (NOT logique)




362
null
   Disponibilité
   Flash Player 5.
   Usage
   null

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Mot-clé ; une valeur spéciale qui peut être affectée aux variables ou renvoyée par une fonction si
   aucune donnée n’a été fournie. Vous pouvez utiliser null pour représenter les valeurs absentes ou
   n’ayant pas de type de données défini.
   Exemple
   Dans un contexte numérique, null est équivalant à 0. Les tests d’égalité peuvent être effectués
   avec null. Dans cette instruction, un nœud d’arborescence binaire ne possède pas d’enfant
   gauche, et le champ pour cet enfant gauche peut donc être défini sur null.
   if (tree.left == null) {
     tree.left = new TreeNode();
   }

Number (fonction)
   Disponibilité
   Flash Player 4.
   Usage
   Number(expression)

   Paramètres
   expression        Une expression à convertir en nombre.
   Renvoie
   Rien.
   Description
   Fonction ; convertit le paramètre expression en nombre et renvoie une valeur comme suit :
   Si expression est un nombre, la valeur renvoyée est expression.
   Si expression est une valeur booléenne, la valeur renvoyée est 1 si expression est true, 0 si
   expression est false.

   Si expression est une chaîne, la fonction tente d’analyser expression comme un nombre
   décimal avec un exposant facultatif (1.57505e-3).
   Si expressionx est undefined, la valeur renvoyée est 0.




                                                                        Dictionnaire ActionScript 363
      Cette fonction est utilisée pour convertir les fichiers Flash 4 contenant des opérateurs déconseillés
      importés dans l’environnement auteur de Flash 5. Consultez l’entrée de l’opérateur & pour plus
      d’informations.
      Voir aussi
      Number (objet)

Number (objet)
      L’objet Number est un simple objet enveloppe pour le type de données de nombre, ce qui signifie
      que vous pouvez manipuler des valeurs numériques primitives en utilisant les méthodes et les
      propriétés associées à l’objet Number. Cet objet est identique à l’objet Number de JavaScript.
      Dans Flash MX, l’objet Number est devenu un objet natif. Vous pourrez donc constater
      d’importantes améliorations des performances.
      Vous devez utiliser un constructeur lorsque vous appelez les méthodes de l’objet Number, mais il
      n’est pas nécessaire d’utiliser le constructeur lorsque vous appelez les propriétés de l’objet
      Number. Les exemples suivants spécifient la syntaxe à employer pour appeler les méthodes et
      propriétés de l’objet Number.
      L’exemple suivant appelle la méthode toString de l’objet Number, qui renvoie la chaîne
      « 1234 ».
      monNombre = new Number(1234);
      monNombre.toString();
      Cet exemple appelle la propriété MIN_VALUE (également appelée « constante ») de l’objet
      Number :
      plusPetit = Number.MIN_VALUE

Méthodes de l’objet Number

      Méthode                    Description

      Number.toString            Renvoie la représentation chaîne d’un objet Number.

      Number.valueOf             Renvoie la valeur primitive d’un objet Number.


Propriétés de l’objet Number

      Propriété                      Description

      Number.MAX_VALUE               Constante représentant le plus grand nombre représentable (IEEE-754 double
                                     précision). Ce nombre est approximativement 1.7976931348623158e+308.

      Number.MIN_VALUE               Constante représentant le plus petit nombre représentable (IEEE-754 double
                                     précision). Ce nombre est approximativement 5e-324.

      Number.NaN                     Constante représentant la valeur de Not a Number (NaN).

      Number.NEGATIVE_INFINITY       Constante représentant la valeur pour l’infini négatif.

      Number.POSITIVE_INFINITY       Constante représentant la valeur pour l’infini positif. Cette valeur est la même
                                     que la variable globale Infinity.




364
Constructeur pour l’objet Number
    Disponibilité
    Flash Player 5.
    Usage
    monNombre = new Number(valeur)

    Paramètres
    valeur    La valeur numérique de l’objet Number créé, ou une valeur à convertir en nombre.
    Renvoie
    Rien.
    Description
    Constructeur ; crée un nouvel objet Number. Vous devez utiliser le constructeur Number lorsque
    vous utilisez les méthodes toString et valueOf de l’objet Number. Il n’est pas nécessaire
    d’utiliser de constructeur lorsque vous utilisez les propriétés de l’objet Number. Le constructeur
    new Number est principalement utilisé comme support. Une occurrence de l’objet Number n’est
    pas identique à la fonction Number qui convertit un paramètre en valeur primitive.
    Exemple
    Le code suivant construit de nouveaux objets Number.
    n1 = new Number(3.4);
    n2 = new Number(-10);

    Voir aussi
    Number (fonction)

Number.MAX_VALUE
    Disponibilité
    Flash Player 5.
    Usage
    Number.MAX_VALUE

    Description
    Propriété ; le plus grand nombre représentable (IEEE-754 double précision). Ce nombre est
    approximativement 1.79E+308.

Number.MIN_VALUE
    Disponibilité
    Flash Player 5.
    Usage
    Number.MIN_VALUE

    Description
    Propriété ; le nombre représentable le plus petit (IEEE-754 double précision). Ce nombre est
    approximativement 5e-324.




                                                                          Dictionnaire ActionScript 365
Number.NaN
      Disponibilité
      Flash Player 5.
      Usage
      Number.NaN

      Description
      Propriété ; la valeur IEEE-754 représentant Not A Number (NaN).

Number.NEGATIVE_INFINITY
      Disponibilité
      Flash Player 5.
      Usage
      Number.NEGATIVE_INFINITY

      Description
      Propriété ; renvoie la valeur IEEE-754 représentant l’infini négatif.
      L’infini négatif est une valeur numérique spéciale qui est renvoyée lorsqu’une opération
      mathématique ou une fonction renvoient une valeur négative trop grande pour être représentée.

Number.POSITIVE_INFINITY
      Disponibilité
      Flash Player 5.
      Usage
      Number.POSITIVE_INFINITY

      Description
      Propriété ; renvoie la valeur IEEE-754 représentant l’infini positif. Cette valeur est identique à la
      variable globale Infinity.
      L’infini positif est une valeur numérique spéciale qui est renvoyée lorsqu’une opération
      mathématique ou une fonction renvoient une valeur trop grande pour être représentée.

Number.toString
      Disponibilité
      Flash Player 5.
      Usage
      monNombre.toString(base)

      Paramètres
      base    Spécifie la base numérique (entre 2 et 36) à utiliser pour la conversion d’un nombre en
      chaîne. Si vous ne spécifiez pas le paramètre base, la valeur par défaut est 10.
      Renvoie
      Rien.


366
    Description
    Méthode ; renvoie la représentation chaîne de l’objet Number spécifié (monNombre).
    Exemple
    L’exemple suivant utilise la méthode Number.toString, en spécifiant 2 pour le paramètre base et
    renvoie une chaîne contenant la représentation binaire de 1000.
    monNombre = new Number(1000);
    monNombre.toString(2);

Number.valueOf
    Disponibilité
    Flash Player 5.
    Usage
    monNombre.valueOf()

    Paramètres
    Aucun.
    Renvoie
    Voir ci-dessous.
    Description
    Méthode ; renvoie le type de valeur primitif de l’objet Number spécifié.

Object (objet)
    L’objet générique Object est à la base de la hiérarchie de classes ActionScript. L’objet ActionScript
    générique Object contient un petit sous-ensemble des fonctionnalités fournies par l’objet
    JavaScript Object. Dans Flash MX, l’objet Object est devenu un objet natif. Vous pourrez donc
    constater d’importantes améliorations des performances.
    L’objet ActionScript générique Object est supporté par Flash Player 5.

Méthodes de l’objet Object

    Méthode                    Description

    Object.addProperty         Crée une propriété de lecture/définition pour un objet.

    Object.registerClass       Affecte une classe ActionScript à une occurrence de clip.

    Object.toString            Convertit l’objet spécifié en chaîne et le renvoie.

    Object.unwatch             Supprime l’enregistrement créé par une méthode Object.watch.

    Object.valueOf             Renvoie la valeur primitive d’un objet Object.

    Object.watch               Enregistre une fonction de rappel invoquée lorsqu’une propriété spécifiée d’un objet
                               ActionScript change.


Propriétés de l’objet Object

    Propriété                  Description

    Object.__proto__           Une référence à la propriété prototype de la fonction constructeur de l’objet.




                                                                                     Dictionnaire ActionScript 367
Constructeur pour l’objet Object
      Disponibilité
      Flash Player 5.
      Usage
      new Object([valeur])

      Paramètres
      valeur Un nombre, une valeur booléenne ou une chaîne à convertir en objet. Ce paramètre est
      facultatif. Si vous ne spécifiez pas valeur, le constructeur crée un nouvel objet sans propriétés
      définies.
      Description
      Constructeur ; crée un nouvel objet Object.

Object.addProperty
      Disponibilité
      Flash Player 6.
      Usage
      monObjet.addProperty( prop, fonctionGet, fonctionSet )

      Paramètres
      prop    Le nom de la propriété d’objet à créer.
      fonctionGet     La fonction qui est invoquée pour récupérer la valeur de la propriété ; ce
      paramètre est un objet de fonction.
      fonctionSet      La fonction qui est invoquée pour définir la valeur de la propriété ; ce paramètre
      est un objet de fonction. Si vous transmettez la valeur null pour ce paramètre, la propriété est en
      lecture seule.
      Renvoie
      Renvoie une valeur de true si la propriété est correctement créée ; sinon, renvoie false.
      Description
      Méthode ; crée une propriété de lecture/définition. Lorsque Flash lit une propriété de lecture/
      définition, il invoque la fonction get et la valeur renvoyée par la fonction devient une valeur de
      prop. Lorsque Flash écrit une propriété de lecture/définition, il invoque la fonction set et lui
      transmet la nouvelle valeur en tant que paramètre. Si une propriété portant le nom donné existe
      déjà, la nouvelle propriété la remplace.
      Une fonction get est une fonction sans paramètre. La valeur renvoyée peut être de tout type. Son
      type peut changer d’une invocation à l’autre. La valeur renvoyée est considérée comme la valeur
      actuelle de la propriété.
      Une fonction set est une fonction qui accepte un paramètre, qui est la nouvelle valeur de la
      propriété. Par exemple, si la propriété x est affectée par l’instruction x = 1, le paramètre 1 de type
      nombre est transmis à la fonction set. La valeur renvoyée par la fonction setter est ignorée.




368
Vous pouvez ajouter des propriété de lecture/définition à des objets prototypes. Si vous ajoutez
une propriété de lecture/définition à un objet prototype, toutes les occurrences d’objet qui
héritent de l’objet prototype héritent de la propriété de lecture/définition. Cela permet d’ajouter
une propriété de lecture/définition à un endroit, au niveau de l’objet prototype, et de la propager
à toutes les occurrences d’une classe, tout comme lorsque vous ajoutez des méthodes à des objets
prototypes. Si une fonction de lecture/définition est invoquée pour une propriété de lecture/
définition d’un objet prototype hérité, la référence transmise à la fonction de lecture/définition
sera l’objet auquel il est fait référence à l’origine, et non l’objet prototype.
En cas d’invocation incorrecte, Object.addProperty peut échouer avec une erreur. Le tableau
suivant décrit les erreurs qui peuvent se produire :

Condition d’erreur                                             Ce qui se produit

prop n’est pas un nom de propriété valide ; par exemple, une   Renvoie false et la propriété n’est pas ajoutée.
chaîne vide.

getFunc n’est pas un objet de fonction valide.                 Renvoie false et la propriété n’est pas ajoutée.

setFunc n’est pas un objet de fonction valide.                 Renvoie false et la propriété n’est pas ajoutée.

Exemple
Usage 1. Les propriétés intégrées TextField.scroll et TextField.maxscroll sont des
propriétés de lecture/définition. L’objet TextField a les méthodes internes getScroll,
setScroll et getMaxScroll. Le constructeur TextField crée les propriétés de lecture/définition
et les oriente vers les méthodes de lecture/définition internes, comme dans l’exemple suivant :
this.addProperty("scroll", this.getScroll, this.setScroll);
this.addProperty("maxscroll", this.getMaxScroll, null);
Lorsqu’un script récupère la valeur de monChampDeTexte.scroll, l’interprète d’ActionScript
invoque automatiquement monChampDeTexte.getScroll. Lorsqu’un script modifie la valeur de
monChampDeTexte.scroll, l’interprète invoque monChampDeTexte.setScroll. La propriété
maxscroll ne spécifie pas une fonction set et les tentatives de modification de maxscroll sont
donc ignorées.
Usage 2. L’exemple ci-dessus de TextField.scroll et TextField.maxscroll fonctionne, mais
les propriétés scroll et maxscroll sont ajoutées à chaque occurrence de l’objet TextField. Cela
signifie que le coût d’utilisation des propriétés est de deux emplacements de propriété pour
chaque occurrence de l’objet. Un trop grand nombre de propriétés comme scroll et maxscroll
dans une classe pourrait entraîner une forte consommation de mémoire. Au lieu de cela, vous
pouvez ajouter les propriétés scroll et maxscroll à TextField.prototype :
TextField.prototype.addProperty("scroll", this.getScroll, this.setScroll);
TextField.prototype.addProperty("maxscroll", this.getMaxScroll, null);
Les propriétés scroll et maxscroll existent maintenant seulement en un endroit : l’objet
TextField.prototype. Cependant, l’effet est le même que celui du code ci-dessus qui ajoutait
scroll et maxscroll directement à chaque occurrence. Si scroll ou maxscroll est obtenu dans
une occurrence TextField, la chaîne de prototype est remontée et la propriété de lecture/
définition de TextField.prototype est détectée.




                                                                              Dictionnaire ActionScript 369
Object.__proto__
      Disponibilité
      Flash Player 5.
      Usage
      monObjet.__proto__

      Paramètres
      Aucun.
      Description
      Propriété ; fait référence à la propriété prototype de la fonction constructeur qui a créé
      monObjet. La propriété __proto__ est automatiquement affectée à tous les objets lors de leur
      création. L’interprète d’ActionScript utilise la propriété __proto__ pour accéder à la propriété
      prototype de la fonction constructeur de l’objet, afin de déterminer quelles propriétés et
      méthodes l’objet hérite de sa classe.

Object.registerClass
      Disponibilité
      Flash Player 6
      Usage
      Object.registerClass(idDeSymbole, laClasse)

      Paramètres
      idDeSymbole      L’identifiant de liaison du symbole de clip, ou l’identifiant de chaîne pour la
      classe ActionScript.
      laClasse     Une référence à la fonction constructeur de la classe ActionScript, ou null pour
      désenregistrer le symbole.
      Renvoie
      Si l’enregistrement de classe réussit, une valeur de true est renvoyée ; sinon, false est renvoyé.
      Description
      Méthode ; associe un symbole de clip à une classe d’objet ActionScript. S’il n’existe aucun
      symbole, Flash crée une association entre un identifiant de chaîne et une classe d’objet.
      Lorsqu’une occurrence du symbole de clip spécifié est placée par le scénario, elle est enregistrée
      dans la classe spécifiée par le paramètre laClasse plutôt que dans la classe MovieClip.
      Lorsqu’une occurrence du symbole de clip spécifié est créée à l’aide des méthodes attachMovie
      ou duplicateMovieClip, elle est enregistrée dans la classe spécifiée par le paramètre laClasse
      plutôt que dans la classe MovieClip.
      Si laClasse est null, Object.registerClass supprime toute définition de classe ActionScript
      associée au symbole de clip ou à l’identifiant de classe spécifié. Pour les symboles de clip, toute
      occurrence existante du clip reste inchangée, mais les nouvelles occurrences du symbole sont
      associées à la classe MovieClip par défaut.
      Si un symbole est déjà enregistré dans une classe, la méthode Object.registerClass le
      remplace par le nouvel enregistrement.




370
Lorsqu’une occurrence de clip est placée par le scénario ou créée à l’aide de attachMovie ou
duplicateMovieClip, ActionScript invoque le constructeur pour la classe appropriée avec le
mot-clé this désignant l’objet. La fonction constructeur est invoquée sans paramètres.
Si vous utilisez la méthode Object.registerClasspour enregistrer un clip dans une classe
ActionScript autre que MovieClip, le symbole du clip n’hérite pas des méthodes, propriétés et
événements de la classe MovieClip intégrée, à moins que vous n’incluiez la classe MovieClip dans
la chaîne de prototype de la classe. Le code suivant crée une nouvelle classe ActionScript appelée
laClasse, qui hérite des propriétés de la classe MovieClip :
laClasse.prototype = new MovieClip();

Exemple
Cet exemple crée un composant pour un objet d’interface de case à cocher standard.
Vous devez d’abord créer un symbole de clip appelé CheckBox dans la bibliothèque. Vous créez
ensuite une classe CheckBox dans ActionScript qui représentera la case à cocher.
// définir un constructeur pour (et donc définir)
// la classe CheckBox

function CheckBox() {
...
}

// définir la chaîne de prototype CheckBox
// pour hériter du clip

CheckBox.prototype = new MovieClip();

// définir des méthodes pour la classe CheckBox

CheckBox.prototype.setLabel = function           (nouvelleEtiquette) {
   this.label = nouvelleEtiquette;
   ...
};
CheckBox.prototype.setValue = function           (nouvelleValeur) {
   this.value = nouvelleValeur;
   ...
};
CheckBox.prototype.getValue = function           () {
   return this.value;
};
CheckBox.prototype.getLabel = function           () {
   return this.label;
};
Vous devez maintenant associer la classe CheckBox au symbole de clip CheckBox. Vous devez
pouvoir identifier le symbole de clip CheckBox avec ActionScript. Pour ce faire, entrez un
identifiant dans la boîte de dialogue Liaison de la bibliothèque et sélectionnez Exporter pour
ActionScript.
Rédigez ensuite le code ActionScript nécessaire à l’association de la classe CheckBox au symbole
CheckBox :
Object.registerClass("CheckBox" /*idSymbole*/, CheckBox /*laClasse*/ );




                                                                     Dictionnaire ActionScript 371
      Usage 1 (placement dans le scénario). Vous pouvez maintenant placer des occurrences de
      CheckBox sur la scène au cours de la programmation et, à l’exécution, les occurrences recevront
      automatiquement la classe CheckBox d’ActionScript. Si vous placez deux occurrences,
      maCaseAcocher1 et maCaseAcocher2, vous pouvez les contrôler en invoquant des méthodes,
      comme dans l’exemple suivant :
      maCaseAcocher1.setValue(true);
      maCaseAcocher2.setValue(false);
      maCaseAcocher2.setLabel("nouvelle étiquette pour la deuxième");
      Usage 2 (occurrences dynamiques). Vous pouvez utiliser la méthode attachMovie pour créer une
      nouvelle occurrence de la case à cocher sur la scène pendant la lecture de l’animation. Le symbole
      CheckBox étant enregistré dans la classe ActionScript CheckBox, la nouvelle occurrence
      dynamique recevra automatiquement cette classe.
      // créationCaseAcocher est une fonction qui
      // crée dynamiquement des cases à cocher
      function créationCaseAcocher(nom, profondeur) {
        attachMovie("CheckBox", nom, profondeur);
      }
      créationCaseAcocher("maCaseAcocher3", 100);
      maCaseAcocher3.setValue(false);
      maCaseAcocher3.setLabel("nouvelle étiquette pour la troisième");

      Voir aussi
      MovieClip.attachMovie, MovieClip.duplicateMovieClip


Object.toString
      Disponibilité
      Flash Player 5.
      Usage
      monObjet.toString()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; convertit l’objet spécifié en chaîne et le renvoie.

Object.unwatch
      Disponibilité
      Flash Player 6.
      Usage
      monObjet.unwatch (prop)
      Paramètres
      prop     Le nom de la propriété d’objet qui ne doit plus être surveillée, sous forme de chaîne.




372
   Renvoie
   Une valeur booléenne.
   Description
   Méthode ; supprime un point de surveillance créé par la méthode Object.watch. Cette méthode
   renvoie une valeur de true si le point de surveillance a été correctement retiré ; sinon, elle renvoie
   une valeur de false.

Object.valueOf
   Disponibilité
   Flash Player 5.
   Usage
   monObjet.valueOf()

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Méthode ; renvoie la valeur primitive de l’objet spécifié. Si l’objet ne possède pas de valeur
   primitive, il est lui-même renvoyé.

Object.watch
   Disponibilité
   Flash Player 6.
   Usage
   monObjet.watch( prop, rappel [, donnéesUtilisateur] )

   Paramètres
   prop     Une chaîne indiquant le nom de la propriété d’objet à surveiller.
   rappel La fonction à invoquer lorsque que la propriété surveillée change. Ce paramètre est un
   objet de fonction, pas un nom de fonction sous forme de chaîne. La forme de callback est
   callback(prop, ancienneVal, nouvelleVal, donnéesUtilisateur).

   donnéesUtilisateur Une donnée ActionScript arbitraire qui est transmise à la méthode
   rappel. Si le paramètre donnéesUtilisateur est omis, undefined est transmis à la méthode           de
   rappel. Ce paramètre est facultatif.
   Renvoie
   Une valeur de true si le point de surveillance est correctement créé ; sinon, renvoie une valeur de
   false.

   Description
   Méthode ; enregistre une fonction de rappel invoquée lorsqu’une propriété spécifiée d’un objet
   ActionScript change. Lorsque la propriété change, la fonction de rappel est invoquée avec
   monObjet comme objet contenant.




                                                                           Dictionnaire ActionScript 373
      Un point de surveillance peut filtrer (ou annuler) l’affectation de valeur, en renvoyant une
      nouvelleVal modifiée (ou ancienneVal). Si vous supprimez une propriété pour laquelle un
      point de surveillance a été défini, ce point de surveillance ne disparaît pas. Si vous recréez
      ultérieurement la propriété, le point de surveillance est toujours en vigueur. Pour supprimer un
      point de surveillance, utilisez la méthode Object.unwatch.
      Il ne peut exister qu’un seul point de surveillance enregistré sur une propriété. Les appels
      ultérieurs à Object.watch sur la même propriété remplacent le point de surveillance original.
      La méthode Object.watch se comporte de façon similaire à la fonction Object.watch de
      Netscape JavaScript 1.2 et ultérieur. La principale différence est le paramètre
      donnéesUtilisateur, qui est une addition Flash à Object.watch que Netscape Navigator ne
      supporte pas. Vous pouvez transmettre le paramètre donnéesUtilisateur à la fonction de rappel
      et l’utiliser dans la fonction de rappel.
      La méthode Object.watch ne peut pas surveiller les propriétés de lecture/définition. Les
      propriétés de lecture/définition fonctionnent par « évaluation passive » – la valeur de la propriété
      n’étant pas déterminée tant que la propriété n’est pas interrogée. Une « évaluation passive » est
      souvent rentable étant donné que la propriété n’est pas constamment mise à jour, mais
      simplement évaluée lorsqu’il le faut. Cependant, Object.watch a besoin d’évaluer une propriété
      pour activer des point de surveillance sur celle-ci. Pour fonctionner avec une propriété de lecture/
      définition, Object.watch a besoin d’évaluer constamment la propriété, ce qui n’est pas rentable.
      En général, les propriétés ActionScript prédéfinies, telles que _x, _y, _width et _height, sont des
      propriétés de lecture/définition, et ne peuvent donc pas être surveillées avec Object.watch.
      Exemple
      Cet exemple montre un composant CheckBox avec des méthodes qui définissent l’étiquette ou la
      valeur de chaque occurrence de case à cocher :
      maCaseAcocher1.setValue(true);
      maCaseAcocher1.setLabel("nouvelle étiquette");
      ...
      Il est pratique de considérer la valeur et l’étiquette d’une case à cocher comme des propriétés. Il
      est possible d’utiliser Object.watch de manière à ce que l’accès à la valeur et à l’étiquette
      ressemble plus à un accès à une propriété qu’à une invocation de méthode, comme dans l’exemple
      suivant :
      // définir un constructeur pour (et donc définir) la classe CheckBox
      function CheckBox() {
        ...
        this.watch ('value', function (id, ancienneVal, nouvelleVal)) {
           ...
        }
        this.watch ('label', function (id, ancienneVal, nouvelleVal)) {
           ...
        }
      }
      Lorsque la propriété de valeur ou d’étiquette est modifiée, la fonction spécifiée par le composant
      est invoquée pour accomplir toutes les tâches nécessaires à la mise à jour de l’apparence et de l’état
      du composant pour refléter ses nouveaux paramètres. Par conséquent, l’instruction d’affectation
      suivante utilise un gestionnaire Object.watch pour aviser le composant que la variable a changé
      et lui fait mettre à jour sa représentation graphique.
      maCaseAcocher1.value = false;




374
   Cette syntaxe est plus concise que la précédente :
   maCaseAcocher1.setValue(false);

   Voir aussi
   Object.addProperty, Object.unwatch


onClipEvent
   Disponibilité
   Flash Player 5.
   Usage
   onClipEvent(événementAnimation){
     instruction(s);
   }

   Paramètres
   Un événementAnimation est un déclenchement appelé « événement ». Lorsque l’événement a
   lieu, les instructions le suivant au sein des accolades sont exécutées. N’importe laquelle des valeurs
   suivantes peut être spécifiée pour le paramètre événementAnimation :
   •   load    L’action est initiée dès que le clip est instancié et apparaît dans le scénario.
   •   unload L’action est initiée dans la première image après la suppression du clip du scénario.
       Les actions associées à l’événement de clip Unload sont traitées avant que des actions ne soient
       associées à l’image affectée.
   •   enterFrame      L’action est déclenchée continuellement à la cadence de l’animation. Les
       actions associées à l’événement de clip enterFrame sont traitées avant les actions associées aux
       images affectées.
   •   mouseMove L’action est initiée chaque fois que la souris est déplacée.      Utilisez les propriétés
       _xmouse et _ymouse pour déterminer la position actuelle de la souris.

   •   mouseDown     L’action est initiée lorsque le bouton gauche de la souris est enfoncé.
   •   mouseUp     L’action est initiée lorsque le bouton gauche de la souris est relâché.
   •   keyDown L’action est initiée lorsqu’une touche est enfoncée. Utilisez la méthode
       Key.getCode pour récupérer les informations concernant la dernière touche enfoncée.

   •   keyUp   L’action est initiée lorsqu’une touche est relâchée. Utilisez la méthode Key.getCode
       pour récupérer les informations concernant la dernière touche enfoncée.
   •   data L’action est initiée lorsque des données sont reçues dans une action loadVariables ou
       loadMovie. Lorsqu’il est spécifié avec une action loadVariables, l’événement data ne
       survient qu’une seule fois, quand la dernière variable est chargée. Lorsqu’il est spécifié avec une
       action loadMovie, l’événement data est répété plusieurs fois, au fur et à mesure que les
       sections de données sont récupérées.
   instruction(s)        Les instructions à exécuter lorsque événementSouris survient.
   Description
   Gestionnaire d’événement ; déclenche des actions définies pour une occurrence de clip spécifique.




                                                                              Dictionnaire ActionScript 375
      Exemple
      L’instruction suivante inclut le script provenant d’un fichier externe lorsque l’animation est
      exportée ; les actions du script inclus sont exécutées au chargement du clip auquel elles sont
      associées.
      onClipEvent(load) {
        #include "monScript.as"
      }
      L’exemple suivant utilise onClipEvent avec l’événement de clip keyDown. L’événement
      d’animation keyDown est généralement utilisé en conjonction avec une ou plusieurs méthodes et
      propriétés associées à l’objet Key. Le script ci-dessous utilise la méthode Key.getCode pour
      déterminer la touche enfoncée par l’utilisateur : si la touche enfoncée correspond à la propriété
      Key.RIGHT, l’animation est envoyée à l’image suivante ; si la touche enfoncée correspond à la
      propriété Key.LEFT, l’animation est envoyée à l’image précédente.
      onClipEvent(keyDown) {
        if (Key.getCode() == Key.RIGHT) {
           _parent.nextFrame();
        } else if (Key.getCode() == Key.LEFT){
           _parent.prevFrame();
        }
      }
      L’exemple suivant utilise onClipEvent avec l’événement d’animation mouseMove. Les propriétés
      _xmouse et _ymouse suivent la position de la souris.
      onClipEvent(mouseMove) {
        stageX=_root.xmouse;
        stageY=_root.ymouse;
      }

      Voir aussi
      Key (objet), MovieClip._xmouse, MovieClip._ymouse,on

on
      Disponibilité
      Flash 2. Tous les événements ne sont pas supportés dans Flash 2.
      Usage
      on(événementSouris) {
        instruction(s);
      }

      Paramètres
      instruction(s)        Les instructions à exécuter lorsque événementSouris survient.
      Un événementSouris est un déclenchement appelé « événement ». Lorsque l’événement a lieu,
      les instructions le suivant au sein des accolades sont exécutées. N’importe laquelle des valeurs
      suivantes peut être spécifiée pour le paramètre événementSouris :
      •   press     Le bouton de la souris est enfoncé alors que le pointeur se trouve au-dessus du
          bouton.
      •   release     Le bouton de la souris est relâché alors que le pointeur se trouve au-dessus du
          bouton.




376
     •   releaseOutside Le bouton de la souris est relâché alors que le pointeur se trouve au dehors
         du bouton après l’enfoncement du bouton pendant que le pointeur est à l’intérieur du bouton.
     •   rollOut     Le pointeur passe en dehors de la zone du bouton.
     •   rollOver     Le pointeur de la souris passe au-dessus du bouton.
     •   dragOut    Alors que le pointeur se trouve au-dessus du bouton, le bouton de la souris est
         enfoncé, puis la souris sort de la zone du bouton.
     •   dragOver    Alors que le pointeur se trouve au-dessus du bouton, le bouton de la souris a été
         enfoncé, puis le pointeur sort du bouton et est ramené au-dessus du bouton.
     •   keyPress ("touche") La touche touche spécifiée est enfoncée. La portion touche du
         paramètre est spécifiée en utilisant n’importe lesquels des codes de touche figurant dans
         l’annexe C, Touches du clavier et valeurs de code correspondantes, de Utilisation de Flash, ou
         n’importe lesquelles des constantes de touche figurant dans Propriétés de l’objet Key.
     Description
     Gestionnaire d’événement ; spécifie l’événement souris ou touche qui déclenche une action.
     Exemple
     Dans le script suivant, l’action startDrag est exécutée lorsque l’utilisateur clique avec la souris et
     le script conditionnel est exécuté lorsque le bouton et l’objet sont relâchés :
     on(press) {
       startDrag("lapin");
     }
     on(release) {
       trace(_root.lapin._y);
       trace(_root.lapin._x);
       stopDrag();
     }

     Voir aussi
     onClipEvent

or
     Disponibilité
     Flash Player 4. Cet opérateur est déconseillé et remplacé par l’opérateur || (OR logique).
     Usage
     condition1 or condition2

     Paramètres
     condition1,2       Une expression évaluée comme true ou false.
     Renvoie
     Rien.
     Description
     Opérateur ; évalue condition1 et condition2 et, si une des expressions est true, l’expression
     entière est true.
     Voir aussi
     || (OR logique), | (OR au niveau du bit)




                                                                             Dictionnaire ActionScript 377
ord
      Disponibilité
      Flash Player 4. Cette fonction est déconseillée et remplacée par les méthodes et propriétés de
      String (objet).
      Usage
      ord(caractère)

      Paramètres
      caractère        Le caractère à convertir en code ASCII.
      Renvoie
      Rien.
      Description
      Fonction de chaîne ; convertit des caractères en code ASCII.
      Voir aussi
      String (objet)

_parent
      Disponibilité
      Flash Player 4.
      Usage
      _parent.propriété
      _parent._parent.propriété

      Description
      Propriété ; spécifie ou renvoie une référence au clip ou objet contenant le clip ou objet courant.
      L’objet courant est l’objet contenant le code ActionScript faisant référence à _parent. Utilisez
      _parent pour spécifier un chemin relatif aux clips ou objets qui se trouvent au-dessus du clip ou
      objet actuel.
      Exemple
      Dans l’exemple suivant, le clip desk est un enfant du clip salleDeClasse. Lorsque le script ci-
      dessous est exécuté dans le clip desk, la tête de lecture atteint l’image 10 du scénario du clip
      salleDeClasse.
      _parent.gotoAndStop(10);

      Voir aussi
      _root, targetPath




378
parseFloat
   Disponibilité
   Flash Player 5.
   Usage
   parseFloat(chaîne)

   Paramètres
   chaîne    La chaîne à lire et à convertir en nombre à virgule flottante.
   Renvoie
   Rien.
   Description
   Fonction ; convertit une chaîne en nombre à virgule flottante. La fonction analyse et renvoie les
   nombres d’une chaîne jusqu’à ce qu’elle atteigne un caractère qui n’appartient pas au nombre
   initial. Si la chaîne ne commence pas par un nombre qui peut être analysé, parseFloat renvoie
   NaN. Les espaces précédant les entiers valides sont ignorés, tout comme les caractères non
   numériques à droite.
   Exemple
   Les exemples suivants utilisent la fonction parseFloat pour évaluer différents types de nombres.
   parseFloat("-2")       renvoie -2
   parseFloat("2.5")       renvoie 2.5
   parseFloat("3.5e6")        renvoie 3.5e6 ou 3500000
   parseFloat("foobar")        renvoie NaN
   parseFloat("5.1")       renvoie 5.1
   parseFloat("3.75math")         renvoie 3.75
   parseFloat("0tasDeTrucs")           renvoie 0

parseInt
   Disponibilité
   Flash Player 5.
   Usage
   parseInt(expression, [base])

   Paramètres
   expression        Une chaîne à convertir en entier.
   base Un entier représentant le radical (base) du nombre à analyser. Les valeurs légales se situent
   entre 2 et –36. Ce paramètre est facultatif.
   Renvoie
   Rien.




                                                                          Dictionnaire ActionScript 379
      Description
      Fonction ; convertit une chaîne en entier. Si la chaîne spécifiée dans les paramètres ne peut pas
      être convertie en un nombre, la fonction renvoie NaN. Les entiers commençant par 0 ou spécifiant
      une base de 8 sont interprétés comme des nombres octaux. Les chaînes commençant par 0x sont
      interprétées comme des nombres hexadécimaux. Les espaces précédant les entiers valides sont
      ignorés, tout comme les caractères non numériques à droite.
      Exemple
      Les exemples suivants utilisent la fonction parseInt pour évaluer différents types de nombres.
      parseInt("3.5")
      // renvoie 3.5

      parseInt("chose")
      // renvoie NaN

      parseInt("4foo")
      // renvoie 4
      Les exemples suivants illustrent les conversions hexadécimales :
      parseInt("0x3F8")
      // renvoie 1016

      parseInt("3E8", 16)
      // renvoie 1000
      Les exemples suivants illustrent les conversions binaires :
      parseInt("1010", 2)
      // renvoie 10       (la représentation décimale du binaire 1010)
      L’exemple suivant illustre l’analyse d’un nombre octal (dans ce cas, le nombre octal est identifié
      par la base 8) :
      parseInt("777", 8)
      // renvoie 511 (la représentation décimale de l’octal 777)

play
      Disponibilité
      Flash 2.
      Usage
      play()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Action ; fait avancer la tête de lecture dans le scénario.




380
  Exemple
  Le code suivant utilise une instruction if pour vérifier la valeur d’un nom entré par l’utilisateur.
  Si l’utilisateur entre Steve, l’action play est appelée et la tête de lecture avance dans le scénario.
  Si l’utilisateur entre autre chose que Steve, l’animation n’est pas lue et un champ de texte
  contenant le nom de variable alert est affiché.
  stop();
  if (nom == "Steve") {
    play();
  } else {
    alert="Vous n’êtes pas Steve !";
  }

prevFrame
  Disponibilité
  Flash 2.
  Usage
  prevFrame()

  Paramètres
  Aucun.
  Renvoie
  Rien.
  Description
  Action ; envoie la tête de lecture à l’image précédente et l’arrête. Si l’image actuelle est 1, la tête de
  lecture ne bouge pas.
  Exemple
  Lorsque l’utilisateur clique sur un bouton auquel le gestionnaire suivant est affecté, la tête de
  lecture est envoyée à l’image précédente.
  on(release) {
    prevFrame();
  }

  Voir aussi
  MovieClip.prevFrame

prevScene
  Disponibilité
  Flash 2.
  Usage
  prevScene()

  Paramètres
  Aucun.
  Renvoie
  Rien.



                                                                             Dictionnaire ActionScript 381
      Description
      Action ; envoie la tête de lecture à l’image 1 de la séquence précédente et l’arrête.
      Voir aussi
      nextScene

print
      Disponibilité
      Flash Player 4.20.
      Usage
      print (niveau)
      print (niveau, "régionDimpression")
      print ("cible")
      print ("cible", "régionDimpression")
      printAsBitmap (niveau)
      printAsBitmap (niveau, "régionDimpression")
      printAsBitmap ("cible")
      printAsBitmap ("cible", "régionDimpression")

      Paramètres
      print En mode Normal dans le panneau Actions, choisissez Comme vecteurs pour imprimer
      les images qui ne contiennent pas d’images bitmap et qui n’utilisent pas d’effets de transparence
      (alpha) ou de couleur ; choisissez Comme bitmap pour imprimer les images qui contiennent des
      images bitmap, des effets de transparence ou des effets de couleur. Si vous choisissez le paramètre
      d’impression Comme bitmap, la syntaxe AsBitmap est annexée à l’action print dans le panneau
      Actions.
      niveau Le niveau Flash Player à imprimer. Dans le panneau Actions, en mode Normal, si vous
      choisissez un niveau, l’action print passe automatiquement à printNum ou printAsBitmapNum ;
      en mode Expert, vous devez spécifier printNum ou printAsBitmapNum. Par défaut, toutes les
      images du niveau sont imprimées. Affectez une étiquette #p aux images que vous souhaitez
      imprimer dans ce niveau.
      cible Le nom d’occurrence d’un clip à imprimer. Par défaut, toutes les images de l’occurrence
      cible sont imprimées. Affectez une étiquette #p aux images que vous souhaitez imprimer dans ce
      clip.
      régionDimpression Un modificateur qui définit la région d’impression de l’animation. Ce
      paramètre est facultatif. Vous pouvez choisir un élément parmi les suivants :
      •   bmovie Désigne le cadre de délimitation d’une image spécifique d’une animation comme
          région d’impression de toutes les images imprimables de l’animation. Affectez une étiquette
          d’image #b à l’image dont vous souhaitez utiliser le cadre de délimitation comme région
          d’impression.
      •   bmax   Désigne un composite de tous les cadres de délimitation, de toutes les images
          imprimables, comme région d’impression. Spécifiez le paramètre bmax lorsque la taille des
          images de votre animation varie.
      •   bframe Indique que le cadre de délimitation de chaque image imprimable est utilisé comme
          région d’impression pour cette image. Cela modifie la région d’impression pour chaque image
          et modifie la taille des objets pour qu’ils correspondent à la région d’impression. Utilisez
          bframe si vous avez des objets de tailles diverses dans chaque image et si vous souhaitez que
          chaque objet remplisse la page imprimée.


382
   Renvoie
   Rien.
   Description
   Action ; imprime le clip cible en fonction des limites spécifiées dans le paramètre (bmovie, bmax
   ou bframe). Affectez une étiquette #p aux images que vous souhaitez imprimer dans l’animation
   cible. Bien que l’action print fournisse des impressions de meilleure qualité que l’action
   printAsBitmap, elle ne peut pas être utilisée pour imprimer des animations utilisant les
   transparences alpha ou des effets de couleur spéciaux.
   Si vous ne spécifiez pas de paramètre de limites d’impression, la région d’impression est
   déterminée par la taille de la scène de l’animation chargée, par défaut. L’animation n’hérite pas de
   la taille de scène de l’animation principale. Vous pouvez contrôler la région d’impression en
   spécifiant les paramètres bmovie, bmax ou bframe.
   Tous les éléments imprimables d’une animation doivent être complètement chargés avant de
   commencer l’impression.
   La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
   Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
   Exemple
   L’exemple suivant imprime toutes les images imprimables du clip monAnimation avec la région
   d’impression définie par le cadre de délimitation de l’image portant l’étiquette d’image #b :
   print("monAnimation","bmovie");
   L’exemple suivant imprime toutes les images imprimables de monAnimation avec une région
   d’impression définie par le cadre de délimitation de chaque image :
   print("monAnimation","bframe");

   Voir aussi
   printNum, printAsBitmap, printAsBitmapNum


printAsBitmap
   Disponibilité
   Flash Player 4.20.
   Usage
   printAsBitmap(cible, "régionDimpression")

   Paramètres
   cible Le nom d’occurrence de clip à imprimer. Par défaut, toutes les images de l’animation
   sont imprimées. Affectez une étiquette #p aux images que vous souhaitez imprimer dans cette
   animation.
   régionDimpression Un modificateur qui définit la région d’impression de l’animation. Vous
   pouvez choisir un des paramètres suivants :
   •   bmovie Désigne le cadre de délimitation d’une image spécifique d’une animation comme
       région d’impression de toutes les images imprimables de l’animation. Affectez une étiquette
       d’image #b à l’image dont vous souhaitez utiliser le cadre de délimitation comme région
       d’impression.




                                                                          Dictionnaire ActionScript 383
      •   bmax   Désigne un composite de tous les cadres de délimitation, de toutes les images
          imprimables, comme région d’impression. Spécifiez le paramètre bmax lorsque la taille des
          images de votre animation varie.
      •   bframe Indique que le cadre de délimitation de chaque image imprimable est utilisé comme
          région d’impression pour cette image. Cela modifie la région d’impression pour chaque image
          et modifie la taille des objets pour qu’ils correspondent à la région d’impression. Utilisez
          bframe si vous avez des objets de tailles diverses dans chaque image et si vous souhaitez que
          chaque objet remplisse la page imprimée.
      Renvoie
      Rien.
      Description
      Action ; imprime le clip cible au format bitmap. Utilisez l’action printAsBitmap pour
      imprimer des animations contenant des images avec des objets qui utilisent des effets de
      transparence ou de couleur. L’action printAsBitmap imprime avec la résolution la plus élevée
      possible sur l’imprimante pour préserver autant de définition et de qualité que possible.
      Si votre animation ne contient pas de transparences alpha ou d’effets de couleur, il est
      recommandé d’utiliser l’action print pour un résultat de meilleure qualité.
      Par défaut, la région d’impression est déterminée par la taille de la scène de l’animation chargée.
      L’animation n’hérite pas de la taille de scène de l’animation principale. Vous pouvez contrôler la
      région d’impression en spécifiant les paramètres bmovie, bmax ou bframe.
      Tous les éléments imprimables d’une animation doivent être complètement chargés avant de
      commencer l’impression.
      La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
      Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
      Voir aussi
      print, printAsBitmapNum, printNum


printAsBitmapNum
      Disponibilité
      Flash Player 5.
      Usage
      printAsBitmapNum(niveau)
      printAsBitmapNum(niveau, "régionDimpression")

      Paramètres
      niveau Le niveau Flash Player à imprimer. Par défaut, toutes les images du niveau sont
      imprimées. Affectez une étiquette #p aux images que vous souhaitez imprimer dans ce niveau.
      régionDimpression Un modificateur qui définit la région d’impression de l’animation. Ce
      paramètre est facultatif. Vous pouvez choisir un des paramètres suivants :
      •   bmovie Désigne le cadre de délimitation d’une image spécifique d’une animation comme
          région d’impression de toutes les images imprimables de l’animation. Affectez une étiquette
          d’image #b à l’image dont vous souhaitez utiliser le cadre de délimitation comme région
          d’impression.



384
  •   bmax   Désigne un composite de tous les cadres de délimitation, de toutes les images
      imprimables, comme région d’impression. Spécifiez le paramètre bmax lorsque la taille des
      images de votre animation varie.
  •   bframe Indique que le cadre de délimitation de chaque image imprimable est utilisé comme
      région d’impression pour cette image. Cela modifie la région d’impression pour chaque image
      et modifie la taille des objets pour qu’ils correspondent à la région d’impression. Utilisez
      bframe si vous avez des objets de tailles diverses dans chaque image et si vous souhaitez que
      chaque objet remplisse la page imprimée.
  Renvoie
  Rien.
  Description
  Action ; imprime un niveau de Flash Player au format bitmap. Utilisez l’action
  printAsBitmapNum pour imprimer des animations contenant des images avec des objets qui
  utilisent des effets de transparence ou de couleur. L’action printAsBitmapNum imprime avec la
  résolution la plus élevée possible sur l’imprimante pour préserver autant de définition et de qualité
  que possible. Pour calculer la taille de fichier imprimable d’une image à imprimer en bitmap,
  multipliez la largeur en pixels par la hauteur en pixels par la résolution de l’imprimante.
  Si votre animation ne contient pas de transparences alpha ou d’effets de couleur, il est
  recommandé d’utiliser l’action printNum pour un résultat de meilleure qualité.
  Par défaut, la région d’impression est déterminée par la taille de la scène de l’animation chargée.
  L’animation n’hérite pas de la taille de scène de l’animation principale. Vous pouvez contrôler la
  région d’impression en spécifiant les paramètres bmovie, bmax ou bframe.
  Tous les éléments imprimables d’une animation doivent être complètement chargés avant de
  commencer l’impression.
  La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
  Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
  Voir aussi
  print, printAsBitmap, printNum


printNum
  Disponibilité
  Flash Player 5.
  Usage
  printNum (niveau, "régionDimpression")

  Paramètres
  niveau Le niveau Flash Player à imprimer. Par défaut, toutes les images du niveau sont
  imprimées. Affectez une étiquette #p aux images que vous souhaitez imprimer dans ce niveau.
  régionDimpression Un modificateur qui définit la région d’impression de l’animation. Vous
  pouvez choisir un des paramètres suivants :




                                                                         Dictionnaire ActionScript 385
      •   bmovie Désigne le cadre de délimitation d’une image spécifique d’une animation comme
          région d’impression de toutes les images imprimables de l’animation. Affectez une étiquette
          d’image #b à l’image dont vous souhaitez utiliser le cadre de délimitation comme région
          d’impression.
      •   bmax   Désigne un composite de tous les cadres de délimitation, de toutes les images
          imprimables, comme région d’impression. Spécifiez le paramètre bmax lorsque la taille des
          images de votre animation varie.
      •   bframe Indique que le cadre de délimitation de chaque image imprimable est utilisé comme
          région d’impression pour cette image. Cela modifie la région d’impression pour chaque image
          et modifie la taille des objets pour qu’ils correspondent à la région d’impression. Utilisez
          bframe si vous avez des objets de tailles diverses dans chaque image et si vous souhaitez que
          chaque objet remplisse la page imprimée.
      Renvoie
      Rien.
      Description
      Action ; imprime le niveau de Flash Player en fonction des limites spécifiées dans le paramètre
      régionDimpression ("bmovie", "bmax", "bframe"). Affectez une étiquette #p aux images que
      vous souhaitez imprimer dans l’animation cible. Bien que l’action printNum fournisse des
      impressions de meilleure qualité que l’action printAsBitmapNum, elle ne peut pas être utilisée
      pour imprimer des animations utilisant les transparences alpha ou des effets de couleur spéciaux.
      Si vous ne spécifiez pas de paramètre de limites d’impression, la région d’impression est
      déterminée par la taille de la scène de l’animation chargée, par défaut. L’animation n’hérite pas de
      la taille de scène de l’animation principale. Vous pouvez contrôler la région d’impression en
      spécifiant les paramètres bmovie, bmax ou bframe.
      Tous les éléments imprimables d’une animation doivent être complètement chargés avant de
      commencer l’impression.
      La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
      Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
      Voir aussi
      print, printAsBitmap, printAsBitmapNum


_quality
      Disponibilité
      Flash Player 5.
      Usage
      _quality

      Description
      Propriété (globale) ; définit ou récupère la qualité de rendu utilisée pour une animation. Les
      polices de périphérique sont toujours aliasées et ne sont donc pas affectées par la propriété
      _quality.

      La propriété _quality peut être définie avec les valeurs suivantes :




386
  •   "LOW" Qualité de rendu faible. Les graphiques ne sont pas anti-aliasés et les bitmaps ne sont
      pas lissés.
  •   "MEDIUM"      Qualité de rendu moyenne. Les graphiques sont anti-aliasés avec une grille 2x2, en
      pixels, mais les bitmaps ne sont pas lissés. Convient aux animations ne contenant pas de texte.
  •   "HIGH" Qualité de rendu élevée. Les graphiques sont anti-aliasés avec une grille 4x4, en
      pixels, et les bitmaps sont lissés si l’animation est statique. Il s’agit du paramètre de qualité de
      rendu par défaut utilisé par Flash.
  •   "BEST" Qualité de rendu très élevée. Les graphiques sont anti-aliasés avec une grille 4x4, en
      pixels, et les bitmaps sont toujours lissés.
  Exemple
  L’exemple suivant définit la qualité de rendu sur LOW :
  _quality = "LOW";

  Voir aussi
  _highquality, toggleHighQuality


random
  Disponibilité
  Flash Player 4. Cette fonction est déconseillée dans Flash 5 ; l’utilisation de la méthode
  Math.random est recommandée.

  Usage
  random(valeur)

  Paramètres
  valeur       Un entier.
  Renvoie
  Un entier.
  Description
  Fonction ; renvoie un entier aléatoire entre 0 et un de moins que l’entier spécifié dans le
  paramètre valeur.
  Exemple
  L’utilisation suivante de random renvoie une valeur de 0, 1, 2, 3 ou 4 :
  random(5);

  Voir aussi
  Math.random




                                                                            Dictionnaire ActionScript 387
removeMovieClip
      Disponibilité
      Flash Player 4.
      Usage
      removeMovieClip(cible)

      Paramètres
      cible    Le chemin cible d’une occurrence de clip créée avec duplicateMovieClip, ou le nom
      d’occurrence d’un clip créé avec les méthodes attachMovie ou duplicateMovieClip de l’objet
      MovieClip.
      Renvoie
      Rien.
      Description
      Action ; supprime une occurrence de clip créée avec les méthodes attachMovie ou
      duplicateMovieClip de l’objet MovieClip, ou avec l’action duplicateMovieClip.

      Voir aussi
      duplicateMovieClip, MovieClip.duplicateMovieClip, MovieClip.attachMovie,
      MovieClip.removeMovieClip


return
      Disponibilité
      Flash Player 5.
      Usage
      return[expression]
      return

      Paramètres
      expression      Une chaîne, un nombre, un tableau ou un objet à évaluer et à renvoyer comme
      valeur de la fonction. Ce paramètre est facultatif.
      Renvoie
      Le paramètre expression évalué, si fourni.
      Description
      Action ; spécifie la valeur renvoyée par une fonction. L’action return évalue expression et
      renvoie le résultat en tant que valeur de la fonction dans laquelle elle est exécutée. L’action
      return entraîne l’arrêt de la fonction et son remplacement par la valeur renvoyée. Si l’instruction
      return est utilisée seule, elle renvoie null.




388
   Exemple
   L’exemple suivant utilise l’action return à l’intérieur du corps de la fonction somme pour
   renvoyer la valeur de la somme des trois paramètres. La ligne de code suivante appelle la fonction
   somme et affecte la valeur renvoyée à la variable nouvelleValeur :
   function somme(a, b, c){
     return a + b + c;
   }
   nouvelleValeur = somme(4, 32, 78);
   trace(nouvelleValeur);
   // affiche 114 dans la fenêtre Sortie

   Voir aussi
   function

_root
   Disponibilité
   Flash Player 4.
   Usage
   _root.clip
   _root.action
   _root.propriété

   Paramètres
   clip     Le nom d’occurrence d’un clip.
   action     Une action ou méthode
   propriété       Une propriété de l’objet MovieClip.
   Description
   Propriété ; spécifie ou renvoie une référence au scénario de l’animation principale. Si une
   animation possède plusieurs niveaux, le scénario principal de l’animation se situe dans le niveau
   contenant le script en cours d’exécution. Par exemple, si un script de niveau 1 est évalué comme
   _root, _level1 est renvoyé.

   La spécification de _root est identique à l’utilisation de la notation à barre oblique (/) pour
   spécifier un chemin absolu au sein du niveau courant.
   Exemple
   L’exemple suivant arrête le scénario du niveau contenant le script en cours d’exécution :
   _root.stop();
   L’exemple suivant envoie la tête de lecture du scénario dans le niveau courant à l’image 3 :
   _root.gotoAndStop(3);

   Voir aussi
   _parent, targetPath




                                                                          Dictionnaire ActionScript 389
scroll
      Disponibilité
      Flash Player 4.
      Usage
      nomDeVariableDeChampDeTexte.scroll = x

      Description
      Propriété ; une propriété maintenant déconseillée qui contrôle l’affichage des informations d’un
      champ de texte associé à une variable. La propriété scroll définit l’endroit où le champ de texte
      commence à afficher le contenu ; après l’avoir définie, Flash Player la met à jour au fur et à
      mesure que l’utilisateur fait défiler le champ de texte. La propriété scroll est utile pour diriger les
      utilisateurs vers un paragraphe spécifique dans un long passage, ou pour créer des champs de texte
      défilants. Cette propriété peut être récupérée et modifiée.
      Exemple
      Le code suivant est associé à un bouton Haut qui fait défiler le champ de texte monTexte :
      on(release) {
        monTexte.scroll = monTexte.scroll + 1;
      }

      Voir aussi
      TextField.maxscroll, TextField.scroll

Selection (objet)
      L’objet Selection vous permet de définir et de contrôler le champ de texte dans lequel est situé le
      curseur dans une animation Flash. Le champ de texte qui a le « focus » est le champ dans lequel se
      trouve actuellement le curseur. Les index de la plage de sélection sont basés sur zéro (par exemple,
      la première position est 0, la deuxième est 1, et ainsi de suite).
      Il n’existe pas de méthode constructeur pour l’objet Selection car il ne peut y avoir qu’un seul
      champ de texte avec focus à la fois.

Méthodes de l’objet Selection

      Méthode                       Description

      Selection.addListener         Enregistre un objet pour la réception de notification lorsque la méthode
                                    onSetFocus est invoquée.

      Selection.getBeginIndex       Renvoie l’index du début de la plage de sélection. Renvoie -1 s’il n’y a pas d’index
                                    ou de champ sélectionné courant.

      Selection.getCaretIndex       Renvoie la position courante du point d’insertion dans la plage de sélection avec
                                    focus. Renvoie -1 s’il n’y a pas de position de point d’insertion ou de plage de
                                    sélection avec focus.

      Selection.getEndIndex         Renvoie l’index de la fin de la plage de sélection. Renvoie -1 s’il n’y a pas d’index
                                    ou de champ sélectionné courant.

      Selection.getFocus            Renvoie le nom de la variable pour le champ de texte avec focus. Renvoie null
                                    s’il n’existe aucun champ de texte avec focus.

      Selection.removeListener      Retire un objet enregistré avec addListener.




390
    Méthode                      Description

    Selection.setFocus           Cible le champ de texte associé à la variable spécifiée dans le paramètre.

    Selection.setSelection       Définit les index de début et de fin de la plage de sélection.


Ecouteurs de l’objet Selection

    Méthode                      Description

    Selection.onSetFocus         Notifié lorsque le focus de saisie change.


Selection.addListener
    Disponibilité
    Flash Player 6.
    Usage
    Selection.addListener(nouvelEcouteur)
    Paramètres
    nouvelEcouteur      Un objet avec une méthode onSetFocus.
    Renvoie
    Rien.
    Description
    Méthode ; enregistre un objet pour la réception de notifications de changement de focus clavier.
    Lorsque le focus change (par exemple, lorsque la méthode Selection.SetFocus est invoquée), la
    méthode onSetFocus de tous les objets écouteurs enregistrés avec addListener est invoquée.
    Plusieurs objets peuvent attendre des notifications de changement de focus. Si l’écouteur
    nouvelEcouteur est déjà enregistré, aucun changement n’a lieu.


Selection.getBeginIndex
    Disponibilité
    Flash Player 5.
    Usage
    Selection.getBeginIndex()

    Paramètres
    Aucun.
    Renvoie
    Un entier.
    Description
    Méthode ; renvoie l’index du début de la plage de sélection. Si aucun index n’existe ou si aucun
    champ de texte courant n’a le focus, la méthode renvoie -1. Les index de la plage de sélection sont
    basés sur zéro (par exemple, la première position est 0, la deuxième est 1, et ainsi de suite).




                                                                                   Dictionnaire ActionScript 391
Selection.getCaretIndex
      Disponibilité
      Flash Player 5.
      Usage
      Selection.getCaretIndex()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie l’index de la position du curseur clignotant. Si aucun curseur clignotant n’est
      affiché, la méthode renvoie -1. Les index de la plage de sélection sont basés sur zéro (par exemple,
      la première position est 0, la deuxième est 1, et ainsi de suite).

Selection.getEndIndex
      Disponibilité
      Flash Player 5.
      Usage
      Selection.getEndIndex()

      Paramètres
      Aucun.
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie l’index de fin de la zone de sélection avec le focus courant. Si aucun index
      n’existe ou s’il n’y a aucune plage de sélection avec le focus, la méthode renvoie -1. Les index de la
      plage de sélection sont basés sur zéro (par exemple, la première position est 0, la deuxième est 1, et
      ainsi de suite).

Selection.getFocus
      Disponibilité
      Flash Player 5. Les noms d’occurrences de boutons et de champs de texte fonctionnent dans
      Flash Player 6.
      Usage
      Selection.getFocus()

      Paramètres
      Aucun.
      Renvoie
      Rien.



392
   Description
   Méthode ; renvoie le nom de variable du champ de texte ayant le focus. Si aucun champ de texte
   n’a le focus, la méthode renvoie null. Si le focus actuel est un bouton, et que le bouton est une
   occurrence de l’objet Button, getFocus renvoie le chemin cible sous forme de chaîne. Si le focus
   actuel est un champ de texte, et que le champ de texte est une occurrence de l’objet TextField,
   getFocus renvoie le chemin cible sous forme de chaîne.

   Si un clip de bouton est le bouton où se trouve actuellement le focus, Selection.getFocus
   renvoie le chemin cible du clip de bouton. Si un champ de texte avec un nom d’occurrence a
   actuellement le focus, Selection.getFocus renvoie le chemin cible de l’objet TextField. Sinon,
   il renvoie le nom de variable du champ de texte.

Selection.onSetFocus
   Disponibilité
   Flash Player 6.
   Usage
   unEcouteur.onSetFocus = function(ancienFocus, nouveauFocus){
   instructions;
   }

   Description
   Ecouteur ; notifié lorsque le focus de saisie change. Pour utiliser onSetFocus, vous devez créer un
   objet d’écoute. Vous pouvez alors définir une fonction pour onSetFocus et utiliser la méthode
   addListener pour enregistrer l’écouteur avec l’objet Selection, comme dans l’exemple suivant :
   unEcouteur = new Object();
   unEcouteur.onSetFocus = function () { ... };
   Selection.addListener(unEcouteur);
   Les écouteurs permettent à différents morceaux de code de coopérer étant donné que plusieurs
   écouteurs peuvent recevoir une notification concernant un seul événement.
   Voir aussi
   Selection.addListener

Selection.removeListener
   Disponibilité
   Flash Player 6.
   Usage
   Selection.removeListener(écouteur)
   Paramètres
   écouteur     L’objet qui ne reçoit plus de notification de focus.
   Renvoie
   Si l’écouteur a été correctement retiré de la méthode renvoie true. Si l’écouteur n’a pas été
   correctement retiré, par exemple si l’écouteur n’apparaissait pas dans la liste des écouteurs de
   l’objet Selection, la méthode renvoie false.
   Description
   Méthode ; retire un objet précédemment enregistré avec addListener.


                                                                         Dictionnaire ActionScript 393
Selection.setFocus
      Disponibilité
      Flash Player 5. Les noms d’occurrences de boutons et de champs de texte ne fonctionnent que
      dans Flash Player 6.
      Usage
      Selection.setFocus("cheminDeVariable")

      Paramètres
      cheminDeVariable        Une chaîne spécifiant le chemin du nom d’une variable associée à un
      champ de texte.
      Renvoie
      Un événement.
      Description
      Méthode ; cible le champ de texte déroulante associé à la variable spécifiée par
      cheminDeVariable. Le paramètre cheminDeVariable doit être une chaîne littérale du chemin
      de cette variable. Vous pouvez utiliser la notation à point ou la notation à barre oblique pour
      spécifier le chemin. Vous pouvez également utiliser un chemin relatif ou absolu.
      Si un chemin cible d’une occurrence de bouton est transmis au paramètre cheminDeVariable, ce
      bouton devient le nouveau focus. Si un chemin cible d’une occurrence de champ de texte est
      transmis au paramètre cheminDeVariable, ce champ de texte devient le nouveau focus. Si null
      est transmis, le focus actuel est retiré.
      Si un clip de bouton est transmis à Selection.setFocus, ce bouton devient le focus actuel. Si
      un objet TextField est spécifié, il devient le focus actuel. Si un objet Button est spécifié, ce bouton
      devient le focus actuel.
      Exemple
      L’exemple suivant met le focus sur un champ de texte du scénario principal qui est associé à la
      variable maVar. Le paramètre cheminDeVariable est un chemin absolu, ce qui vous permet
      d’appeler l’action à partir de n’importe quel scénario.
      Selection.setFocus("_root.maVar");
      Dans l’exemple suivant, le champ de texte associé à maVar est dans un clip appelé monClip dans le
      scénario principal. Vous pouvez utiliser l’un ou l’autre des deux chemins suivants pour définir le
      focus, le premier étant relatif, le deuxième absolu.
      Selection.setFocus("monClip.maVar");
      Selection.setFocus("_root.monClip.maVar");




394
Selection.setSelection
   Disponibilité
   Flash Player 5.
   Usage
   Selection.setSelection(début, fin)

   Paramètres
   début     L’index de début de la plage de sélection.
   fin     L’index de fin de la plage de sélection.
   Renvoie
   Rien.
   Description
   Méthode ; définit la plage de sélection du champ de texte avec focus. La nouvelle plage de
   sélection commencera à l’index spécifié dans le paramètre début et finira à l’index spécifié dans le
   paramètre fin. Les index de la plage de sélection sont basés sur zéro (par exemple, la première
   position est 0, la deuxième est 1, et ainsi de suite). Cette méthode n’a aucun effet si aucun champ
   de texte n’a le focus.

set variable
   Disponibilité
   Flash Player 4.
   Usage
   set(variable, expression)

   Paramètres
   variable      Un identifiant devant contenir la valeur du paramètre de l’expression.
   expression        Une valeur affectée à la variable.
   Renvoie
   Rien.
   Description
   Action ; affecte une valeur à une variable. Une variable est un conteneur d’informations. Le
   conteneur reste toujours le même, c’est le contenu qui peut varier. La modification de la valeur
   d’une variable pendant la lecture d’une animation permet d’enregistrer les informations relatives
   aux actions de l’utilisateur, d’enregistrer les valeurs modifiées pendant la lecture de l’animation ou
   d’évaluer si une condition est true ou false.
   Les variables peuvent contenir n’importe quel type de données (par exemple, chaîne, nombre,
   booléen, objet ou clip). Le scénario de chaque animation et clip possède son propre jeu de
   variables et chaque variable possède sa propre valeur indépendante des variables des autres
   scénarios.
   ActionScript est un langage dynamiquement typé. Chaque variable a un type. Le type est affecté
   à l’exécution et peut changer pendant l’exécution. Ceci est différent d’un langage de type
   statique, comme Java ou C++, où le type est affecté au moment de la compilation et ne peut pas
   changer à l’exécution.


                                                                           Dictionnaire ActionScript 395
      Exemple
      Cet exemple définit une variable appelée orig_x_pos qui stocke la position originale de l’axe x du
      clip vaisseau afin de pouvoir le réinitialiser à sa position de début plus tard dans l’animation.
      on(release) {
        set(pos_x_orig, getProperty ("vaisseau", _x ));
      }
      Le code précédent donne le même résultat que le suivant :
      on(release) {
        pos_x_orig = vaisseau._x;
      }

      Voir aussi
      var, call


setInterval
      Disponibilité
      Flash Player 6.
      Usage
      setInterval( fonction, intervalle[, param1, param2, ..., paramn] )
      setInterval( objet, nomDeMéthode, intervalle[, param1, param2, ..., paramn] )

      Paramètres
      fonction     Un nom de fonction ou une référence à une fonction anonyme.
      objet    Un objet dérivé de l’objet Object.
      nomDeMéthode        Le nom de la méthode à appeler pour le paramètre objet.
      intervalle        Le temps en millisecondes entre appels au paramètre fonction ou nomDeMéthode.
      param1, param2, ..., paramn           Paramètres facultatifs transmis au paramètre fonction ou
      nomDeMéthode.

      Renvoie
      Un identifiant d’intervalle que vous pouvez transmettre à clearInterval pour annuler
      l’intervalle.
      Description
      Action ; appelle une fonction, une méthode ou un objet à intervalles périodiques pendant la
      lecture d’une animation. Vous pouvez utiliser une fonction d’intervalle pour mettre à jour des
      variables d’une base de données ou mettre à jour un temps affiché.
      Si intervalle est inférieur à la cadence de l’animation (par exemple, 10 images par seconde est
      égal à 100 millisecondes), la fonction d’intervalle est appelée aussi près que possible de
      intervalle. Vous devez utiliser la fonction updateAfterEvent pour assurer un rafraîchissement
      de l’écran avec une fréquence appropriée. Si intervalle est supérieur à la cadence de
      l’animation, la fonction d’intervalle est seulement appelée à chaque fois que la tête de lecture entre
      dans une image, afin de minimiser l’impact de chaque rafraîchissement de l’écran.
      Le premier exemple de syntaxe ci-dessus est la syntaxe par défaut pour la fonction setInterval
      dans le panneau Actions en mode Normal. Pour utiliser le deuxième exemple de syntaxe, vous
      devez utiliser le panneau Action en mode Expert.



396
   Exemple
   Usage 1. L’exemple suivant appelle une fonction anonyme toutes les 1000 millisecondes (toutes
   les secondes).
   setInterval( function(){ trace("intervalle appelé"); }, 1000 );
   Usage 2. L’exemple suivant définit deux fonctions de rappel et appelle chacune d’elles. Les deux
   appels à la fonction setInterval envoient la chaîne "intervalle appelé" à la fenêtre Sortie
   toutes les 1000 millisecondes. Le premier appel à setInterval appelle la fonction callback1,
   qui contient une action trace. Le deuxième appel à setInterval transmet la chaîne
   "intervalle appelé" à la fonction callback2 en tant que paramètre.
   function callback1() {
     trace("intervalle appelé");
   }

   function callback2(param) {
     trace(param);
   }

   setInterval( callback1, 1000 );
   setInterval( callback2, 1000, "intervalle appelé" );
   Usage 3. Cet exemple utilise une méthode d’un objet. Vous devez utiliser cette syntaxe lorsque
   vous voulez appeler une méthode qui est définie pour un objet. Vous pouvez seulement utiliser
   cette syntaxe en mode Expert.
   obj = new Object();
   obj.interval = function() {
     trace("fonction d’intervalle appelée");
   }

   setInterval( obj, "interval", 1000 );

   obj2 = new Object();
   obj2.interval = function(s) {
     trace(s);
   }
   setInterval( obj2, "interval", 1000, "fonction d’intervalle appelée" );
   Vous devez utiliser la deuxième forme de la syntaxe setInterval pour appeler une méthode d’un
   objet, comme suit :
   setInterval( obj2, "interval", 1000, "fonction d’intervalle appelée" );

   Voir aussi
   clearInterval, updateAfterEvent


setProperty
   Disponibilité
   Flash Player 4.
   Usage
   setProperty("cible", propriété, valeur/expression)

   Paramètres
   cible    Le chemin du nom d’occurrence du clip dont la propriété est à définir.
   propriété       La propriété à définir.


                                                                        Dictionnaire ActionScript 397
      valeur    La nouvelle valeur littérale de la propriété.
      expression     Une équation qui est la nouvelle valeur de la propriété.
      Renvoie
      Rien.
      Description
      Action ; modifie la valeur d’une propriété de clip pendant la lecture de l’animation.
      Exemple
      Cette instruction définit la propriété _alpha du clip nommé étoile sur 30 % lorsque le bouton
      est cliqué :
      on(release) {
        setProperty("étoile", _alpha, "30");
      }

      Voir aussi
      getProperty

Sound (objet)
      L’objet Sound vous permet de contrôler le son dans une animation. Vous pouvez ajouter des sons
      à un clip à partir de la bibliothèque pendant la lecture de l’animation et contrôler ces sons. Si vous
      ne spécifiez pas de cible (cible) lorsque vous créez un nouvel objet Sound, vous pouvez utiliser
      les méthodes pour contrôler le son de toute l’animation. Vous devez utiliser le constructeur new
      Sound pour créer une occurrence de l’objet Sound avant d’en appeler les méthodes.
      L’objet Sound est supporté par Flash Player 5 et Flash Player 6.

Méthodes de l’objet Sound

      Méthode                   Description

      Sound.attachSound         Attache le son spécifié dans le paramètre.

      Sound.getBytesLoaded      Renvoie le nombre d’octets chargés pour le son spécifié.

      Sound.getBytesTotal       Renvoie la taille du son, en octets.

      Sound.getPan              Renvoie la valeur de l’appel setPan précédent.

      Sound.getTransform        Renvoie la valeur de l’appel setTransform précédent.

      Sound.getVolume           Renvoie la valeur de l’appel setVolume précédent.

      Sound.loadSound           Charge un fichier MP3 dans Flash Player.

      Sound.setPan              Définit la balance gauche/droite du son.

      Sound.setTransform        Définit la quantité de chaque canal, gauche et droite, à lire dans chaque haut-
                                parleur.

      Sound.setVolume           Définit le niveau du volume pour un son.

      Sound.start               Démarre la lecture d’un son depuis le début ou, en option, depuis un point défini
                                dans le paramètre.

      Sound.stop                Arrête le son spécifié ou tous les sons en cours de lecture.




398
Propriétés de l’objet Sound

    Propriété             Description

    Sound.duration        Durée d’un son, en millisecondes.

    Sound.position        Nombre de millisecondes de lecture du son.


Gestionnaires d’événement de l’objet Sound

    Méthode               Description

    Sound.onLoad          Invoqué au chargement d’un son.

    Sound.onSoundComp     Invoqué à la fin de la lecture d’un son.
    lete


Constructeur pour l’objet Sound
    Disponibilité
    Flash Player 5.
    Usage
    new Sound([cible])

    Paramètres
    cible     L’occurrence de clip sur laquelle agit l’objet Sound. Ce paramètre est facultatif.
    Renvoie
    Rien.
    Description
    Constructeur ; crée un nouvel objet Sound pour un clip spécifié. Si vous ne spécifiez pas
    d’occurrence cible, l’objet Sound contrôle tous les sons de l’animation.
    Exemple
    L’exemple suivant crée une nouvelle occurrence de l’objet Sound appelé sonGlobal. La deuxième
    ligne appelle la méthode setVolume et règle le volume de tous les sons de l’animation à 50 %.
    sonGlobal = new Sound();
    sonGlobal.setVolume(50);
    L’exemple suivant crée une nouvelle occurrence de l’objet Sound, lui transmet le clip cible
    monAnimation et appelle la méthode start, qui démarre tous les sons de monAnimation.
    sonDanimation = new Sound(monAnimation);
    sonDanimation.start();




                                                                            Dictionnaire ActionScript 399
Sound.attachSound
      Disponibilité
      Flash Player 5.
      Usage
      monSon.attachSound("nomIdentifiant")

      Paramètres
      nomIdentifiant L’identifiant d’un son exporté dans la bibliothèque. L’identifiant est situé
      dans la boîte de dialogue Propriétés de liaison de symbole.
      Renvoie
      Rien.
      Description
      Méthode ; associe le son spécifié par le paramètre nomIdentifiant à l’objet Sound spécifié. Le
      son doit se trouver dans la bibliothèque de l’animation courante et être spécifié pour l’exportation
      dans la boîte de dialogue Propriétés de liaison de symbole. Vous devez appeler Sound.start pour
      démarrer la lecture du son.
      Voir aussi
      Sound.start

Sound.duration
      Disponibilité
      Flash Player 6.
      Usage
      monSon.duration
      Description
      Propriété (lecture seule) ; la durée d’un son, en millisecondes.

Sound.getBytesLoaded
      Disponibilité
      Flash Player 6.
      Usage
      monSon.getBytesLoaded()

      Paramètres
      Aucun.
      Renvoie
      Un entier indiquant le nombre d’octets chargés.




400
   Description
   Méthode ; renvoie le nombre d’octets chargés (en flux continu) pour l’objet Sound spécifié. Vous
   pouvez comparer la valeur de getBytesLoaded avec celle de getBytesTotal pour déterminer le
   pourcentage d’un son qui a été chargé.
   Voir aussi
   Sound.getBytesTotal

Sound.getBytesTotal
   Disponibilité
   Flash Player 6.
   Usage
   monSon.getBytesTotal()

   Paramètres
   Aucun.
   Renvoie
   Un entier indiquant la taille totale, en octets, de l’objet Sound spécifié.
   Description
   Méthode ; renvoie la taille, en octets, de l’objet Sound spécifié.
   Voir aussi
   Sound.getBytesLoaded

Sound.getPan
   Disponibilité
   Flash Player 5.
   Usage
   monSon.getPan();

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Méthode ; renvoie le niveau de balance défini dans le dernier appel setPan sous la forme d’un
   entier compris entre -100 (gauche) et 100 (droite). 0 règle le canal gauche et le canal droit au
   même niveau. Le réglage de balance contrôle la balance gauche-droite des sons actuels et futurs
   d’une animation.
   Cette méthode est cumulable avec les méthodes setVolume ou setTransform.
   Voir aussi
   Sound.setPan




                                                                            Dictionnaire ActionScript 401
Sound.getTransform
      Disponibilité
      Flash Player 5.
      Usage
      monSon.getTransform();

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; renvoie les informations de transformation de son pour l’objet Sound spécifié défini
      avec le dernier appel setTransform.
      Voir aussi
      Sound.setTransform

Sound.getVolume
      Disponibilité
      Flash Player 5.
      Usage
      monSon.getVolume()

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode ; renvoie le niveau du volume du son sous la forme d’un entier compris entre 0 et 100,
      avec 0 pour éteint et 100 pour volume maximum. Le paramètre par défaut est 100.
      Voir aussi
      Sound.setVolume

Sound.loadSound
      Disponibilité
      Flash Player 6.
      Usage
      monSon.loadSound("url", fluxContinu)

      Paramètres
      url   L’emplacement sur un serveur d’un fichier MP3.
      fluxContinu    Une valeur booléenne qui indique si le son est un son en flux continu ou un son
      d’événement.



402
  Renvoie
  Rien.
  Description
  Méthode ; charge un fichier MP3 dans une occurrence de l’objet Sound. Vous pouvez utiliser le
  paramètre isStreaming pour indiquer si le son est un événement ou un son lu en flux continu.
  Les sons d’événement sont complètement chargés avant d’être lus. Ils sont gérés par l’objet Sound
  d’ActionScript et répondent à toutes les méthodes et propriétés de cet objet.
  Les sons en flux continu sont lus pendant leur téléchargement. La lecture commence lorsque
  suffisamment de données ont été reçues pour démarrer le décompresseur. Comme c’est le cas
  pour les sons d’événement, les sons en flux continu existent seulement en mémoire virtuelle et ne
  sont pas téléchargés sur le disque dur.
  Exemple
  L’exemple suivant charge un son d’événement :
  s.loadSound( "http://cheminDuServeur:port/nomDuFichierMp3", false);
  L’exemple suivant charge un son en flux continu :
  loadSound( "http://cheminDuServeur:port/nomDuFichierMp3", true);

Sound.onLoad
  Disponibilité
  Flash Player 6.
  Usage
  monObjetSound.onLoad = fonctionDeRappel
  Paramètres
  monObjetSound     Un objet Sound.
  fonctionDeRappel      Une fonction.
  Renvoie
  Rien.
  Description
  Gestionnaire d’événement ; automatiquement invoqué au chargement d’un son. Vous devez créer
  une fonction exécutée lorsque l’événement onLoad est invoqué. Vous pouvez utiliser une fonction
  anonyme ou une fonction nommée.
  Voir aussi
  Sound.onSoundComplete




                                                                      Dictionnaire ActionScript 403
Sound.onSoundComplete
      Disponibilité
      Flash Player 6.
      Usage
      monObjetSound.onSoundComplete = fonctionDeRappel
      Paramètres
      monObjetSound     Un objet Sound.
      fonctionDeRappel      Une fonction.
      Renvoie
      Rien.
      Description
      Evénement ; automatiquement invoqué à la fin de la lecture d’un son. Vous pouvez utiliser
      l’événement onSoundComplete pour déclencher des événements dans une animation à la fin d’un
      son.
      Vous devez créer une fonction exécutée lorsque l’événement onSoundComplete est invoqué. Vous
      pouvez utiliser une fonction anonyme ou une fonction nommée.
      Exemple
      Usage 1. L’exemple suivant utilise une fonction anonyme :
      s = new Sound();
      s.attachSound("monSon");
      s.onSoundComplete = function() { trace("monSon est terminé"); };
      s.start();
      Usage 2. L’exemple suivant utilise une fonction nommée :
      function callback1() {
      trace("monSon est terminé");
      }

      s = new Sound();
      s.attachSound("monSon");

      s.onSoundComplete = callback1;

      s.start();

Sound.position
      Disponibilité
      Flash Player 6.
      Usage
      monSon.position
      Paramètres
      Aucun.




404
  Renvoie
  Nombre de millisecondes de lecture du son.
  Description
  Propriété (lecture seule) ; renvoie le nombre de millisecondes écoulées depuis le début de la
  lecture d’un son. Si le son est lu en boucle, la position est remise à 0 au début de chaque boucle.

Sound.setPan
  Disponibilité
  Flash Player 5.
  Usage
  monSon.setPan(balance);

  Paramètres
  balance    Un entier spécifiant la balance gauche-droite d’un son. Les valeurs correctes sont
  comprises entre -100 et 100, avec -100 pour le canal de gauche, 100 pour le canal de droite et 0
  pour répartir le son d’une manière uniforme entre les deux canaux.
  Renvoie
  Rien.
  Description
  Méthode ; détermine la façon dont le son est réparti dans les canaux droit et gauche (haut-
  parleurs). Pour les sons mono, balance détermine le haut-parleur (gauche ou droit) par lequel
  passe le son.
  Exemple
  L’exemple suivant crée une concurrence de l’objet Sound s et associe un son à l’identifiant L7 de
  la bibliothèque. Il appelle également les méthodes setVolume et setPan pour contrôler le son L7.
  onClipEvent(mouseDown) {
  // créer un objet Sound
    s = new Sound(this);
  // associer un son de la bibliothèque
    s.attachSound("L7");
  // définir le volume à 50 %
    s.setVolume(50);
  // désactiver le son dans le canal droit
    s.setPan(-100);
  // démarrer à partir de 30 secondes et lire le son 5 fois
    s.start(30, 5);

  Voir aussi
  Sound.attachSound, Sound.setPan, Sound.setTransform, Sound.setVolume, Sound.start




                                                                        Dictionnaire ActionScript 405
Sound.setTransform
      Disponibilité
      Flash Player 5.
      Usage
      monSon.setTransform(objetDeTransformationDeSon)

      Paramètres
      objetDeTransformationDeSon          Un objet créé avec le constructeur de l’objet générique Object.
      Renvoie
      Rien.
      Description
      Méthode ; définit les informations de transformation (balance) du son pour un objet Sound.
      Le paramètre objetDeTransformationDeSon est un objet que vous créez avec la méthode
      constructeur de l’objet générique Object avec des paramètres spécifiant comment le son est réparti
      dans les canaux gauche et droit (haut-parleurs).
      Les sons utilisent un espace disque et une mémoire considérables. Les sons stéréo utilisant deux
      fois plus de données que les sons mono, il est généralement conseillé d’utiliser des sons mono de 6
      bits et 22 kHz. Vous pouvez utiliser la méthode setTransform pour lire des sons mono en stéréo,
      des sons stéréo en mono, et pour ajouter des effets sonores intéressants.
      Les paramètres de objetDeTransformationDeSon sont les suivants :
      11 Une valeur de pourcentage spécifiant la quantité de l’entrée gauche à lire dans le haut-
      parleur gauche (0–100).
      1r Une valeur de pourcentage spécifiant la quantité de l’entrée droite à lire dans le haut-parleur
      gauche (0–100).
      rr Une valeur de pourcentage spécifiant la quantité de l’entrée droite à lire dans le haut-parleur
      droit (0–100).
      rl    Une valeur de pourcentage spécifiant la quantité de l’entrée gauche à lire dans le haut-
      parleur droit (0–100).
      Le résultat net de ces paramètres est représenté par la formule suivante :
      sortieGauche = entrée_gauche * ll + entrée_droite * lr
      sortieDroite = entrée_droite * rr + entrée_gauche * rl
      Les valeurs de entrée_gauche ou entrée_droite sont déterminées par le type de son (mono ou
      stéréo) de votre animation.
      Les sons stéréo divisent l’entrée de son de manière égale entre les haut-parleurs droit et gauche et
      ont les paramètres de transformation par défaut suivants :
      ll   =   100
      lr   =   0
      rr   =   100
      rl   =   0




406
Les sons mono sont lus dans le haut-parleur gauche et ont les paramètres de transformation par
défaut suivants :
ll   =   100
lr   =   100
rr   =   0
rl   =   0

Exemple
L’exemple suivant illustre un résultat pouvant être obtenu avec la méthode setTransform, mais
pas avec les méthodes setVolume ou setPan, même combinées.
Le code suivant crée un objet monObjetDeTransformationDeSon et définit ses propriétés de
manière à ce que le son des deux canaux soit lu uniquement dans le canal gauche.
monObjetDeTransformationDeSon = new Object;
monObjetDeTransformationDeSon.ll = 100;
monObjetDeTransformationDeSon.lr = 100;
monObjetDeTransformationDeSon.rr = 0;
monObjetDeTransformationDeSon.rl = 0;
Pour appliquer l’objet monObjetDeTransformationDeSon à un objet Sound, vous devez alors
transmettre l’objet à l’objet Sound avec la méthode setTransform, comme suit :
monSon.setTransform(monObjetDeTransformationDeSon);
L’exemple suivant lit un son stéréo en mono, le monObjetDeTransformationDeSonMono ayant
les paramètres suivants :
monObjetDeTransformationDeSonMono = new Object;
monObjetDeTransformationDeSonMono.ll = 50;
monObjetDeTransformationDeSonMono.lr = 50;
monObjetDeTransformationDeSonMono.rr = 50;
monObjetDeTransformationDeSonMono.rl = 50;
monSon.setTransform(monObjetDeTransformationDeSonMono);
Cet exemple lit le canal gauche à la moitié de sa capacité et ajoute le reste du canal gauche dans le
canal droit ; monObjetDeTransformationDeSonMoitié a les paramètres suivants.
monObjetDeTransformationDeSonMoitié = new Object;
monObjetDeTransformationDeSonMoitié.ll = 50;
monObjetDeTransformationDeSonMoitié.lr = 0;
monObjetDeTransformationDeSonMoitié.rr = 100;
monObjetDeTransformationDeSonMoitié.rl = 50;
setTransform(monObjetDeTransformationDeSonMoitié);

Voir aussi
Constructeur pour l’objet Object




                                                                       Dictionnaire ActionScript 407
Sound.setVolume
      Disponibilité
      Flash Player 5.
      Usage
      monSon.setVolume(volume)

      Paramètres
      volume Un nombre entre 0 et 100 représentant le niveau du volume. 100 est le volume
      maximum et 0 le volume nul. Le paramètre par défaut est 100.
      Renvoie
      Rien.
      Description
      Méthode ; définit le volume pour l’objet Sound.
      Exemple
      L’exemple suivant définit le volume sur 50 % et transfert progressivement le son du haut-parleur
      gauche vers le droit :
      onClipEvent(load) {
        i = -100;
        s = new Sound();
        s.setVolume(50);
      }
      onClipEvent (enterFrame) {
        if (i <= 100) {
           S.setPan(i++);
        }
      }

      Voir aussi
      Sound.setPan, Sound.setTransform


Sound.start
      Disponibilité
      Flash Player 5.
      Usage
      monSon.start([décalageSecondes, boucle])

      Paramètres
      décalageSecondes       Un paramètre facultatif vous permettant de démarrer la lecture du son à un
      point spécifique. Par exemple, si vous avez un son de 30 secondes et que vous souhaitez démarrer
      la lecture du son au milieu, spécifiez 15 pour le paramètre décalageSecondes. Le son n’est pas
      retardé de 15 secondes, la lecture démarrant à la seconde 15.
      boucle    Un paramètre facultatif vous permettant de spécifier le nombre de répétitions du son.
      Renvoie
      Rien.




408
   Description
   Méthode ; démarre la lecture du dernier son associé, depuis le début si aucun paramètre n’est
   spécifié, ou à l’endroit du son spécifié dans le paramètre décalageSecondes.
   Voir aussi
   Sound.stop

Sound.stop
   Disponibilité
   Flash Player 5.
   Usage
   monSon.stop(["nomIdentifiant"])

   Paramètres
   nomIdentifiant     Un paramètre facultatif spécifiant un son spécifique à arrêter. Le paramètre
   nomIdentifiant    doit se trouver entre guillemets (" ").
   Renvoie
   Rien.
   Description
   Méthode ; arrête tous les sons en cours de lecture si aucun paramètre n’est spécifié, ou
   uniquement le son spécifié dans le paramètre nomIdentifiant.
   Voir aussi
   Sound.start

_soundbuftime
   Disponibilité
   Flash Player 4.
   Usage
   _soundbuftime = entier
   Paramètres
   entier    Le nombre de secondes avant que l’animation ne démarre en lecture continue.
   Description
   Propriété (globale) ; établit le nombre de secondes de mise en tampon d’un son en flux continu.
   La valeur par défaut est de 5 secondes.




                                                                         Dictionnaire ActionScript 409
Stage (objet)
      L’objet Stage est un objet de haut niveau auquel vous pouvez accéder sans utiliser de constructeur.
      Utilisez les méthodes et propriétés de cet objet pour accéder aux informations de limites d’une
      animation Flash et les manipuler.
      L’objet Stage est disponible dans Flash Player 6 et les versions suivantes.

Méthodes de l’objet Stage

      Méthode                   Description

      Stage.addListener         Ajoute un objet d’écoute à l’objet Stage.

      Stage.removeListener      Supprime un objet d’écoute de l’objet Stage.


Propriétés de l’objet Stage

      Propriété                          Description

      Stage.align                        Alignement de l’animation Flash dans le navigateur.

      Stage.height                       Hauteur de la scène, en pixels.

      Stage.width                        Largeur de la scène, en pixels.

      Stage.scaleMode                    Redimensionnement actuel de l’animation Flash.


Gestionnaires d’événement de l’objet Stage

      Méthode                   Description

      Stage.onResize            Indique que l’animation a été redimensionnée.


Stage.addListener
      Disponibilité
      Flash Player 6.
      Usage
      Stage.addListener(monEcouteur)

      Paramètres
      monEcouteur       Un objet qui attend une notification de rappel de la part de l’événement
      onResize.

      Renvoie
      Rien.
      Description
      Méthode ; détecte le redimensionnement d’une animation Flash si Stage.scaleMode =
      "noScale". La méthode addListener ne fonctionne pas avec le paramètre d’échelle d’animation
      par défaut ("showAll"), ni avec d’autres paramètres d’échelle ("exactFit" et "noBorder").




410
   Pour utiliser addListener, vous devez d’abord créer un objet d’écoute. Un objet d’écoute est un
   objet qui reçoit une notification d’un événement lorsque cet événement est déclenché dans une
   animation. Les objets d’écoute de l’objet Stage reçoivent une notification de Stage.onResize.
   Exemple
   Cet exemple crée un objet d’écoute appelé monEcouteur. Il utilise ensuite monEcouteur pour
   appeler onResize et définir une fonction qui sera appelée lorsque onResize sera déclenché.
   Enfin, le code ajoute l’objet monEcouteur à la liste de rappel de l’objet Stage. Les objets d’écoute
   permettent à plusieurs objets d’attendre des notifications de redimensionnement.
   monEcouteur = new Object();
   monEcouteur.onResize = function () { ... }
   Stage.addListener(monEcouteur);

Stage.align
   Disponibilité
   Flash Player 6.
   Usage
   Stage.align
   Description
   Propriété ; indique l’alignement actuel de l’animation Flash sur la scène.
   Le tableau suivant répertorie les valeurs de la propriété align. Toute valeur qui n’apparaît pas
   dans cette liste centre l’animation sur la scène.

   Valeur                            Vertical                         Horizontal

   "T"                               top                              center

   "B"                               bottom                           center

   "L"                               center                           left

   "R"                               center                           right

   "TL"                              top                              left

   "TR"                              top                              right

   "BL"                              bottom                           left

   "BR"                              bottom                           right




                                                                             Dictionnaire ActionScript   411
Stage.height
      Disponibilité
      Flash Player 6.
      Usage
      Stage.height
      Description
      Propriété (lecture seule) ; indique la hauteur, en pixels, de la scène de l’animation Flash. Lorsque
      la propriété Stage.noScale a une valeur de true, height représente la hauteur de Flash Player.
      Lorsque la valeur de Stage.noScale est false (l’animation est redimensionnée en même temps
      que la fenêtre du lecteur), height représente la hauteur de l’animation Flash.

Stage.onResize
      Disponibilité
      Flash Player 6.
      Usage
      Stage.onResize() = function() {...}
      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Méthode de rappel ; indique que l’animation Flash a été redimensionnée. Vous pouvez utiliser cet
      événement pour rédiger une fonction qui dispose les objets sur la scène lorsqu’une animation est
      redimensionnée.

Stage.removeListener
      Disponibilité
      Flash Player 6.
      Usage
      Stage.removeListener(monEcouteur)

      Paramètres
      monEcouteur       Un objet ajouté à la liste de rappel d’un objet avec la méthode addListener.
      Renvoie
      Rien.
      Description
      Méthode ; retire un objet d’écoute créé avec addListener.
      Voir aussi
      Stage.addListener




412
Stage.scaleMode
   Disponibilité
   Flash Player 6.
   Usage
   Stage.scaleMode = "valeur"

   Description
   Propriété ; indique le dimensionnement actuel de l’animation Flash sur la scène. La propriété
   scaleMode oblige l’animation à adopter un mode de redimensionnement spécifique. Par défaut,
   l’animation utilise les paramètres HTML définis dans la boîte de dialogue Paramètres de
   publication.
   La propriété scaleMode peut utiliser les valeurs "exactFit", "showAll", "noBorder" et
   "noScale".  Toute autre valeur définit la propriété scaleMode à la valeur par défaut de
   "showAll".


Stage.width
   Disponibilité
   Flash Player 6.
   Usage
   Stage.width
   Description
   Propriété (lecture seule) ; indique la largeur, en pixels, de la scène de l’animation Flash. Lorsque la
   valeur de Stage.noScale est true, la propriété width représente la largeur du lecteur. Lorsque la
   valeur de Stage.noScale est false (l’animation est redimensionnée en même temps que la
   fenêtre du lecteur), width représente la largeur de l’animation Flash.

startDrag
   Disponibilité
   Flash Player 4.
   Usage
   startDrag(cible,[verrouiller ,gauche, haut, droite, bas])

   Paramètres
   cible    Le chemin cible de l’animation à faire glisser.
   verrouiller      Une valeur booléenne spécifiant si le clip glissable est verrouillé au centre de la
   position de la souris (true) ou verrouillé sur le point auquel l’utilisateur a cliqué sur le clip
   (false). Ce paramètre est facultatif.
   gauche, haut, droite, bas Valeurs relatives aux coordonnées du parent du clip spécifiant un
   rectangle de contrainte pour le clip. Ces paramètres sont facultatifs.
   Renvoie
   Rien.




                                                                            Dictionnaire ActionScript 413
      Description
      Action ; rend le clip cible déplaçable pendant la lecture de l’animation. Vous ne pouvez déplacer
      qu’un seul clip à la fois. Une fois l’opération startDrag exécutée, le clip reste déplaçable jusqu’à
      ce qu’il soit explicitement arrêté par une action stopDrag ou jusqu’à ce qu’une action startDrag
      soit appelée pour un autre clip.
      Exemple
      Pour créer un clip que l’utilisateur pourra positionner à n’importe quel endroit, associez les
      actions startDrag et stopDrag à un bouton dans le clip.
      on(press) {
        startDrag(this,true);
      }
      on(release) {
        stopDrag();
      }

      Voir aussi
      MovieClip._droptarget, stopDrag


stop
      Disponibilité
      Flash 2.
      Usage
      stop

      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Action ; arrête l’animation en cours de lecture. L’utilisation la plus fréquente de cette action sert à
      contrôler les clips à l’aide de boutons.

stopAllSounds
      Disponibilité
      Flash Player 3.
      Usage
      stopAllSounds()

      Paramètres
      Aucun.
      Renvoie
      Rien.




414
   Description
   Action ; arrête tous les sons en cours de lecture dans une animation sans arrêter la tête de lecture.
   La lecture des sons définis en flux continu reprendra lorsque la tête de lecture passera dans les
   images où ils se trouvent.
   Exemple
   Le code suivant peut être appliqué à un bouton qui, lorsque cliqué, arrête tous les sons de
   l’animation.
   on(release) {
     stopAllSounds();
   }

   Voir aussi
   Sound (objet)

stopDrag
   Disponibilité
   Flash Player 4.
   Usage
   stopDrag()

   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Action ; arrête l’opération de déplacement courante.
   Exemple
   Cette instruction arrête l’action de déplacement de l’occurrence mc lorsque l’utilisateur relâche le
   bouton de la souris :
   on(press) {
     startDrag("mc");
   }
   on(release) {
     stopdrag();
   }

   Voir aussi
   MovieClip.stopDrag, MovieClip._droptarget, startDrag,




                                                                          Dictionnaire ActionScript 415
String (fonction)
      Disponibilité
      Flash Player 4.
      Usage
      String(expression)

      Paramètres
      expression        Une expression à convertir en chaîne.
      Renvoie
      Voir ci-dessous.
      Description
      Fonction ; renvoie une représentation chaîne du paramètre spécifié, comme suit :
      Si expression est une valeur booléenne, la chaîne renvoyée true ou false.
      Si expression est un nombre, la chaîne renvoyée est une représentation texte du nombre.
      Si expression est une chaîne, la chaîne renvoyée est expression.
      Si expression est un objet, la valeur renvoyée est la représentation chaîne de l’objet, générée par
      l’appel de la propriété String de l’objet ou par l’appel de Object.toString, si une telle propriété
      n’existe pas.
      Si expression est un clip, la valeur renvoyée est le chemin cible du clip en notation à barre
      oblique (/).
      Si expression est undefined, la valeur renvoyée est une chaîne vide ("").
      Voir aussi
      Number.toString, Object.toString,         String (objet), " " (délimiteur de chaîne)

" " (délimiteur de chaîne)
      Disponibilité
      Flash Player 4.
      Usage
      "texte"

      Paramètres
      texte     Un caractère.
      Renvoie
      Rien.
      Description
      Délimiteur de chaîne ; lorsque utilisés avant et après des caractères, les guillemets droits indiquent
      que les caractères ont une valeur littérale et sont considérés comme une chaîne (pas une variable,
      ni une valeur numérique, ni un autre élément ActionScript).




416
   Exemple
   Cette exemple utilise des guillemets pour indiquer que la valeur de la variable devinette est la
   chaîne littérale « Prince Edward Island » et non le nom d’une variable. La valeur de province est
   une variable, et non une valeur littérale ; pour déterminer la valeur de province, la valeur de
   devinette doit être localisée.
   devinette = "Prince Edward Island";
   on(release) {
     province = devinette
     trace(province);
   }

   // affiche Prince Edward Island dans la fenêtre Sortie

   Voir aussi
   String (objet), String (fonction)

String (objet)
   L’objet String est une enveloppe pour le type de données primitif de chaîne, ce qui vous permet
   d’utiliser les méthodes et les propriétés de l’objet String pour manipuler les types primitifs de
   valeurs de chaîne. Vous pouvez convertir la valeur de n’importe quel objet en chaîne avec la
   fonction String(). Dans Flash MX, l’objet String est devenu un objet natif. Vous pourrez donc
   constater d’importantes améliorations des performances.
   Toutes les méthodes de l’objet String, à l’exception de concat, fromCharCode, slice et substr,
   sont génériques. Cela signifie que les méthodes appellent elles-mêmes this.toString avant
   d’effectuer leurs opérations et que vous pouvez utiliser ces méthodes avec des objets autres que
   String.
   Tous les index de chaîne étant basés sur zéro, l’index du dernier caractère de toute chaîne x est
   comme suit :
   x.length - 1
   Vous pouvez appeler n’importe quelle méthode de l’objet String en utilisant la méthode
   constructeur new String ou en utilisant une valeur de chaîne littérale. Si vous spécifiez une
   chaîne littérale, l’interprète d’ActionScript la convertit automatiquement en objet String
   temporaire, appelle la méthode puis supprime l’objet String temporaire. Vous pouvez également
   utiliser la propriété String.length avec une chaîne littérale.
   Il est important de ne pas faire de confusion entre une chaîne littérale et une occurrence de l’objet
   String. Dans l’exemple suivant, la première ligne de code crée la chaîne littérale s1 et la seconde
   ligne de code crée une occurrence de l’objet String s2.
   s1 = "machin"
   s2 = new String("machin")
   Utilisez des chaînes littérales, à moins que vous n’ayez spécifiquement besoin d’utiliser un objet
   String.




                                                                          Dictionnaire ActionScript 417
Méthodes de l’objet String

      Méthode                  Description

      String.charAt            Renvoie le caractère situé à un endroit spécifique dans une chaîne.

      String.charCodeAt        Renvoie la valeur du caractère situé à l’index donné sous forme d’entier de 16 bits entre
                               0 et 65535.

      String.concat            Combine le texte de deux chaînes et renvoie une nouvelle chaîne.

      String.fromCharCode Renvoie une chaîne constituée des caractères spécifiés dans les paramètres.

      String.indexOf           Recherche la chaîne et renvoie l’index de la sous-chaîne spécifiée dans les paramètres.
                               Si la valeur apparaît plus d’une fois, l’index de la première occurrence est renvoyé. Si la
                               valeur n’est pas trouvée, -1 est renvoyé.

      String.lastIndexOf       Renvoie l’index de la dernière sous-chaîne dans la chaîne qui apparaît avant la position
                               de début spécifiée dans le paramètre, ou -1 s’il n’y en a pas.

      String.slice             Extrait une section d’une chaîne et renvoie une nouvelle chaîne.

      String.split             Scinde un objet String en tableau de chaînes en séparant la chaîne en sous-chaînes.

      String.substr            Renvoie un nombre spécifié de caractères d’une chaîne, en commençant à l’endroit
                               spécifié dans le paramètre.

      String.substring         Renvoie les caractères entre deux index, spécifiés dans les paramètres, sous la forme
                               d’une chaîne.

      String.toLowerCase       Convertit la chaîne en minuscules et renvoie le résultat ; ne change pas le contenu de
                               l’objet d’origine.

      String.toUpperCase       Convertit la chaîne en majuscules et renvoie le résultat ; ne change pas le contenu de
                               l’objet d’origine.


Propriétés de l’objet String

      Propriété              Description

      String.length          Renvoie la longueur de la chaîne.


Constructeur pour l’objet String
      Disponibilité
      Flash Player 5.
      Usage
      new String(valeur)

      Paramètres
      valeur      La valeur initiale du nouvel objet String.
      Renvoie
      Rien.
      Description
      Constructeur ; crée un nouvel objet String.
      Voir aussi
      String (fonction), " " (délimiteur de chaîne)




418
String.charAt
   Disponibilité
   Flash Player 5.
   Usage
   maChaîne.charAt(index)

   Paramètres
   index    Le numéro du caractère de la chaîne à renvoyer.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; renvoie le caractère à la position spécifiée par le paramètre index. L’index du premier
   caractère d’une chaîne est 0. Si index n’est pas un nombre compris entre 0 et string.length - 1,
   une chaîne vide est renvoyée.

String.charCodeAt
   Disponibilité
   Flash Player 5.
   Usage
   maChaîne.charCodeAt(index)

   Paramètres
   index Un entier spécifiant la position d’un caractère dans la chaîne. Le premier caractère est
   indiqué par 0 et le dernier caractère est indiqué par maChaîne.length-1.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; renvoie un entier de 16 bits, compris entre 0 et 65535, qui représente le caractère
   spécifié par index.
   Cette méthode est semblable à string.charAt, excepté que la valeur renvoyée est un code de
   caractère entier de 16 bits, pas un caractère.
   Exemple
   Dans l’exemple suivant, la méthode charCodeAt est appelée pour la première lettre de la chaîne
   "Chris".
   s = new String("Chris");
   i = s.charCodeAt(0);
   // i = 67




                                                                        Dictionnaire ActionScript 419
String.concat
      Disponibilité
      Flash Player 5.
      Usage
      maChaîne.concat(valeur1,...valeurN)

      Paramètres
      valeur1,...valeurN         Zéro ou plusieurs valeurs à concaténer.
      Renvoie
      Voir ci-dessous.
      Description
      Méthode ; combine la valeur de l’objet String aux paramètres et renvoie la nouvelle chaîne, la
      valeur d’origine (maChaîne) restant inchangée.

String.fromCharCode
      Disponibilité
      Flash Player 5.
      Usage
      String.fromCharCode(c1,c2,...cN)

      Paramètres
      c1,c2,...cN        Entiers décimaux qui représentent des valeurs ASCII.
      Renvoie
      Voir ci-dessous.
      Description
      Méthode ; renvoie une chaîne constituée des caractères représentés par les valeurs ASCII des
      paramètres.
      Exemple
      Cet exemple utilise la méthode fromCharCode pour insérer un caractère « @ » dans l’adresse
      électronique.
      adresse = "chien" + String.fromCharCode(64) + "niche.net";
      trace(adresse);
      // Résultat : chien@niche.net

String.indexOf
      Disponibilité
      Flash Player 5.
      Usage
      maChaîne.indexOf(sousChaîne, [indexDébut])

      Paramètres
      sousChaîne        Un entier ou une chaîne spécifiant la sous-chaîne à rechercher dans maChaîne.



420
   indexDébut Un entier spécifiant le point de début dans maChaîne à partir duquel effectuer la
   recherche de la sous-chaîne. Ce paramètre est facultatif.
   Renvoie
   Rien.
   Description
   Méthode ; recherche la chaîne et renvoie la position de la première occurrence de la sousChaîne
   spécifiée. Si la valeur n’est pas trouvée, la méthode renvoie -1.

String.lastIndexOf
   Disponibilité
   Flash Player 5.
   Usage
   maChaîne.lastIndexOf(sousChaîne, [indexDébut])

   Paramètres
   sousChaîne        Un entier ou une chaîne spécifiant la chaîne à rechercher.
   indexDébut     Un entier spécifiant le point de début à partir duquel effectuer la recherche de
   sousChaîne.   Ce paramètre est facultatif.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; recherche la chaîne, de droite à gauche, et renvoie l’index de la dernière occurrence de
   sousChaîne trouvée avant indexDébut dans la chaîne appelante. Si sousChaîne n’est pas
   trouvée, la méthode renvoie -1.

String.length
   Disponibilité
   Flash Player 5.
   Usage
   string.length

   Paramètres
   Aucun.
   Description
   Propriété ; renvoie le nombre de caractères de l’objet String spécifié.




                                                                             Dictionnaire ActionScript 421
String.slice
      Disponibilité
      Flash Player 5.
      Usage
      maChaîne.slice(début, [fin])

      Paramètres
      début     Un nombre spécifiant l’index du point de début de la section. Si début est un nombre
      négatif, le point de début est déterminé à partir de la fin de la chaîne, -1 étant le dernier caractère.
      fin    Un nombre spécifiant l’index du point de fin de la section. Si fin n’est pas spécifié, la
      section inclut tous les caractères depuis début jusqu’à la fin de la chaîne. Si fin est un nombre
      négatif, le point de fin est déterminé depuis la fin de la chaîne, -1 étant le dernier caractère.
      Renvoie
      Voir ci-dessous.
      Description
      Méthode ; extrait une section, ou une sous-chaîne, de l’objet String spécifié, puis la renvoie sous
      forme de nouvelle chaîne, sans modifier l’objet String d’origine. La chaîne renvoyée inclut le
      caractère début et tous les caractères jusqu’au caractère fin (exclu).
      Exemple
      L’exemple suivant définit une variable, texte, crée une occurrence de l’objet String, s, et lui
      transmet la variable text. La méthode slice extrait une section de la chaîne contenue dans la
      variable et l’action trace l’envoie à la fenêtre Sortie.
      texte = "lexington";
      s = new String( texte );
      trace(s.slice( 1, 3 ));
      trace(s);
      La fenêtre Sortie affiche ex.
      Le code suivant produit le même résultat, mais le paramètre transmis à la fonction String est une
      chaîne au lieu d’être une variable.
      s = new String( "lexington" );
      trace(s.slice( 1, 3 ));
      trace(s);
      La fenêtre Sortie affiche ex.

String.split
      Disponibilité
      Flash Player 5.
      Usage
      maChaîne.split("délimiteur", [limite])

      Paramètres
      délimiteur      Le caractère ou la chaîne au niveau duquel maChaîne est scindée. Si le paramètre
      délimiteur    est undefined, la chaîne tout entière est placée dans le premier élément du tableau.



422
   limite    Le nombre d’éléments à placer dans le tableau. Ce paramètre est facultatif.
   Renvoie
   Un tableau contenant les sous-chaînes de maChaîne.
   Description
   Méthode ; scinde un objet String en sous-chaînes à l’endroit où se trouve le paramètre
   délimiteur et renvoie les sous-chaînes dans un tableau. Si vous utilisez une chaîne vide ("")
   comme délimiteur, chaque caractère de la chaîne est placé en tant qu’élément dans le tableau,
   comme dans le code suivant.
   maChaîne = "Joe";
   i = maChaîne.split("");
   trace (i);
   La fenêtre Sortie affiche le contenu suivant :
   J, O, E
   Si le paramètre delimiter est undefined, la chaîne tout entière est placée dans le premier
   élément du tableau renvoyé.
   Exemple
   L’exemple suivant renvoie un tableau avec cinq éléments.
   maChaîne = "P, A, T, S, Y";
   maChaîne.split(",");
   Cet exemple renvoie un tableau avec deux éléments.
   maChaîne.split(",", 2);

String.substr
   Disponibilité
   Flash Player 5.
   Usage
   maChaîne.substr(début, [longueur])

   Paramètres
   début Un entier indiquant la position du premier caractère de maChaîne devant être utilisé
   pour créer la sous-chaîne. Si début est un nombre négatif, la position de début est déterminée
   depuis la fin de la chaîne, -1 étant le dernier caractère.
   longueur Le nombre de caractères dans la sous-chaîne créée. Si longueur n’est pas spécifié, la
   sous-chaîne inclut tous les caractères du début jusqu’à la fin de la chaîne.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; renvoie les caractères d’une chaîne depuis l’index spécifié par le paramètre début
   jusqu’au nombre de caractères spécifié dans le paramètre longueur. La méthode substr ne
   change pas la chaîne spécifiée par maChaîne ; elle renvoie une nouvelle chaîne.




                                                                        Dictionnaire ActionScript 423
String.substring
      Disponibilité
      Flash Player 5.
      Usage
      maChaîne.substring(de, à)

      Paramètres
      de Un entier indiquant la position du premier caractère de maChaîne utilisé pour créer la sous-
      chaîne. Les valeurs valides pour de sont 0 à string.length - 1. Si de est une valeur négative, 0
      est utilisé.
      à Un entier étant égal à 1+ l’index du dernier caractère de maChaîne devant être extrait. Les
      valeurs valides pour à sont comprises entre 1 et string.length. Le caractère indexé par le
      paramètre à n’est pas inclus dans la chaîne extraite. Si ce paramètre est omis, string.length est
      utilisé. Si ce paramètre est une valeur négative, 0 est utilisé.
      Renvoie
      Voir ci-dessous.
      Description
      Méthode ; renvoie une chaîne constituée des caractères contenus entre les points spécifiés par les
      paramètres de et à. Si le paramètre à n’est pas spécifié, la fin de la sous-chaîne est la fin de la
      chaîne. Si la valeur de de est égale à la valeur de à, la méthode renvoie une chaîne vide. Si la valeur
      de de est supérieure à la valeur de à, les paramètres sont automatiquement permutés avant
      l’exécution de la fonction et la valeur d’origine reste inchangée.

String.toLowerCase
      Disponibilité
      Flash Player 5.
      Usage
      maChaîne.toLowerCase()

      Paramètres
      Aucun.
      Renvoie
      Voir ci-dessous.
      Description
      Méthode ; renvoie une copie de l’objet String, les caractères majuscules étant convertis en
      minuscules. La valeur d’origine reste inchangée.




424
String.toUpperCase
   Disponibilité
   Flash Player 5.
   Usage
   maChaîne.toUpperCase()

   Paramètres
   Aucun.
   Renvoie
   Voir ci-dessous.
   Description
   Méthode ; renvoie une copie de l’objet String, les caractères minuscules étant convertis en
   majuscules. La valeur d’origine reste inchangée.

substring
   Disponibilité
   Flash Player 4. Cette fonction est déconseillée dans Flash 5 et remplacée par String.substr.
   Usage
   substring("chaîne", index, nombre)

   Paramètres
   chaîne     La chaîne de laquelle extraire la nouvelle chaîne.
   index     Le numéro du premier caractère à extraire.
   nombre     Le nombre de caractères à inclure dans la chaîne extraite, excluant le caractère d’index.
   Renvoie
   Rien.
   Description
   Fonction de chaîne ; extrait une portion d’une chaîne. Cette fonction est basée sur 1, alors que les
   méthodes de l’objet String sont basées sur 0.
   Voir aussi
   String.substr

super
   Disponibilité
   Flash Player 6.
   Usage
   super.méthode([param1, ..., paramN])
   super([param1, ..., paramN])

   Paramètres
   méthode      La méthode à invoquer dans la superclasse.



                                                                          Dictionnaire ActionScript 425
      param1 Des paramètres facultatifs qui sont transmis à la version superclasse de la méthode
      (syntaxe 1) ou à la fonction constructeur de la superclasse (syntaxe 2).
      Renvoie
      Les deux formes invoquent une fonction. La fonction peut renvoyer n’importe quelle valeur.
      Description
      Opérateur : le premier style de syntaxe peut être utilisé dans le corps d’une méthode d’objet pour
      invoquer la version superclasse d’une méthode, et peut en option transmettre des paramètres
      (param1 ... paramN) à la méthode de superclasse. Ceci est utile pour créer des méthodes de sous-
      classe qui ajoutent un comportement supplémentaire aux méthodes superclasse, mais qui
      invoquent également les méthodes superclasse pour remplir leur comportement d’origine.
      Le deuxième style de syntaxe peut être utilisé dans le corps d’une fonction constructeur pour
      invoquer la version superclasse de la fonction constructeur, et peut en option lui transmettre des
      paramètres. Ceci est utile pour créer une sous-classe qui effectue une initialisation
      supplémentaire, mais qui invoque également le constructeur de superclasse pour effectuer une
      initialisation de superclasse.
      Exemple
      L’exemple suivant crée deux classes, ClasseParent et ClasseEnfant, et définit une méthode appelée
      méthode pour chaque classe. Chaque définition de méthode comporte une action trace qui
      envoie un message à la fenêtre Sortie. L’avant-dernière ligne de code crée une occurrence de
      ClasseEnfant et appelle sa méthode méthode :
      function ClasseParent() {
      }
      ClasseParent.prototype.méthode = function () {
         trace("implémentation ClasseParent de méthode");
      };
      function ClasseEnfant() {
      }
      ClasseEnfant.prototype = new ClasseParent();
      ClasseEnfant.prototype.méthode = function () {
         trace("implémentation ClasseEnfant de méthode");
         super.méthode();
      };
      x = new ClasseEnfant();
      x.méthode();
      Le résultat suivant est affiché dans la fenêtre Sortie :
      implémentation ClasseEnfant de méthode
      implémentation ClasseParent de méthode
      L’exemple suivant transmet des paramètres au super constructeur :
      function SuperClasse(param){
        trace("Le constructeur SuperClasse a reçu " + param);
      }
      function SousClasse(param){
        super(param);
        trace("constructeur SousClasse");
      }




426
switch
   Disponibilité
   Flash Player 4.
   Usage
   switch (expression){
     clauseDeCas:
     [clauseParDéfaut:]
   }

   Paramètres
   expression        Toute expression.
   clauseDeCas      Un mot-clé case, suivi d’une expression, de deux points et d’un groupe
   d’instructions à exécuter si l’expression correspond au paramètre expression avec une égalité
   stricte (===).
   clauseParDéfaut Un mot-clé default, suivi d’instructions à exécuter si aucune des
   expressions de cas ne correspond au paramètre expression par égalité stricte (===).
   Renvoie
   Rien.
   Description
   Action ; crée une structure de branchement pour des instructions ActionScript. Comme l’action
   if, l’action switch teste une condition et exécute des instructions si la condition renvoie une
   valeur de true.
   Exemple
   Dans l’exemple suivant, si le paramètre nombre est 1, l’action trace qui suit case 1 est exécutée ;
   si le paramètre nombre est 2, l’action trace qui suit case 2 est exécutée, et ainsi de suite. Si
   aucune expression case ne correspond au paramètre nombre, l’action trace qui suit le mot-clé
   default est exécutée.
   switch (nombre) {
     case 1:
        trace ("case 1 est true");
        break;
     case 2:
        trace ("case 2 est true");
        break;
     case 3:
        trace ("case 3 est true");
        break;
     default:
        trace ("aucun cas n’est est true")
   }




                                                                         Dictionnaire ActionScript 427
      Dans l’exemple suivant, il n’y a aucune rupture dans le premier groupe de cas ; donc, si le nombre
      est 1, A et B sont tous deux envoyés à la fenêtre Sortie.
      switch (nombre) {
        case 1:
           trace ("A");
        case 2:
           trace ("B");
           break;
        default
           trace ("D")
      }

      Voir aussi
      === (égalité stricte), break, case, default, if


System (objet)
      Ceci est un objet de haut niveau qui contient l’objet Capabilities. Vous devez utiliser l’objet
      System pour pouvoir utiliser l’objet Capabilities et ses propriétés. Par exemple, le code suivant
      vérifie si un système a des capacités audio.
      System.capabilites.hasAudio

System.capabilities (objet)
      Vous pouvez utiliser l’objet System.capabilities pour déterminer les capacités du système et du
      lecteur hébergeant une animation Flash. Ceci vous permet d’adapter le contenu à différents
      formats. Par exemple, l’écran d’un téléphone cellulaire (noir et blanc, 100 pixels carrés) est
      différent de l’écran couleur de 1000 pixels carrés d’un ordinateur. Pour fournir un contenu
      approprié au plus grand nombre possible d’utilisateurs, vous pouvez utiliser l’objet Capabilities
      pour déterminer le type de périphérique dont dispose un utilisateur. Vous pouvez alors spécifier
      au serveur d’envoyer des fichiers SWF différents selon les capacités du périphérique ou indiquer à
      l’animation Flash de modifier sa présentation en fonction des capacités du périphérique.
      Vous pouvez envoyer des informations sur les capacités en utilisant une méthode HTTP GET ou
      POST. L’exemple suivant est un exemple d’une chaîne de serveur pour un périphérique qui
      n’offre pas de support MP3 et dispose d’un écran de 400 x 200 pixels, 8 x 4 centimètres :
      "A=t&MP3=f&AE=gsm&VE=h11&ACC=f&V=WIN%206%2C0%2C0%2C129&M=Macromedia%WINDOWS&R=
        400x200&DP=72&COL=color&AR=1.0&OS=WINDOWS%2000&L=en-US"
      L’objet Capabilities est disponible dans Flash Player 6.
      Vous devez accéder à toutes les propriétés de l’objet Capabilities par l’intermédiaire de l’objet
      System.capabilities.




428
Propriétés de l’objet Capabilities

    Propriété                                   Description

    System.capabilities.hasAudioEncoder         Indique les encodeurs audio supportés.

    System.capabilities.hasAccessibility        Indique si le périphérique répond aux normes d’accessibilité.

    System.capabilities.hasAudio                Indique si le périphérique supporte les fonctions audio.

    System.capabilities.hasMP3                  Indique si le périphérique est équipé d’un décodeur MP3.

    System.capabilities.language                Indique la langue que Flash Player supporte.

    System.capabilities.manufacturer            Indique le fabricant de Flash Player.

    System.capabilities.os                      Indique le système d’exploitation hébergeant Flash Player.

    System.capabilities.pixelAspectRatio        Indique le rapport largeur/hauteur, en pixels, de l’écran.

    System.capabilities.screenColor             Indique si l’écran est en couleur, noir et blanc, ou à nuances de
                                                gris.

    System.capabilities.screenDPI               Indique la valeur de points par pouce de l’écran.

    System.capabilities.screenResolution.x      Indique la taille horizontale de l’écran.

    System.capabilities.screenResolution.y      Indique la taille verticale de l’écran.

    System.capabilities.version                 Indique la version minimum de Flash Player supportée.

    System.capabilities.hasVideoEncoder         Indique les encodeurs vidéo supportés.


System.capabilities.hasAudioEncoder
    Disponibilité
    Flash Player 6.
    Usage
    System.capabilities.hasAudioEncoder

    Description
    Propriété ; un tableau de décodeurs audio. La chaîne du serveur est AE.

System.capabilities.hasAccessibility
    Disponibilité
    Flash Player 6.
    Usage
    System.capabilities.hasAccessibility

    Description
    Propriété ; une valeur booléenne indiquant si un périphérique répond aux normes d’accessibilité.
    La valeur par défaut est false. La chaîne du serveur est ACC.




                                                                                Dictionnaire ActionScript 429
System.capabilities.hasAudio
      Disponibilité
      Flash Player 6.
      Usage
      System.capabilities.hasAudio

      Description
      Propriété ; une valeur booléenne indiquant si le lecteur est équipé de fonctions audio. La valeur
      par défaut est true. La chaîne du serveur est A.

System.capabilities.hasMP3
      Disponibilité
      Flash Player 6.
      Usage
      System.capabilities.hasMP3

      Description
      Propriété ; une valeur booléenne indiquant si le lecteur est équipé d’un décodeur MP3. La valeur
      par défaut est true. La chaîne du serveur est MP3.

System.capabilities.language
      Disponibilité
      Flash Player 6.
      Usage
      System.capabilities.language

      Description
      Propriété ; un code de langue constitué de deux lettres minuscules, conformément à la norme
      ISO 639-1, et un code de pays facultatif constitué de deux lettres majuscules, conformément à la
      norme ISO 3166. Les langues elles-mêmes sont nommées avec les étiquettes en anglais. Par
      exemple, « fr-FR » est la langue du document que vous lisez actuellement. La chaîne du serveur
      est LAN. Flash supporte le sous-ensemble suivant de balises de langues :

      Langue                          Balise                 Pays et balises supportés

      Allemand                        de

      Anglais                         en                     Etats-Unis = US, Royaume-Uni = UK

      Chinois simplifié               zh                     PRC (chinois simplifié) = CN

      Chinois traditionnel            zh                     Taiwan (chinois traditionnel) = TW

      Coréen                          ko

      Danois                          da

      Espagnol                        es

      Finlandais                      fi

      Français                        fr




430
   Langue                          Balise                 Pays et balises supportés

   Hollandais                      nl

   Hongrois                        hu

   Italien                         it

   Japonais                        ja

   Norvégien                       no

   Polonais                        pl

   Portugais                       pt

   Russe                           ru

   Suédois                         sv

   Tchèque                         cs

   Turc                            tr

   Autre/inconnu                   xu


System.capabilities.manufacturer
   Disponibilité
   Flash Player 6.
   Usage
   System.capabilities.manufacturer

   Description
   Propriété ; une chaîne indiquant le fabricant de Flash Player. La valeur par défaut est
   "Macromedia nomOS" (nomOS peut être "Windows","Macintosh" ou "Other OS Name"). La
   chaîne du serveur est M.

System.capabilities.os
   Disponibilité
   Flash Player 6.
   Usage
   System.capabilities.os

   Description
   Propriété ; une chaîne indiquant le fabricant de Flash Player. La valeur par défaut est une chaîne
   vide (""). La propriété os peut renvoyer les chaînes suivantes : "Windows XP", "Windows 2000",
   "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE" (disponible uniquement dans
   le SDK, pas dans la version de bureau) et "MacOS". La chaîne du serveur est OS.




                                                                        Dictionnaire ActionScript 431
System.capabilities.pixelAspectRatio
      Disponibilité
      Flash Player 6.
      Usage
      System.capabilities.pixelAspectRatio

      Description
      Propriété ; un entier indiquant le rapport largeur/hauteur, en pixels, de l’écran. La valeur par
      défaut est 1.0. La chaîne du serveur est PAR.

System.capabilities.screenColor
      Disponibilité
      Flash Player 6.
      Usage
      System.capabilities.screenColor

      Description
      Propriété ; indique la couleur de l’écran, couleur (color), gris (gray) ou noir et blanc (bw). La
      valeur par défaut est color. La chaîne du serveur est SC.

System.capabilities.screenDPI
      Disponibilité
      Flash Player 6.
      Usage
      System.capabilities.screenDPI

      Description
      Propriété ; indique la valeur de points par pouces (ppp) de l’écran, en pixels. La valeur par défaut
      est 72. La chaîne du serveur est DPI.

System.capabilities.screenResolution.x
      Disponibilité
      Flash Player 6.
      Usage
      System.capabilities.screenResolution.x

      Description
      Propriété ; un entier indiquant la résolution horizontale maximum de l’écran. La valeur par
      défaut est 800 (pixels). La chaîne du serveur est SRX.




432
System.capabilities.screenResolution.y
   Disponibilité
   Flash Player 6.
   Usage
   System.capabilities.screenResolution.y

   Description
   Propriété ; un entier indiquant la résolution verticale maximum de l’écran. La valeur par défaut
   est 600 (pixels). La chaîne du serveur est SRY.

System.capabilities.version
   Disponibilité
   Flash Player 6.
   Usage
   System.capabilities.version

   Description
   Propriété ; un entier qui spécifie la version de Flash Player supportée. La valeur par défaut est 6.0.
   La chaîne du serveur est VER.

System.capabilities.hasVideoEncoder
   Disponibilité
   Flash Player 6.
   Usage
   System.capabilities.hasVideoEncoder

   Description
   Propriété ; un tableau d’encodeurs vidéo. La chaîne du serveur est VE.

targetPath
   Disponibilité
   Flash Player 5.
   Usage
   targetpath(objetClip)

   Paramètres
   objetClip Référence (par exemple, _root ou _parent) au clip dont le chemin cible est en
   cours de récupération.
   Renvoie
   Rien.




                                                                           Dictionnaire ActionScript 433
      Description
      Fonction ; renvoie une chaîne contenant le chemin cible de objetClip. Le chemin cible est
      renvoyé avec la notation point. Pour récupérer le chemin cible dans la notation à barre oblique,
      utilisez la propriété _target.
      Exemple
      Cet exemple affiche le chemin cible d’un clip dès son chargement.
      onClipEvent(load) {
        trace(targetPath(this));
      }

      Voir aussi
      eval

tellTarget
      Disponibilité
      Flash Player 3. Déconseillé dans Flash 5 ; l’utilisation de la notation à point et de l’action with est
      recommandée.
      Usage
      tellTarget("cible") {
        instruction(s);
      }

      Paramètres
      cible    Une chaîne spécifiant le chemin cible du scénario à contrôler.
      instruction(s)       Les instructions à exécuter si la condition est évaluée comme true.
      Renvoie
      Rien.
      Description
      Action ; applique les instructions spécifiées dans le paramètre instructions au scénario spécifié
      dans le paramètre cible. L’action tellTarget est utile pour les contrôles de navigation. Affectez
      tellTarget aux boutons qui arrêtent ou démarrent les clips n’importe où sur la scène. Vous
      pouvez également envoyer les clips à une image particulière de ce clip. Par exemple, vous pouvez
      affecter tellTarget aux boutons qui arrêtent ou démarrent les clips sur la scène ou qui envoient
      les clips dans une image particulière.
      Dans Flash 5, vous pouvez utiliser la notation à point au lieu de l’action tellTarget. Vous
      pouvez utiliser l’action with pour communiquer plusieurs actions au même scénario. Vous
      pouvez utiliser l’action with pour cibler n’importe quel objet, alors que l’action tellTarget ne
      peut cibler que des clips.




434
    Exemple
    Cette instruction tellTarget contrôle l’occurrence de clip balle du scénario principal. L’image
    1 de l’occurrence de clip balle est vide et possède une action stop invisible sur la scène. Lorsque
    le bouton avec l’action suivante est cliqué, tellTarget indique à la tête de lecture du clip balle
    d’atteindre l’image 2 où commence l’animation.
    on(release) {
      tellTarget("balle") {
         gotoAndPlay(2);
      }
    }
    L’exemple suivant utilise la notation à point pour obtenir les mêmes résultats.
    on(release) {
      balle.gotoAndPlay(2);
    }
    Si vous avez besoin de communiquer plusieurs commandes à l’occurrence balle, vous pouvez
    utiliser l’action with, comme dans l’instruction suivante.
    on(release) {
      with(balle) {
         gotoAndPlay(2);
         _alpha = 15;
         _xscale = 50;
         _yscale = 50;
      }
    }

    Voir aussi
    with

TextField (objet)
    Tous les champs de texte dynamique et de saisie d’une animation Flash sont des occurrences de
    l’objet TextField. Vous pouvez donner un nom d’occurrence à un champ de texte dans
    l’inspecteur des propriétés et utiliser les méthodes et propriétés de l’objet TextField pour le
    manipuler avec ActionScript. Les noms d’occurrence TextField sont affichés dans l’explorateur
    d’animations et dans la boîte de dialogue Insérer un chemin cible du panneau Actions.
    L’objet TextField hérite de l’objet Object.
    Pour créer un champ de texte de façon dynamique, vous pouvez utiliser la méthode
    MovieClip.createTextField.
    L’objet TextField est supporté par Flash Player 6 et les versions suivantes de Flash Player.

Méthodes de l’objet TextField

    Méthode                         Description

    TextField.addListener           Enregistre un objet pour la réception de notification lorsque les événements
                                    onChanged et onScroller sont invoqués.

    TextField.getDepth              Renvoie la profondeur d’un champ de texte.

    TextField.getNewTextFormat      Lit le format de texte par défaut affecté au texte nouvellement inséré.

    TextField.removeListener        Supprime un objet d’écoute.

    TextField.removeTextField       Supprime un champ de texte créé avec MovieClip.createTextField.




                                                                                  Dictionnaire ActionScript 435
      Méthode                      Description

      TextField.setNewTextFormat   Définit un objet de format de texte pour le texte qui est inséré par un utilisateur
                                   ou par une méthode.

      TextField.replaceSel         Remplace la sélection actuelle.

      TextField.setTextFormat      Définit le format de texte par défaut affecté au texte nouvellement inséré.


Propriétés de l’objet TextField

      Propriété                     Description

      TextField._alpha              La valeur de transparence d’une occurrence de champ de texte.

      TextField.autoSize            Contrôle le dimensionnement et l’alignement automatique des champs de
                                    texte.

      TextField.background          Indique si le champ de texte a un remplissage d’arrière-plan.

      TextField.backgroundColor     Indique la couleur du remplissage d’arrière-plan.

      TextField.border              Indique si le champ de texte a une bordure.

      TextField.borderColor         Indique la couleur de la bordure.

      TextField.bottomScroll        La dernière ligne visible dans un champ de texte.

      TextField.embedFonts          Indique si le champ de texte utilise des polices vectorielles intégrées ou des
                                    polices de périphérique.

      TextField._highquality        Indique la qualité de rendu de l’animation.

      TextField._height             La hauteur d’une occurrence de champ de texte, en pixels. Cela n’affecte
                                    que le cadre de délimitation du champ de texte, pas l’épaisseur de la bordure
                                    ou la taille du texte.

      TextField.hscroll             Indique la valeur de défilement horizontal d’un champ de texte.

      TextField.html                Indique la position de défilement maximum d’un champ de texte.

      TextField.htmlText            Contient la représentation HTML du contenu d’un champ de texte.

      TextField.length              Le nombre de caractères d’un champ de texte.

      TextField.maxChars            La quantité maximum de caractères qu’un champ de texte peut contenir.

      TextField.maxhscroll          La valeur maximum de TextField.hscroll.

      TextField.maxscroll           La valeur maximum de TextField.scroll.

      TextField.multiline           Indique si le champ de texte contient plusieurs lignes.

      TextField._name               Le nom d’occurrence d’une occurrence de champ de texte.

      TextField._parent             Une référence à l’occurrence parent de cette occurrence ; de type Button ou
                                    MovieClip.

      TextField.password            Indique si un champ de texte masque les caractères saisis.

      TextField._quality            Indique la qualité de rendu d’une animation

      TextField.restrict            Le jeu de caractères qu’un utilisateur peut rentrer dans un champ de texte.

      TextField._rotation           Le degré de rotation d’une occurrence de champ de texte.

      TextField.scroll              Indique la position de défilement actuelle d’un champ de texte.

      TextField.selectable          Indique si un champ de texte est sélectionnable.




436
    Propriété                  Description

    TextField._soundbuftime    La durée nécessaire de mise en tampon d’un son avant sa lecture en flux
                               continu.

    TextField.tabEnabled       Indique si un clip est inclus dans l’ordre de tabulation automatique.

    TextField.tabIndex         Indique l’ordre de tabulation d’un objet.

    TextField.text             Le texte du champ de texte.

    TextField.textColor        La couleur du texte d’un champ de texte.

    TextField.textHeight       La hauteur du cadre de délimitation du champ de texte.

    TextField.textWidth        La largeur du cadre de délimitation du champ de texte.

    TextField.type             Indique si un champ de texte est un champ de saisie ou un champ de texte
                               dynamique.

    TextField._url             L’URL du fichier SWF créateur de l’occurrence de champ de texte.

    TextField.variable         Le nom de variable associé au champ de texte.

    TextField._visible         Une valeur booléenne déterminant si l’occurrence d’un champ de texte est
                               masquée ou visible.

    TextField._width           La largeur d’une occurrence de champ de texte, en pixels. Cela n’affecte que
                               le cadre de délimitation du champ de texte, pas l’épaisseur de la bordure ou
                               la taille du texte.

    TextField.wordWrap         Indique si le texte du champ de texte passe automatiquement à la ligne.

    TextField._x               La coordonnée x d’une occurrence de champ de texte.

    TextField._xmouse          La coordonnée x du curseur par rapport à une occurrence de champ de
                               texte.

    TextField._xscale          La valeur spécifiant le pourcentage de redimensionnement horizontal d’une
                               occurrence de champ de texte.

    TextField._y               La coordonnée y d’une occurrence de champ de texte.

    TextField._ymouse          La coordonnée y du curseur par rapport à une occurrence de champ de
                               texte.

    TextField._yscale          La valeur spécifiant le pourcentage de redimensionnement vertical d’une
                               occurrence de champ de texte.


Gestionnaires d’événement de l’objet TextField

    Méthode                   Description

    TextField.onChanged       Invoqué lorsque le contenu du champ de texte change.

    TextField.onKillFocus     Invoqué lorsqu’un champ de texte perd le focus.

    TextField.onScroller      Invoqué lorsque la propriété scroll, maxscroll, hscroll, maxhscroll ou
                              bottomscroll d’un champ de texte change.

    TextField.onSetFocus      Invoqué lorsqu’un champ de texte reçoit le focus.




                                                                            Dictionnaire ActionScript 437
Ecouteurs de l’objet TextField

      Méthode                        Description

      TextField.onChanged            Notifié lorsque le contenu du champ de texte change.

      TextField.onScroller           Notifié lorsque la propriété scroll ou maxscroll d’un champ de texte
                                     change.


TextField._alpha
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte._alpha

      Description
      Propriété ; définit et récupère la transparence alpha (valeur) du champ de texte spécifié par
      monChampDeTexte. Les valeurs valides vont de 0 (transparence complète) à 100 (opacité
      complète).
      Exemple
      Les instructions suivantes définissent la propriété _alpha d’un champ de texte nommé texte1
      sur 30 %.
      on(release) {
        texte1._alpha = 30;
      }

TextField.addListener
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.addListener(nouvelEcouteur)
      Paramètres
      nouvelEcouteur    ; un objet avec les notifications d’événements onChanged et onScroller.
      Renvoie
      Rien.
      Description
      Méthode ; enregistre un objet pour la réception de notifications d’événements. Lorsque
      l’événement onChanged ou onScroller se produit, les événements TextField.onChanged et
      TextField.onScroller sont invoqués, suivis des méthodes onChanged et onScroller des
      objets d’écoute enregistrés avec addListener. Plusieurs objets peuvent attendre des notifications
      de changement. Si l’écouteur nouvelEcouteur est déjà enregistré, aucun changement n’a lieu.




438
TextField.autoSize
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.autoSize

   Description
   Propriété ; contrôle le dimensionnement et l’alignement automatique des champs de texte. Si la
   valeur de dimension automatique est "none", le champ de texte se comporte normalement, ne se
   redimensionne pas automatiquement et ne s’aligne pas pour correspondre au texte. Si la valeur est
   "left", le champ de texte s’agrandit ou se rétrécit sur son côté droit et sur son côté inférieur pour
   adapter sa taille au texte contenu. Le côté gauche et le côté supérieur restent à la même position.
   Si la valeur de dimension automatique est "center", le champ de texte se redimensionne
   automatiquement, mais le centre horizontal du champ de texte reste ancré à la position du centre
   horizontal d’origine du champ de texte. Le côté inférieur se déplace toujours pour ajuster la taille
   du champ de texte au texte contenu. Si la valeur de dimension automatique est "right", le
   champ de texte se redimensionne automatiquement, mais s’agrandit ou se rétrécit sur son côté
   gauche et sur son côté inférieur. Le côté supérieur et le côté droit restent à la même position.
   Lorsque vous paramétrez la propriété autoSize, true est synonyme de "left" et false est
   synonyme de "none".
   Exemple
   Les instructions suivantes définissent la propriété autosize du champ de texte champDeTexte2
   sur "center".
   champDeTexte2.autosize = "center";

TextField.background
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.background

   Description
   Propriété ; si true, le champ de texte a un remplissage d’arrière-plan. Si false, le champ de texte
   n’a pas de remplissage d’arrière-plan.




                                                                          Dictionnaire ActionScript 439
TextField.backgroundColor
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.backgroundColor

      Description
      Propriété ; la couleur d’arrière-plan du champ de texte. La valeur par défaut est 0xFFFFFF (blanc).
      Cette propriété peut être récupérée ou définie, même s’il n’y a actuellement aucun arrière-plan,
      mais la couleur est seulement visible si le champ de texte a une bordure.
      Voir aussi
      TextField.background

TextField.border
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.border

      Description
      Propriété ; si true, le champ de texte a une bordure. Si false, le champ de texte n’a pas de
      bordure.

TextField.borderColor
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.borderColor

      Description
      Propriété ; la couleur de bordure du champ de texte (la valeur par défaut est 0x000000 – le noir).
      Cette propriété peut être récupérée ou définie, même s’il n’y a actuellement aucune bordure.
      Voir aussi
      TextField.border




440
TextField.bottomScroll
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.bottomScroll

   Description
   Propriété (lecture seule) ; un entier (index basé sur 1) qui indique la dernière ligne actuellement
   visible dans monChampDeTexte. Considérez le champ de texte comme une « fenêtre » sur un bloc
   de texte. La propriété Textfield.scroll est l’index basé sur 1 de la première ligne visible dans la
   fenêtre.
   Tout le texte entre les lignes TextField.scroll et TextField.bottomScroll est actuellement
   visible dans le champ de texte.

TextField.embedFonts
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.embedFonts

   Description
   Propriété ; une valeur booléenne qui, lorsque true, rend le champ de texte avec des polices
   vectorielles intégrées. Si false, le champ de texte est rendu avec les polices de périphériques.

TextField._focusrect
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._focusrect

   Description
   Propriété ; une valeur booléenne spécifiant si un rectangle jaune apparaît autour du champ de
   texte avec focus clavier.

TextField.getDepth
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.getDepth

   Paramètres
   Aucun.




                                                                          Dictionnaire ActionScript 441
      Renvoie
      Un entier.
      Description
      Méthode ; renvoie la profondeur d’un champ de texte.

TextField.getFontList
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.getFontList

      Paramètres
      Aucun.
      Renvoie
      Un tableau.
      Description
      Méthode ; renvoie un objet Array dont les éléments sont les noms de toutes les polices installées
      sur le système hébergeant Flash Player, y compris les polices figurant dans le fichier SWF et tous
      les fichiers SWF d’éléments chargés. Les noms sont de type chaîne.

TextField.getNewTextFormat
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.getNewTextFormat()

      Paramètres
      Aucun.
      Renvoie
      Un objet TextFormat.
      Description
      Méthode ; renvoie un objet TextFormat contenant une copie de l’objet de format de texte du
      champ de texte. L’objet de format de texte est le format que reçoit le texte nouvellement inséré, tel
      que le texte inséré par la méthode replaceSel ou le texte entré par un utilisateur. Lorsque
      getNewTextFormat est invoqué, l’objet TextFormat est retourné avec toutes ses propriétés
      définies. Aucune propriété n’est null.




442
TextField.getTextFormat
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.getTextFormat()
   monChampDeTexte.getTextFormat (index)
   monChampDeTexte.getTextFormat (indexDébut, indexFin)

   Paramètres
   index    Un entier spécifiant un caractère d’une chaîne.
   Renvoie
   Un objet.
   Description
   Méthode. Usage 1. Renvoie un objet TextFormat contenant des informations de format pour
   tout le texte d’un champ de texte. Seules les propriétés qui sont communes à tout le texte du
   champ de texte sont définies dans l’objet TextFormat résultant. Toute propriété qui est mixte, ce
   qui signifie qu’elle a différentes valeurs à différents points du texte, a sa valeur définie sur null.
   Usage 2. Renvoie un objet TextFormat contenant une copie du format de texte du champ de
   texte à index.
   Usage 3. Renvoie un objet TextFormat contenant des informations de formatage pour la plage de
   texte allant de indexDébut à indexFin.
   Voir aussi
   TextField.getNewTextFormat, TextField.setNewTextFormat, TextField.setTextFormat


TextField._height
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._height

   Description
   Propriété ; définit et récupère la hauteur du champ de texte, en pixels.
   Exemple
   L’exemple de code suivant définit la hauteur et la largeur d’un champ de texte.
   monChampDeTexte._width = 200;
   monChampDeTexte._height = 200;




                                                                            Dictionnaire ActionScript 443
TextField._highquality
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte._highquality

      Description
      Propriété (globale) ; spécifie le niveau d’anti-alias appliqué à l’animation en cours. Spécifiez 2
      (qualité maximum) pour appliquer une qualité élevée avec le lissage bitmap toujours actif.
      Spécifiez 1 (qualité élevée) pour appliquer l’anti-alias ; cela lissera les bitmaps si le clip ne contient
      pas d’animation. Spécifiez 0 (faible qualité) pour empêcher l’anti-alias.
      Exemple
      _highquality = 1;

      Voir aussi
      _quality, toggleHighQuality


TextField.hscroll
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.hscroll

      Renvoie
      Un entier.
      Description
      Propriété ; indique la position de défilement horizontal actuelle. Si la propriété hscroll a pour
      valeur 0, le texte ne défile pas horizontalement.
      Exemple
      L’exemple suivant fait défiler le texte horizontalement.
      on(release) {
        monChampDeTexte.hscroll += 1;
      }

      Voir aussi
      TextField.maxhscroll, TextField.scroll




444
TextField.html
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.html

   Description
   Propriété ; une valeur indiquant si le champ de texte contient une représentation HTML. Si la
   propriété html est true, le champ de texte est un champ de texte html. Si html est false, le
   champ de texte n’est pas un champ de texte html.
   Voir aussi
   TextField.htmlText

TextField.htmlText
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.htmlText

   Description
   Propriété ; si le champ de texte est un champ de texte HTML, cette propriété contient la
   représentation HTML du contenu du champ de texte. Si le champ de texte n’est pas un champ de
   texte HTML, elle se comporte de façon identique à la propriété text. Vous pouvez indiquer
   qu’un champ de texte est un champ de texte HTML dans l’inspecteur des propriétés, ou en
   définissant la propriété html du champ de texte sur true.
   Exemple
   Dans l’exemple suivant, le texte du champ de texte texte2 est rendu en gras.
   texte2.html = true;
   texte2.htmlText = "<b> ceci est du texte en gras </b>";

TextField.length
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.length

   Description
   Propriété (lecture seule) ; indique le nombre de caractères d’un champ de texte. Cette propriété
   renvoie la même valeur que text.length, mais elle est plus rapide. Un caractère tel que « tab »
   (« \t ») compte comme un seul caractère.




                                                                        Dictionnaire ActionScript 445
TextField.maxChars
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.maxChars

      Description
      Propriété ; indique la quantité maximum de caractères qu’un champ de texte peut contenir. Un
      script peut insérer plus de texte que maxChars ne le permet ; la propriété maxChars n’indique que
      la quantité de texte qu’un utilisateur peut entrer. Si la valeur de cette propriété est null, il n’y a
      pas de limite sur la quantité de texte qu’un utilisateur peut entrer.

TextField.maxhscroll
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.maxhscroll

      Description
      Propriété (lecture seule) ; indique la valeur maximum de TextField.hscroll.
      Voir aussi
      TextField.hscroll

TextField.maxscroll
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.maxscroll

      Description
      Propriété (lecture seule) ; indique la valeur maximum de TextField.scroll.
      Voir aussi
      TextField.scroll




446
TextField.multiline
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.multiline

   Description
   Propriété ; indique si le champ de texte est un champ de texte multiligne. Si la valeur est true, le
   champ de texte est multiligne ; si la valeur est false, le champ de texte est un champ de texte à
   ligne unique.

TextField._name
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._name

   Description
   Propriété ; renvoie le nom d’occurrence du champ de texte spécifié par monChampDeTexte.

TextField.onChanged
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.onChanged
   Paramètres
   Aucun.
   Renvoie
   Rien.
   Description
   Gestionnaire d’événement ; invoqué lorsque le contenu d’un champ de texte change. Par défaut,
   il est indéfini ; vous pouvez le définir dans un script.




                                                                          Dictionnaire ActionScript 447
TextField.onKillFocus
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.onKillFocus = function (nouveauFocus) {
      instructions;
      };
      Paramètres
      nouveauFocus       L’objet recevant le focus.
      Renvoie
      Rien.
      Description
      Gestionnaire d’événement ; un événement invoqué lorsqu’un champ de texte perd le focus
      clavier. La méthode onKillFocus reçoit un paramètre, nouveauFocus, qui est un objet
      représentant le nouvel objet recevant le focus. Si aucun objet ne reçoit le focus, nouveauFocus
      contient la valeur null.

TextField.onScroller
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.onScroller
      Description
      Gestionnaire d’événement ; un événement invoqué lorsqu’une des propriétés de défilement du
      champ de texte change.
      Voir aussi
      TextField.hscroll, TextField.maxhscroll, TextField.maxscroll, TextField.scroll


TextField.onSetFocus
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.onSetFocus = function(ancienFocus){
      instructions;
      };

      Paramètres
      ancienFocus       L’objet devant perdre le focus.
      Renvoie
      Rien.




448
   Description
   Gestionnaire d’événement ; invoqué lorsqu’un champ de texte reçoit le focus clavier. Le
   paramètre ancienFocus est l’objet perdant le focus. Par exemple, si l’utilisateur appuie sur la
   touche Tab pour faire passer le focus de saisie d’un bouton à un champ de texte, ancienFocus
   contient l’occurrence de champ de texte.
   Si aucun objet n’a précédemment reçu le focus, ancienFocus contient une valeur null.

TextField._parent
   Disponibilité
   Flash Player 6.
   Usage
   _parent.propriété
   _parent._parent.propriété

   Description
   Propriété ; spécifie ou renvoie une référence au clip ou objet contenant le clip ou objet courant.
   L’objet courant est l’objet contenant le code ActionScript faisant référence à _parent. Utilisez
   _parent pour spécifier un chemin relatif aux clips ou objets qui se trouvent au-dessus du clip ou
   objet actuel.
   Voir aussi
   _root, targetPath


TextField.password
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.password

   Description
   Propriété ; si la valeur de password est true, le champ de texte est un champ de texte de mot de
   passe dont le contenu est masqué. Si false, le champ de texte n’est pas un champ de mode passe.

TextField._quality
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._quality

   Description
   Propriété (globale) ; définit ou récupère la qualité de rendu utilisée pour une animation. Les
   polices de périphérique sont toujours aliasées et ne sont donc pas affectées par la propriété
   _quality.

   La propriété _quality peut être définie avec les valeurs suivantes :




                                                                          Dictionnaire ActionScript 449
      •   "LOW" Qualité de rendu faible. Les graphiques ne sont pas anti-aliasés et les bitmaps ne sont
          pas lissés.
      •   "MEDIUM"      Qualité de rendu moyenne. Les graphiques sont anti-aliasés avec une grille 2x2, en
          pixels, mais les bitmaps ne sont pas lissés. Convient aux animations ne contenant pas de texte.
      •   "HIGH" Qualité de rendu élevée. Les graphiques sont anti-aliasés avec une grille 4x4, en
          pixels, et les bitmaps sont lissés si l’animation est statique. Il s’agit du paramètre de qualité de
          rendu par défaut utilisé par Flash.
      •   "BEST" Qualité de rendu très élevée. Les graphiques sont anti-aliasés avec une grille 4x4, en
          pixels, et les bitmaps sont toujours lissés.
      Exemple
      L’exemple suivant définit la qualité de rendu sur LOW :
      champDeTexte._quality = "LOW";

      Voir aussi
      _highquality, toggleHighQuality


TextField.removeListener
      Disponibilité
      Flash Player 6.
      Usage
      Selection.removeListener(écouteur)
      Paramètres
      écouteur      L’objet qui ne reçoit plus de notification de focus.
      Renvoie
      Si l’écouteur a été correctement retiré de la méthode renvoie true. Si écouteur n’a pas été
      correctement retiré, par exemple si écouteur n’apparaissait pas dans la liste des écouteurs de
      l’objet TextField, la méthode renvoie false.
      Description
      Méthode ; retire un objet d’écoute précédemment enregistré pour une occurrence de champ de
      texte avec addListener.




450
TextField.removeTextField
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.removeTextField()

   Description
   Méthode ; supprime le champ de texte spécifié par monChampDeTexte. Cette opération peut
   uniquement être réalisée sur un champ de texte qui a été créé avec la méthode createTextField
   de l’objet MovieClip. Elle ne fonctionnera pas sur des champs de texte placés par le scénario.
   Lorsque vous appelez cette méthode, le champ de texte reçoit une commande de suppression.
   Cela est semblable à la méthode MovieClip.removeMovieClip.
   Voir aussi
   MovieClip.createTextField

TextField.replaceSel
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.replaceSel(texte)

   Paramètres
   texte    Une chaîne.
   Renvoie
   Rien.
   Description
   Méthode ; remplace la sélection actuelle par le contenu du paramètre texte. Le texte est inséré à
   la place de la sélection actuelle, en utilisant le format de caractère par défaut et le format de
   paragraphe par défaut actuellement en vigueur. Le texte n’est pas considéré comme HTML,
   même si le champ de texte est un champ de texte HTML.
   Vous pouvez utiliser la méthode replaceSel pour insérer et supprimer du texte sans perturber le
   format des caractères et des paragraphes du reste du texte.




                                                                        Dictionnaire ActionScript 451
TextField.restrict
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.restrict

      Description
      Propriété ; indique le jeu de caractères qu’un utilisateur peut rentrer dans le champ de texte. Si la
      valeur de la propriété restrict est null, vous pouvez entrer n’importe quel caractère. Si la valeur
      de la propriété restrict est une chaîne vide, vous ne pouvez entrer aucun caractère. Si la valeur
      de la propriété restrict est une chaîne de caractères, vous ne pouvez entrer que les caractères de
      la chaîne dans le champ de texte. La chaîne est lue de gauche à droite. Une plage peut être
      spécifiée en utilisant un tiret (-). Ceci limite seulement l’interaction avec l’utilisateur, un script
      pouvant mettre n’importe quel texte dans le champ de texte. Cette propriété ne se synchronise pas
      avec les cases à cocher de polices vectorielles intégrées de l’inspecteur des propriétés.
      Si la chaîne commence par un caret (^), tous les caractères sont initialement acceptés et les
      caractères suivants de la chaîne sont exclus du jeu de caractères acceptés. Si la chaîne ne
      commence pas par un caret (^), aucun caractère n’est initialement accepté et les caractères
      suivants de la chaîne sont inclus dans le jeu de caractères acceptés.
      Exemple
      L’exemple suivant permet seulement que des caractères majuscules, des espaces et des nombres
      soient entrés dans un champ de texte :
      mon_txt.restrict = "A-Z 0-9";
      L’exemple suivant comprend tous les caractères, mais exclut les lettres minuscules :
      mon_txt.restrict = "^a-z";
      Vous pouvez utiliser une barre oblique inverse pour entrer un ^ ou - textuellement. Les séquences
      de barre oblique inverse acceptées sont \-, \^ ou \\. La barre oblique inverse doit être effectivement
      un caractère de la chaîne ; aussi, pour le spécifier dans ActionScript, une double barre oblique
      inverse doit être utilisée. Par exemple, le code suivant inclut uniquement le tiret (-) et le caret (^) :
      mon_txt.restrict = "\\-\\^";
      Le caret (^) peut être utilisé n’importe où dans la chaîne pour alterner entre l’inclusion de
      caractères et l’exclusion de caractères. Le code suivant inclut seulement les lettres majuscules, mais
      exclut la lettre majuscule Q :
      mon_txt.restrict = "A-Z^Q";
      Vous pouvez utiliser la séquence d’échappement \u pour construire des chaînes restrict. Le
      code suivant inclut seulement les caractères compris entre le code ASCII 32 (espace) et le code
      ASCII 126 (tilde).
      mon_txt.restrict = "\u0020-\u007E";




452
TextField._rotation
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._rotation

   Description
   Propriété ; spécifie la rotation du champ de texte, en degrés.

TextField.scroll
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.scroll

   Description
   Propriété ; définit la position verticale du texte dans un champ de texte. La propriété scroll est
   utile pour diriger les utilisateurs vers un paragraphe spécifique dans un long passage, ou pour créer
   des champs de texte défilants. Cette propriété peut être récupérée et modifiée.
   Exemple
   Le code suivant est associé à un bouton Haut qui fait défiler le champ de texte monTexte.
   on(release) {
     monTexte.scroll = monTexte.scroll + 1;
   }

   Voir aussi
   TextField.maxscroll, TextField.scroll


TextField.selectable
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.selectable

   Description
   Propriété ; une valeur booléenne indiquant si le champ de texte est sélectionnable. La valeur true
   indique que le texte est sélectionnable.




                                                                          Dictionnaire ActionScript 453
TextField.setNewTextFormat
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.setNewTextFormat(formatDeTexte)

      Paramètres
      formatDeTexte        Une occurrence de l’objet TextFormat.
      Renvoie
      Rien.
      Description
      Méthode ; définit un objet TextFormat pour le texte nouvellement inséré, tel que le texte inséré
      par la méthode replaceSel ou le texte entré par un utilisateur dans un champ de texte. Chaque
      champ de texte a un nouveau format de texte. Lorsque du texte est inséré, le nouveau format est
      appliqué au nouveau texte.
      Le format de texte est défini dans une nouvelle occurrence de l’objet TextFormat. Contient des
      informations de format de caractères et de paragraphes. Les informations de format des caractères
      décrivent l’apparence des différents caractères, telles que le nom de la police, la taille de la police,
      la couleur du texte et l’URL associée. Les informations de format des paragraphes décrivent
      l’apparence des paragraphes, telles que la marge gauche, la marge droite, l’indentation de la
      première ligne et l’alignement à gauche, à droite, au centre ou justifié.
      Voir aussi
      TextField.getNewTextFormat, TextField.getTextFormat, TextField.setTextFormat


TextField.setTextFormat
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.setTextFormat (formatDeTexte)
      monChampDeTexte.setTextFormat (index, formatDeTexte)
      monChampDeTexte.setTextFormat (indexDébut, indexFin, formatDeTexte)

      Paramètres
      indexDébut        Un entier.
      indexFin     Un entier spécifiant le premier caractère suivant la plage texte souhaitée.
      formatDeTexte Une occurrence de l’objet TextFormat. Un objet TextFormat contient des
      informations de format de caractères et de paragraphes.
      Renvoie
      Rien.




454
   Description
   Méthode ; définit un objet de format de texte pour une plage de texte spécifiée dans un champ de
   texte. Vous pouvez affecter un format de texte à chaque caractère d’un champ de texte. Le format
   du premier caractère d’un paragraphe est examiné pour effectuer le formatage de paragraphe sur
   tout le paragraphe. La méthode setTextFormat change le format de texte appliqué à des
   caractères individuels, à des groupes de caractères ou à l’ensemble du texte d’un champ de texte.
   Le format de texte est défini dans une nouvelle occurrence de l’objet TextFormat. Contient des
   informations de format de caractères et de paragraphes. Les informations de format des caractères
   décrivent l’apparence des différents caractères, telles que le nom de la police, la taille de la police,
   la couleur du texte et l’URL associée. Les informations de format des paragraphes décrivent
   l’apparence des paragraphes, telles que la marge gauche, la marge droite, l’indentation de la
   première ligne et l’alignement à gauche, à droite, au centre ou justifié.
   Usage 1. Applique les propriétés de formatDeTexte à tout le texte du champ de texte.
   Usage 2. Applique les propriétés de formatDeTexte au caractère à la position index.
   Usage 3. Applique les propriétés du paramètre formatDeTexte à la plage de texte allant du
   paramètre indexDébut au paramètre indexFin.
   Exemple
   Cet exemple crée un objet TextFormat appelé monFormatDeTexte et définit sa propriété bold sur
   true. Il appelle ensuite la méthode setTextFormat et applique le nouveau format de texte au
   champ de texte monChampDeTexte.
   monFormatDeTexte = new TextFormat();
   monFormatDeTexte.bold = true;
   monChampDeTexte.setTextFormat(monFormatDeTexte);

   Voir aussi
   TextFormat (objet)

TextField._soundbuftime
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._soundbuftime

   Description
   Propriété (globale) ; un entier spécifiant le nombre de secondes de mise en tampon d’un son avant
   sa lecture en flux continu.




                                                                            Dictionnaire ActionScript 455
TextField.tabEnabled
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.tabEnabled
      Description
      Propriété ; peut être définie pour une occurrence des objets MovieClip, Button ou TextField.
      Valeur undefined par défaut.
      Si la propriété tabEnabled est undefined ou true, l’objet est inclus dans l’ordre de tabulation
      automatique et l’objet est inclus dans l’ordre de tabulation personnalisé si la propriété tabIndex
      est également définie. Si tabEnabled est false, l’objet n’est pas inclus dans l’ordre de tabulation
      automatique. Pour un clip, si tabEnabled est false, les enfants du clip peuvent toujours être
      inclus dans l’ordre de tabulation automatique, à moins que la propriété tabChildren ait
      également été définie sur false.
      Si tabEnabled est undefined ou true, l’objet est inclus dans l’ordre de tabulation automatique
      si la propriété tabIndex est définie. Si tabEnabled est false, l’objet n’est pas inclus dans l’ordre
      de tabulation automatique, même si la propriété tabIndex est définie. Si tabEnabled est défini
      sur false dans un clip, les enfants du clip peuvent toujours être inclus dans l’ordre de tabulation
      automatique.

TextField.tabIndex
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.tabIndex
      Paramètres
      Aucun.
      Renvoie
      Rien.
      Description
      Propriété ; permet de définir l’ordre de tabulation automatique des objets d’une animation. Vous
      pouvez définir la propriété tabIndex, qui est undefined par défaut, pour une occurrence de
      bouton, clip ou champ de texte.
      Si un des objets affichés dans l’animation Flash contient une propriété tabIndex, l’ordre de
      tabulation automatique est désactivé, et l’ordre de tabulation est calculé en fonction des propriétés
      tabIndex des objets de l’animation. L’ordre de tabulation personnalisé n’inclut que les objets
      possédant des propriétés tabIndex.
      La propriété tabIndex doit être un entier positif. Les objets sont placés dans l’ordre
      correspondant à leurs propriétés tabIndex, dans un ordre croissant. Un objet avec une propriété
      tabIndex dont la valeur est 1 précède un objet avec une valeur tabIndex de 2. Si deux objets ont
      la même valeur tabIndex, celui qui précède l’autre dans l’ordre de tabulation est undefined.




456
   L’ordre de tabulation personnalisé défini par la propriété tabIndex est flat. Cela signifie que la
   relation hiérarchique des objets de l’animation Flash n’a pas importance. Tous les objets de
   l’animation Flash possédant des propriétés tabIndex sont placés dans l’ordre de tabulation, qui
   est déterminé par l’ordre des valeurs tabIndex. Si deux objets ont la même valeur tabIndex,
   celui qui précède l’autre dans l’ordre de tabulation est undefined. Vous ne devriez pas utiliser la
   même valeur tabIndex pour plusieurs objets.

TextField._target
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._target

   Description
   Propriété (lecture seule) ; renvoie le chemin cible de l’occurrence de champ de texte spécifiée dans
   le paramètre monChampDeTexte.

TextField.text
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.text

   Description
   Propriété ; indique le texte d’un champ de texte. Les lignes sont séparées par le caractère de retour
   chariot (« \r », ASCII 13). Cette propriété contient le texte normal, non formaté, sans balises
   HTML, même si le champ de texte est en HTML.
   Voir aussi
   TextField.htmlText

TextField.textColor
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte.textColor

   Description
   Propriété ; indique la couleur du texte d’un champ de texte.




                                                                          Dictionnaire ActionScript 457
TextField.textHeight
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.textHeight

      Description
      Propriété ; indique la hauteur du texte.

TextField.textWidth
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.textWidth

      Description
      Propriété ; indique la largeur du texte.

TextField.type
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.type

      Description
      Propriété ; spécifie le type du champ de texte. Il y a deux valeurs : "dynamic", qui spécifie un
      champ de texte dynamique (ne peut pas être modifié par l’utilisateur) et "input", qui spécifie un
      champ de texte de saisie.
      Exemple
      monChampDeTexte.type = "dynamic";

TextField._url
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte._url

      Description
      Propriété (lecture seule) ; récupère l’URL du fichier SWF créateur de ce champ de texte.




458
TextField.variable
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._variable

   Description
   Propriété ; le nom de la variable à laquelle le champ de texte est associé. Le type de cette propriété
   est String.

TextField._visible
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._visible

   Description
   Propriété ; une valeur booléenne indiquant le champ de texte spécifié par le paramètre
   monChampDeTexte est visible. Les champs de texte qui ne sont pas visibles (propriété _visible
   définie sur false) sont désactivés.

TextField._width
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._width

   Description
   Propriété ; définit et récupère la largeur du champ de texte, en pixels.
   Exemple
   L’exemple suivant définit les propriétés de hauteur et de largeur d’un champ de texte :
   monChampDeTexte._width=200;
   monChampDeTexte._height=200;

   Voir aussi
   MovieClip._height




                                                                           Dictionnaire ActionScript 459
TextField.wordWrap
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte.wordWrap

      Description
      Propriété ; une valeur booléenne indiquant si le contenu du champ de texte passe
      automatiquement à la ligne. Si la valeur de wordWrap est true, le champ de texte passe
      automatiquement à la ligne ; si la valeur est false, le champ de texte ne passe pas
      automatiquement à la ligne.

TextField._x
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte._x

      Description
      Propriété ; un entier définissant la coordonnée x du champ de texte par rapport aux coordonnées
      locales du clip parent. Si un champ de texte se trouve dans le scénario principal, son système de
      coordonnées fait référence au coin supérieur gauche de la scène, comme (0, 0). Si le champ de
      texte se trouve dans un clip qui a subi des transformations, le champ de texte est dans le système
      de coordonnées local du clip le contenant. Donc, pour un clip ayant pivoté de 90° dans le sens
      inverse des aiguilles d’une montre, le champ de texte inclus hérite d’un système de coordonnées
      qui a pivoté de 90° dans le sens inverse des aiguilles d’une montre. Les coordonnées du champ de
      texte font référence à la position du point d’alignement.
      Voir aussi
      TextField._xscale, TextField._y, TextField._yscale


TextField._xmouse
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte._xmouse

      Description
      Propriété (lecture seule) ; renvoie la coordonnée x de la position de la souris par rapport au champ
      de texte.
      Voir aussi
      TextField._ymouse




460
TextField._xscale
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._xscale

   Description
   Propriété ; détermine l’échelle horizontale (pourcentage) du champ de texte telle qu’appliquée à
   partir du point d’alignement du champ de texte. Le point d’alignement par défaut est (0,0).
   Voir aussi
   TextField._x, TextField._y, TextField._yscale


TextField._y
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._y

   Description
   Propriété ; définit la coordonnée y du champ de texte par rapport aux coordonnées locales du clip
   parent. Si un champ de texte se trouve dans le scénario principal, son système de coordonnées fait
   référence au coin supérieur gauche de la scène, comme (0, 0). Si le champ de texte se trouve dans
   un autre clip qui a subi des transformations, le champ de texte est dans le système de coordonnées
   local du clip le contenant. Donc, pour un clip ayant pivoté de 90° dans le sens inverse des aiguilles
   d’une montre, le champ de texte inclus hérite d’un système de coordonnées qui a pivoté de 90°
   dans le sens inverse des aiguilles d’une montre. Les coordonnées du champ de texte font référence
   à la position du point d’alignement.
   Voir aussi
   TextField._x, TextField._xscale, TextField._yscale


TextField._ymouse
   Disponibilité
   Flash Player 6.
   Usage
   monChampDeTexte._ymouse

   Description
   Propriété (lecture seule) ; indique la coordonnée y de la position de la souris par rapport au champ
   de texte.
   Voir aussi
   TextField._xmouse




                                                                          Dictionnaire ActionScript 461
TextField._yscale
      Disponibilité
      Flash Player 6.
      Usage
      monChampDeTexte._yscale

      Description
      Propriété ; définit l’échelle verticale (pourcentage) du champ de texte telle qu’appliquée à partir
      du point d’alignement du champ de texte. Le point d’alignement par défaut est (0,0).
      Voir aussi
      TextField._x, TextField._xscale, TextField._y


TextFormat (objet)
      L’objet TextFormat représente les informations de format des caractères.
      Vous devez utiliser le constructeur new TextFormat pour créer une occurrence de l’objet
      TextFormat avant d’en appeler les méthodes.
      Vous pouvez définir les paramètres de TextFormat sur null pour indiquer qu’ils sont indéfinis.
      Lorsque vous appliquez un objet TextFormat à un champ de texte avec la méthode
      setTextFormat, seules ses propriétés définies sont appliquées, comme dans l’exemple suivant :
      monFormatDeTexte = new TextFormat();
      monFormatDeTexte.bold = true;
      monChampDeTexte.setTextFormat(monFormatDeTexte);
      Ce code crée d’abord un objet TextFormat vide, avec toutes ses propriétés indéfinies, puis
      applique la propriété bold à une valeur définie.
      Le code monChampDeTexte.setTextFormat(monFormatDeTexte) change seulement la propriété
      bold du format de texte par défaut du champ de texte, étant donné que la propriété bold est la
      seule qui soit définie dans monFormatDeTexte. Tous les autres aspects du format de texte par
      défaut du champ de texte restent inchangés.
      Lorsque getTextFormat est invoqué, un objet TextFormat est retourné avec toutes ses propriétés
      définies, aucune propriété restant null.

Méthodes de l’objet TextFormat

      Méthode                      Description

      TextFormat.getTextExtent     Renvoie un objet avec deux propriétés, width et height, qui indiquent la taille
                                   d’un texte dans un champ de texte.




462
Propriétés de l’objet TextFormat

    Propriété                      Description

    TextFormat.align               Indique l’alignement d’un paragraphe.

    TextFormat.blockIndent         Indique l’indentation d’un bloc, en points.

    TextFormat.bold                Indique si le texte apparaît en gras.

    TextFormat.bullet              Indique si le texte fait partie d’une liste à puces.

    TextFormat.color               Indique la couleur du texte.

    TextFormat.font                Indique le nom de la police du texte avec ce format.

    TextFormat.indent              Indique l’indentation, de la marge gauche au premier caractère du paragraphe.

    TextFormat.italic              Indique si le texte apparaît en italique.

    TextFormat.leading             Indique l’espace séparant les lignes.

    TextFormat.leftMargin          Indique la marge gauche du paragraphe, en points.

    TextFormat.rightMargin         Indique la marge droite