Forums d'entraide informatique - Astuces - Conseils

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
Usage 1 : 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;
Usage 2 : 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; do while 373
Usage 3 : L’exemple suivant illustre une autre façon de supprimer une propriété d’objet.
// créer un objet Array de longueur 0
mon_array = new Array();
// ajouter un élément au tableau. // Array.length est maintenant 1
mon_array[0] = "abc";
// ajouter un autre élément au tableau. // Array.length est maintenant 2
mon_array[1] = "def";
// ajouter un autre élément au tableau. // Tableau.length est maintenant 3
mon_array[1] = "ghi";
// mon_array[2] est supprimé, mais Array.length n’est pas changé
delete monTableau[2];
trace(mon_array.length);
Usage 4 : 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;
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.
Consultez également
var
do while
Disponibilité
Flash Player 4.
Usage
do {
instruction(s)
} while (condition)
Paramètres
condition La condition à évaluer.
instruction(s) La ou les instructions à exécuter tant que le paramètre condition est évalué
comme true.
Renvoie
Rien.
Description
Instruction : exécute les instructions, puis évalue la condition dans une boucle, tant que la
condition est true.374 Chapitre 12 : Dictionnaire ActionScript Présentation
Consultez également
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 fichiers SWF sur des
profondeurs occupées.
Renvoie
Une référence au clip dupliqué.
Description
Fonction : crée une occurrence de clip pendant la lecture du fichier SWF. 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().
Consultez également
MovieClip.duplicateMovieClip, removeMovieClip(), MovieClip.removeMovieClip()
dynamic
Disponibilité
Flash Player 6.
Usage
dynamic class nomDeLaClasse  [ extends superClasse ]
  [ implements nomDinterface [, nomDinterface... ] ]
{
// définition de la classe ici
}else 375
Remarque : Pour utiliser ce mot-clé, vous devez définir ActionScript 2.0 et Flash Player 6 ou version
ultérieure dans l’onglet Flash de la boîte de dialogue Paramètres de publication de votre fichier FLA.
Ce mot-clé n’est supporté que lorsqu’il est utilisé dans des fichiers de scripts externes et non dans
des scripts écrits dans le panneau Actions.
Description
Mot-clé : définit que les objets basés sur la classe spécifiée peuvent ajouter des propriétés
dynamiques et y accéder au moment de l’exécution.
La vérification du type sur les classes dynamiques est moins stricte que sur les classes non
dynamiques, car les membres auxquels vous accédez dans la définition et les occurrences de classe
ne sont pas comparés à ceux définis dans le domaine des classes. Il est toutefois toujours possible
de vérifier le type de retour et les types de paramètres de ces fonctions de membre de classe. Ce
comportement s’avère particulièrement utile pour la manipulation des objets MovieClip, car il
existe plusieurs façons d’ajouter de manière dynamique des propriétés et des objets à un clip, par
exemple MovieClip.createEmptyMovieClip() et MovieClip.createTextField().
Les sous-classes de classes dynamiques sont également dynamiques.
Pour plus d’informations, consultez Création de classes dynamiques, page 180.
Exemple
Dans l’exemple suivant, la classe B a été marquée comme dynamique ; ainsi, l’appel d’une
fonction non déclarée ne génèrera pas d’erreur au moment de la compilation.
// dans B.as
dynamic class B extends class_A {
  function B() {
/*il s’agit du constructeur*/
}
  function m():Number {renvoie 25;}
  function o(s:String):Void {trace(s);}
}
// dans C.as
class C extends class_A {
  function C() {
/*il s’agit du constructeur*/
}
  function m():Number {renvoie 25;}
  function o(s:String):Void {trace(s);}
}
// dans un autre script
var var1 = B.n();   // pas d’erreur
var var2 = C.n()    // erreur puisqu’il n’existe pas de fonction n dans C.as
Consultez également
classe, extends
else
Disponibilité
Flash Player 4.
Usage
if (condition){376 Chapitre 12 : Dictionnaire ActionScript Présentation
instruction(s);
} else (condition){
instruction(s);
}
Paramètres
condition Une expression évaluée en tant que true ou false.
instruction(s) Une série alternative d’instructions à exécuter si la condition spécifiée dans
l’instruction if est false.
Renvoie
Rien.
Description
Instruction : spécifie les instructions à exécuter si la condition de l’instruction if renvoie false.
Consultez également
else if
Disponibilité
Flash Player 4.
Usage
if (condition){
instruction(s);
} else if (condition){
instruction(s);
}
Paramètres
condition Une expression évaluée en tant que true ou false.
instruction(s) Une série alternative d’instructions à exécuter si la condition spécifiée dans
l’instruction if est false.
Renvoie
Rien.
Description
Instruction : é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 :eq (égal à — spécifique à la chaîne) 377
// 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;
}
Consultez également
#endinitclip
Disponibilité
Flash Player 6.
Usage
#endinitclip
Paramètres
Aucun.
Renvoie
Rien.
Description
Directive du compilateur : 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
Consultez également
#initclip
eq (égal à — spécifique à la chaîne)
Disponibilité
Flash Player 4. Cet opérateur est déconseillé dans Flash 5 et remplacé par l’opérateur ==
(égalité).
Usage
expression1 eq expression2378 Chapitre 12 : Dictionnaire ActionScript Présentation
Paramètres
expression1, expression2 Nombres, chaînes ou variables.
Renvoie
Rien.
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.
Consultez également
== (égalité)
Classe Error
Disponibilité
Flash Player 7.
Description
Contient les informations concernant une erreur qui s’est produite dans un script. Vous créez une
objet Error à l’aide de la fonction constructeur Error. Généralement, vous « émettez » un nouvel
objet Error à partir d’un bloc de code try qui est ensuite « saisi » par un bloc de code catch ou
finally.
Vous pouvez également créer une sous-classe de la classe Error et émettre des occurrences de cette
sous-classe.
Méthode de la classe Error
Propriétés de la classe Error
Constructeur de la classe Erreur
Disponibilité
Flash Player 7.
Usage
new Error([message])
Méthode Description
Error.toString() Renvoie la représentation chaîne d’un objet Error.
Propriété Description
Error.message Une chaîne qui contient un message d’erreur associé à une erreur.
Error.name Une chaîne qui contient le nom de l’objet Error.Error.name 379
Paramètres
message Une chaîne associée à l’objet Error ; ce paramètre est facultatif.
Renvoie
Rien.
Description
Constructeur : crée un nouvel objet Error. Si le message est spécifié, sa valeur est affectée à la
propriété Error.message de l’objet.
Exemple
Dans l’exemple suivant, une fonction émet une erreur (avec un message spécifié) si les deux
chaînes auxquelles elle est transmise ne sont pas identiques.
function compareStrings(string_1, string_2) {
if(string_1 != string_2) {
throw new Error("Les chaînes ne correspondent pas.");
}
}
try
compareStrings("Chien","chien");
} catch (e) {
trace(e.toString());
}
Consultez également
throw, try..catch..finally
Error.message
Disponibilité
Flash Player 7.
Usage
monErreur.message
Description
Propriété : contient le message associé à l’objet Erreur. Par défaut, la valeur de la propriété est
"Error". Vous pouvez spécifier une propriété message quand vous créez un nouvel objet Error en
transmettant la chaîne d’erreur à la fonction du constructeur Error.
Consultez également
throw, try..catch..finally
Error.name
Disponibilité
Flash Player 7.
Usage
monErreur.name380 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Propriété : contient le nom de l’objet Error. Par défaut, la valeur de la propriété est "Error".
Consultez également
throw, try..catch..finally
Error.toString()
Disponibilité
Flash Player 7.
Usage
mon_err.toString()
Renvoie
Une chaîne.
Description
Méthode : renvoie la chaîne "Erreur" par défaut ou la valeur contenue dans Error.message, si
défini.
Consultez également
Error.message, throw, try..catch..finally
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]}");
Consultez également
unescapeeval() 381
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
Une valeur, une référence à un objet ou à un clip, ou undefined.
Description
Fonction : accède aux variables, propriétés, objets ou clips par nom. Si expression est une
variable ou une propriété, la valeur de la variable ou de la propriété est renvoyée. Si 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 et les
versions suivantes, il est recommandé d’utiliser la classe pour simuler des tableaux.
Dans Flash 4, 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 ([]).
Dans Flash 5 et les versions suivantes, vous ne pouvez pas utiliser la fonction eval() pour définir
et récupérer dynamiquement la valeur d’une variable ou d’un nom d’occurrence car vous ne
pouvez pas utiliser la fonction eval() dans la partie gauche d’une équation. Par exemple,
remplacez le code suivant :
eval ("var" + i) = "premier";
par celui-ci :
this["var"+i] = "premier"
ou :
set ("var" + i, "premier");
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, eval() renvoie la valeur de la variable et
l’affecte à y :
morceau3 = "dangereux";
x = 3;
y = eval("morceau" + x);
trace(y);382 Chapitre 12 : Dictionnaire ActionScript Présentation
// Résultat : dangereux
Consultez également
Classe Array
extends
Disponibilité
Flash Player 6.
Usage
class nomDeLaClasse extends autreNomDeClasse {}
interface nomDinterface extends autreNomDinterface {}
Remarque : Pour utiliser ce mot-clé, vous devez définir ActionScript 2.0 et Flash Player 6 ou version
ultérieure dans l’onglet Flash de la boîte de dialogue Paramètres de publication de votre fichier FLA.
Ce mot-clé n’est supporté que lorsqu’il est utilisé dans des fichiers de scripts externes et non dans
des scripts écrits dans le panneau Actions.
Paramètres
nomDeLaClasse Le nom de la classe que vous définissez.
autreNomDeClasse Le nom de la classe sur laquelle nomDeLaClasse est basé.
nomDinterface Le nom de l’interface que vous définissez.
autreNomDinterface Le nom de l’interface sur laquelle nomDinterface est basé.
Description
Mot-clé : définit une classe ou une interface qui est une sous-classe d’une autre classe ou
interface ; la dernière est une superclasse. La sous-classe hérite de toutes les méthodes, propriétés,
fonctions, etc., qui sont définies dans la super-classe.
Pour plus d’informations, consultez Création de sous-classes, page 169.
Exemple
Dans la classe B, telle que définie ci-dessous, un appel au constructeur de la classe A sera
automatiquement inséré comme première instruction de la fonction du constructeur de B,
puisque aucun appel n’existe à cet endroit. (C’est-à-dire qu’il est commenté dans l’exemple.)
class B extends class A
{
  function B() { // il s’agit du constructeur
// super(); // facultatif; inséré durant la compilation si omis
}
  function m():Number {renvoie 25;}
  function o(s:String):Void {trace(s);}
}
Consultez également
classe, implements, interfacefor 383
false
Disponibilité
Flash Player 5.
Usage
false
Description
Constante : Une valeur booléenne unique représentant l’opposé de true.
Consultez également
true
_focusrect
Disponibilité
Flash Player 4.
Usage
_focusrect = booléen;
Description
Propriété (globale) : spécifie si un rectangle jaune apparaît autour du bouton ou du clip avec focus
clavier. La valeur par défaut, true, affiche un rectangle jaune autour du bouton ou du clip avec
focus, à mesure que l’utilisateur appuie sur la touche de tabulation pour parcourir les objets du
fichier SWF. 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.
Consultez également
Button._focusrect, MovieClip._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 en tant que 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.384 Chapitre 12 : Dictionnaire ActionScript Présentation
next 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
Instruction : une construction de boucle qui évalue l’expression init (initialiser) une fois, puis
commence une séquence de boucle par laquelle, tant 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 la classe Array (comme Array.sort et Array.reverse()) ne sont pas
comprises dans l’énumération d’un objet Array, et les propriétés du clip, comme _x et _y, ne sont
pas énumérées. Dans des fichiers de classe externes, les membres d’occurrence ne peuvent pas être
énumérés : seuls les membres dynamiques et statiques peuvent être énumérés.
Exemple
L’exemple suivant utilise for pour additionner les éléments d’un tableau :
mon_array=new Array();
for(i=0; i<10; i++) {
mon_array [i] = (i + 5)*10;
trace(mon_array[i]);
}
Les résultats suivants sont affichés dans le panneau de 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;
}
Consultez également
++ (incrémentation), –– (décrémentation), for..in, var
for..in
Disponibilité
Flash Player 5.for..in 385
Usage
for(itérantDeVariable in objet){
instruction(s);
}
Paramètres
itérantDeVariable Le nom d’une variable qui joue le rôle d’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 à répéter.
instruction(s) Une instruction à exécuter pour chaque itération.
Renvoie
Rien.
Description
Instruction : effectue une boucle sur les propriétés d’un objet ou sur les éléments d’un tableau et
exécute l’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 la classe Array (comme Array.sort et Array.reverse()) ne sont pas
comprises dans l’énumération d’un objet Array, et les propriétés du clip, comme _x et _y, ne sont
pas énumérées. Dans des fichiers de classe externes, les membres d’occurrence ne peuvent pas être
énumérés : seuls les membres dynamiques et statiques peuvent être énumérés.
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 mon_mc) {
if (typeof (mon_mc[nom]) = "clip") {
trace ("J’ai un clip appelé " + nom);386 Chapitre 12 : Dictionnaire ActionScript Présentation
}
}
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);
}
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.
Description
Fonction : permet au fichier SWF de communiquer avec Flash Player ou avec le programme qui
héberge 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 un fichier SWF lu
dans Flash Player autonome (y compris les projections) :
Commande Paramètres Objectif
quitter 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 que le fichier
SWF soit toujours affiché dans sa taille originale et que son
échelle ne soit jamais modifiée. La spécification de true oblige
le fichier SWF à adopter l’échelle 100% du lecteur.fscommand() 387
La commande exec ne peut contenir que les caractères A–Z, a–z, 0–9, point (.) et trait de
soulignement (_). La commande exec n’est exécutée que dans le sous-répertoire fscommand. En
d’autres termes, si vous utilisez la commande fscommand exec pour appeler une application,
cette dernière doit résider dans un sous-dosser nommé fscommand.
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
nomanimation_DoFScommand dans la page HTML contenant le fichier SWF. 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 vous affectez le nom monDocument à Flash Player, la fonction JavaScript appelée
est monDocument_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. Pour plus d’informations, consultez le
centre de support de Director Support Center à l’adresse www.macromedia.com/support/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 à l’adresse
www.macromedia.com/support/flash.
Exemple
Usage 1 : Dans l’exemple suivant, l’action fscommand définit Flash Player de sorte que
l’animation soit affichée en mode 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.
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 de
l’application
Exécute une application depuis la projection.
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.
Commande Paramètres Objectif388 Chapitre 12 : Dictionnaire ActionScript Présentation
Vous devez ajouter une fonction à la page HTML contenant le fichier SWF. Cette fonction,
monDocument_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
monDocument_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 "fenêtreMessage". Le cas
échéant, une fenêtre d’alerte JavaScript s’ouvre et affiche le contenu de la chaîne paramètres.
function monDocument_DoFSCommand(commande, args) {
if (commande == "fenêtreMessage") {
alert(args);
}
}
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 fichier SWF avec le modèle Flash et FSCommand dans les
paramètres de publication HTML, la fonction monDocument_DoFSCommand est automatiquement
insérée. Les attributs NAME et ID du fichier SWF seront le nom du fichier. Par exemple, pour le fichier
monDocument.fla, les attributs seront définis sur monDocument.
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.
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
fonction.
Renvoie
Rien.Classe Function 389
Description
Instruction : 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 un fichier SWF. 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. 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(rayon) {
this.rayon = rayon;
}
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}
Classe Function
Disponibilité
Flash Player 6.
Résumé des méthodes de la classe 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. 390 Chapitre 12 : Dictionnaire ActionScript Présentation
Résumé des propriétés de la classe 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 la classe Function, elle 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 pouvez construire un fichier SWF contenant des champs de saisie qui permettent à
l’utilisateur d’entrer le nom d’une fonction à invoquer, ainsi que des paramètres zéro ou plus à
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.
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()
{
Propriété Description
Function.prototype Fait référence à un objet qui est le prototype d’une classe.Function.call 391
   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 dans
ActionScript est représentée par un objet Function, toutes les fonctions supportent donc cette
méthode.
Dans presque tous les cas, l’opérateur d’appel de la fonction (()) peut être utilisé au lieu de cette
méthode. L’opérateur d’appel de la fonction permet de rédiger le code de façon concise et lisible.
Cette méthode 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);
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)392 Chapitre 12 : Dictionnaire ActionScript Présentation
Exemple
Cet exemple utilise la méthode Function.call() pour imposer à une fonction un
comportement identique à celui d’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 vers le panneau de sortie :
this == obj? true
Function.prototype
Disponibilité
Flash Player 5. Si vous utilisez ActionScript 2.0, vous ne devez pas utiliser cette propriété : elle
représente l’implémentation de l’héritage de ActionScript 1.
Usage
maFonction.prototype
Description
Propriété : dans une fonction constructeur ActionScript 1, la propriété prototype fait référence à
un objet qui est le prototype de la classe construite. Chaque occurrence de la classe, créée par la
fonction constructeur, hérite de toutes les propriétés et méthodes de l’objet prototype.
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.getProperty 393
Consultez également
>= (supérieur ou égal à)
get
Disponibilité
Flash Player 6.
Usage
function get property() {
// vos instructions
}
Remarque : Pour utiliser ce mot-clé, vous devez définir ActionScript 2.0 et Flash Player 6 ou version
ultérieure dans l’onglet Flash de la boîte de dialogue Paramètres de publication de votre fichier FLA.
Ce mot-clé n’est supporté que lorsqu’il est utilisé dans des fichiers de scripts externes et non dans
des scripts écrits dans le panneau Actions.
Paramètres
propriété Le mot que vous souhaitez utiliser pour faire référence à la propriété à laquelle get
accède ; cette valeur doit être identique à celle utilisée dans la commande set correspondante.
Renvoie
La valeur de la propriété spécifiée par nomDeProp.
Description
Mot-clé : permet une « obtention » implicite des propriétés associées aux objets basés sur des
classes définies dans des fichiers de classe externes. L’utilisation de méthodes d’obtention
implicites vous permet d’accéder aux propriétés d’objets sans accéder directement à ces objets. Les
méthodes get/set implicites sont des abréviations syntaxiques de la méthode
Object.addProperty() dans ActionScript 1.
Pour plus d’informations, consultez Méthodes get/set implicites, page 179.
Consultez également
Object.addProperty(), set
getProperty
Disponibilité
Flash Player 4.
Usage
getProperty(mon_mc, propriété)
Paramètres
mon_mc Le nom d’occurrence d’un clip dont la propriété est récupérée.
propriété La propriété d’un clip.394 Chapitre 12 : Dictionnaire ActionScript Présentation
Renvoie
La valeur de la propriété spécifiée.
Description
Fonction : renvoie la valeur de la propriété spécifiée pour le clip mon_mc.
Exemple
L’exemple suivant récupère la coordonnée de l’axe horizontal (_x) pour le clip mon_mc et l’affecte à
la variable mon_mc_x :
mon_mc_x = getProperty(_root.mon_mc, _x);
getTimer
Disponibilité
Flash Player 4.
Usage
getTimer()
Paramètres
Aucun.
Renvoie
Le nombre de millisecondes écoulées depuis le démarrage de la lecture du fichier SWF.
Description
Fonction : renvoie le nombre de millisecondes écoulées depuis le démarrage de la lecture du
fichier SWF.
getURL()
Disponibilité
Flash 2. Les options GET et POST ne sont disponibles que dans Flash Player 4 et les versions
ultérieures du lecteur.
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 laquelle ou 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.getVersion 395
• _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.

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. Des URL absolues doivent inclure la référence au protocole,
comme http:// ou file:///.
cible Un chemin vers la cible d’un clip. Le clip cible sera remplacé par l’image ou le fichier
SWF chargé.
méthode 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.loadMovieNum() 421
Description
Fonction : charge un fichier SWF ou JPEG dans Flash Player en cours de lecture du fichier SWF
d’origine.
Conseil : Si vous souhaitez suivre la progression du téléchargement, utilisez
MovieClipLoader.loadClip() au lieu de cette fonction.
La fonction loadMovie() vous permet d’afficher plusieurs fichiers SWF simultanément et de
basculer entre les fichiers SWF sans charger un autre document HTML. Sans la fonction
loadMovie(), Flash Player affiche un seul fichier SWF avant de quitter.
Si vous souhaitez charger un fichier SWF ou JPEG dans un niveau spécifique,
utilisez loadMovieNum() au lieu de loadMovie().
Si un fichier SWF est chargé dans un clip cible, vous pouvez utiliser le chemin cible de ce clip
pour cibler le fichier chargé. Un fichier SWF ou une 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 du fichier SWF
chargé 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 du fichier SWF s’aligne avec le coin supérieur gauche de la
scène.
Utilisez unloadMovie() pour supprimer les fichiers SWF chargés avec loadMovie().
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. La fonction
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 à partir du même répertoire que le fichier SWF qui
appelle la fonction loadMovie() :
loadMovie("image45.jpeg", "notreClip");
Consultez également
_level, loadMovieNum(), MovieClipLoader.loadClip(), unloadMovie()
loadMovieNum()
Disponibilité
Flash Player 4. Les fichiers Flash 4 ouverts dans Flash 5 ou ultérieur sont convertis de manière à
utiliser la syntaxe correcte.
Usage
loadMovieNum("url",niveau[, variables])422 Chapitre 12 : Dictionnaire ActionScript Présentation
Paramètres
url Une URL absolue ou relative du fichier SWF ou JPEG à charger. Un chemin relatif doit
être relatif au fichier SWF au niveau 0. Pour une utilisation dans Flash Player autonome ou pour
un test en mode test d’animation dans l’application auteur Flash, tous les fichiers SWF doivent
être stockés dans le même répertoire et les noms de fichier ne peuvent pas inclure des
spécifications de répertoire ou de lecteur de disque.
niveau Un entier spécifiant le niveau Flash Player auquel le fichier SWF sera chargé.
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
Fonction : charge un fichier SWF ou JPEG dans un niveau de Flash Player en cours de lecture du
fichier SWF d’origine.
Conseil : Si vous souhaitez suivre la progression du téléchargement, utilisez
MovieClipLoader.loadClip() au lieu de cette fonction.
Normalement, Flash Player affiche un seul fichier SWF avant de quitter. L’action loadMovie()
vous permet d’afficher plusieurs fichiers SWF simultanément et de basculer entre les fichiers SWF
sans charger un autre document HTML.
Si vous souhaitez spécifier une cible au lieu d’un niveau, utilisez loadMovie() au lieu de
loadMovieNum().
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 loadMovieNum(), vous devez spécifier un niveau Flash Player dans
lequel charger le fichier SWF. Lorsqu’un fichier SWF est chargé dans un niveau, vous pouvez
utiliser la syntaxe _levelN pour cibler le fichier SWF, où N est le numéro de niveau.
Lorsque vous chargez un fichier SWF, vous pouvez spécifier un quelconque numéro et charger des
fichiers SWF dans un niveau dans lequel un fichier SWF a déjà été chargé. Si tel est le cas, le
nouveau fichier SWF remplacera le fichier SWF existant. Si vous chargez un fichier SWF dans le
niveau 0, tous les niveaux de Flash Player sont vidés et le niveau 0 est remplacé par le nouveau
fichier. Le fichier SWF dans le niveau 0 définit la cadence, la couleur d’arrière-plan et la taille des
images pour tous les autres fichiers SWF chargés.
L’action loadMovieNum() vous permet également de charger des fichiers JPEG dans un fichier
SWF 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 unloadMovieNum() pour supprimer des fichiers SWF ou des images chargés avec
loadMovieNum().loadVariables() 423
Exemple
Cet exemple charge l’image JPEG image45.jpg dans le niveau 2 de Flash Player.
loadMovieNum("http://www.blag.com/image45.jpg", 2);
Consultez également
loadMovie(), unloadMovieNum(), _level
loadVariables()
Disponibilité
Flash Player 4 ; comportement modifié dans Flash Player 7.
Usage
loadVariables ("url" , target [, variables])
Paramètres
url Une URL absolue ou relative où se trouvent les variables. Si le fichier SWF résultant de cet
appel est ouvert dans un navigateur web, l’url doit être du même domaine que le fichier SWF ;
pour plus de détails, consultez la description ci-dessous.
cible Le chemin cible d’un clip qui reçoit les variables chargées.
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
Fonction ; 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 clip cible. Cette
action peut également être utilisée pour affecter de nouvelles valeurs aux variables du fichier SWF
actif.
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). Tout nombre de variables peut être
spécifié. Par exemple, la séquence suivante définit plusieurs variables :
company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103
Dans des fichiers SWF exécutés dans une version du lecteur antérieure à Flash Player 7, l’url
doit être du même super-domaine que le fichier SWF résultant de cet appel. Par exemple, un
fichier SWF à l’adresse www.Domaine.com peut charger des variables d’un fichier SWF à l’adresse
store.Domaine.com car les deux fichiers sont du même super-domaine de Domaine.com.424 Chapitre 12 : Dictionnaire ActionScript Présentation
Dans des fichiers SWF d’une quelconque version exécutée dans Flash Player 7 ou ultérieur, l’url
doit être exactement du même domaine (consultez Fonctions de sécurité de Flash Player, page 196).
Par exemple, un fichier SWF à l’adresse www.Domaine.com peut uniquement charger des
variables de fichiers SWF également à l’adresse www.Domaine.com. Si vous souhaitez charger des
variables d’un autre domaine, vous pouvez placer un fichier de régulation inter-domaines sur le
serveur hébergeant le fichier SWF auquel vous accédez actuellement. Pour plus d’informations,
consultez A propos de l’autorisation de chargement de données inter-domaines, page 198.
Si vous souhaitez charger des variables dans un niveau spécifique, utilisez loadvariablesNum()
au lieu de loadVariables().
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("donnees.txt", "_root.varCible");
}
Consultez également
loadvariablesNum(), loadMovie(), loadMovieNum(), getURL(), MovieClip.loadMovie,
MovieClip.loadVariables()
loadvariablesNum()
Disponibilité
Flash Player 4. Les fichiers Flash 4 ouverts dans Flash 5 ou ultérieur sont convertis de manière à
utiliser la syntaxe correcte. Comportement modifié dans Flash Player 7.
Usage
loadVariablesNum("url",niveau[, variables])
Paramètres
url Une URL absolue ou relative où se trouvent les variables. Si le fichier SWF résultant de cet
appel est ouvert dans un navigateur web, l’url doit être du même domaine que le fichier SWF ;
pour plus de détails, consultez la description ci-dessous.
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.Classe LoadVars 425
Description
Fonction : lit des données depuis un fichier externe, tel qu’un fichier texte ou un texte généré par
un script CGI, ASP, PHP ou Perl, et définit les valeurs des variables dans un niveau Flash Player.
Vous pouvez également utiliser cette fonction pour mettre à jour les variables du fichier SWF actif
à l’aide de nouvelles valeurs.
Le texte de l’URL spécifiée doit être au format MIME standard application/x-www-form-
urlencoded (un format standard utilisé par les scripts CGI). Tout nombre de variables peut être
spécifié. Par exemple, la séquence suivante définit plusieurs variables :
company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103
Dans des fichiers SWF exécutés dans une version du lecteur antérieure à Flash Player 7, l’url
doit être du même super-domaine que le fichier SWF résultant de cet appel. Par exemple, un
fichier SWF à l’adresse www.Domaine.com peut charger des variables d’un fichier SWF à l’adresse
store.Domaine.com car les deux fichiers sont du même super-domaine de Domaine.com.
Dans des fichiers SWF d’une quelconque version exécutée dans Flash Player 7 ou ultérieur, l’url
doit être exactement du même domaine (consultez Fonctions de sécurité de Flash Player, page 196).
Par exemple, un fichier SWF à l’adresse www.Domaine.com peut uniquement charger des
variables de fichiers SWF également à l’adresse www.Domaine.com. Si vous souhaitez charger des
variables d’un autre domaine, vous pouvez placer un fichier de régulation inter-domaines sur le
serveur hébergeant le fichier SWF auquel vous accédez actuellement. Pour plus d’informations,
consultez A propos de l’autorisation de chargement de données inter-domaines, page 198.
Si vous souhaitez charger des variables dans un clip spécifique, utilisez loadVariables()au lieu
de loadVariablesNum().
Exemple
Cet exemple charge des informations depuis un fichier texte vers des champs de texte dans le
scénario principal du fichier SWF (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("donnees.txt", 0);
}
Consultez également
getURL(), loadMovie(), loadMovieNum(), loadVariables(), MovieClip.loadMovie,
MovieClip.loadVariables()
Classe LoadVars
Disponibilité
Flash Player 6.
Description
La classe LoadVars constitue une alternative à la fonction loadVariables() pour transférer des
variables entre une application Flash et un serveur.426 Chapitre 12 : Dictionnaire ActionScript Présentation
Vous pouvez utiliser cette classe pour obtenir la vérification du chargement réussi des données, les
indications de progression et les données de flux pendant le téléchargement. La classe LoadVars
fonctionne de manière semblable à Classe XML : elle utilise les méthodes load(), send() et
sendAndLoad() pour communiquer avec un serveur. La principale différence entre la classe
LoadVars et la classe 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.
La classe LoadVars est soumise aux mêmes restrictions de sécurité que la classe XML.
Résumé des méthodes de la classe LoadVars
Résumé des propriétés de la classe LoadVars
Résumé des gestionnaires d’événement de la classe LoadVars
Constructeur pour la classe LoadVars
Disponibilité
Flash Player 6.
Méthode Description
LoadVars.addRequestHeader() Ajoute ou modifie les en-têtes HTTP pour les opérations POST.
LoadVars.getBytesLoaded() Renvoie le nombre d’octets téléchargés par LoadVars.load() ou
LoadVars.sendAndLoad().
LoadVars.getBytesTotal() Renvoie le nombre total d’octets téléchargés par une opération load
ou une méthode sendAndLoad.
LoadVars.load() Télécharge des variables à partir d’une URL spécifiée.
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 URL qui contient toutes les variables
énumérables de l’objet LoadVars.
Propriété Description
LoadVars.contentType Indique le type MIME des données.
LoadVars.loaded Une valeur booléenne indiquant si une opération load ou
sendAndLoad est terminée.
Gestionnaire
d’événement
Description
LoadVars.onData Invoqué lorsque les données ont été complètement téléchargées du
serveur ou lorsqu’une erreur se produit au cours de ce
téléchargement.
LoadVars.onLoad Invoqué lorsqu’une opération load ou sendAndLoad est terminée.LoadVars.addRequestHeader() 427
Usage
new LoadVars()
Paramètres
Aucun.
Renvoie
Rien.
Description
Constructeur : crée un 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 un objet LoadVars nommé mes_lv :
var mes_lv = new LoadVars();
LoadVars.addRequestHeader()
Disponibilité
Flash Player 6.
Usage
mon_lv.addRequestHeader(headerName, headerValue)
mon_lv.addRequestHeader(["headerName_1", "headerValue_1" ... "nomDentête_n",
"valeurDentête_n"])
Paramètres
nomDentête Un nom d’en-tête de requête HTTP.
valeurDentête La valeur associée à nomDentête.
Renvoie
Rien.
Description
Méthode : ajoute ou modifie les en-têtes de requête HTTP (telles que Content-type ou
SOAPAction) envoyés avec les actions POST. Dans la première utilisation, vous transmettez deux
chaînes à la méthode : nomDentête et valeurDentête. Dans la seconde utilisation, vous
transmettez un tableau de chaînes, alternant noms et valeurs d’en-têtes.
Si des appels multiples sont définis pour un seul et même nom d’en-tête, chaque valeur successive
remplace la valeur définie dans le précédent appel.
Les en-têtes HTTP standard suivantes ne peuvent pas être ajoutées ou modifiées dans cette
méthode : Accept-Ranges, Age, Allow, Allowed, Connection, Content-Length, Content-
Location, Content-Range, ETag, Host, Last-Modified, Locations, Max-Forwards, Proxy-
Authenticate, Proxy-Authorization, Public, Range, Retry-After, Server, TE, Trailer,
Transfer-Encoding, Upgrade, URI, Vary, Via, Warning et WWW-Authenticate.428 Chapitre 12 : Dictionnaire ActionScript Présentation
Exemple
Cet exemple ajoute un en-tête HTTP personnalisé nommé SOAPAction avec une valeur Foo à
l’objet mon_lv.
mon_lv.addRequestHeader("SOAPAction", "’Foo’");
L’exemple suivant crée un tableau nommé en-têtes contenant deux en-têtes secondaires et leurs
valeurs associées. Le tableau est transmis en tant qu’argument à addRequestHeader().
var en-têtes = ["Content-type", "texte/normal", "X-ClientAppVersion", "2.0"];
mon_lv.addRequestHeader(headers);
Voir aussi
XML.addRequestHeader()
LoadVars.contentType
Disponibilité
Flash Player 6.
Usage
mes_lv.contentType
Description
Propriété : le type MIME envoyé au serveur lorsque vous appelez LoadVars.send() ou
LoadVars.sendAndLoad(). La valeur par défaut est application/x-www-urlform-encoded.
Consultez également
LoadVars.send(), LoadVars.sendAndLoad()
LoadVars.getBytesLoaded()
Disponibilité
Flash Player 6.
Usage
mes_lv.getBytesLoaded()
Paramètres
Aucun.
Renvoie
Un entier.
Description
Méthode : renvoie le nombre d’octets téléchargés par LoadVars.load() ou
LoadVars.sendAndLoad(). Cette méthode 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.load() 429
LoadVars.getBytesTotal()
Disponibilité
Flash Player 6.
Usage
mes_lv.getBytesTotal()
Paramètres
Aucun.
Renvoie
Un entier.
Description
Méthode : renvoie le nombre total d’octets téléchargés par LoadVars.load() ou
LoadVars.sendAndLoad(). Cette méthode renvoie undefined si aucune opération load n’est en
cours ou si une opération load n’a pas encore été initiée. Cette méthode 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 ; comportement modifié dans Flash Player 7.
Usage
mes_lv.load(url)
Paramètres
url L’URL où se trouvent les variables à télécharger. Si le fichier SWF résultant de cet appel est
ouvert dans un navigateur web, l’url doit être du même domaine que le fichier SWF ; pour plus
de détails, consultez la description ci-dessous.
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 mes_lv. Les propriétés de mes_lv avec les mêmes noms que les variables
téléchargées sont supprimées. Les propriétés de mes_lv 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-form-
urlencoded. Il s’agit du même format que celui utilisé par loadVariables().
Dans des fichiers SWF exécutés dans une version du lecteur antérieure à Flash Player 7, l’url
doit être du même super-domaine que le fichier SWF résultant de cet appel. Par exemple, un
fichier SWF à l’adresse www.Domaine.com peut charger des variables d’un fichier SWF à l’adresse
store.Domaine.com car les deux fichiers sont du même super-domaine de Domaine.com.430 Chapitre 12 : Dictionnaire ActionScript Présentation
Dans des fichiers SWF d’une quelconque version exécutée dans Flash Player 7 ou ultérieur, l’url
doit être exactement du même domaine (consultez Fonctions de sécurité de Flash Player, page 196).
Par exemple, un fichier SWF à l’adresse www.Domaine.com peut uniquement charger des
variables de fichiers SWF également à l’adresse www.Domaine.com. Si vous souhaitez charger des
variables d’un autre domaine, vous pouvez placer un fichier de régulation inter-domaines sur le
serveur hébergeant le fichier SWF auquel vous accédez actuellement. Pour plus d’informations,
consultez A propos de l’autorisation de chargement de données inter-domaines, page 198.
De même, dans des fichiers publiés pour Flash Player 7, la sensibilité à la casse (consultez Hauteur
de casse, page 31) est prise en charge pour les variables externes chargées à l’aide de
LoadVars.load().
Cette méthode est similaire à XML.load().
LoadVars.loaded
Disponibilité
Flash Player 6.
Usage
mes_lv.loaded
Description
Propriété : undefined par défaut. Lorsqu’une opération LoadVars.load() ou
LoadVars.sendAndLoad() est initiée, la propriété loaded est définie sur la valeur false ; lorsque
l’opération est terminée, la propriété loaded est définie sur la valeur 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 la valeur false.
Cette propriété est similaire à la propriété XML.loaded.
LoadVars.onData
Disponibilité
Flash Player 6.
Usage
mon_lv.onData = function(src) {
// vos instructions
}
Paramètres
src Les données brutes (non analysées) à partir de l’appel d’une méthode LoadVars.load() ou
LoadVars.sendAndLoad().
Renvoie
Rien.LoadVars.send() 431
Description
Gestionnaire d’événement : invoqué lorsque les données ont été complètement téléchargées du
serveur ou lorsqu’une erreur se produit au cours de ce téléchargement. Ce gestionnaire est invoqué
avant l’analyse des données ; ainsi, il peut être utilisé pour appeler une routine d’analyse
personnalisée au lieu d’une routine intégrée dans Flash Player. La valeur du paramètre src
transmise à la fonction affectée à LoadVars.onData peut être soit undefined, soit une chaîne
contenant les paires nom-valeur encodées URL téléchargées depuis le serveur. Si la valeur
renvoyée est undefined, une erreur a eu lieu pendant le téléchargement à partir du serveur.
L’implémentation par défaut de LoadVars.onData invoque LoadVars.onLoad. Vous pouvez
écraser cette implémentation par défaut en affectant une fonction personnalisée à
LoadVars.onData, mais LoadVars.onLoad ne sera plus appelé à moins que vous ne l’appeliez
dans votre implémentation de LoadVars.onData.
LoadVars.onLoad
Disponibilité
Flash Player 6.
Usage
mon_lv.onLoad = function(success) {
// vos instructions
}
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 LoadVars.load() ou
LoadVars.sendAndLoad() est terminée. Si l’opération est réussi, mes_lv est renseigné par des
variables téléchargées par l’opération ; ces variables sont disponibles lorsque ce gestionnaire est
invoqué.
Par défaut, ce gestionnaire n’est pas défini.
Cette méthode est similaire à XML.onLoad.
LoadVars.send()
Disponibilité
Flash Player 6.
Usage
mes_lv.send(url [,cible, méthode] )432 Chapitre 12 : Dictionnaire ActionScript Présentation
Paramètres
url L’URL à laquelle télécharger les variables.
cible La fenêtre du navigateur dans laquelle les réponses seront affichées.
méthode La méthode GET ou POST du protocole HTTP.
Renvoie
Une chaîne.
Description
Méthode : envoie les variables de l’objet mes_lv à l’URL spécifiée. Toutes les variables
énumérables dans mes_lv sont concaténées dans une chaîne au format application/x-www-form-
urlencoded par défaut et la chaîne est envoyée à l’URL à l’aide de la méthode HTTP POST. 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 mes_lv.contentType ou la valeur par
défaut application/x-www-form-urlencoded. 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 à XML.send.
LoadVars.sendAndLoad()
Disponibilité
Flash Player 6 ; comportement modifié dans Flash Player 7.
Usage
mes_lv.sendAndLoad(url, objetCible[,méthode])
Paramètres
url L’URL à laquelle télécharger les variables. Si le fichier SWF résultant de cet appel est ouvert
dans un navigateur web, l’url doit être du même domaine que le fichier SWF ; pour plus de
détails, consultez la description ci-dessous.
objetCible L’objet LoadVars qui reçoit les variables chargées.
méthode La méthode GET ou POST du protocole HTTP.
Renvoie
Une chaîne.
Description
Méthode : envoie les variables de l’objet mes_lv à 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 envoyées de la même façon que LoadVars.send(). Les variables sont
téléchargées dans objetCible de la même façon que LoadVars.load().Classe LocalConnection 433
Dans des fichiers SWF exécutés dans une version du lecteur antérieure à Flash Player 7, l’url
doit être du même super-domaine que le fichier SWF résultant de cet appel. Par exemple, un
fichier SWF à l’adresse www.Domaine.com peut charger des variables d’un fichier SWF à l’adresse
store.Domaine.com car les deux fichiers sont du même super-domaine de Domaine.com.
Dans des fichiers SWF d’une quelconque version exécutée dans Flash Player 7 ou ultérieur, l’url
doit être exactement du même domaine (consultez Fonctions de sécurité de Flash Player, page 196).
Par exemple, un fichier SWF à l’adresse www.Domaine.com peut uniquement charger des
variables de fichiers SWF également à l’adresse www.Domaine.com. Si vous souhaitez charger des
variables d’un autre domaine, vous pouvez placer un fichier de régulation inter-domaines sur le
serveur hébergeant le fichier SWF auquel vous accédez actuellement. Pour plus d’informations,
consultez A propos de l’autorisation de chargement de données inter-domaines, page 198.
Cette méthode est similaire à XML.sendAndLoad.
LoadVars.toString()
Disponibilité
Flash Player 6.
Usage
mes_lv.toString()
Paramètres
Aucun.
Renvoie
Une chaîne.
Description
Méthode : renvoie une chaîne contenant toutes les variables énumérables dans mes_lv, dans le
contenu MIME encodant application/x-www-form-urlencoded.
Exemple
var mesVars = new LoadVars();
mesVars.nom = "Gary";
mesVars.age = 26;
trace (mesVars.toString());
// donnerait le résultat
//nom=Gary&age=26
Classe LocalConnection
Disponibilité
Flash Player 6.434 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
La classe LocalConnection permet de développer des fichiers SWF pouvant échanger des
instructions sans l’utilisation de fscommand() ou JavaScript. Les objets LocalConnection ne
peuvent communiquer qu’entre des fichiers SWF exécutées sur le même ordinateur client, mais ils
peuvent être exécutés dans deux applications différentes, par exemple, un fichier SWF exécuté
dans un navigateur et un autre exécuté dans une projection. Vous pouvez utiliser les objets
LocalConnection pour envoyer et recevoir des données au sein d’un seul et même fichier SWF,
mais il ne s’agit pas là d’une implémentation standard ; tous les exemples contenus dans cette
section illustrent la communication entre les différents fichiers SWF.
Les principales méthodes utilisées pour envoyer et recevoir des données sont
LocalConnection.send() et LocalConnection.connect(). De la façon la plus simple, votre
code implémente les commandes suivantes ; notez que les commandes
LocalConnection.send() et LocalConnection.connect() spécifient le même nom de
connexion, nom_lc :
// Code dans l’animation de réception
Réception_lc = new LocalConnection();
Réception_lc.methodToExecute = function(param1, param2)
{
// Code à exécuter
}
Réception_lc.connect("nom_lc");
// Code dans l’animation d’envoi
Envoi_lc = new LocalConnection();
Envoi_lc.send("nom_lc", "méthodeAExécuter", donnée1, donnée2)
La façon la plus simple d’utiliser un objet LocalConnection est de n’autoriser la communication
qu’entre les objets LocalConnection situés dans le même domaine, puisque vous n’aurez pas à
vous occuper des questions de sécurité. Cependant, si vous devez autoriser la communication
entre les domaines, vous disposez de plusieurs façons d’implémenter les mesures de sécurité. Pour
plus d’informations, consultez la discussion concernant le paramètre nomDeConnexion dans
LocalConnection.send() et les entrées LocalConnection.allowDomain et
LocalConnection.domain().
Résumé des méthodes de la classe LocalConnection
Méthode Description
LocalConnection.close() Ferme (déconnecte) l’objet LocalConnection.
LocalConnection.connect() Prépare l’objet LocalConnection à recevoir les
commandes d’une commande LocalConnection.send().
LocalConnection.domain() Renvoie une chaîne représentant le super-domaine de
l’emplacement du fichier SWF actuel.
LocalConnection.send() Invoque une méthode sur un objet LocalConnection
spécifié.Classe LocalConnection 435
Résumé des gestionnaires d’événement de la classe LocalConnection
Constructeur pour la classe LocalConnection
Disponibilité
Flash Player 6.
Usage
new LocalConnection()
Paramètres
Aucun.
Renvoie
Rien.
Description
Constructeur : crée un objet LocalConnection.
Exemple
L’exemple suivant montre comment un fichier SWF d’envoi et de réception crée des objets
LocalConnnection. Notez que les deux fichiers SWF peuvent utiliser le même nom ou des noms
différents pour leurs objets LocalConnection respectifs. Dans cet exemple, ils utilisent le même
nom, ma_lc.
// Code dans le fichier SWF de réception
ma_lc = new LocalConnection();
ma_lc.uneMéthode = function()
// Vos instructions
}
ma_lc.connect("nomDeConnexion");
// Code dans le fichier SWF d’envoi
ma_lc = new LocalConnection();
ma_lc.send("nomDeConnexion", "uneMéthode");
Gestionnaire d’événement Description
LocalConnection.allowDomain Invoque si l’objet actuel LocalConnection spécifié (de
réception) reçoit une requête pour invoquer une méthode
à partir d’un objet d’envoi LocalConnection.
LocalConnection.allowInsecureDomain Invoqué si l’objet LocalConnection (de réception) actuel,
qui se trouve dans un fichier SWF hébergé dans un
domaine utilisant un protocole sécurisé (HTTPS), reçoit
une requête pour invoquer une méthode à partir de l’objet
LocalConnection d’envoi qui se trouve dans un fichier
SWF hébergé sur un protocole non sécurisé.
LocalConnection.onStatus Invoqué après qu’un objet d’envoi LocalConnection ait
essayé d’envoyer une commande à un objet
LocalConnection de réception.436 Chapitre 12 : Dictionnaire ActionScript Présentation
Consultez également
LocalConnection.connect(), LocalConnection.send()
LocalConnection.allowDomain
Disponibilité
Flash Player 6 ; comportement modifié dans Flash Player 7.
Usage
Réception_lc.allowDomain = function([DomaineDenvoi]) {
// Vos instructions renvoient true ou false
}
Paramètres
DomaineDenvoi Un paramètre facultatif spécifiant le domaine du fichier SWF contenant l’objet
d’envoi LocalConnection.
Renvoie
Rien.
Description
Gestionnaire d’événement : invoqué dès que Réception_lc reçoit une requête pour invoquer une
méthode à partir d’un objet d’envoi LocalConnection. Flash attend le code que vous implémentez
dans ce gestionnaire pour renvoyer une valeur booléenne true ou false. Si le gestionnaire ne
revoie pas true, la requête de l’objet d’envoi est ignorée et la méthode n’est pas invoquée.
Utilisez cette commande pour autoriser explicitement les objets LocalConnection des domaines
spécifiés, ou de tout domaine, à exécuter les méthodes de réception de l’objet LocalConnection. Si
vous ne déclarez pas le paramètre DomaineDenvoi, vous aurez probablement à accepter les
commandes de tous les domaines ; le code de votre gestionnaire sera tout simplement return
true. Si vous déclarez DomaineDenvoi, vous aurez probablement à comparer la valeur de
DomaineDenvoi avec les domaines dont vous voulez accepter les commandes. Les exemples
suivants illustrent ces deux implémentations.
Dans des fichiers exécutés dans Flash Player 6, le paramètre DomaineDenvoi contient le super-
domaine de l’appelant. Dans des fichiers exécutés dans Flash Player 7 ou ultérieur, le paramètre
DomaineDenvoi contient le domaine exact de l’appelant. Dans ce dernier cas, pour autoriser
l’accès par des fichiers SWF hébergés à l’adresse www.domaine.com ou store.domaine.com, vous
devez autoriser explicitement l’accès à partir des deux domaines.
// Pour Flash Player 6
Réception_lc.allowDomain = function(DomaineDenvoi) {
return(DomaineDenvoi=="domaine.com");
}
// Commandes correspondantes pour autoriser l’accès à partir de fichiers SWF
// exécutés dans Flash Player 7 ou ultérieur
Réception_lc.allowDomain = function(DomaineDenvoi) {
return(DomaineDenvoi=="www.domaine.com");
DomaineDenvoi=="store.domaine.com");
}LocalConnection.allowInsecureDomain 437
De même, pour des fichiers exécutés dans Flash Player 7 ou ultérieur, vous ne pouvez pas utiliser
cette méthode pour autoriser des fichiers SWF hébergés à l’aide d’un protocole sécurisé (HTTPS)
de permettre l’accès à partir de fichiers SWF hébergés par des protocoles non sécurisés ; vous
devez plutôt utiliser le gestionnaire d’événement LocalConnection.allowInsecureDomain.
Exemple
L’exemple suivant montre comment un objet LocalConnection dans un fichier SWF de réception
peut autoriser les fichiers SWF de tout domaine à invoquer ses méthodes. Comparez ceci à
l’exemple de LocalConnection.connect(), dans lequel seuls les fichiers SWF du même
domaine peuvent invoquer la méthode Trace dans le fichier SWF de réception. Pour une
discussion concernant l’utilisation du trait de soulignement (_) dans le nom de connexion,
consultez LocalConnection.send().
var uneConnexionLocale = new LocalConnection();
uneConnexionLocale.Trace = function(uneChaîne)
{
unChampDeTexte = unChampDeTexte + uneChaîne + newline;
}
uneConnexionLocale.allowDomain = function() {
// Tout domaine peut invoquer des méthodes sur cet objet LocalConnection
renvoie true;
}
uneConnexionLocale.connect("_trace");
Dans l’exemple suivant, le fichier SWF de réception n’accepte que les commandes des fichiers
SWF situés dans ceDomaine.fr ou ceDomaineLa.fr.
var uneConnexionLocale = new LocalConnection();
uneConnexionLocale.Trace = function(uneChaîne)
{
unChampDeTexte = unChampDeTexte + uneChaîne + newline;
}
uneConnexionLocale.allowDomain = function(domaineDenvoi)
{
return(domaineDenvoi=="ceDomaine.fr" || domaineDenvoi=="ceDomaineLa.fr");
}
uneConnexionLocale.connect("_trace");
Consultez également
LocalConnection.connect(), LocalConnection.domain(), LocalConnection.send()
LocalConnection.allowInsecureDomain
Disponibilité
Flash Player 7.
Usage
Réception_lc.allowInsecureDomain = function([DomaineDenvoi]) {
// Vos instructions renvoient true ou false
}438 Chapitre 12 : Dictionnaire ActionScript Présentation
Paramètres
DomaineDenvoi Un paramètre facultatif spécifiant le domaine du fichier SWF contenant l’objet
d’envoi LocalConnection.
Renvoie
Rien.
Description
Gestionnaire d’événement : invoqué si Réception_lc, qui se trouve dans un fichier SWF hébergé
dans un domaine utilisant un protocole sécurisé (HTTPS), reçoit une requête pour invoquer une
méthode à partir de l’objet LocalConnection d’envoi qui se trouve dans un fichier SWF hébergé
sur un protocole non sécurisé. Flash attend le code que vous implémentez dans ce gestionnaire
pour renvoyer une valeur booléenne true ou false. Si le gestionnaire ne revoie pas true, la
requête de l’objet d’envoi est ignorée et la méthode n’est pas invoquée.
Par défaut, les fichiers SWF hébergés utilisant le protocole HTTPS ne sont accessibles que par
d’autres fichiers SWF hébergés utilisant le protocole HTTPS. Cette implémentation garantit
l’intégrité fournie par le protocole HTTPS.
L’utilisation de cette méthode pour remplacer le comportement par défaut n’est pas recommandée
car elle compromet la sécurité HTTPS. Vous pouvez devoir cependant l’utiliser, par exemple, si
vous devez autoriser l’accès à des fichiers HTTPS publiés pour Flash Player 7 ou ultérieur à partir
de fichiers HTTP publiés pour Flash Player 6.
Un fichier SWF publié pour Flash Player 6 peut utiliser le gestionnaire d’événement
LocalConnection.allowDomain pour autoriser un accès HTTP à HTTPS. Cependant, étant
donné que la sécurité est implémentée différemment dans Flash Player 7, vous devez utiliser la
méthode LocalConnection.allowInsecureDomain() pour autoriser un tel accès dans des
fichiers SWF publiés pour Flash Player 7 ou ultérieur.
Consultez également
LocalConnection.allowDomain, LocalConnection.connect()
LocalConnection.close()
Disponibilité
Flash Player 6.
Usage
Réception_lc.close
Paramètres
Aucun.
Renvoie
Rien.LocalConnection.connect() 439
Description
Méthode : ferme (déconnecte) un objet LocalConnection. Emettez cette commande lorsque vous
ne voulez plus que l’objet accepte les commandes, par exemple, lorsque vous souhaitez émettre
une commande LocalConnection.connect() à l’aide du même paramètre nomDeConnexion
dans un autre fichier SWF.
Consultez également
LocalConnection.connect()
LocalConnection.connect()
Disponibilité
Flash Player 6.
Usage
Réception_lc.connect(nomDeConnexion)
Paramètres
nomDeConnexion Une chaîne qui correspond au nom de connexion spécifié dans la commande
LocalConnection.send() qui veut communiquer avec Réception_lc.
Renvoie
La valeur booléenne est true si aucun autre traitement en cours sur la même machine client n’a
déjà émis cette commande à l’aide de la même valeur pour le paramètre nomDeConnexion ; dans le
cas contraire, la valeur est false.
Description
Méthode : prépare un objet LocalConnection pour recevoir les commandes à partir d’une
commande LocalConnection.send() (nommée « objet d’envoi LocalConnection »). L’objet
utilisé avec cette commande est nommé « objet de réception LocalConnection ». Les objets de
réception et d’envoi doivent être exécutés sur la même machine client.
Assurez-vous de définir les méthodes liées à Réception_lc avant d’appeler cette méthode,
comme indiqué dans les exemples de cette section.
Par défaut, Flash Player résout nomDeConnexion en une valeur "super-
domaine:nomDeConnexion", où super-domaine est le super-domaine du fichier SWF contenant
la commande LocalConnection.connect(). Par exemple, si le fichier SWF contenant l’objet de
réception LocalConnection est situé dans www.Domaine.com, nomDeConnexion indique
"unDomain.com:nomDeConnexion". (Si un fichier SWF est situé sur l’ordinateur client, la valeur
affectée à super-domaine est "localhost".)
Par défaut également, Flash Player permet à l’objet de réception LocalConnection d’accepter
uniquement les commandes des objets d’envoi LocalConnection dont le nom de connexion
indique également une valeur "super-domaine:nomDeConnexion". Ainsi, Flash facilite la
communication entre les fichiers SWF situés dans le même domaine.
Si vous implémentez une communication seulement entre les fichiers SWF du même domaine,
spécifiez une chaîne pour nomDeConnexion qui ne commence pas par un trait de soulignement
(_) et qui n’indique aucun nom de domaine (par exemple "monDomaine:nomDeConnexion").
Utilisez la même chaîne dans la commande LocalConnection.connect(nomDeConnexion).440 Chapitre 12 : Dictionnaire ActionScript Présentation
Si vous implémentez une communication entre des fichiers SWF situés dans différents domaines,
consultez la section relative à nomDeConnexion dans LocalConnection.send() et les entrées
LocalConnection.allowDomain et LocalConnection.domain().
Exemple
L’exemple suivant illustre comment un fichier SWF situé dans un domaine particulier peut
invoquer une méthode nommée Trace dans un fichier SWF de réception du même domaine. La
réception d’un fichier SWF fonctionne comme une fenêtre trace pour le fichier SWF d’envoi ; elle
contient deux méthodes que les autres fichiers SWF peuvent appeler Trace et Clear. Les boutons
enfoncés dans les fichiers SWF d’envoi appellent ces méthodes avec les paramètres spécifiés.

Exemple
Consultez l’exemple relatif à Camera.onStatus.
Consultez également
Microphone.get(), Microphone.muted
Microphone.rate
Disponibilité
Flash Player 6.
Usage
MicrophoneActif.rate
Description
Propriété (lecture seule) : le taux d’échantillonnage auquel le microphone capture le son, en kHz.
La valeur par défaut est 8 kHz si le périphérique de capture du son supporte cette valeur. Sinon, la
valeur par défaut correspond au premier niveau de capture au-delà de 8 kHz supporté par votre
périphérique de capture du son. Il s’agit généralement de 11 kHz.470 Chapitre 12 : Dictionnaire ActionScript Présentation
Pour définir cette valeur, utilisez Microphone.setRate().
Exemple
L’exemple suivant enregistre le taux actuel dans la variable original.
original = monMic.rate;
Consultez également
Microphone.setRate()
Microphone.setGain()
Disponibilité
Flash Player 6.
Usage
MicrophoneActif.setGain(gain)
Paramètres
gain Un entier spécifiant le niveau d’amplification que le microphone doit appliquer au signal.
Les valeurs valides sont comprises entre 0 et 100. La valeur par défaut est 50, mais l’utilisateur
peut la modifier dans le panneau Microphone des paramètres Flash Player.
Renvoie
Rien.
Description
Méthode : définit le gain du microphone, c’est-à-dire le coefficient de multiplication que le
microphone doit appliquer au signal avant de le transmettre. La valeur 0 multiplie le signal par
zéro ; cela signifie que le microphone ne transmet aucun son.
Ce paramètre s’apparente au bouton de réglage du volume d’une chaîne hi-fi : 0 correspond à
aucun volume et 50 au volume normal ; une valeur inférieure à 50 correspond à un volume plus
faible que le volume normal et une valeur supérieure à 50 correspond à un volume plus élevé.
Exemple
L’exemple suivant veille à ce que le paramètre de gain du microphone soit inférieur ou égal à 55.
var monMic = Microphone.get();
if (monMic.gain > 55){
monMic.setGain(55);
}
Consultez également
Microphone.gain, Microphone.setUseEchoSuppression()
Microphone.setRate()
Disponibilité
Flash Player 6.Microphone.setSilenceLevel() 471
Usage
MicrophoneActif.setRate(kHz)
Paramètres
kHz Le taux d’échantillonnage auquel le microphone capture le son, en kHz. Les valeurs valides
sont 5, 8, 11, 22 et 44. La valeur par défaut est 8 kHz si le périphérique de capture du son
supporte cette valeur. Sinon, la valeur par défaut correspond au premier niveau de capture au-delà
de 8 kHz supporté par votre périphérique de capture du son. Il s’agit généralement de 11 kHz.
Renvoie
Rien.
Description
Méthode : définit le taux d’échantillonnage, en kHz, auquel le microphone capture le son.
Exemple
L’exemple suivant définit le taux d’échantillonnage conformément au choix de l’utilisateur (affecté
à la variable tauxUtilisateur) s’il correspond à l’une des valeurs suivantes : 5, 8, 11, 22 ou 44.
Si la valeur choisie par l’utilisateur ne correspond pas, elle est arrondie à la valeur supportée par le
périphérique de capture du son la plus proche.
monMic.setRate(tauxUtilisateur);
Consultez également
Microphone.rate
Microphone.setSilenceLevel()
Disponibilité
Flash Player 6.
Usage
MicrophoneActif.setSilenceLevel(niveau [, délai])
Paramètres
niveau Un entier spécifiant le niveau sonore requis pour activer le microphone et invoquer
Microphone.onActivity(true). Les valeurs valides sont comprises entre 0 et 100. La valeur par
défaut est 10.
délai Un paramètre entier facultatif spécifiant le nombre de millisecondes d’inactivité devant
s’écouler pour que Flash considère que le son s’est arrêté et invoque
Microphone.onActivity(false). La valeur par défaut est 2 000 (2 secondes).
Renvoie
Rien.
Description
Méthode : définit le niveau sonore minimum considéré comme du son et (éventuellement) la
durée de silence nécessaire pour considérer que le son est vraiment arrêté. 472 Chapitre 12 : Dictionnaire ActionScript Présentation
• Pour que le microphone ne détecte aucun son, affectez la valeur 100 au paramètre niveau ;
Microphone.onActivity n’est jamais invoqué.
• Pour connaître le niveau sonore que le microphone détecte actuellement, utilisez
Microphone.activityLevel.
La détection de l’activité consiste à surveiller les niveaux sonores pour détecter lorsqu’une
personne est en train de parler. Elle permet d’économiser de la bande passante en évitant
d’envoyer le flux audio lorsque personne ne parle. Ces informations peuvent également servir de
retour visuel pour indiquer aux utilisateurs qu’ils (ou les autres utilisateurs) sont silencieux.
Les valeurs de silence sont la réciproque directe des valeurs d’activité. Le silence complet
correspond à une valeur d’activité de 0. Un bruit fort et constant (aussi fort qu’il peut être
enregistré, d’après le gain actuel) correspond à une valeur d’activité de 100. Une fois le gain
correctement réglé, la valeur d’activité est inférieure à la valeur de silence lorsque vous ne parlez
pas ; lorsque vous parlez, la valeur d’activité est supérieure à la valeur de silence.
Cette méthode a le même objectif que Camera.setMotionLevel() ; les deux méthodes
permettent de déterminer à quel moment le gestionnaire d’événement onActivity doit être
invoqué. Cependant, ces méthodes ont un impact très différent sur la publication en flux
continus :
• Camera.setMotionLevel() est conçu pour détecter les mouvements et n’affecte pas
l’utilisation de la bande passante. Même lorsqu’un flux continu vidéo ne détecte pas de
mouvement, la vidéo est envoyée.
• Microphone.setSilenceLevel() est conçu pour optimiser la bande passante. Lorsqu’un flux
continu audio est considéré comme silencieux, aucune donnée audio n’est envoyée. Un
message unique est envoyé, indiquant le début du silence.
Exemple
L’exemple suivant permet à l’utilisateur de déterminer le niveau du silence. Le code suivant est
affecté au bouton :
on (press)
{
this.makeSilenceLevel(this.silenceLevel);
}
La fonction makeSilenceLevel() appelée par le bouton continue :
function makeSilenceLevel(s)
{
this.obj.setSilenceLevel(s);
this.SyncMode();
this.silenceLevel= s;
}
Pour plus d’informations, consultez l’exemple relatif à Camera.setMotionLevel().
Consultez également
Microphone.activityLevel, Microphone.onActivity, Microphone.setGain(),
Microphone.silenceLevel(), Microphone.silenceTimeout()Microphone.silenceLevel() 473
Microphone.setUseEchoSuppression()
Disponibilité
Flash Player 6.
Usage
MicrophoneActif.setUseEchoSuppression(supprimer)
Paramètres
supprimer Une valeur booléenne indiquant si la fonction de suppression de l’écho doit être
utilisée (true) ou non (false).
Renvoie
Rien.
Description
Méthode : spécifie l’utilisation ou non de la fonction de suppression de l’écho du codec audio. La
valeur par défaut est false à moins que l’utilisateur ne sélectionne ReduceEcho dans le panneau
Microphone des paramètres Flash Player.
La suppression de l’écho permet de réduire les effets de bouclage audio qui se produisent lorsque
le son émis par le haut-parleur est capté par le microphone sur le même ordinateur. (A ne pas
confondre avec la fonction d’annulation de l’écho, qui supprime totalement le retour.)
Il est généralement recommandé d’utiliser la suppression de l’écho lorsque le son capturé par le
micro est diffusé par des haut-parleurs (et non par un casque) sur le même ordinateur. Si le fichier
SWF permet aux utilisateurs de spécifier le périphérique de sortie audio, vous pouvez appeler
Microphone.setUseEchoSuppression(true) s’ils utilisent conjointement les haut-parleurs et le
microphone.
Les utilisateurs peuvent également régler ces paramètres dans le panneau Microphone des
paramètres Flash Player.
Exemple
L’exemple suivant active la suppression de l’écho.
monmic.setUseEchoSuppression(true);
Consultez également
Microphone.setGain(), Microphone.useEchoSuppression()
Microphone.silenceLevel()
Disponibilité
Flash Player 6.
Usage
MicrophoneActif.silenceLevel474 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Propriété (lecture seule) : un entier spécifiant le niveau sonore requis pour activer le microphone
et invoquer Microphone.onActivity(true). La valeur par défaut est 10.
Exemple
Consultez l’exemple relatif à Microphone.silenceTimeout().
Consultez également
Microphone.gain, Microphone.setSilenceLevel()
Microphone.silenceTimeout()
Disponibilité
Flash Player 6.
Usage
MicrophoneActif.silenceTimeout
Description
Propriété (lecture seule) : valeur numérique représentant le nombre de millisecondes entre le
moment où le microphone cesse de détecter du son et le moment où
Microphone.onActivity(false) est invoqué. La valeur par défaut est 2 000 (2 secondes).
Pour définir cette valeur, utilisez Microphone.setSilenceLevel().
Exemple
L’exemple suivant multiplie par deux la valeur actuelle du délai d’attente.
monMic.setSilenceLevel(monMic.silenceLevel, monMic.silenceTimeOut * 2);
Consultez également
Microphone.setSilenceLevel()
Microphone.useEchoSuppression()
Disponibilité
Flash Player 6.
Usage
MicrophoneActif.useEchoSuppression
Description
Propriété (lecture seule) : valeur booléenne définie sur la valeur true si la suppression de l’écho est
activée et sur la valeur false dans le cas contraire. La valeur par défaut est false à moins que
l’utilisateur ne sélectionne ReduceEcho dans le panneau Microphone des paramètres Flash Player.
Exemple
L’exemple suivant vérifie l’état de la suppression de l’écho et l’active si elle est désactivée.
_root.monMic.onActivity = function(active) {
if (active == true) {Classe Mouse 475
if (_root.monMic.useEchoSuppression == false) {
_root.monMic.setUseEchoSuppression(true);
}
}
}
Consultez également
Microphone.setUseEchoSuppression()
MMExecute()
Disponibilité
Flash Player 7.
Usage
MMExecute("Commande API Flash JavaScript;")
Paramètres
Commande API Flash JavaScript Toute commande que vous pouvez utiliser dans un fichier
Flash JavaScript (JSFL).
Renvoie
Le résultat, le cas échéant, est envoyé par l’instruction JavaScript.
Description
Fonction ; vous permet d’émettre des commandes de l’API Flash JavaScript à partir
d’ActionScript.
L’API Flash JavaScript (JSAPI) propose plusieurs objets, méthodes et propriétés pour dupliquer
ou émuler des commandes qu’un utilisateur peut saisir dans l’environnement de programmation.
Grâce à JSAPI, vous pouvez écrire des scripts qui étendent Flash de diverses manières : ajout de
commandes aux menus, manipulation d’objets sur la scène, répétition de séquences de
commandes, etc.
Un utilisateur exécute généralement un script JSAPI en sélectionnant Commandes > Exécuter la
commande. Vous pouvez cependant utiliser cette fonction dans un script ActionScript pour
appeler une commande JSAPI directement. Si vous utilisez MMExecute() dans un script sur
l’image 1 de votre fichier, la commande est exécutée lorsque le fichier SWF est chargé.
Pour plus d’informations sur JSAPI, consultez www.macromedia.com/go/jsapi_info_en.
Exemple
La commande suivante renvoie un tableau d’objets dans la bibliothèque :
var libe:Array = MMExecute("fl.getDocumentDOM().library.items;");
trace(libe.length + " articles de la bibliothèque");
Classe Mouse
Disponibilité
Flash Player 5.476 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
La classe Mouse est une classe de haut niveau : vous pouvez accéder à ses propriétés et à ses
méthodes sans utiliser de constructeur. Utilisez les méthodes de la classe Mouse pour masquer et
afficher le pointeur de la souris (curseur) dans le fichier SWF. 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
(consultez Création d’un pointeur de souris personnalisé, page 98).
Résumé des méthodes de la classe Mouse
Résumé des écouteurs de la classe Mouse
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 d’écouteurs onMouseDown,
onMouseMove et onMouseUp.
Le paramètre nouvelEcouteur doit contenir un objet avec des méthodes définies pour les
écouteurs onMouseDown, onMouseMove et onMouseUp.
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 le fichier SWF.
Mouse.removeListener() Supprime un objet enregistré avec addListener().
Mouse.show() Affiche le pointeur de la souris dans le fichier SWF.
Méthode Description
Mouse.onMouseDown Notifié lorsque le bouton de la souris est enfoncé.
Mouse.onMouseMove Notifié lorsque la souris est déplacée.
Mouse.onMouseUp Notifié lorsque le bouton de la souris est relâché.
Mouse.onMouseWheel Notifié lorsque l’utilisateur manipule la molette de la souris.Mouse.onMouseDown 477
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 cette méthode est invoquée. Plusieurs
objets peuvent attendre des notifications de souris. Si l’écouteur nouvelEcouteur est déjà
enregistré, aucun changement n’a lieu.
Consultez également
Mouse.onMouseDown, Mouse.onMouseMove, Mouse.onMouseUp
Mouse.hide()
Disponibilité
Flash Player 5.
Usage
Mouse.hide()
Paramètres
Aucun.
Renvoie
Une valeur booléenne : true si le pointeur est visible et false dans le cas contraire.
Description
Méthode : masque le pointeur dans un fichier SWF. Le pointeur est visible par défaut.
Exemple
Le code suivant, associé à un clip du scénario principal, masque le pointeur standard et définit les
positions x et y de l’occurrence de clip PointeurPerso_mc aux positions x et y de la souris dans le
scénario principal.
onClipEvent (enterFrame) {
Mouse.hide();
PointeurPerso_mc._x = _root._xmouse;
PointeurPerso_mc._y = _root._ymouse;
}
Consultez également
Mouse.show(), MovieClip._xmouse, MovieClip._ymouse
Mouse.onMouseDown
Disponibilité
Flash Player 6.
Usage
unEcouteur.onMouseDown
Paramètres
Aucun.478 Chapitre 12 : Dictionnaire ActionScript Présentation
Renvoie
Rien.
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 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.
Consultez également
Mouse.addListener()
Mouse.onMouseMove
Disponibilité
Flash Player 6.
Usage
unEcouteur.onMouseMove
Paramètres
Aucun.
Renvoie
Rien.
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
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.
Consultez également
Mouse.addListener()Mouse.onMouseWheel 479
Mouse.onMouseUp
Disponibilité
Flash Player 6.
Usage
unEcouteur.onMouseUp
Paramètres
Aucun.
Renvoie
Rien.
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 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.
Consultez également
Mouse.addListener()
Mouse.onMouseWheel
Disponibilité
Flash Player 7 (Windows uniquement).
Usage
unEcouteur.onMouseWheel = function ( [ delta , scrollTarget ]) {
// vos instructions
}
Paramètres
delta Un nombre facultatif indiquant le nombre de lignes qui défilent pour chaque cran de la
molette de la souris que l’utilisateur fait tourner. Une valeur delta positive indique que le
défilement se fait vers le haut ; une valeur négative indique que le défilement se fait vers le bas.
Cette valeur se situe généralement entre 1 et 3. Un défilement plus rapide peut produire des
valeurs plus grandes.
Si vous ne souhaitez pas spécifier de valeur pour delta mais que vous souhaitez en spécifier une
pour scrollTarget, définissez null pour delta.
scrollTarget La première occurrence de clip sous le pointeur une fois la molette de la souris
tournée. 480 Chapitre 12 : Dictionnaire ActionScript Présentation
Renvoie
Rien.
Description
Ecouteur : notifié lorsque l’utilisateur manipule la molette de la souris. Pour utiliser l’écouteur
onMouseWheel, vous devez créer un objet d’écoute. Vous pouvez ensuite définir une fonction
pour onMouseWheel et utiliser addListener() pour enregistrer l’écouteur avec l’objet Mouse.
Remarque : Les écouteurs d’événement molette de souris sont disponibles uniquement dans les
versions Windows de Flash Player.
Exemple
L’exemple suivant montre comment créer un objet écouteur qui réagit aux événements de
mollette de souris. Dans cet exemple, la coordonnée x d’un objet clip appelé clip_mc (non
illustré) change à chaque fois que l’utilisateur fait tourner la mollette de la souris.
EcouteurSouris = new Object();
EcouteurSouris.onMouseWheel = function(delta) {
clip_mc._x += delta;
}
Mouse.addListener(EcouteurSouris);
Consultez également
Mouse.addListener(), TextField.mouseWheelEnabled
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 : supprime un objet précédemment enregistré avec addListener().
Mouse.show()
Disponibilité
Flash Player 5.
Usage
Mouse.show()Classe MovieClip 481
Paramètres
Aucun.
Renvoie
Rien.
Description
Méthode : affiche le pointeur de la souris dans un fichier SWF. Le pointeur est visible par défaut.
Consultez également
Mouse.show(), MovieClip._xmouse, MovieClip._ymouse
Classe MovieClip
Disponibilité
Flash Player 3.
Description
Les méthodes de la classe MovieClip fournissent les mêmes fonctionnalités 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 de constructeur pour appeler les méthodes de la
classe MovieClip ; faites référence aux occurrences de clips par leurs noms, avec la syntaxe
suivante :
mon_mc.play();
mon_mc.gotoAndPlay(3);
Résumé des méthodes de la classe MovieClip
Méthode Description
MovieClip.attachAudio() Capture et joue du son local à partir d’un microphone.
MovieClip.attachMovie() Associe un fichier SWF 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’un
fichier SWF 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.getInstanceAtDepth() Indique si une profondeur particulière est déjà occupée par un
clip.482 Chapitre 12 : Dictionnaire ActionScript Présentation
MovieClip.getNextHighestDepth() Indique une valeur de profondeur que vous pouvez
transmettre à d’autres méthodes pour vous assurer que Flash
effectue un rendu du clip devant tous les objets du clip actuel.
MovieClip.getSWFVersion() Renvoie un entier indiquant la version deFlash Player pour
laquelle le clip a été publié.
MovieClip.getTextSnapshot() Renvoie un objet TextSnapshot contenant le texte dans les
champs de texte statiques du clip spécifié.
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 vers une image spécifique du clip et lit
le fichier SWF.
MovieClip.gotoAndStop Envoie la tête de lecture vers une image spécifique du clip et
arrête le fichier SWF.
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 le fichier SWF spécifié 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
duplicateMovieClip(), MovieClip.duplicateMovieClip ou
MovieClip.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 du fichier SWF actuel.
MovieClip.stopDrag() Arrête le déplacement d’un clip en cours de déplacement.
MovieClip.swapDepths() Echange le niveau de profondeur de deux fichiers SWF.
MovieClip.unloadMovie() Supprime un fichier SWF chargé avec loadMovie().
Méthode DescriptionClasse MovieClip 483
Méthodes de dessin de la classe MovieClip
Résumé des propriétés de la classe 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é 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 à partir d’un fichier SWF 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é du rendu d’un fichier SWF.
MovieClip.menu Associe un objet ContextMenu à un clip.
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.484 Chapitre 12 : Dictionnaire ActionScript Présentation
Résumé des gestionnaires d’événement de la classe MovieClip
MovieClip.tabChildren Indique si les enfants d’un clip sont inclus dans l’ordre de
tabulation automatique.
mon_mc.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.
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 pointeur de la souris 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 pointeur de la souris dans une occurrence
de clip.
MovieClip._yscale La valeur spécifiant le pourcentage de redimensionnement
vertical d’un clip.
Gestionnaire d’événement 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é de manière continue à la cadence du fichier SWF.
Les actions associées à l’événement de clip enterFrame sont
traitées avant les actions associées aux images affectées.
Propriété DescriptionMovieClip._alpha 485
MovieClip._alpha
Disponibilité
Flash Player 4.
Usage
mon_mc._alpha
Description
Propriété : la valeur de transparence alpha du clip spécifié par mon_mc. Les valeurs valides vont de
0 (transparence complète) à 100 (opacité complète). La valeur par défaut est 100. 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.
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.
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
Unload sont traitées avant que des actions ne soient
associées à l’image affectée.
Gestionnaire d’événement Description486 Chapitre 12 : Dictionnaire ActionScript Présentation
Exemple
Le code suivant définit la propriété _alpha d’un clip appelé star_mc à 30 % lorsque l’utilisateur
clique sur le bouton :
on(release) {
star_mc._alpha = 30;
}
Consultez également
Button._alpha, TextField._alpha
MovieClip.attachAudio()
Disponibilité
Flash Player 6 ; la possibilité de joindre du son à partir de fichiers Flash Video (FLV) a été ajoutée
dans Flash Player 7.
Usage
mon_mc.attachAudio(source)
Paramètres
source L’objet contenant le son à jouer. Les valeurs valides sont un objet Microphone, un objet
NetStream qu’un fichier FLV lit et false (arrête la lecture du son).
Renvoie
Rien.
Description
Méthode : spécifie la source audio à lire. Pour arrêter la lecture de la source audio, affectez false
à source.
Exemple
Le code suivant associe un microphone à un clip.
mon_mic = Microphone.get();
this.attachAudio(mon_mic);
L’exemple suivant montre comment vous pouvez utiliser un objet Sound pour contrôler le son
associé à un fichier FLV.
// Clip est le nom d’occurrence du clip
// qui contient l’objet vidéo "ma_vidéo".
_root.Clip.ma_vidéo.attachVideo(_root.myNetStream);
_root.Clip.attachAudio(_root.myNetStream);
var snd = new Sound("_root.Clip");
//Pour régler le son :
_root.snd.setVolume(100);
Consultez également
Classe Microphone, NetStream.play(), Classe Sound, Video.attachVideo()MovieClip.beginFill() 487
MovieClip.attachMovie()
Disponibilité
Flash Player 5.
Usage
mon_mc.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.
nouveauNom Un nom d’occurrence unique pour le clip en cours d’association avec le clip.
profondeur Un entier spécifiant le niveau de profondeur auquel associer le fichier SWF.
objetInit (supporté par Flash Player 6 et ultérieur) 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.
Renvoie
Une référence à la nouvelle occurrence.
Description
Méthode : prend un symbole de la bibliothèque et l’associe au fichier SWF spécifié par mon_mc
sur la scène. Utilisez removeMovieClip() ou unloadMovie() pour supprimer un fichier SWF
associé à attachMovie().
Exemple
L’exemple suivant associe le symbole dont l’identifiant de liaison est un « cercle » à l’occurrence de
clip qui se trouve sur la scène du fichier SWF.
on (release) {
    truc.attachMovie( "cercle", "cercle1", 2 );
}
Consultez également
MovieClip.removeMovieClip(), MovieClip.unloadMovie(), Object.registerClass(),
removeMovieClip()
MovieClip.beginFill()
Disponibilité
Flash Player 6.
Usage
mon_mc.beginFill([rvb[, alpha]])488 Chapitre 12 : Dictionnaire ActionScript Présentation
Paramètre
rvb Une valeur chromatique hexadécimale (par exemple, le rouge correspond à 0xFF0000, le
bleu correspond à 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 endFill(). Si aucun remplissage n’est actuellement
associé au chemin, endFill() doit être appelé pour appliquer le remplissage.
Consultez également
MovieClip.beginGradientFill(), MovieClip.endFill()
MovieClip.beginGradientFill()
Disponibilité
Flash Player 6.
Usage
mon_mc.beginGradientFill(typeDeRemplissage, couleurs, alphas, rapports,
matrice)
Paramètre
typeDeRemplissage 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 correspond à 0xFF0000, le bleu correspond à 0x0000FF, etc.).
alphas Un tableau de valeurs alpha pour les couleurs correspondantes du tableau couleurs, les
valeurs valides sont comprises entre 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 iMovieClip.beginGradientFill() 489
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();
}
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, traduit, 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 );490 Chapitre 12 : Dictionnaire ActionScript Présentation
              moveto(100,100);
              lineto(100,300);
              lineto(300,300);
              lineto(300,100);
              lineto(100,100);
              endFill();
              }
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
(si la position actuelle du dessin 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 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.
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);MovieClip.clear() 491
endFill();
matrice = { typeDeMatrice:"box", x:100, y:310, l:500, h:200, r0/
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();
}
Consultez également
MovieClip.beginFill(), MovieClip.endFill(), MovieClip.lineStyle(),
MovieClip.lineTo(), MovieClip.moveTo()
MovieClip.clear()
Disponibilité
Flash Player 6.
Usage
mon_mc.clear()
Paramètres
Aucun.
Renvoie
Rien.
Description
Méthode : supprime tous les graphiques créés à l’exécution à l’aide des méthodes de dessin de la
classe MovieClip, y compris les styles de traits spécifiés avec MovieClip.lineStyle(). Les
formes et les lignes dessinées à main levée pendant la phase de programmation (avec les outils de
dessin Flash) ne sont pas supprimées.492 Chapitre 12 : Dictionnaire ActionScript Présentation
Consultez également
MovieClip.lineStyle()
MovieClip.createEmptyMovieClip()
Disponibilité
Flash Player 6.
Usage
mon_mc.createEmptyMovieClip(nomDoccurrence, profondeur)
Paramètres
nomDoccurrence Une chaîne identifiant le nom d’occurrence du nouveau clip.
profondeur Un entier spécifiant la profondeur du nouveau clip.
Renvoie
Une référence au nouveau clip.
Description
Méthode : crée un clip vide comme enfant d’un clip existant. Cette méthode a le même
comportement que 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.
Consultez également
MovieClip.attachMovie()
MovieClip.createTextField()
Disponibilité
Flash Player 6.
Usage
mon_mc.createTextField(nomDoccurrence, profondeur, x, y, largeur, hauteur)
Paramètres
nomDoccurence 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.MovieClip.createTextField() 493
Renvoie
Rien.
Description
Méthode : crée un champ de texte vide comme enfant du clip spécifié par mon_mc. Vous pouvez
utiliser createTextField() pour créer des champs de texte lors de la lecture d’un fichier SWF.
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
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);494 Chapitre 12 : Dictionnaire ActionScript Présentation
Consultez également
Classe TextFormat
MovieClip._currentframe
Disponibilité
Flash Player 4.
Usage
mon_mc._currentframe
Description
Propriété (lecture seule) : renvoie le numéro de l’image où se trouve la tête de lecture dans le
scénario spécifié par mon_mc.
Exemple
L’exemple suivant utilise la propriété _currentframe pour faire avancer la tête de lecture du clip
actionClip_mc de cinq images par rapport à son emplacement actuel.
actionClip_mc.gotoAndStop(_currentframe + 5);
MovieClip.curveTo()
Disponibilité
Flash Player 6.
Usage
mon_mc.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.MovieClip._droptarget 495
Description
Méthode : dessine une courbe avec le style de trait courant depuis 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 au-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();
}
Consultez également
MovieClip.beginFill(), MovieClip.createEmptyMovieClip(), MovieClip.endFill(),
MovieClip.lineStyle(), MovieClip.lineTo(), MovieClip.moveTo()
MovieClip._droptarget
Disponibilité
Flash Player 4.
Usage
mon_mc._droptarget
Description
Propriété (lecture seule) : renvoie le chemin absolu avec la syntaxe à barre oblique de l’occurrence
de clip sur laquelle mon_mc 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 en une référence avec syntaxe à point.
Remarque : Vous devez réaliser cette conversion si vous utilisez ActionScript 2.0 qui ne prend pas
en charge la syntaxe à barre oblique. 496 Chapitre 12 : Dictionnaire ActionScript Présentation
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 du fichier SWF à l’aide du script
suivant :
x_pos = tasDeTrucs._x;
y_pos = tasDeTrucs._y;
Consultez également
startDrag()
MovieClip.duplicateMovieClip
Disponibilité
Flash Player 5.
Usage
mon_mc.duplicateMovieClip(nouveauNom, profondeur [,objetInit])
Paramètres
nouveauNom Un identifiant unique pour le clip dupliqué.
profondeur Un nombre unique indiquant la profondeur à laquelle le fichier SWF spécifié doit
être placé.
objetInit (Supporté par Flash Player 6 et ultérieur.) 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.
Renvoie
Une référence au clip dupliqué.MovieClip.endFill() 497
Description
Méthode : crée une occurrence du clip spécifié pendant la lecture du fichier SWF. 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
duplicateMovieClip() pour leur parent. Si le clip parent est effacé, le clip dupliqué l’est
également.
Consultez également
duplicateMovieClip(), MovieClip.removeMovieClip()
MovieClip.enabled
Disponibilité
Flash Player 6.
Usage
mon_mc.enabled
Description
Propriété : 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 la valeur false, les méthodes de rappel et les
gestionnaires d’événement d’action on du clip de bouton ne sont plus invoqués et les images
Dessus, Bas 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
mon_mc.endFill()
Paramètres
Aucun.
Renvoie
Rien.498 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Méthode : applique un remplissage aux lignes et aux courbes ajoutées depuis le dernier appel de la
méthode beginFill() ou beginGradientFill(). Flash utilise le remplissage spécifié lors de
l’appel précédent de 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
mon_mc.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
mon_mc._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
mon_mc._framesloaded
Description
Propriété (lecture seule) : le nombre d’images chargées depuis un fichier SWF lu 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
très utile pour contrôler le processus de téléchargement des fichiers SWF volumineux. Par
exemple, il peut s’avérer utile d’afficher un message aux utilisateurs leur indiquant que le fichier
SWF est en cours de chargement jusqu’à ce qu’une image spécifique contenue dans le fichier SWF
soit chargée.MovieClip.getBounds 499
Exemple
L’exemple suivant utilise la propriété _framesloaded pour démarrer un fichier SWF 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;
}
Consultez également
Classe MovieClipLoader
MovieClip.getBounds
Disponibilité
Flash Player 5.
Usage
mon_mc.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 minimum et maximum des coordonnées x et
y de l’occurrence spécifiée par mon_mc pour le paramètre espaceDeCoordonnéesCible.
Remarque : Utilisez MovieClip.localToGlobal() et MovieClip.globalToLocal() pour convertir les
coordonnées locales du clip en coordonnées de scène ou, à l’inverse, les coordonnées de scène en
coordonnées locales.
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;
Consultez également
MovieClip.globalToLocal(), MovieClip.localToGlobal()500 Chapitre 12 : Dictionnaire ActionScript Présentation
MovieClip.getBytesLoaded()
Disponibilité
Flash Player 5.
Usage
mon_mc.getBytesLoaded()
Paramètres
Aucun.
Renvoie
Un entier indiquant le nombre d’octets chargés.
Description
Méthode : renvoie le nombre d’octets déjà chargé (transmis) pour le clip spécifié par mon_mc.
Vous pouvez comparer cette valeur avec la valeur renvoyée par MovieClip.getBytesTotal()
pour déterminer quel pourcentage de clip a été chargé.
Consultez également
MovieClip.getBytesTotal()
MovieClip.getBytesTotal()
Disponibilité
Flash Player 5.
Usage
mon_mc.getBytesTotal()
Paramètres
Aucun.
Renvoie
Un nombre entier indiquant la taille totale, en octets, de mon_mc.
Description
Méthode : renvoie la taille, en octets, du clip spécifié par mon_mc. Pour les clips externes (le fichier
SWF racine ou un clip chargé dans une cible ou un niveau), la valeur renvoyée correspond à la
taille du fichier SWF.
Consultez également
MovieClip.getBytesLoaded()
MovieClip.getDepth()
Disponibilité
Flash Player 6.MovieClip.getNextHighestDepth() 501
Usage
mon_mc.getDepth()
Paramètres
Aucun.
Renvoie
Un entier.
Description
Méthode : renvoie la profondeur d’une occurrence de clip. Pour plus d’informations, consultez
Gestion des profondeurs de clip, page 133.
Consultez également
MovieClip.getInstanceAtDepth(), MovieClip.getNextHighestDepth(),
MovieClip.swapDepths()
MovieClip.getInstanceAtDepth()
Disponibilité
Flash Player 7.
Usage
mon_mc.getInstanceAtDepth(profondeur)
Paramètres
profondeur Un nombre entier qui spécifie le niveau de profondeur à interroger.
Renvoie
Une chaîne représentant le nom du clip situé à la profondeur spécifiée ou undefined si aucun clip
ne se trouve à cette profondeur.
Description
Méthode : vous permet de déterminer si une profondeur particulière est déjà occupée par un clip.
Vous pouvez utiliser cette méthode avant d’utiliser MovieClip.attachMovie(),
MovieClip.duplicateMovieClip ou MovieClip.createEmptyMovieClip() pour déterminer
si le paramètre de profondeur à transmettre à l’une de ces méthodes contient déjà un clip. Pour
plus d’informations, consultez Gestion des profondeurs de clip, page 133.
Consultez également
MovieClip.getDepth(), MovieClip.getNextHighestDepth(), MovieClip.swapDepths()
MovieClip.getNextHighestDepth()
Disponibilité
Flash Player 7.
Usage
mon_mc.getNextHighestDepth()502 Chapitre 12 : Dictionnaire ActionScript Présentation
Paramètres
Aucun.
Renvoie
Un entier représentant le prochain ordre de profondeur disponible qui apparaîtra au-dessus de
tous les autres objets au même niveau et sur le même calque dans mon_mc.
Description
Méthode : vous permet de déterminer une valeur de profondeur qui vous pouvez transmettre à
MovieClip.attachMovie(), MovieClip.duplicateMovieClip, ou
MovieClip.createEmptyMovieClip() pour vérifier que le clip apparaît au-dessus de tous les
autres objets au même niveau et sur le même calque dans le clip actuel. La valeur renvoyée est 0 ou
plus (ainsi, les valeurs négatives ne sont pas renvoyées).
Pour plus d’informations, consultez Gestion des profondeurs de clip, page 133.
Consultez également
MovieClip.getDepth(), MovieClip.getInstanceAtDepth(), MovieClip.swapDepths()
MovieClip.getSWFVersion()
Disponibilité
Flash Player 7.
Usage
mon_mc.getSWFVersion()
Paramètres
Aucun.
Renvoie
Un entier qui spécifie que la version de Flash Player ciblée lors du chargement du fichier SWF
dans mon_mc était publié.
Description
Méthode : renvoie un entier indiquant la version de Flash Player pour laquelle l’objet mon_mc a
été publié. Si mon_mc est un fichier JPEG ou si une erreur se produit et que Flash ne peut pas
déterminer la version SWF de mon_mc , -1 est renvoyé.
MovieClip.getTextSnapshot()
Disponibilité
Programmation : Flash MX 2004.
Lecture : De fichiers SWF publiés pour Flash Player 6 ou ultérieur, lus dans Flash Player 7 ou
ultérieur.
Usage
mon_mc.getTextSnapshot();MovieClip.getURL() 503
Paramètres
Aucun.
Renvoie
Un objet TextSnapshot contenant le texte statique de mon_mc ou un chaîne vide si mon_mc ne
contient pas de texte statique.
Description
Méthode : renvoie un objet TextSnapshot contenant le texte de tous les champs de texte statiques
dans le clip spécifié ; le texte de clips enfant n’est pas inséré.
Flash concatène le texte et le place dans l’objet TextSnapshot dans un ordre représentant l’ordre
d’indexation des champs de texte statiques dans le clip. Les champs de texte ne comportant pas de
valeurs d’indexation sont placés par ordre aléatoire dans l’objet et précèdent le texte de champs
comportant des valeurs d’indexation. Aucun saut de ligne ou formatage n’indique la fin d’un
champ et le début du suivant.
Remarque : Vous ne pouvez pas spécifier de valeur d’indexation pour du texte statique dans Flash.
D’autres produits le permettent, Macromedia FlashPaper par exemple.
Le contenu de l’objet TextSnapshot n’est pas dynamique, c’est-à-dire que, si le clip se déplace sur
une autre image ou s’il est modifié (si des objets du clip sont ajoutés ou supprimés, par exemple),
l’objet TextSnapshot peut ne pas représenter le texte réel du clip. Pour s’assurer que le contenu de
l’objet est le contenu réel, émettez de nouveau cette commande si nécessaire.
Consultez également
objet TextSnapshot
MovieClip.getURL()
Disponibilité
Flash Player 5.
Usage
mon_mc.getURL(URL [,fenêtre, variables])
Paramètres

Description
Méthode : termine une méthode MovieClip.startDrag() Une animation rendue déplaçable
avec cette méthode 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.
Consultez également
MovieClip._droptarget, MovieClip.startDrag(), stopDrag()
MovieClip.swapDepths()
Disponibilité
Flash Player 5.
Usage
mon_mc.swapDepths(profondeur)
mon_mc.swapDepths(cible)
Paramètres
profondeur Un nombre spécifiant le niveau de profondeur auquel mon_mc doit être placé.
cible Une chaîne spécifiant l’occurrence de clip dont la profondeur est permutée par
l’occurrence spécifiée par mon_mc. Les deux occurrences doivent avoir le même clip parent.
Renvoie
Rien.532 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Méthode : permute l’ordre d’empilement, ou ordre z (niveau de profondeur), de l’occurrence
spécifiée (mon_mc) avec le clip spécifié par le paramètre cible ou avec le clip occupant
actuellement le niveau spécifié dans le paramètre profondeur. Les deux clips doivent avoir le
même clip parent. La permutation du niveau de profondeur des clips a pour effet de déplacer un
clip devant ou derrière l’autre. Si un clip est en cours d’interpolation lors de l’appel de cette
méthode, l’interpolation est arrêtée. Pour plus d’informations, consultez Gestion des profondeurs de
clip, page 133.
Consultez également
_level, MovieClip.getDepth(), MovieClip.getInstanceAtDepth(),
MovieClip.getNextHighestDepth()
MovieClip.tabChildren
Disponibilité
Flash Player 6.
Usage
mon_mc.tabChildren
Description
Propriété : undefined par défaut. Si tabChildren a pour valeur 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.
L’utilisateur peut cliquer sur chaque élément pour le sélectionner, de sorte que chaque élément est
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.
La propriété tabChildren n’a aucun effet si la propriété tabIndex est utilisée. La propriété
tabChildren n’affecte que l’ordre de tabulation automatique.
Consultez également
Button.tabIndex, mon_mc.tabEnabled, MovieClip.tabIndex, TextField.tabIndex
mon_mc.tabEnabled
Disponibilité
Flash Player 6.
Usage
mon_mc.tabEnabledMovieClip.tabIndex 533
Description
Propriété : spécifie si mon_mc est inclus dans l’ordre de tabulation automatique. Valeur undefined
par défaut.
Si tabEnabled est undefined, l’objet est inclus dans l’ordre de tabulation automatique
uniquement s’il définit au moins un gestionnaire de boutons, par exemple
MovieClip.onRelease. Si tabEnabled est 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 ou
personnalisé, même si la propriété tabIndex est définie. Toutefois, si MovieClip.tabChildren a
pour valeur true, les enfants du clip peuvent rester inclus dans l’ordre de tabulation automatique,
même si tabEnabled est défini sur la valeur false.
Consultez également
Button.tabEnabled, MovieClip.tabChildren, MovieClip.tabIndex,
TextField.tabEnabled
MovieClip.tabIndex
Disponibilité
Flash Player 6.
Usage
mon_mc.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 du fichier SWF 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 du
fichier SWF. 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 dont la valeur
tabIndex est 1 précède un objet dont la valeur tabIndex est de 2. L’ordre de tabulation
personnalisé ignore les relations hiérarchiques entre les objets d’un fichier SWF. Tous les objets du
fichier SWF 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.
Consultez également
Button.tabIndex, TextField.tabIndex534 Chapitre 12 : Dictionnaire ActionScript Présentation
MovieClip._target
Disponibilité
Flash Player 4.
Usage
mon_mc._target
Description
Propriété (lecture seule) : renvoie le chemin cible de l’occurrence de clip spécifié par mon_mc.
MovieClip._totalframes
Disponibilité
Flash Player 4.
Usage
mon_mc._totalframes
Description
Propriété (lecture seule) : renvoie le nombre total d’images de l’occurrence de clip spécifiée dans le
paramètre mon_mc.
MovieClip.trackAsMenu
Disponibilité
Flash Player 6.
Usage
mon_mc.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.
Consultez également
Button.trackAsMenu
MovieClip.unloadMovie()
Disponibilité
Flash Player 5.MovieClip.useHandCursor 535
Usage
mon_mc.unloadMovie()
Paramètres
Aucun.
Renvoie
Rien.
Description
Méthode : renvoie le contenu d’une occurrence de clip. Les propriétés d’occurrence et les
gestionnaires de clip restent.
Pour supprimer l’occurrence, y compris ses propriétés et les gestionnaires de clip, utilisez
MovieClip.removeMovieClip().
Consultez également
MovieClip.attachMovie(), MovieClip.loadMovie, unloadMovie(), unloadMovieNum()
MovieClip._url
Disponibilité
Flash Player 4.
Usage
mon_mc._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
mon_mc.useHandCursor
Description
Propriété : une valeur booléenne indiquant si le curseur en forme de main (main) apparaît 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 la valeur true, la main utilisée pour les boutons s’affiche 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.536 Chapitre 12 : Dictionnaire ActionScript Présentation
MovieClip._visible
Disponibilité
Flash Player 4.
Usage
mon_mc._visible
Description
Propriété : une valeur booléenne indiquant si le clip spécifié par mon_mc est visible. Les clips qui
ne sont pas visibles (propriété _visible définie sur false) sont désactivés. Par exemple, le
bouton d’un clip dont la propriété _visible est définie sur la valeur false ne peut pas être
cliqué.
Consultez également
Button._visible, TextField._visible
MovieClip._width
Disponibilité
Flash Player 4 en tant que propriété en lecture seule.
Usage
mon_mc._width
Description
Propriété : 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;
}
Consultez également
MovieClip._height
MovieClip._x
Disponibilité
Flash Player 3.
Usage
mon_mc._xMovieClip._xscale 537
Description
Propriété : un entier définissant la coordonnée x d’un clip 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 degrés 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 degrés dans le sens
inverse des aiguilles d’une montre. Les coordonnées du clip font référence à la position du point
d’alignement.
Consultez également
MovieClip._xscale, MovieClip._y, MovieClip._yscale
MovieClip._xmouse
Disponibilité
Flash Player 5.
Usage
mon_mc._xmouse
Description
Propriété (lecture seule) : renvoie la coordonnée x de la position de la souris.
Consultez également
Classe Mouse, MovieClip._ymouse
MovieClip._xscale
Disponibilité
Flash Player 4.
Usage
mon_mc._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 %.
Consultez également
MovieClip._x, MovieClip._y, MovieClip._yscale538 Chapitre 12 : Dictionnaire ActionScript Présentation
MovieClip._y
Disponibilité
Flash Player 3.
Usage
mon_mc._y
Description
Propriété : définit la coordonnée y du clip 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 degrés 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 degrés dans le sens inverse des
aiguilles d’une montre. Les coordonnées du clip font référence à la position du point
d’alignement.
Consultez également
MovieClip._x, MovieClip._xscale, MovieClip._yscale
MovieClip._ymouse
Disponibilité
Flash Player 5.
Usage
mon_mc._ymouse
Description
Propriété (lecture seule) : indique la coordonnée y de la position de la souris.
Consultez également
Classe Mouse, MovieClip._xmouse
MovieClip._yscale
Disponibilité
Flash Player 4.
Usage
mon_mc._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).Classe MovieClipLoader 539
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 %.
Consultez également
MovieClip._x, MovieClip._xscale, MovieClip._y
Classe MovieClipLoader
Disponibilité
Flash Player 7.
Description
Cette classe vous permet d’implémenter des rappels des écouteurs offrant des informations d’état
durant le chargement des fichiers SWF et JPEG (téléchargés) dans les clips. Pour utiliser les
fonctionnalités MovieClipLoader, utilisez MovieClipLoader.loadClip() plutôt que
loadMovie() ou MovieClip.loadMovie() pour charger les fichiers SWF.
Une fois la commande MovieClipLoader.loadClip() activée, les événements suivants se
produisent, dans l’ordre spécifié :
• Une fois les premiers octets du fichier téléchargé enregistrés sur disque, l’écouteur
MovieClipLoader.onLoadStart() est appelé.
• Si vous avez implémenté l’écouteur MovieClipLoader.onLoadProgress(), ce dernier est
appelé durant le processus de chargement.
Remarque : Vous pouvez appeler MovieClipLoader.getProgress() à tout moment durant le
processus de chargement.
• Une fois le fichier téléchargé entier enregistré sur disque, l’écouteur
MovieClipLoader.onLoadComplete() est appelé.
• Une fois les premières actions d’image du fichier téléchargé effectuées, l’écouteur
MovieClipLoader.onLoadInit() est appelé.
Une fois MovieClipLoader.onLoadInit() appelé, vous pouvez définir les propriétés, utiliser les
méthodes, ou bien interagir avec le clip chargé.
Si le chargement du fichier échoue, l’écouteur MovieClipLoader.onLoadError() est appelé.
Méthodes de la classe MovieClipLoader
Méthode Description
MovieClipLoader.addListener() Enregistre un objet pour recevoir une notification lors de
l’appel d’un gestionnaire d’événements
MovieClipLoader.
MovieClipLoader.getProgress() Renvoie le nombre d’octets chargés et le nombre total
d’octets pour un fichier en cours de chargement à l’aide
de MovieClipLoader.loadClip().
MovieClipLoader.loadClip() Charge un fichier SWF ou JPEG dans un clip dans
Flash Player, lors de la lecture du clip d’origine. 540 Chapitre 12 : Dictionnaire ActionScript Présentation
Ecouteurs de la classe MovieClipLoader
Constructeur de la classe MovieClipLoader
Disponibilité
Flash Player 7.
Usage
new MovieClipLoader()
Paramètres
Aucun.
Renvoie
Rien.
Description
Constructeur : crée un objet MovieClipLoader que vous pouvez utiliser pour implémenter un
nombre d’écouteurs pour répondre aux événements lors du téléchargement d’un fichier SWF ou
JPEG.
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
Consultez également
MovieClipLoader.addListener()
MovieClipLoader.removeListener() Supprime un objet enregistré à l’aide de
MovieClipLoader.addListener().
MovieClipLoader.unloadClip() Supprime un clip chargé via
MovieClipLoader.loadClip().
Ecouteur Description
MovieClipLoader.onLoadComplete() Appelé si un fichier chargé à l’aide de
MovieClipLoader.loadClip() est entièrement
téléchargé.
MovieClipLoader.onLoadError() Appelé si le chargement d’un fichier chargé à l’aide de
MovieClipLoader.loadClip() a échoué.
MovieClipLoader.onLoadInit() Appelé si les actions sur la première image du clip
chargées ont été exécutées.
MovieClipLoader.onLoadProgress() Appelé à chaque fois que le contenu de chargement est
enregistré sur disque durant le processus de
chargement.
MovieClipLoader.onLoadStart() Appelé si un appel de MovieClipLoader.loadClip() a
commencé le téléchargement d’un fichier.
Méthode DescriptionMovieClipLoader.getProgress() 541
MovieClipLoader.addListener()
Disponibilité
Flash Player 7.
Usage
mon_mcl.addListener(objetDecoute)
Paramètres
objetDecoute Un objet qui écoute une notification de rappel à partir des gestionnaires
d’événements MovieClipLoader.
Renvoie
Rien.
Description
Méthode : enregistre un objet pour recevoir une notification lors de l’appel d’un gestionnaire
d’événements MovieClipLoader.
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
Consultez également
MovieClipLoader.onLoadComplete(), MovieClipLoader.onLoadError(),
MovieClipLoader.onLoadInit(), MovieClipLoader.onLoadProgress(),
MovieClipLoader.onLoadStart(), MovieClipLoader.removeListener()
MovieClipLoader.getProgress()
Disponibilité
Flash Player 7.
Usage
mon_mcl.getProgress(cible_mc)
Paramètres
cible_mc Un fichier SWF ou JPEG chargé via MovieClipLoader.loadClip().
Renvoie
Un objet qui a deux propriétés intégrées : bytesLoaded et bytesTotal.
Description
Méthode : renvoie le nombre d’octets chargés et le nombre total d’octets pour un fichier en cours
de chargement à l’aide de MovieClipLoader.loadClip() ; pour les clips compressés, ce nombre
reflète le nombre d’octets compressés. Cette méthode vous permet de demander explicitement ces
informations, plutôt que (ou en plus) d’enregistrer une fonction d’écouteur
MovieClipLoader.onLoadProgress().542 Chapitre 12 : Dictionnaire ActionScript Présentation
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
Consultez également
MovieClipLoader.onLoadProgress()
MovieClipLoader.loadClip()
Disponibilité
Flash Player 7.
Usage
mon_mcl.loadMovie("url", cible )
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. Des URL absolues doivent inclure la référence au protocole,
comme http:// ou file:///. Les noms de fichiers ne peuvent pas inclure de spécifications de disque
dur.
cible Le chemin cible d’un clip, ou un nombre entier spécifiant le niveau, dans Flash Player,
auquel ce clip sera chargé. Le clip cible sera remplacé par l’animation ou l’image chargée.
Renvoie
Rien.
Description
Charge un fichier SWF ou JPEG dans un clip dans Flash Player, lors de la lecture du clip
d’origine. 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.
L’utilisation de cette méthode au lieu de la méthode loadMovie() ou MovieClip.loadMovie()
offre de nombreux avantages :
• Le gestionnaire MovieClipLoader.onLoadStart() est appelé au démarrage du chargement.
• Le gestionnaire MovieClipLoader.onLoadError() est appelé si le clip ne peut pas être chargé.
• Le gestionnaire MovieClipLoader.onLoadProgress() est appelé durant le processus de
chargement.
• Le gestionnaire MovieClipLoader.onLoadInit() est appelé une fois les actions sur la
première image du clip exécutées, afin que vous puissiez commencer la manipulation du clip
chargé.
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.
Vous pouvez utiliser cette méthode pour charger un ou plusieurs fichiers dans un même clip ou à
un même niveau ; les objets d’écoute MovieClipLoader reçoivent l’occurrence de chargement du
clip cible en tant que paramètre. Vous pouvez également créer un objet MovieClipLoader
différent pour chaque fichier chargé.MovieClipLoader.loadClip() 543
Utilisez MovieClipLoader.unloadClip() pour supprimer les clips ou les images chargées via
cette méthode, ou pour annuler une opération de chargement en cours.
Exemple
L’exemple suivant illustre l’utilisation d’une grande partie des méthodes MovieClipLoader et des
écouteurs.
// premier ensemble d’écouteurs
var mon_mcl = new MovieClipLoader();
monEcouteur = new Object();
monEcouteur.onLoadStart = function (cible_mc)
{
maTrace ("*********Première occurrence de mon_mcl*********");
maTrace ("Votre chargement a commencé sur le clip . = " + cible_mc);
var loadProgress = mon_mcl.getProgress(cible_mc);
maTrace(loadProgress.bytesLoaded + " = octets chargés au démarrage");
maTrace(loadProgress.bytesTotal + " = total des octets au démarrage");
}
monEcouteur.onLoadProgress = function (cible_mc, loadedBytes, totalBytes)
{
maTrace ("*********Progression de la première occurrence de
mon_mcl*********");
maTrace ("onLoadProgress() rappelé sur clip " + cible_mc);
maTrace(loadedBytes + " = octets chargés au rappel de progression " );
maTrace(totalBytes + " = total octets au rappel de progression \n");
}
monEcouteur.onLoadComplete = function (cible_mc)
{
maTrace ("*********Première occurrence de mon_mcl*********");
maTrace ("Votre chargement est effectué sur le clip = " + cible_mc);
var loadProgress = mon_mcl.getProgress(cible_mc);
maTrace(loadProgress.bytesLoaded + " = octets chargés à la fin");
maTrace(loadProgress.bytesTotal + " = total des octets à la fin");
}
monEcouteur.onLoadInit = function (cible_mc)
{
maTrace ("*********Première occurrence de mon_mcl*********");
maTrace ("Clip = " + cible_mc + " est maintenant initialisé");
// vous pouvez maintenant effectuer tous les réglages requis, par exemple :
cible_mc._width = 100;
cible_mc._width = 100;
}
objetDecoute.onLoadError() = function (cible_mc, errorCode) {
{
maTrace ("*********Première occurrence de mon_mcl*********");
maTrace ("CODE ERREUR = " + codeErreur);
maTrace ("Votre chargement a échoué sur le clip = " + cible_mc + "\n");
}
mon_mcl.addListener(monEcouteur);
//Charger maintenant les fichiers dans leurs emplacements cibles.
// charge dans les clips - chaînes utilisées en tant que cibles
mon_mcl.loadClip("http://www.undomaine.quelquepart.com/
unFichier.swf","_root.monMC");
mon_mcl.loadClip("http://www.undomaine.quelquepart.com/unAutreFichier.swf",
"_level0.monMC2");
//échec du chargement
mon_mcl.loadClip("http://www.undomaine.quelquepart.com/unFichier.jpg",
_root.monMC5);
// charge dans les clips - occurrence de clip utilisée en tant que cible.544 Chapitre 12 : Dictionnaire ActionScript Présentation
mon_mcl.loadClip("http://www.undomaine.quelquepart.com/unAutreFichier.jpg",
_level0.monMC3);
// charge dans _level1
mon_mcl.loadClip("fichier:///C:/media/images/uneImage.jpg", 1);

//Second ensemble d’écouteurs
var autre_mcl = new MovieClipLoader();
monEcouteur2 = new Object();
monEcouteur2.onLoadStart = function (cible_mc)
{
maTrace("*********Seconde occurrence mon_mcl*********");
maTrace ("Votre chargement a commencé sur le clip22. = " + cible_mc);
var loadProgress = mon_mcl.getProgress(cible_mc);
maTrace(loadProgress.bytesLoaded + " = octets chargés au démarrage");
maTrace(loadProgress.bytesTotal + " = total des octets au démarrage");
}
monEcouteur2.onLoadComplete = function (cible_mc)
{
maTrace("*********Seconde occurrence mon_mcl*********");
maTrace ("Votre chargement est effectué sur le clip = " + cible_mc);
var loadProgress = mon_mcl.getProgress(cible_mc);
maTrace(loadProgress.bytesLoaded + " = octets chargés à la fin");
maTrace(loadProgress.bytesTotal + " = total des octets à la fin");
}
monEcouteur2.onLoadError = function (cible_mc, codeErreur)
{
maTrace("*********Seconde occurrence mon_mcl*********");
maTrace ("CODE ERREUR = " + codeErreur);
maTrace ("Votre chargement a échoué sur le clip = " + cible_mc + "\n");
}
autre_mcl.addListener(monEcouteur2);
//Charger maintenant les fichiers dans leurs emplacements cibles (à l’aide de
la seconde occurrence de MovieClipLoader)
autre_mcl.loadClip("http://www.undomaine.quelquepart.com/
encoreUnAutreFichier.jpg", _root.monMC4);
// Activer l’instruction suivante une fois le téléchargement terminé,
// et une fois mon_mcl.onLoadInit appelé.
// mon_mcl.removeListener(monEcouteur)
// mon_mcl.removeListener(monEcouteur2)
Consultez également
MovieClipLoader.unloadClip()
MovieClipLoader.onLoadComplete()
Disponibilité
Flash Player 7.
Usage
objetDecoute.onLoadComplete() = function (cible_mc) {
// vos instructions
}
Paramètres
objetDecoute Un objet d’écoute ajouté via MovieClipLoader.addListener().MovieClipLoader.onLoadError() 545
cible_mc Le clip chargé par une méthode MovieClipLoader.loadClip().
Renvoie
Rien.
Description
Ecouteur : appelé si un fichier chargé à l’aide de MovieClipLoader.loadClip() est entièrement
téléchargé.
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
Consultez également
MovieClipLoader.addListener(), MovieClipLoader.onLoadStart(),
MovieClipLoader.onLoadError()
MovieClipLoader.onLoadError()
Disponibilité
Flash Player 7.
Usage
objetDecoute.onLoadError() = function(cible_mc, codeErreur) {
// vos instructions
}
Paramètres
objetDecoute Un objet d’écoute ajouté via MovieClipLoader.addListener().
cible_mc Le clip chargé par une méthode MovieClipLoader.loadClip().
codeErreur Une chaîne qui explique la cause de l’échec.
Renvoie
L’une des deux chaînes : « URLNotFound » ou « LoadNeverCompleted ».
Description
Ecouteur : appelé en cas d’échec du chargement d’un fichier à l’aide de
MovieClipLoader.loadClip().
La chaîne « URLNotFound » est renvoyée si ni l’écouteur MovieClipLoader.onLoadStart(), ni
l’écouteur MovieClipLoader.onLoadComplete() ne sont appelés. Par exemple, si un serveur est
en panne ou si le fichier est introuvable, ces écouteurs ne sont pas appelés.
La chaîne « LoadNeverCompleted » est renvoyée si MovieClipLoader.onLoadStart() a été
appelé, mais pas MovieClipLoader.onLoadComplete(). Par exemple, si
MovieClipLoader.onLoadStart() est appelé mais que le téléchargement est interrompu en
raison d’une surcharge du serveur, une panne du serveur, et ainsi de suite,
MovieClipLoader.onLoadComplete() n’est pas appelé.546 Chapitre 12 : Dictionnaire ActionScript Présentation
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
MovieClipLoader.onLoadInit()
Disponibilité
Flash Player 7.
Usage
objetDecoute.onLoadInit() = function (cible_mc) {
// vos instructions
}
Paramètres
objetDecoute Un objet d’écoute ajouté via MovieClipLoader.addListener().
cible_mc Le clip chargé par une méthode MovieClipLoader.loadClip().
Renvoie
Rien.
Description
Appelé si les actions sur la première image du clip chargées ont été exécutées. Une fois
MovieClipLoader.onLoadInit() appelé, vous pouvez définir les propriétés, utiliser les méthodes,
ou bien interagir avec le clip chargé.
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
Consultez également
MovieClipLoader.onLoadStart()
MovieClipLoader.onLoadProgress()
Disponibilité
Flash Player 7.
Usage
objetDecoute.onLoadProgress() =
function(cible_mc [, loadedBytes [, totalBytes ] ] ) {
// vos instructions
}
Paramètres
objetDecoute Un objet d’écoute ajouté via MovieClipLoader.addListener().
cible_mc Le clip chargé par une méthode MovieClipLoader.loadClip().
loadedBytes Le nombre d’octets chargés au moment de l’appel de l’écouteur.
totalBytes Le nombre total d’octets contenus dans le fichier en cours de chargement. MovieClipLoader.removeListener() 547
Renvoie
Rien.
Description
Ecouteur : appelé à chaque fois que le contenu de chargement est enregistré sur disque durant le
processus de chargement (à savoir, entre MovieClipLoader.onLoadStart() et
MovieClipLoader.onLoadComplete()). Vous pouvez utiliser cette méthode pour afficher des
informations concernant la progression du téléchargement, à l’aide des paramètres loadedBytes
et totalBytes.
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
Consultez également
MovieClipLoader.getProgress()
MovieClipLoader.onLoadStart()
Disponibilité
Flash Player 7.
Usage
objetDecoute.onLoadStart() = function (cible_mc) {
// vos instructions
}
Paramètres
objetDecoute Un objet d’écoute ajouté via MovieClipLoader.addListener().
cible_mc Le clip chargé par une méthode MovieClipLoader.loadClip().
Renvoie
Rien.
Description
Ecouteur : appelé si un appel de MovieClipLoader.loadClip() a commencé le téléchargement
d’un fichier.
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
Consultez également
MovieClipLoader.onLoadError(), MovieClipLoader.onLoadInit(),
MovieClipLoader.onLoadComplete()
MovieClipLoader.removeListener()
Disponibilité
Flash Player 7.548 Chapitre 12 : Dictionnaire ActionScript Présentation
Usage
mon_mcl.removeListener(objetDecoute)
Paramètres
objetDecoute Un objet d’écoute ajouté via MovieClipLoader.addListener().
Renvoie
Rien.
Description
Méthode : supprime un objet utilisé pour recevoir une notification lors de l’appel d’un
gestionnaire d’événements MovieClipLoader.
Exemple
Pour plus d’informations, consultez MovieClipLoader.loadClip().
MovieClipLoader.unloadClip()
Disponibilité
Flash Player 7.
Usage
mon_mcl.unloadClip(cible)
Paramètres
cible La chaîne ou le nombre entier passés dans l’appel correspondant à
mon_mcl.loadClip().
Renvoie
Rien.
Description
Méthode : supprime un clip chargé via MovieClipLoader.loadClip(). Si vous activez cette
commande lors du chargement d’un clip, MovieClipLoader.onLoadError() est appelé.
Consultez également
MovieClipLoader.loadClip()
NaN
Disponibilité
Flash Player 5.
Usage
NaN
Description
Variable : une variable prédéfinie avec la valeur IEEE-754 pour NaN (Not a Number). Pour
déterminer si un nombre est NaN, utilisez isNaN().Classe NetConnection 549
Consultez également
isNaN(), Number.NaN
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
Une valeur booléenne.
Description
Opérateur (comparaison) : compare expression1 avec expression2 et renvoie true si
expression1 n’est pas égale à expression2 ; sinon, renvoie false.
Consultez également
!= (inégalité)
Classe NetConnection
Disponibilité
Flash Player 7.
Remarque : Cette classe est également prise en charge dans Flash Player 6, dans le cadre d’une
utilisation avec Flash Communication Server. Pour plus d’informations, consultez la documentation
de Flash Communication Server.
Description
La classe NetConnection permet de lire des fichiers FLV en flux continu à partir d’un disque local
ou d’une adresse HTTP. Pour plus d’informations sur le flux vidéo, consultez Lecture dynamique
des fichiers FLV externes, page 205.
Résumé des méthodes de la classe NetConnection
Méthode Description
NetConnection.connect() Ouvre une connexion locale qui vous permet de lire les fichiers vidéo
(FLV) depuis une adresse HTTP ou depuis un système de fichiers
local.550 Chapitre 12 : Dictionnaire ActionScript Présentation
Constructeur pour la classe NetConnection
Disponibilité
Flash Player 7.
Remarque : Cette classe est également prise en charge dans Flash Player 6, dans le cadre d’une
utilisation avec Flash Communication Server. Pour plus d’informations, consultez la documentation
de Flash Communication Server.
Usage
new NetConnection()
Paramètres
Aucun.
Renvoie
Rien.
Description
Constructeur : crée un objet NetConnection que vous pouvez utiliser pour lire les fichiers de
diffusion en flux locaux (FLV). Après la création de l’objet NetConnection, utilisez
NetConnection.connect() pour effectuer la connexion réelle.
La lecture des fichiers FLV externes offre plusieurs avantages par rapport à l’intégration de vidéo
dans un document Flash : performances et gestion de la mémoire améliorées, indépendance des
cadences vidéo et Flash. Pour plus d’informations, consultez Lecture dynamique des fichiers FLV
externes, page 205.
Consultez également
Classe NetStream, Video.attachVideo()
NetConnection.connect()
Flash Player7.
Remarque : Cette méthode est également prise en charge dans Flash Player 6 dans le cadre d’une
utilisation avec Flash Communication Server. Pour plus d’informations, consultez la documentation
de Flash Communication Server.
Usage
mon_nc.connect(nul);
Paramètres
Aucun (vous devez passer null).
Renvoie
Rien.
Description
Ouvre une connexion locale lqui vous permet de lire les fichiers vidéo (FLV) depuis une adresse
HTTP ou depuis un système de fichiers local.Classe NetStream 551
Consultez également
Classe NetStream
Classe NetStream
Disponibilité
Flash Player 7.
Remarque : Cette classe est également prise en charge dans Flash Player 6, dans le cadre d’une
utilisation avec Flash Communication Server. Pour plus d’informations, consultez la documentation
de Flash Communication Server.
Description
La classe NetStream fournit des méthodes et des propriétés permettant de lire des fichiers Flash
Video (FLV) depuis le système de fichiers local ou une adresse HTTP. Vous devez utiliser un objet
NetStream pour diffuser en flux la vidéo via un objet NetConnection. La lecture des fichiers FLV
externes offre plusieurs avantages par rapport à l’intégration de vidéo dans un document Flash :
performances et gestion de la mémoire améliorées, indépendance des cadences vidéo et Flash.
Cette classe offre plusieurs méthodes et propriétés que vous pouvez utiliser pour suivre la
progression du fichier lors de son chargement et de sa lecture. Ces méthodes permettent en outre
à l’utilisateur de contrôler la lecture (arrêt, pause, et ainsi de suite).
Pour plus d’informations sur le flux vidéo, consultez Lecture dynamique des fichiers FLV externes,
page 205.
Résumé des méthodes de la classe NetStream
Les méthodes et propriétés suivantes des classes NetConnection et NetStream sont utilisées pour
contrôler la lecture des fichiers FLV.
Résumé des propriétés de la classe NetStream
Méthode Objectif
NetStream.close() Ferme le flux mais ne supprime pas l’objet vidéo.
NetStream.pause() Arrête ou relance la lecture d’un flux vidéo.
NetStream.play() Commence la lecture d’un fichier vidéo externe (FLV).
NetStream.seek() Recherche une position spécifique dans le fichier FLV.
NetStream.setBufferTime() Spécifie la durée de la mise en mémoire tampon des données avant le
démarrage de l’affichage du flux vidéo.
Propriété Description
NetStream.bufferLength Le nombre de secondes de données actuellement incluses dans la
mémoire tampon.
NetStream.bufferTime Lecture seule : le nombre de secondes assignées à la mémoire
tampon par NetStream.setBufferTime().
NetStream.bytesLoaded Lecture seule : le nombre d’octets de données chargées dans le
lecteur.552 Chapitre 12 : Dictionnaire ActionScript Présentation
Résumé des gestionnaires d’événement de la classe NetStream
Constructeur pour la classe NetStream
Disponibilité
Flash Player 7.
Remarque : Cette classe est également prise en charge dans Flash Player 6, dans le cadre d’une
utilisation avec Flash Communication Server. Pour plus d’informations, consultez la documentation
de Flash Communication Server.
Usage
new NetStream(mon_nc)
Paramètres
mon_nc Un objet NetConnection.
Renvoie
Rien.
Description