ADOBE FLASH LITE 2, FLASH LITE 3 User Manual

ADOBE® FLASH® LITE™ 2.x et 3.x

Guide de référence du langage Adobe® ActionScript

Guide de référence du langage ActionScript™ Flash® Lite™ 2.x et 3.x d'Adobe®

S’il est distribué avec un logiciel comprenant un contrat de licence, ce manuel, ainsi que le logiciel qui y est décrit, sont cédés sous licence et ne peuvent être utilisés ou copiés que conformément à la présente licence. Sauf lorsque cela est prévu par la licence, aucune partie de ce manuel ne peut être reproduite, conservée sur un support de stockage ou transmise par un moyen ou sous une forme quelconque (électronique, mécanique, enregistrée ou autre), sans l’autorisation écrite préalable d’Adobe Systems Incorporated. Veuillez noter que le contenu de ce manuel est protégé par des droits d’auteur, même s’il n’est pas distribué avec un logiciel comprenant un contrat de licence.

Les informations contenues dans ce manuel sont fournies à titre purement indicatif et ne doivent pas être considérées comme un engagement de la part d’Adobe Systems Incorporated, qui se réserve le droit de les modifier sans préavis. Adobe Systems Incorporated décline toute responsabilité en cas d’éventuelles erreurs ou inexactitudes relevées dans le contenu informationnel de ce manuel.

Nous attirons votre attention sur le fait que les illustrations ou images que vous pouvez être amené à inclure dans vos projets sont peut-être protégées par des droits d’auteur. L’exploitation de matériel protégé sans l’autorisation de l’auteur constitue une violation de droit. Assurez-vous d’obtenir les autorisations requises avant de procéder.

Toutes les références à des noms de sociétés utilisés dans les modèles sont purement fictives et ne renvoient à aucune entreprise existante.

Adobe, the Adobe logo, ActionScript, Flash, and Flash Lite are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.

Windows, Windows NT, and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. All other trademarks are the property of their respective owners.

Sorenson Spark™ video compression and decompression technology licensed from Sorenson Media, Inc.

MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson Multimedia (

Portions licensed from Nellymoser, Inc. (

www.nellymoser.com).

http://www.iis.fhg.de/amm/).

http://www.on2.com.

Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.

Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

Sommaire

Chapitre 1 : Eléments du langage ActionScript

Directives de compilation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

constantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Fonctions globales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Propriétés globales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

opérateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Commandes fscommand2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Chapitre 2 : Classes ActionScript

arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

BitmapData (flash.display.BitmapData) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Boolean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Bouton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

capabilities (System.capabilities) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

ColorTransform (flash.geom.ColorTransform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

ExtendedKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319

LoadVars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

LocalConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

Matrix (flash.geom.Matrix) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390

MovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

MovieClipLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

NetConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482

NetStream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

Point (flash.geom.Point) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519

Rectangle (flash.geom.Rectangle) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527

Security (System.security) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549

Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554

SharedObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561

Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572

Stage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592

String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

iii

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Sommaire

System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610

TextField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613

TextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653

Transform (flash.geom.Transform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673

XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679

XMLNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697

XMLSocket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713

Chapitre 3 : Code ActionScript déconseillé

Fonctions déconseillées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721

Propriétés déconseillées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722

Opérateurs déconseillés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723

Chapitre 4 : Eléments de code ActionScript non pris en charge

Classes non prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724

Méthodes non prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724

Propriétés non prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724

Fonctions globales non prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724

Gestionnaires d'événements non pris en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

Commandes fs non prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

Index ...............................................................................................................726

Chapitre 1 : Eléments du langage ActionScript

Cette section fournit des informations sur la syntaxe, l'utilisation et des exemples de code concernant les fonctions et les propriétés globales (éléments n'appartenant pas à une classe ActionScript), ainsi que les directives de compilation ; pour les constantes, elle décrit les opérateurs, instructions et mots-clés utilisés dans ActionScript et définis par la spécification de langage ECMAScript (ECMA-262), version 4.

Directives de compilation

Cette section regroupe les directives à inclure dans votre fichier ActionScript pour demander au compilateur de prétraiter certaines instructions.

Résumé des directives de compilation

Directive Description

#endinitclip Directive de compilation ; indique la fin d'un bloc d'actions d'initialisation.

#include Directive de compilation : inclut le contenu du fichier spécifié, comme si les

#initclip Directive de compilation ; indique le début d'un bloc d'actions d'initialisation.

commandes du fichier faisaient partie du script d'appel.

#endinitclip, directive

#endinitclip

Directive de compilation ; indique la fin d'un bloc d'actions d'initialisation.

Disponibilité

Flash Lite™ 2.0

Exemple

#initclip ...initialization actions go here... #endinitclip

#include, directive

#include "[path]filename.as"

Remarque : Ne placez pas de point-virgule (;) à la fin de la ligne qui contient l'instruction #include.

Directive de compilation : inclut le contenu du fichier spécifié, comme si les commandes du fichier faisaient partie du script d'appel. La directive modifications à un fichier externe, vous devez enregistrer le fichier et recompiler tous les fichiers FLA qui l'utilisent.

#include est appelée lors de la compilation. Cela signifie que si vous apportez des

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Si vous utilisez le bouton Vérifier la syntaxe pour un script contenant des instructions #include, la syntaxe des fichiers inclus est également vérifiée.

Vous pouvez utiliser

#include dans des fichiers FLA et dans des fichiers de script externes, mais pas dans les fichiers

de classe ActionScript 2.0.

Vous pouvez omettre le chemin, ou spécifier un chemin relatif ou absolu pour le fichier à inclure. Si vous ne spécifiez pas de chemin, le fichier AS doit figurer dans l'un des emplacements suivants :

• Le même répertoire que le fichier FLA. Le même répertoire que le script contenant l'instruction #include.

• Le répertoire Include global, qui peut prendre l'une des formes suivantes :

Windows® 2000 or Windows XP: C:\Documents and Settings\utilisateur \Local

Settings\Application Data\Adobe\Flash 10\langue\Configuration\Include

Windows Vista®: C:\Users\utilisateur \Local Settings\ Application Data\Adobe\Flash 8\langue\Configuration\Include

Macintosh® OS X: Disque dur/Users/Library/Application Support/Adobe/Flash 10/langue/Configuration/Include

• Le répertoire programme Flash \langue\First Run\Include. Si vous enregistrez un fichier à cet endroit, il est copié

dans le répertoire Include global lors du démarrage suivant de Flash®.

Pour spécifier un chemin relatif pour le fichier AS, placez un point (.) pour représenter le répertoire actuel, deux points

..) pour représenter le répertoire parent et une barre oblique (/) pour représenter les sous-répertoires. Consultez les

( exemples suivants :

Pour spécifier un chemin absolu pour le fichier AS, appliquez le format correspondant à votre plate-forme (Macintosh ou Windows). Consultez les exemples suivants : (Cette utilisation n'est pas recommandée car elle nécessite une structure de répertoires identique sur l'ordinateur servant à compiler le script.)

Remarque : Si vous placez des fichiers dans le répertoire First Run/Include ou dans le répertoire global Include, sauvegardez ces fichiers. En effet, si vous devez désinstaller et réinstaller Flash, ces répertoires risquent d'être supprimés ou remplacés.

Disponibilité

Flash Lite 2.0

Paramètres

[chemin]nom_fichier.as - nom_fichier.as Nom de fichier et chemin facultatif du script à ajouter au panneau

Actions ou au script actuel. Nous recommandons d'utiliser l'extension .as.

Exemple

Les exemples suivants indiquent différentes manières de spécifier un chemin pour un fichier à inclure dans votre script :

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

// Note that #include statements do not end with a semicolon (;) // AS file is in same directory as FLA file or script // or is in the global Include directory or the First Run/Include directory #include "init_script.as"

// AS file is in a subdirectory of one of the above directories // The subdirectory is named "FLA_includes" #include "FLA_includes/init_script.as" // AS file is in a subdirectory of the script file directory // The subdirectory is named "SCRIPT_includes" #include "SCRIPT_includes/init_script.as" // AS file is in a directory at the same level as one of the above directories // AS file is in a directory at the same level as the directory // that contains the script file // The directory is named "ALL_includes" #include "../ALL_includes/init_script.as"

// AS file is specified by an absolute path in Windows // Note use of forward slashes, not backslashes #include "C:/Flash_scripts/init_script.as"

// AS file is specified by an absolute path on Macintosh #include "Mac HD:Flash_scripts:init_script.as"

#initclip, directive

#initclip order

Remarque : Ne placez pas de point-virgule (;) à la fin de la ligne qui contient l'instruction #initclip.

Directive de compilation ; indique le début d'un bloc d'actions d'initialisation. Lorsque plusieurs clips sont initialisés simultanément, vous pouvez utiliser le paramètre Les actions d'initialisation s'exécutent lorsqu'un symbole de clip est défini. Si le clip est un symbole exporté, les actions d'initialisation s'exécutent avant les actions de l'image 1 du fichier SWF. Sinon, elles s'exécutent immédiatement avant les actions portant sur l'image qui contient la première occurrence du symbole de clip correspondant.

Les actions d'initialisation ne s'exécutent qu'une seule fois lors de la lecture d'un fichier SWF ; utilisez-les pour les initialisations uniques, telles que les opérations de définition de classe et d'inscription.

Disponibilité

Flash Lite 2.0

Paramètres

order - Entier non négatif spécifiant l'ordre d'exécution des blocs de code #initclip. Ce paramètre est facultatif.

Vous devez spécifier la valeur à l'aide d'un littéral entier (seules les valeurs décimales sont autorisées, et non pas les valeurs hexadécimales), et non à l'aide d'une variable. Si vous incluez plusieurs blocs clip unique, le compilateur utilise alors la dernière valeur

#initclip de ce symbole.

Exemple

Dans l'exemple suivant, le code ActionScript est placé sur l'image 1 au sein d'une occurrence de clip. Un fichier texte variables.txt est placé dans le même répertoire.

order pour spécifier l'initialisation devant se produire en premier.

#initclip dans un symbole de

order spécifiée dans ce symbole de clip pour tous les blocs

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

#initclip

trace("initializing app");

var variables:LoadVars = new LoadVars();

variables.load("variables.txt");

variables.onLoad = function(success:Boolean) {

trace("variables loaded:"+success);

if (success) { for (i in variables) { trace("variables."+i+" = "+variables[i]); } } };

#endinitclip

Eléments du langage ActionScript

constantes

Une constante est une variable qui représente une propriété dont la valeur ne change jamais. Cette section décrit des constantes globales qui sont disponibles pour tous les scripts.

Résumé des constantes

Modificateurs Constante Description

false Valeur booléenne unique qui représente l'opposé de

Infinity Spécifie la valeur IEEE-754 représentant l'infini positif.

-Infinity Spécifie la valeur IEEE-754 représentant l'infini négatif.

NaN Variable prédéfinie incluant la valeur IEEE-754 pour NaN (n'est

newline Insère un caractère de retour chariot (

null Valeur spéciale qui peut être affectée à des variables ou

true Valeur booléenne unique qui représente l'opposé de false.

undefined Une valeur spéciale, qui indique généralement qu'une variable

pas un nombre).

\r) qui insère une ligne

vierge dans le texte généré par votre code.

renvoyée par une fonction en l'absence de données.

n'a pas encore reçu de valeur.

true.

false, constante

Valeur booléenne unique qui représente l'opposé de true.

Lorsque le typage automatique de données convertit chaîne, il renvoie

"false".

false en nombre, il renvoie 0. Lorsqu'il convertit false en

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Disponibilité

Flash Lite 1.1

Exemple

Cet exemple indique comment le typage automatique de données convertit

var bool1:Boolean = Boolean(false);

// converts it to the number 0 trace(1 + bool1); // outputs 1

// converts it to a string trace("String: " + bool1); // outputs String: false

false en nombre et en chaîne :

Infinity, constante

Spécifie la valeur IEEE-754 représentant l'infini positif. La valeur de cette constante est identique à

Number.POSITIVE_INFINITY.

Disponibilité

Flash Lite 2.0

Voir aussi

POSITIVE_INFINITY (propriété Number.POSITIVE_INFINITY)

-Infinity, constante

Spécifie la valeur IEEE-754 représentant l'infini négatif. La valeur de cette constante est identique à

Number.NEGATIVE_INFINITY.

Disponibilité

Flash Lite 2.0

Voir aussi

NEGATIVE_INFINITY (propriété Number.NEGATIVE_INFINITY)

NaN, constante

Variable prédéfinie incluant la valeur IEEE-754 pour NaN (n'est pas un nombre). Pour déterminer si la valeur d'un nombre est NaN, utilisez

Disponibilité

Flash Lite 1.1

Voir aussi

isNaN, fonction, NaN (propriété Number.NaN)

isNaN().

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

newline, constante

Insère un caractère de retour chariot (\r) qui insère une ligne vierge dans le texte généré par votre code. Utilisez

newline pour ménager un espace pour les informations extraites par une fonction ou une instruction dans votre code.

Disponibilité

Flash Lite 1.1

Exemple

L'exemple suivant indique comment

var myName:String = "Lisa", myAge:Number = 30; trace(myName+myAge); trace("-----"); trace(myName+newline+myAge); // output: Lisa30

---- Lisa 30

newline affiche la sortie à partir de l'instruction trace() sur plusieurs lignes.

Voir aussi

trace, fonction

null, constante

Valeur spéciale qui peut être affectée à des variables ou renvoyée par une fonction en l'absence de données. Vous pouvez utiliser

null pour représenter les valeurs manquantes ou dont le type de données n'est pas défini.

Disponibilité

Flash Lite 1.1

Exemple

Dans un contexte numérique,

null renvoie 0. Vous pouvez exécuter des tests d'égalité avec null. Dans cette

instruction, le nœud d'arbre binaire ne comporte pas d'enfant gauche, par conséquent le champ de cet enfant gauche peut être défini sur

if (tree.left == null) { tree.left = new TreeNode(); }

null.

true, constante

Valeur booléenne unique qui représente l'opposé de false. Lorsque le typage automatique de données convertit true en nombre, il renvoie 1. Lorsqu'il convertit

true en chaîne, il renvoie "true".

Disponibilité

Flash Lite 1.1

Exemple

L'exemple suivant illustre l'utilisation de

true dans une instruction if :

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

var shouldExecute:Boolean; // ... // code that sets shouldExecute to either true or false goes here // shouldExecute is set to true for this example:

shouldExecute = true;

if (shouldExecute == true) { trace("your statements here"); }

// true is also implied, so the if statement could also be written: // if (shouldExecute) { // trace("your statements here"); // }

L'exemple suivant indique comment le typage automatique de données convertit true en nombre 1 :

var myNum:Number; myNum = 1 + true; trace(myNum); // output: 2

Voir aussi

false, constante, Boolean

undefined, constante

Une valeur spéciale, qui indique généralement qu'une variable n'a pas encore reçu de valeur. Une référence à une valeur non définie renvoie la valeur spéciale

"undefined". L'unique valeur du type undefined est undefined.

Dans les fichiers publiés pour Flash Player 6 ou version précédente, la valeur de chaîne vide). Dans les fichiers publiés pour Flash Player 7 ou version ultérieure, la valeur de

"undefined" (undefined est converti en chaîne).

Dans les fichiers publiés pour Flash Player 6 ou version précédente, la valeur de fichiers publiés pour Flash Player 7 ou version précédente, la valeur de

La valeur avec l'opérateur d'égalité (

undefined est similaire à la valeur spéciale null. Lorsque les propriétés null et undefined sont comparées

==), elles sont considérées comme égales. Lorsque les propriétés null et undefined sont

comparées avec l'opérateur d'égalité stricte (

Disponibilité

Flash Lite 1.1

Exemple

Dans l'exemple suivant, la variable

x n'a pas été déclarée, sa valeur est donc undefined.

Dans la première section du code, l'opérateur d'égalité ( s'affiche dans le panneau Sortie. Dans la première section du code, l'opérateur d'égalité ( la valeur

undefined ; le résultat s'affiche dans le fichier journal.

undefined. Le code ActionScript typeof(undefined) renvoie la chaîne

String(undefined) est « » (une

String(undefined) est

Number(undefined) est 0. Dans les

Number(undefined) est NaN.

===), elles sont considérées comme différentes.

==) compare la valeur de x à la valeur undefined ; le résultat

==) compare la valeur de x à

Dans la deuxième section du code, l'opérateur d'égalité (

==) compare les valeurs null et undefined.

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

// x has not been declared trace("The value of x is "+x);

if (x == undefined) { trace("x is undefined"); } else { trace("x is not undefined"); }

trace("typeof (x) is "+typeof (x));

if (null == undefined) { trace("null and undefined are equal"); } else { trace("null and undefined are not equal"); }

Le résultat suivant s'affiche dans le panneau Sortie.

The value of x is undefined x is undefined typeof (x) is undefined null and undefined are equal

Eléments du langage ActionScript

Fonctions globales

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

Résumé des fonctions globales

ModificateursSignature Description

Array([numElements],

Boolean(expression:Obje

call

chr

clearInterval(intervalID:N

Boolean(), int() etc.), la production d'informations de débogage (trace()) et la communication

fscommand()).

[elementN]) : Array

ct) : Boolean

(frame:Object) Déconseillé depuis Flash Player 5. Cette action est déconseillée

(number:Number) :

String

umber)

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

Convertit le paramètre expression en une valeur booléenne et

true ou false.

renvoie

au profit de l'instruction

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

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée au profit de

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

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

function.

String.fromCharCode().

duplicateMovieClip(target:

Object, newname:String, depth:Number)

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

ModificateursSignature Description

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

escape

eval

(expression:Strin

g) : String

(expression:Object)

: Object

fscommand(command:Stri

ng, parameters:String)

fscommand2

ng, parameters:String)

(command:Stri

getProperty(my_mc:Object

, property:Object) : Object

getTimer

() : Number Renvoie le nombre de millisecondes qui se sont écoulées depuis

getURL(url:String,

[window:String], [method:String])

getVersion

() : String Renvoie une chaîne contenant la version de Flash Player et des

gotoAndPlay([scene:Strin

g], frame:Object)

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

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

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

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

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

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

my_mc.

le début de la lecture du fichier SWF.

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

informations sur la plate-forme.

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

gotoAndStop([scene:Stri

ng], frame:Object)

ifFrameLoaded([scene:Str

ing], frame:Object, statement(s):Object)

int

isFinite

isNaN

(value:Number) :

Number

(expression:Objec

t) : Boolean

(expression:Object

) : Boolean

length(expression:Strin

g, variable:Object) : Number

loadMovie(url:String,

target:Object, [method:String])

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

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée. Adobe recommande d'employer la propriété

MovieClip._framesloaded.

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

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée au profit de

Math.round().

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

Evalue l'expression et renvoie true s'il s'agit d'un nombre fini

false s'il s'agit de l'infini ou de l'infini négatif.

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

Déconseillé depuis Flash Player 5. Cette fonction, de même que les fonctions de chaîne, est déconseillée. Adobe recommande d'employer les méthodes de la classe String et la propriété

String.length pour effectuer les mêmes opérations.

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

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

ModificateursSignature Description

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

loadMovieNum

, level:Number, [method:String])

(url:String

loadVariables(url:String,

target:Object, [method:String])

loadVariablesNum

ng, level:Number, [method:String])

mbchr

(number:Number) Déconseillé depuis Flash Player 5. Cette fonction est

(url:Stri

mblength(string:String)

: Number

mbord(character:String

) : Number

mbsubstring(value:String

, index:Number, count:Number) : String

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

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

déconseillée au profit de la méthode

String.fromCharCode().

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

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

String.length.

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

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée au profit de la méthode

String.charCodeAt().

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

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée au profit de la méthode

String.substr().

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

nextFrame

nextScene

Number

ct) : Number

Object([value:Object])

: Object

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

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

(expression:Obje

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

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

on(mouseEvent:Object) Spécifie l'événement de type souris ou pression de touche devant

déclencher une action.

onClipEvent(movieEvent:O

bject)

ord(character:String) :

Number

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

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

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

parseFloat

: Number

(string:String)

parseInt(expression:Stri

ng, [radix:Number]) : Number

Convertit une chaîne en nombre à virgule flottante.

Convertit une chaîne en entier.

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

ModificateursSignature Description

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

prevFrame

prevScene

random

Number

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

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

(value:Number) :

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée au profit de

Math.random().

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

removeMovieClip

bject)

setInterval(functionName:O

bject, interval:Number, [param:Object], objectName:Object, methodName:String) : Number

setProperty(target:Object

, property:Object, expression:Object)

startDrag(target:Object,

[lock:Boolean], [left,top,right,bottom :Number])

(target:O

Supprime le clip spécifié.

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

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

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

stop() Arrête le fichier SWF en cours de lecture.

stopAllSounds

() Arrête tous les sons en cours de diffusion à partir d'un fichier SWF,

sans arrêter la tête de lecture.

value.

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

String

substring(string:String,

targetPath(targetObject:

tellTarget

(expression:Object

) : String

index:Number, count:Number) : String

Object) : String

(target:String,

statement(s):Object)

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

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée au profit de

String.substr().

Extrait une partie d'une chaîne.

Renvoie une chaîne contenant le chemin cible de

movieClipObject.

Déconseillé depuis Flash Player 5. Adobe recommande d'utiliser une notation de type point (.) et l'instruction

Cette fonction applique les instructions spécifiées dans le paramètre

target.

statements au scénario spécifié par le paramètre

toggleHighQuality() Déconseillé depuis Flash Player 5. Cette fonction est

déconseillée au profit de

_quality.

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

trace(expression:Object) Evalue l'expression et renvoie le résultat.

with.

ModificateursSignature Description

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

unescape(string:String)

unloadMovie

unloadMovieNum

: String

(target) Supprime le clip qui a été chargé par l'intermédiaire de la fonction

(level:Nu

mber)

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

loadMovie() de Flash Player.

Supprime un fichier SWF ou une image chargés par l'intermédiaire de la fonction

loadMovieNum() de Flash Player.

Array, fonction

Array(): Array Array(numElements:Number): Array Array( [element0:Object [, element1, element2, ...elementN] ]) : Array

Crée un nouveau tableau de longueur zéro ou supérieure, ou un tableau contenant la liste des éléments spécifiés, probablement de types de données différents.

Permet de créer l'un des tableaux suivants :

• un tableau vide ;

• un tableau d'une longueur spécifique mais dont les éléments ont des valeurs non définies ;

• un tableau dont les éléments ont des valeurs spécifiques.

L'utilisation de cette fonction revient à créer un tableau avec le constructeur Array (voir « Constructeur pour la classe Array »).

Vous pouvez transmettre un nombre ( différents (

element0, element1, ... elementN).

numElements) ou la liste des éléments contenant un ou plusieurs types

Les paramètres qui peuvent accepter plusieurs types de données sont répertoriés dans la signature sous le type

Object.

Disponibilité

Flash Lite 2.0

Paramètres

numElements [facultatif] - Entier positif spécifiant le nombre d'éléments contenus dans le tableau. Vous pouvez

spécifier numElements ou la liste des éléments, mais pas les deux.

elementN [facultatif] - un ou plusieurs paramètres, element0, element1, ... , elementN, dont les valeurs peuvent être de

n'importe quel type. Les paramètres qui peuvent accepter plusieurs types de données sont répertoriés sous le type

Object. Vous pouvez spécifier numElements ou la liste des éléments, mais pas les deux.

Valeur renvoyée

Array - Tableau.

Exemple

var myArray:Array = Array(); myArray.push(12); trace(myArray); //traces 12 myArray[4] = 7; trace(myArray); //traces 12,undefined,undefined,undefined,7

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Utilisation 2 : L'exemple suivant crée un tableau de longueur 4 qui n'inclut aucun élément défini :

var myArray:Array = Array(4); trace(myArray.length); // traces 4 trace(myArray); // traces undefined,undefined,undefined,undefined

Utilisation 3 : L'exemple suivant crée un tableau incluant trois éléments définis :

var myArray:Array = Array("firstElement", "secondElement", "thirdElement"); trace (myArray); // traces firstElement,secondElement,thirdElement

Remarque : Contrairement au constructeur de classe Array, la fonction Array() n'utilise pas le mot-clé new.

Voir aussi

Array

Boolean, fonction

Boolean(expression:Object) : Boolean

Convertit le paramètre expression en valeur booléenne et renvoie une valeur comme indiqué dans la liste suivante :

• Si expression est une valeur booléenne, la valeur renvoyée est expression.

• Si expression est un nombre, la valeur renvoyée est true si le nombre diffère de zéro ; sinon, la valeur renvoyée est

false.

Si expression est une chaîne, la valeur renvoyée est l'une des valeurs suivantes :

• Dans les fichiers publiés pour Flash Player 6 ou une version plus récente, la chaîne est tout d'abord convertie en

nombre. Sa valeur est

true si le nombre est différent de zéro, false dans le cas contraire.

• Dans les fichiers publiés pour Flash Player 7 ou version ultérieure, le résultat est true si la longueur de la chaîne est

supérieure à zéro et

Si expression est une chaîne, le résultat est

false en cas de chaîne vide.

true si la longueur de cette chaîne est supérieure à zéro, false en cas de

chaîne vide.

• Si expression est undefined ou NaN (n'est pas un nombre), la valeur renvoyée est false.

• Si expression est un clip ou un objet, la valeur renvoyée est true.

Remarque : Contrairement au constructeur de classe Boolean, la fonction Boolean() n'utilise pas le mot-clé new. De plus, le constructeur de classe Boolean initialise un objet booléen sur false si aucun paramètre n'est spécifié, bien que la fonction Boolean() renvoie undefined en l'absence de paramètres.

Disponibilité

Flash Lite 2.0

Paramètres

expression:Object - Expression à convertir en valeur booléenne.

Valeur renvoyée

Boolean - Valeur booléenne.

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Exemple

trace(Boolean(-1)); // output: true trace(Boolean(0)); // output: false trace(Boolean(1)); // output: true

trace(Boolean(true)); // output: true trace(Boolean(false)); // output: false

trace(Boolean("true")); // output: true trace(Boolean("false")); // output: true

trace(Boolean("Craiggers")); // output: true trace(Boolean("")); // output: false

Si les fichiers sont publiés pour Flash Player 6 ou version antérieure, les résultats diffèrent pour trois des exemples précédents :

trace(Boolean("true")); // output: false trace(Boolean("false")); // output: false trace(Boolean("Craiggers")); // output: false

Cet exemple illustre une différence significative entre l'utilisation de la fonction Boolean() et celle de la classe Boolean. La fonction

Boolean() permet de créer une valeur booléenne, tandis que la classe Boolean crée un objet

booléen. Les valeurs booléennes sont comparées en fonction de leur valeur, tandis que les objets booléens sont comparés par référence.

// Variables representing Boolean values are compared by value var a:Boolean = Boolean("a"); // a is true var b:Boolean = Boolean(1); // b is true trace(a==b); // true

// Variables representing Boolean objects are compared by reference var a:Boolean = new Boolean("a"); // a is true var b:Boolean = new Boolean(1); // b is true trace(a == b); // false

Voir aussi

Boolean

call, fonction

call(frame)

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

Exécute le script dans l'image appelée sans positionner la tête de lecture sur celle-ci. Les variables locales n'existent pas après l'exécution du script.

• Si les variables ne sont pas déclarées dans un bloc ({}) mais que la liste d'actions a été exécutée à l'aide d'une action

call(), les variables sont locales et expirent à la fin de la liste actuelle.

• Si les variables ne sont pas déclarées dans un bloc et que la liste d'action actuelle n'a pas été exécutée à l'aide de

l'action call(), les variables sont interprétées en tant que variables de scénario.

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Disponibilité

Flash Lite 1.0

Paramètres

frame:Object - Etiquette ou numéro d'une image dans le scénario.

Voir aussi

Array, fonction, call (méthode Function.call)

chr, fonction

chr(number) : String

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée au profit de String.fromCharCode().

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

Disponibilité

Flash Lite 1.0

Paramètres

number:Number - Numéro de code ASCII.

Valeur renvoyée

String - La valeur de caractère du code ASCII spécifié.

Exemple

L'exemple suivant convertit le nombre 65 en lettre A et l'affecte à la variable

myVar : myVar = chr(65);

Voir aussi

fromCharCode (méthode String.fromCharCode)

clearInterval, fonction

clearInterval(intervalID:Number) : Void

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

Disponibilité

Flash Lite 2.0

Paramètres

intervalID:Number - Identificateur numérique (entier) renvoyé par un appel à setInterval().

Exemple

L'exemple suivant définit, puis supprime un appel interval :

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

function callback() { trace("interval called: "+getTimer()+" ms."); }

var intervalID:Number = setInterval(callback, 1000);

Vous devez supprimer l'intervalle lorsque vous n'avez plus besoin de la fonction. Créez un bouton intitulé

clearInt_btn et utilisez le code ActionScript suivant pour supprimer setInterval() :

clearInt_btn.onRelease = function(){ clearInterval( intervalID ); trace("cleared interval"); };

Voir aussi

setInterval, fonction

duplicateMovieClip, fonction

duplicateMovieClip(target:String, newname:String, depth:Number) : Void duplicateMovieClip(target:MovieClip, newname:String, depth:Number) : Void

Crée une occurrence de clip pendant la lecture du fichier SWF. La tête de lecture des clips dupliqués commence toujours à l'image 1, quelle que soit la position de la tête de lecture dans le clip d'origine. Les variables du clip d'origine ne sont pas copiées dans le clip dupliqué. La fonction ou la méthode occurrence de clip créée avec

duplicateMovieClip().

removeMovieClip() permet de supprimer une

Disponibilité

Flash Lite 2.0

Paramètres

target:Object - Chemin cible du clip à dupliquer. Ce paramètre peut être de type String (tel que "my_mc") ou une

référence directe à l'occurrence de clip (par exemple my_mc). Les paramètres qui peuvent accepter plusieurs types de données sont répertoriés sous le type

newname:String - Identificateur unique du clip dupliqué.

depth:Number - Niveau de profondeur unique pour le clip dupliqué. Le niveau de profondeur correspond à l'ordre

Object.

d'empilement des clips dupliqués. Cet ordre d'empilement correspond à l'ordre d'empilement des calques dans le scénario ; les clips dont le niveau de profondeur est inférieur sont masqués par les clips de niveau supérieur. Vous devez associer un niveau de profondeur à chaque clip pour ne pas remplacer les fichiers SWF figurant à des profondeurs non utilisées.

Exemple

L'exemple suivant entraîne la création d'une occurrence de clip appelée puis le clip

img_mc est dupliqué. Le clip dupliqué est intitulé newImg_mc ; ce nouveau clip est déplacé sur la scène afin

img_mc. Une image est chargée dans le clip,

de ne pas recouvrir le clip d'origine et la même image est chargée dans le deuxième clip.

this.createEmptyMovieClip("img_mc", this.getNextHighestDepth()); img_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg"); duplicateMovieClip(img_mc, "newImg_mc", this.getNextHighestDepth()); newImg_mc._x = 200; newImg_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg");

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Pour supprimer le clip dupliqué, vous pouvez ajouter ce code pour un bouton intitulé myButton_btn.

this.myButton_btn.onRelease = function(){ removeMovieClip(newImg_mc); };

Voir aussi

removeMovieClip, fonction, duplicateMovieClip (méthode MovieClip.duplicateMovieClip),

removeMovieClip (méthode MovieClip.removeMovieClip)

escape, fonction

escape(expression:String) : String

Convertit le paramètre en chaîne et applique le format de code URL, où tous les caractères qui ne sont pas de type alphanumérique sont remplacés par des séquences hexadécimales (%). Lorsque cette fonction est utilisée dans une chaîne codée au format URL, le symbole pour-cent (%) introduit les caractères d'échappement et ne doit pas être confondu avec l'opérateur modulo (%).

Disponibilité

Flash Lite 2.0

Paramètres

expression:String - Expression à convertir en chaîne et à coder au format URL.

Valeur renvoyée

String - Chaîne codée au format URL.

Exemple

Le code suivant donne le résultat

var email:String = "someuser@somedomain.com"; trace(escape(email));

someuser%40somedomain%2Ecom :

Dans cet exemple, le symbole (@) a été remplacé par %40 et le point (.) par %2E. Cela est particulièrement utile lorsque vous essayez de transmettre des informations à un serveur distant et si les données contiennent des caractères spéciaux (par exemple,

var redirectUrl = "http://www.somedomain.com?loggedin=true&username=Gus"; getURL("http://www.myothersite.com?returnurl="+ escape(redirectUrl));

& ou ?), comme indiqué dans le code suivant :

Voir aussi

unescape, fonction

eval, fonction

eval(expression:Object) : Objecteval(expression:String) : Object

Accède aux variables, propriétés, objets ou clips en fonction de leur nom. Lorsque l'expression est une variable ou une propriété, la fonction renvoie la valeur de cette variable ou de cette propriété. Si l'expression est un objet ou un clip, la fonction renvoie une référence de l'objet ou du clip. Si l'élément nommé dans l'expression est introuvable, la fonction renvoie undefined.

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Sous Flash 4, eval() permettait de simuler des tableaux ; à partir de Flash 5, vous devez utiliser la classe Array pour ce faire.

Sous Flash 4, vous pouvez également utiliser nom d'occurrence et l'extraire. Cette opération est également possible avec l'opérateur de tableau (

A partir de Flash 5, vous ne pouvez plus recourir à variable ou d'un nom d'occurrence, car vous ne pouvez pas utiliser

eval() pour définir de façon dynamique la valeur d'une variable ou d'un

[]).

eval() pour définir de façon dynamique et extraire la valeur d'une

eval() dans la partie gauche d'une équation. Par

exemple, remplacez le code

eval ("var" + i) = "first";

par :

this["var"+i] = "first"

ou par :

set ("var" + i, "first");

Disponibilité

Flash Lite 1.0

Paramètres

expression:Object - Nom d'une variable, d'une propriété, d'un objet ou d'un clip à extraire. Ce paramètre peut être

de type String ou une référence directe à l'occurrence d'objet (les guillemets (" ") sont facultatifs.)

Valeur renvoyée

Object - Une valeur, une référence à un objet ou un clip, ou undefined.

Exemple

L'exemple suivant utilise ActionScript définit la propriété

for (var i = 1; i <= 3; i++) { setProperty(eval("square"+i+"_mc"), _rotation, 5); }

eval() pour définir les propriétés des clips nommés de façon dynamique. Ce code

_rotation de trois clips intitulés square1_mc, square2_mc et square3_mc.

Vous pouvez également utiliser le code ActionScript suivant :

for (var i = 1; i <= 3; i++) { this["square"+i+"_mc"]._rotation = -5; }

Voir aussi

Array, set variable, instruction

fscommand, fonction

fscommand(command:String, parameters:String) : Void

La fonction fscommand() permet à un fichier SWF de communiquer avec le lecteur Flash Lite ou l'environnement d'un périphérique mobile (tel qu'un système d'exploitation). Les paramètres définissent le nom de l'application en cours de démarrage et les paramètres correspondants, séparés par des virgules.

Commande Paramètres Rôle

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

launch application-path,

arg1, arg2,..., argn

activateTextField"" (ignoré) Cette commande active de façon asynchrone le champ

Cette commande lance une autre application sur un périphérique mobile. Le nom de l'application et ses paramètres sont transmis à l'aide d'un argument unique.

Remarque : Cette fonctionnalité dépend du système d'exploitation. Utilisez cette commande avec circonspection, dans la mesure où elle a recours au périphérique hôte pour exécuter une opération non prise en charge. Ceci risque d'entraîner un blocage sur ce périphérique.

Cette commande est prise en charge uniquement lorsque le lecteur Flash Lite est en cours d'exécution en mode autonome. Elle n'est pas prise en charge lorsque le lecteur s'exécute dans le contexte d'une autre application (par exemple, en tant que module externe dans un navigateur).

texte sélectionné, ce qui autorise les modifications par l'utilisateur. En raison de son comportement asynchrone, cette commande est traitée à la fin de l'image. Le code ActionScript qui suit immédiatement l'appel à

fscommand() s'exécute en premier. Si aucun texte n'est

sélectionné lorsque la commande est traitée, rien ne se produit. Cette commande donne le focus a un champ texte qui a été transmis auparavant à la méthode

Selection.setFocus() et active le champ texte en vue

de sa modification. Cette commande a uniquement un effet lorsque le téléphone prend en charge la modification de texte en ligne.

Cette commande peut être appelée dans le cadre d'un rappel de l'écouteur d'événements

Selection.onSetFocus(). Les champs texte

deviennent alors actifs et peuvent être modifiés lorsqu'ils sont sélectionnés.

Remarque : dans la mesure où la fonction s'exécute de façon asynchrone, le champ texte ne devient pas immédiatement actif ; il le devient à la fin de l'image.

fscommand()

Disponibilité

Flash Lite 1.1

Paramètres

command:String - Chaîne transmise à l'application hôte ou commande passée au lecteur Flash Lite.

parameters:String - Chaîne transmise à l'application hôte ou valeur passée au lecteur Flash Lite.

Exemple

Dans l'exemple suivant, la fonction

fscommand() ouvre wap.yahoo.com sur le navigateur services/Web des téléphones

de la gamme Series 60 :

on(keyPress "9") { status = fscommand("launch", "z:\\system\apps\browser\browser.app,http://wap.yahoo.com"); }

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

fscommand2, fonction

fscommand2(command:String, parameter1:String,...parameterN:String) : Void

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

Pour utiliser

fscommand2() afin d'envoyer un message au lecteur Flash Lite, vous devez utiliser les commandes et les

paramètres prédéfinis. Consultez la section "Commandes fscommand2" de la rubrique « Eléments du langage ActionScript » pour prendre connaissance des commandes et paramètres pouvant être spécifiés pour la fonction

fscommand(). Ces valeurs contrôlent les fichiers SWF lus par le lecteur Flash Player.

La fonction

fscommand2() est similaire à la fonction fscommand(), à l'exception des différences suivantes :

• La fonction fscommand2() peut contenir autant d'arguments que nécessaire. Par opposition, fscommand() ne peut

recevoir qu'un seul argument.

• Flash Lite exécute fscommand2() immédiatement (en d'autres termes, dans l'image) alors que fscommand() est

exécuté à la fin du traitement de l'image.

• La fonction fscommand2() renvoie une valeur permettant de rapporter si la commande a réussi, échoué ou bien

son résultat.

Remarque : Aucune des commandes

fscommand2() n'est disponible dans les lecteurs Web.

Disponibilité

Flash Lite 1.1

Commandes fscommand2() déconseillées

Certaines commandes suivant répertorie les commandes

Commande Remplacée par

fscommand2() de Flash Lite 1.1 sont désormais déconseillées dans Flash Lite 2.0. Le tableau

fscommand2() remplacées :

Escape Fonction globale

GetDateDay Méthode getDate() de l'objet Date

GetDateMonth Méthode

GetDateWeekday Méthode

GetDateYear Méthode

GetLanguage Propriété

GetLocaleLongDate Méthode getLocaleLongDate() de l'objet Date

GetLocaleShortDate Méthode

GetLocaleTime Méthode

GetTimeHours Méthode

GetTimeMinutes Méthode

GetTimeSeconds Méthode

GetTimeZoneOffset Méthode

SetQuality

Unescape Fonction globale unescape()

MovieClip._quality

escape

getMonth() de l'objet Date

getDay() de l'objet Date

getYear() de l'objet Date

System.capabilities.language

getLocaleShortDate() de l'objet Date

getLocaleTime() de l'objet Date

getHours() de l'objet Date

getMinutes() de l'objet Date

getSeconds() de l'objet Date

getTimeZoneOffset() de l'objet Date

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Paramètres

command:String - Chaîne transmise à l'application hôte ou commande passée au lecteur Flash Lite.

parameters:String - Chaîne transmise à l'application hôte ou valeur passée au lecteur Flash Lite.

getProperty, fonction

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

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

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

Disponibilité

Flash Lite 1.0

Paramètres

my_mc:Object - Nom d'occurrence d'un clip pour lequel la propriété est extraite.

property:Object - Propriété d'un clip.

Valeur renvoyée

Object - La valeur de la propriété spécifiée.

Exemple

L'exemple suivant crée un nouveau clip

someClip_mc et affiche la valeur alpha (_alpha) du clip someClip_mc dans le

panneau Sortie :

this.createEmptyMovieClip("someClip_mc", 999); trace("The alpha of "+getProperty(someClip_mc, _name)+" is: "+getProperty(someClip_mc, _alpha));

getTimer, fonction

getTimer() : Number

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

Disponibilité

Flash Lite 1.0

Valeur renvoyée

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

Exemple

Dans l'exemple suivant, les fonctions

this.createTextField("timer_txt", this.getNextHighestDepth(), 0, 0, 100, 22); function updateTimer():Void { timer_txt.text = getTimer(); }

var intervalID:Number = setInterval(updateTimer, 100);

getTimer() et setInterval() sont utilisées pour créer un minuteur simple :

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

getURL, fonction

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

Charge un document en provenance d'une URL spécifique dans une fenêtre ou transmet des variables à une autre application, à une URL donnée. Pour tester cette fonction, assurez-vous que le fichier à charger existe à l'emplacement prévu. Pour utiliser une URL absolue (par exemple, http://www.myserver.com), vous devez disposer d'une connexion réseau.

Remarque : Cette fonction n'est pas prise en charge pour les périphériques BREW.

Disponibilité

Flash Lite 1.0

Paramètres

url:String - URL permettant d'obtenir le document.

window:String [facultatif] - Spécifie la fenêtre ou le cadre HTML dans lequel le document doit se charger. Vous

pouvez entrer le nom d'une fenêtre spécifique ou le sélectionner à partir des noms cibles réservés suivants :

• _self spécifie le cadre actif de la fenêtre en cours d'utilisation.

• _blank crée une fenêtre.

• _parent appelle le parent du cadre actif.

• _top sélectionne le cadre de plus haut niveau de la fenêtre active.

method:String [facultatif] - Méthode GET ou POST permettant d'envoyer des variables. En l'absence de variables,

omettez ce paramètre. La méthode nombreuses. La méthode

POST place les variables dans un en-tête HTTP distinct et permet d'envoyer des variables

longues de type chaîne.

GET ajoute les variables à la fin de l'URL et est utilisée lorsque les variables sont peu

Exemple

Cet exemple charge une image dans un clip. Lorsque l'utilisateur clique sur l'image, une nouvelle URL est chargée dans une nouvelle fenêtre de navigateur.

var listenerObject:Object = new Object(); listenerObject.onLoadInit = function(target_mc:MovieClip) { target_mc.onRelease = function() { getURL("http://www.macromedia.com/software/flash/flashpro/", "_blank"); }; }; var logo:MovieClipLoader = new MovieClipLoader(); logo.addListener(listenerObject); logo.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", this.createEmptyMovieClip("macromedia_mc", this.getNextHighestDepth()));

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

myBtn_btn.onRelease = function(){ getURL("mailto:you@somedomain.com"); };

Vous pouvez également utiliser la méthode GET ou POST pour envoyer des variables. L'exemple suivant utilise la méthode

GET pour ajouter des variables à une URL :

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

var firstName:String = "Gus"; var lastName:String = "Richardson"; var age:Number = 92; myBtn_btn.onRelease = function() { getURL("http://www.macromedia.com", "_blank", "GET"); };

Eléments du langage ActionScript

Le code ActionScript suivant utilise la méthode POST pour placer les variables dans l'en-tête HTTP. Assurez-vous de tester vos documents dans une fenêtre de navigateur ; sinon, vos variables sont envoyées à l'aide de la méthode

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

GET :

Voir aussi

loadVariables, fonction, send (méthode XML.send), sendAndLoad (méthode XML.sendAndLoad)

getVersion, fonction

getVersion() : String

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

getVersion ne renvoie des informations qu'à partir de la version 5 de Flash Player.

Disponibilité

Flash Lite 2.0

Valeur renvoyée

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

Exemple

Les exemples suivants identifient le numéro de version du lecteur Flash Player sur lequel est lu le fichier SWF :

var flashVersion:String = getVersion(); trace(flashVersion); // output: WIN 8,0,1,0 trace($version); // output: WIN 8,0,1,0 trace(System.capabilities.version); // output: WIN 8,0,1,0

La chaîne suivante est renvoyée par la fonction getVersion :

WIN 8,0,1,0

Cette chaîne renvoyée indique que la plate-forme utilisée est Microsoft Windows, et que le numéro de version de Flash Player est la version majeure 8, version mineure 1 (8.1).

Voir aussi

os (propriété capabilities.os), version (propriété capabilities.version)

gotoAndPlay, fonction

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

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Place la tête de lecture sur l'image spécifiée dans une séquence et commence la lecture à partir de cette image. Si aucune séquence n'est spécifiée, la tête de lecture passe à l'image spécifiée de la séquence en cours. Le paramètre scene est réservé au scénario racine. Vous ne pouvez pas l'utiliser dans les scénarios des clips ou autres objets du document.

Disponibilité

Flash Lite 1.0

Paramètres

scene:String [facultatif] - Chaîne spécifiant le nom de la séquence cible de la tête de lecture.

frame:Object - Nombre représentant le numéro d'image ou chaîne représentant l'étiquette de l'image cible de la tête

de lecture.

Exemple

Dans l'exemple suivant, un document contient deux séquences : étiquette d'image sur l'image 10 intitulée

newFrame et deux boutons, myBtn_btn et myOtherBtn_btn. Ce code

sceneOne et sceneTwo. La séquence 1 contient une

ActionScript est placé sur l'image 1, séquence 1 du scénario principal.

stop(); myBtn_btn.onRelease = function(){ gotoAndPlay("newFrame"); };

myOtherBtn_btn.onRelease = function(){ gotoAndPlay("sceneTwo", 1); };

Lorsque l'utilisateur clique sur les boutons, la tête de lecture se déplace à l'emplacement spécifié et continue la lecture.

Voir aussi

gotoAndPlay (méthode MovieClip.gotoAndPlay), nextFrame, fonction, play, fonction, prevFrame,

fonction

gotoAndStop, fonction

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

Place la tête de lecture sur l'image spécifiée sur une séquence et l'arrête à ce niveau. Si aucune séquence n'est spécifiée, la tête de lecture passe à l'image de la séquence en cours. Le paramètre scene est réservé au scénario racine. Vous ne pouvez pas l'utiliser dans les scénarios des clips ou autres objets du document.

Disponibilité

Flash Lite 1.0

Paramètres

scene:String [facultatif] - Chaîne spécifiant le nom de la séquence cible de la tête de lecture.

frame:Object - Nombre représentant le numéro d'image ou chaîne représentant l'étiquette de l'image cible de la tête

de lecture.

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Exemple

Dans l'exemple suivant, un document contient deux séquences : étiquette d'image sur l'image 10 intitulée

newFrame et deux boutons, myBtn_btn et myOtherBtn_btn. Ce code

sceneOne et sceneTwo. La séquence 1 contient une

ActionScript est placé sur l'image 1, séquence 1 du scénario principal :

stop();

myBtn_btn.onRelease = function(){ gotoAndStop("newFrame"); };

myOtherBtn_btn.onRelease = function(){ gotoAndStop("sceneTwo", 1); };

Lorsque l'utilisateur clique sur les boutons, la tête de lecture se déplace à l'emplacement spécifié et arrête la lecture.

Voir aussi

gotoAndStop (méthode MovieClip.gotoAndStop), stop, fonction, play, fonction, gotoAndPlay,

fonction

ifFrameLoaded, fonction

ifFrameLoaded( [scene,] frame) { statement(s); }

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée. Adobe recommande d'employer la propriété

MovieClip._framesloaded.

Vérifie si le contenu d'une image spécifique est disponible localement. Utilisez la fonction commencer à lire une animation simple pendant le téléchargement du reste du fichier SWF sur l'ordinateur local. La différence d'utilisation entre les fonctions vous permet d'ajouter des instructions

_framesloaded et ifFrameLoaded réside dans le fait que _framesloaded

if ou else personnalisées.

Disponibilité

Flash Lite 1.0

Paramètres

scene:String [facultatif] - Chaîne qui spécifie le nom de la séquence à charger.

frame:Object - Numéro ou étiquette d'image devant être chargés avant l'exécution de l'instruction suivante.

statement(s):Object - Instructions d'exécution si la séquence spécifiée, ou la séquence et l'image, sont chargées.

Voir aussi

addListener (méthode MovieClipLoader.addListener)

ifFrameLoaded pour

int, fonction

int(value) : Number

Déconseillé depuis Flash Player 5. Cette fonction est déconseillée au profit de Math.round().

Convertit un nombre décimal en valeur entière en tronquant la valeur décimale. Cette fonction correspond à

Math.floor() si le paramètre value est positif et à Math.ceil() si le paramètre value est négatif.

GUIDE DE RÉFÉRENCE DU LANGAGE ACTIONSCRIPT FLASH LITE 2.X ET 3.X

Eléments du langage ActionScript

Disponibilité

Flash Lite 1.0

Paramètres

value:Number - Nombre devant être arrondi à un entier.

Valeur renvoyée

Number - Le nombre entier tronqué.

Voir aussi

round (méthode Math.round), floor (méthode Math.floor), ceil (méthode Math.ceil)

isFinite, fonction

isFinite(expression:Object) : Boolean

Evalue l'expression et renvoie true s'il s'agit d'un nombre fini ou false s'il s'agit de l'infini ou de l'infini négatif. La présence du signe infini ou infini négatif indique une erreur mathématique, telle que la division par 0.

Disponibilité

Flash Lite 2.0

Paramètres

expression:Object - Valeur booléenne, variable ou toute autre expression à évaluer.

Valeur renvoyée

Boolean - Valeur booléenne.

Exemple

L'exemple suivant affiche les valeurs renvoyées pour

isFinite(56) // returns true

isFinite(Number.POSITIVE_INFINITY) //returns false

isFinite :

isNaN, fonction

isNaN(expression:Object) : Boolean

Evalue le paramètre et renvoie true si la valeur est NaN (not a number - n'est pas un nombre). Cette fonction permet de s'assurer qu'une expression mathématique a été évaluée correctement en tant que nombre.

Disponibilité

Flash Lite 2.0

Paramètres

expression:Object - Valeur booléenne, variable ou toute autre expression à évaluer.

+ 703 hidden pages