Forums d'entraide informatique - Astuces - Conseils

Propriété : spécifie le type du champ de texte. Il y a deux valeurs : "dynamic", qui spécifie un
champ de texte dynamique ne pouvant pas être modifié par l’utilisateur et "input", qui spécifie
un champ de texte de saisie.
Exemple
mon_txt.type = "dynamic";
TextField._url
Disponibilité
Flash Player 6.
Usage
mon_txt._url
Description
Propriété (lecture seule) : récupère l’URL du fichier SWF créateur de ce champ de texte. TextField._width 705
TextField.variable
Disponibilité
Flash Player 6.
Usage
mon_txt.variable
Description
Propriété : le nom de la variable à laquelle le champ de texte est associé. Le type de cette propriété
est String.
TextField._visible
Disponibilité
Flash Player 6.
Usage
mon_txt._visible
Description
Propriété : une valeur booléenne indiquant si le champ de texte mon_txt est visible. Les champs
de texte qui ne sont pas visibles (propriété _visible définie sur false) sont désactivés.
Consultez également
Button._visible, MovieClip._visible
TextField._width
Disponibilité
Flash Player 6.
Usage
mon_txt._width
Description
Propriété : la largeur du champ de texte, en pixels.
Exemple
L’exemple suivant définit les propriétés de hauteur et de largeur d’un champ de texte :
mon_txt._width=200;
mon_txt._height=200;
Consultez également
MovieClip._height706 Chapitre 12 : Dictionnaire ActionScript Présentation
TextField.wordWrap
Disponibilité
Flash Player 6.
Usage
mon_txt.wordWrap
Description
Propriété : une valeur booléenne indiquant si le contenu du champ de texte passe
automatiquement à la ligne. Si la valeur de wordWrap est true, le champ de texte passe
automatiquement à la ligne ; si la valeur est false, le champ de texte ne passe pas
automatiquement à la ligne.
TextField._x
Disponibilité
Flash Player 6.
Usage
mon_txt._x
Description
Propriété : un entier définissant la coordonnée x du champ de texte par rapport aux coordonnées
locales du clip parent. Si un champ de texte se trouve dans le scénario principal, son système de
coordonnées fait référence au coin supérieur gauche de la scène, comme (0, 0). Si le champ de
texte se trouve dans un clip qui a subi des transformations, le champ de texte est dans le système
de coordonnées local du clip le contenant. Donc, pour un clip ayant pivoté de 90 dans le sens
inverse des aiguilles d’une montre, le champ de texte inclus hérite d’un système de coordonnées
qui a pivoté de 90 dans le sens inverse des aiguilles d’une montre. Les coordonnées du champ de
texte font référence à la position du point d’alignement.
Consultez également
TextField._xscale, TextField._y, TextField._yscale
TextField._xmouse
Disponibilité
Flash Player 6.
Usage
mon_txt._xmouse
Description
Propriété (lecture seule) : renvoie la coordonnée x de la position de la souris par rapport au champ
de texte.
Consultez également
TextField._ymouseTextField._ymouse 707
TextField._xscale
Disponibilité
Flash Player 6.
Usage
mon_txt._xscale
Description
Propriété : détermine l’échelle horizontale (exprimée en pourcentage) du champ de texte telle
qu’elle est appliquée à partir du point d’alignement du champ de texte. Le point d’alignement par
défaut est (0,0).
Consultez également
TextField._x, TextField._y, TextField._yscale
TextField._y
Disponibilité
Flash Player 6.
Usage
mon_txt._y
Description
Propriété : la coordonnée y du champ de texte par rapport aux coordonnées locales du clip parent.
Si un champ de texte se trouve dans le scénario principal, son système de coordonnées fait
référence au coin supérieur gauche de la scène, comme (0, 0). Si le champ de texte se trouve dans
un autre clip qui a subi des transformations, le champ de texte est dans le système de coordonnées
local du clip le contenant. Donc, pour un clip ayant pivoté de 90 dans le sens inverse des aiguilles
d’une montre, le champ de texte inclus hérite d’un système de coordonnées qui a pivoté de 90
dans le sens inverse des aiguilles d’une montre. Les coordonnées du champ de texte font référence
à la position du point d’alignement.
Consultez également
TextField._x, TextField._xscale, TextField._yscale
TextField._ymouse
Disponibilité
Flash Player 6.
Usage
mon_txt._ymouse
Description
Propriété (lecture seule) : indique la coordonnée y de la position de la souris par rapport au champ
de texte.708 Chapitre 12 : Dictionnaire ActionScript Présentation
Consultez également
TextField._xmouse
TextField._yscale
Disponibilité
Flash Player 6.
Usage
mon_txt._yscale
Description
Propriété : échelle verticale (exprimée en pourcentage) du champ de texte telle qu’elle est
appliquée à partir du point d’alignement du champ de texte. Le point d’alignement par défaut est
(0,0).
Consultez également
TextField._x, TextField._xscale, TextField._y
Classe TextFormat
Disponibilité
Flash Player 6.
Description
La classe TextFormat donne les informations sur les format des caractères.
Vous devez utiliser le constructeur new TextFormat() pour créer un objet TextFormat avant d’en
appeler les méthodes.
Vous pouvez définir les paramètres de TextFormat sur null pour indiquer qu’ils ne sont pas
définis. Lorsque vous appliquez un objet TextFormat à un champ de texte à l’aide de
TextField.setTextFormat, seules ses propriétés définies sont appliquées, comme dans
l’exemple suivant :
mon_fmt = new TextFormat();
mon_fmt.bold = true;
mon_txt.setTextFormat(mon_fmt);
Ce code crée d’abord un objet TextFormat vide, avec toutes ses propriétés non définies, puis
applique la propriété bold à une valeur définie.
Le code mon_txt.setTextFormat(mon_fmt) ne modifie que la propriété bold du format de
texte par défaut du champ de texte, étant donné que la propriété bold est la seule qui soit définie
dans mon_fmt. Tous les autres aspects du format de texte par défaut du champ de texte restent
inchangés.
Lorsque TextField.getTextFormat() est invoqué, un objet TextFormat est renvoyé avec toutes
ses propriétés définies, aucune propriété ne restant null.Classe TextFormat 709
Résumé des méthodes de la classe TextFormat
Résumé des propriétés de la classe TextFormat
Constructeur pour la classe TextFormat
Disponibilité
Flash Player 6.
Usage
new TextFormat([police, [taille, [couleur, [gras, [italique, [souligné, [url,
[cible, [alignement, [margeGauche, [margeDroite, [indentation,
[espacement]]]]]]]]]]]]])
Paramètres
police Le nom d’une police pour le texte, sous forme de chaîne.
taille Un entier indiquant la taille en points.
Méthode Description
TextFormat.getTextExtent() Renvoie les informations relatives aux mesures du texte dans une
chaîne de texte.
Propriété Description
TextFormat.align Indique l’alignement d’un paragraphe.
TextFormat.blockIndent Indique l’indentation d’un bloc, en points.
TextFormat.bold Indique si le texte apparaît en gras.
TextFormat.bullet Indique si le texte fait partie d’une liste à puces.
TextFormat.color Indique la couleur du texte.
TextFormat.font Indique le nom de la police du texte avec ce format.
TextFormat.indent Indique l’indentation, de la marge gauche au premier caractère du
paragraphe.
TextFormat.italic Indique si le texte apparaît en italique.
TextFormat.leading Indique le nombre d’espaces verticaux (espacement) entre les lignes.
TextFormat.leftMargin Indique la marge gauche du paragraphe, en points.
TextFormat.rightMargin Indique la marge droite du paragraphe, en points.
TextFormat.size Indique la taille du texte, en points.
TextFormat.tabStops Spécifie des taquets de tabulation personnalisés.
TextFormat.target Indique la fenêtre de navigateur dans laquelle un hyperlien est affiché.
TextFormat.underline Indique si le texte est souligné.
TextFormat.url Indique l’URL à laquelle le texte est lié.710 Chapitre 12 : Dictionnaire ActionScript Présentation
couleur La couleur du texte utilisant ce format de texte. Un nombre contenant trois
composants RVB 8 bits ; par exemple, 0xFF0000 est le rouge, 0x00FF00 est le vert.
gras Une valeur booléenne indiquant si le texte apparaît en gras.
italique Une valeur booléenne indiquant si le texte apparaît en italique.
souligné Une valeur booléenne indiquant si le texte apparaît souligné.
url L’URL à laquelle le texte de ce format est lié. Si url est une chaîne vide, le texte n’a pas
d’hyperlien.
cible La fenêtre cible dans laquelle est affiché l’hyperlien. Si la fenêtre ciblée est une chaîne
vide, le texte est affiché dans la fenêtre cible par défaut, _self. Si le paramètre url est défini sur
une chaîne vide ou sur la valeur null, vous pouvez récupérer ou définir cette propriété, mais elle
n’aura aucun effet.
alignement L’alignement du paragraphe, représenté sous forme de chaîne. Si "left", le
paragraphe est aligné à gauche. Si "center", le paragraphe est centré. Si "right", le paragraphe
est aligné à droite.
margeGauche Indique la marge gauche du paragraphe, en points.
margeDroite Indique la marge droite du paragraphe, en points.
indentation Un entier indiquant l’indentation de la marge gauche au premier caractère du
paragraphe.
espacement Un nombre indiquant l’espace séparant les lignes.
Renvoie
Rien.
Description
Constructeur : crée un objet TextFormat avec les propriétés spécifiées. Vous pouvez ensuite
changer les propriétés de l’objet TextFormat pour changer le formatage des champs de texte.
N’importe quel paramètre peut être défini sur la valeur null pour indiquer qu’il n’est pas défini.
Tous les paramètres sont facultatifs, tous les paramètres omis étant considérés comme null.
TextFormat.align
Disponibilité
Flash Player 6.
Usage
mon_fmt.align
Description
Propriété : indique l’alignement du paragraphe, représenté sous forme de chaîne. L’alignement du
paragraphe, représenté sous forme de chaîne. Si "left", le paragraphe est aligné à gauche. Si
"center", le paragraphe est centré. Si "right", le paragraphe est aligné à droite. La valeur par
défaut est null, qui indique que la propriété n’est pas définie.TextFormat.color 711
TextFormat.blockIndent
Disponibilité
Flash Player 6.
Usage
mon_fmt.blockIndent
Description
Propriété : un nombre qui indique l’indentation d’un bloc, en points. L’indentation de bloc est
appliquée à un bloc de texte entier ; c’est-à-dire, à toutes les lignes du texte. A l’inverse,
l’indentation normale (TextFormat.indent) affecte seulement la première ligne de chaque
paragraphe. Si cette propriété est null, l’objet TextFormat ne spécifie pas d’indentation de bloc.
TextFormat.bold
Disponibilité
Flash Player 6.
Usage
mon_fmt.bold
Description
Propriété : une valeur booléenne indiquant si le texte apparaît en gras. La valeur par défaut est
null, qui indique que la propriété n’est pas définie.
TextFormat.bullet
Disponibilité
Flash Player 6.
Usage
mon_fmt.bullet
Description
Propriété : une valeur booléenne indiquant si le texte fait partie d’une liste à puces. Dans une liste
à puces, chaque paragraphe de texte est indenté. Un symbole de puce est affiché à gauche de la
première ligne de chaque paragraphe. La valeur par défaut est null.
TextFormat.color
Disponibilité
Flash Player 6.
Usage
mon_fmt.color712 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Propriété : indique la couleur du texte. Un nombre contenant trois composants RVB 8 bits ; par
exemple, 0xFF0000 est le rouge, 0x00FF00 est le vert.
TextFormat.font
Disponibilité
Flash Player 6.
Usage
mon_fmt.font
Description
Propriété : le nom de la police pour le texte dans ce format de texte, sous forme de chaîne. La
valeur par défaut est null, qui indique que la propriété n’est pas définie.
TextFormat.getTextExtent()
Disponibilité
Flash Player 6. Le paramètre facultatif width est supporté dans Flash Player 7.
Usage
mon_fmt.getTextExtent(texte, [largeur])
Paramètres
texte Une chaîne.
largeur Un nombre facultatif représentant la largeur, en pixels, à partir de laquelle le texte
spécifié doit faire un retour à la ligne.
Renvoie
Un objet avec les propriétés width, height, ascent, descent, textFieldHeight et
textFieldWidth.
Description
Méthode : renvoie les informations concernant les mesures du texte de la chaîne de texte texte au
format spécifié par mon_fmt. La chaîne texte est considéré comme un texte ordinaire (et non
HTML).
La méthode renvoie un objet avec six propriétés : ascent, descent,width, height,
textFieldHeight et textFieldWidth. Toutes les mesures sont indiquées en pixels.
Si un paramètre width est spécifié, l’habillage du texte est appliqué au texte spécifié. Cela permet
de déterminer la hauteur à laquelle le champ de texte affiche la totalité du texte spécifié.
Les mesures ascent et descent fournissent respectivement la distance au-dessus et au-dessous de
la ligne de base d’une ligne de texte. La ligne de base de la première ligne de texte est positionnée
à l’origine du champ de texte à laquelle est additionnée sa mesure ascent.TextFormat.getTextExtent() 713
Les mesures width et height fournissent la largeur et la hauteur de la chaîne de texte. Les mesures
textFieldHeight et textFieldWidth indiquent la hauteur et la largeur requises d’un objet
champ de texte pour afficher la totalité de la chaîne de texte. Les champs de texte sont entourés
d’une bordure large de deux pixels. Ainsi, la valeur textFieldHeight est égale à la valeur height
+ 4 ; de même, la valeur textFieldWidth est toujours égale à la valeur width + 4.
Si vous créez un champ de texte sur la base métrique, utilisez textFieldHeight plutôt que
height et textFieldWidth plutôt que width.
L’illustration ci-dessous répertorie ces différentes mesures.
Lorsque vous définissez un objet TextFormat, veillez à ce que l’ensemble des attributs soient
identiques à ceux du champ de texte, notamment la police, la taille de police et l’espacement. La
valeur par défaut de l’espacement est 2.
Exemple
Cet exemple crée un champ de texte d’une ligne juste assez grand pour afficher une chaîne de
texte au format spécifié.
var texte = "Petite chaîne";
// Créer un objet TextFormat
// et appliquer ses propriétés.
var txt_fmt = new TextFormat();
with(txt_fmt) {
font = "Arial";
bold = true;
}
// Obtenir des informations métriques sur la chaîne de texte
// avec le format spécifié.
var métrique = txt_fmt.getTextExtent(text);
// Créer un champ de texte juste assez grand pour afficher le texte.
this.createTextField ("champDeTexte", 0, 100, 100, métrique.textFieldWidth,
métrique.textFieldHeight);
champDeTexte.border = true;
champDeTexte.wordWrap = true;714 Chapitre 12 : Dictionnaire ActionScript Présentation
// Affecter la même chaîne de texte et
// l’objet TextFormat à l’objet TextField.
champDeTexte.text = text;
champDeTexte.setTextFormat(txt_fmt);
L’exemple suivant crée un champ de texte de plusieurs lignes, large de 100 pixels, dont la taille
permet d’afficher une chaîne au format spécifié.
// Créer un objet TextFormat.
var txt_fmt:TextFormat= new TextFormat();
// Spécifier les propriétés du format pour l’objet TextFormat :
txt_fmt.font = "Arial";
txt_fmt.bold = true;
txt_fmt.leading = 4;
// La chaîne de texte à afficher
var texteAAfficher:String = "Macromedia Flash 7, à présent disponible avec des
mesures métriques de texte améliorées.";
// Obtenir les informations relatives aux mesures du texte pour la chaîne,
// retour à la ligne à 100 pixels.
var métrique:Object = txt_fmt.getTextExtent(texteAAfficher, 100);
// Créer un nouvel objet TextField à l’aide des
// informations métriques obtenues.
this.createTextField ("champDeTexte", 0, 50, 50-metrics.ascent, 100,
métrique.textFieldHeight)
champDeTexte.wordWrap = true;
champDeTexte.border = true;
// Affecter le texte et l’objet TextFormat à TextObject :
champDeTexte.text = texteAAfficher;
champDeTexte.setTextFormat(unFormat);
TextFormat.indent
Disponibilité
Flash Player 6.
Usage
mon_fmt.indent
Description
Propriété : un entier indiquant l’indentation de la marge gauche au premier caractère du
paragraphe. La valeur par défaut est null, qui indique que la propriété n’est pas définie.
Consultez également
TextFormat.blockIndent
TextFormat.italic
Disponibilité
Flash Player 6.
Usage
mon_fmt.italicTextFormat.size 715
Description
Propriété : une valeur booléenne indiquant si le texte dans ce format de texte apparaît en italique.
La valeur par défaut est null, qui indique que la propriété n’est pas définie.
TextFormat.leading
Disponibilité
Flash Player 6.
Usage
mon_fmt.leading
Description
Propriété : nombre d’espaces verticaux (espacement) entre les lignes. La valeur par défaut est null,
qui indique que la propriété n’est pas définie.
TextFormat.leftMargin
Disponibilité
Flash Player 6.
Usage
mon_fmt.leftMargin
Description
Propriété : la marge gauche du paragraphe, en points. La valeur par défaut est null, qui indique
que la propriété n’est pas définie.
TextFormat.rightMargin
Disponibilité
Flash Player 6.
Usage
mon_fmt.rightMargin
Description
Propriété : la marge droite du paragraphe, en points. La valeur par défaut est null, qui indique
que la propriété n’est pas définie.
TextFormat.size
Disponibilité
Flash Player 6.
Usage
mon_fmt.size716 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Propriété : la taille, en points, du texte de ce format. La valeur par défaut est null, qui indique
que la propriété n’est pas définie.
TextFormat.tabStops
Disponibilité
Flash Player 6.
Usage
mon_fmt.tabStops
Description
Propriété : spécifie des arrêts de tabulation personnalisés, sous forme d’un tableau d’entiers non
négatifs. Chaque arrêt de tabulation est spécifié en points. Si des arrêts de tabulation personnalisés
ne sont pas spécifiés (null), l’arrêt de tabulation par défaut est 4 (largeur de caractère moyenne).
TextFormat.target
Disponibilité
Flash Player 6.
Usage
mon_fmt.target
Description
Propriété : indique la fenêtre cible dans laquelle est affiché l’hyperlien. Si la fenêtre ciblée est une
chaîne vide, le texte est affiché dans la fenêtre cible par défaut, _self. Si la propriété
TextFormat.url est une chaîne vide ou null, vous pouvez obtenir ou définir cette propriété,
mais elle n’aura aucun effet.
TextFormat.underline
Disponibilité
Flash Player 6.
Usage
mon_fmt.underline
Description
Propriété : une valeur booléenne qui indique si le texte utilisant le format est souligné (true) ou
non (false). Ce soulignement est semblable à celui appliqué par la balise <U>, qui n’est pas un
« véritable » soulignement étant donné qu’il ne saute pas correctement les jambages. La valeur par
défaut est null, qui indique que la propriété n’est pas définie.objet TextSnapshot 717
TextFormat.url
Disponibilité
Flash Player 6.
Usage
mon_fmt.url
Description
Propriété : indique l’URL à laquelle le texte de ce format est lié. Si la propriété url est une chaîne
vide, le texte n’a pas d’hyperlien. La valeur par défaut est null, qui indique que la propriété n’est
pas définie.
objet TextSnapshot
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.
Description
Les objets TextSnapshot vous permettent d’utiliser du texte statique dans un clip. Vous pouvez les
utiliser, par exemple, pour positionner le texte avec une plus grande précision que celle autorisée
par le texte dynamique, mais le texte n’est toujours accessible qu’en mode lecture seule.
N’utilisez pas un constructeur pour créer un objet TextSnapshot ; il est renvoyé par
MovieClip.getTextSnapshot().
Résumé des méthodes de l’objet TextSnapshot
Méthode Description
TextSnapshot.findText() Renvoie la position de la première occurrence de texte
spécifié.
TextSnapshot.getCount() Renvoie le nombre de caractères.
TextSnapshot.getSelected() Spécifie si une partie du texte de la plage spécifiée a été
sélectionnée par TextSnapshot.setSelected().
TextSnapshot.getSelectedText() Renvoie une chaîne qui contient tous les caractères spécifiés
par TextSnapshot.setSelected().
TextSnapshot.getText() Renvoie une chaîne contenant les caractères de la plage
spécifiée.
TextSnapshot.hitTestTextNearPos() Vous permet de déterminer quel caractère de l’objet se
trouve sur ou près des coordonnées spécifiées.718 Chapitre 12 : Dictionnaire ActionScript Présentation
TextSnapshot.findText()
Disponibilité
Programmation : Flash MX 2004.
Lecture : Fichiers SWF publiés pour Flash Player 6 ou ultérieur, lus dans Flash Player 7 ou
ultérieur.
Usage
maCapture.findText( indexDebut, texteArechercher, sensibleAlaCasse )
Paramètres
indexDebut Un entier spécifiant le point de départ dans maCapture à partir duquel effectuer la
recherche du texte spécifié.
texteArechercher Une chaîne spécifiant le texte à rechercher. Si vous spécifiez une chaîne
littérale plutôt qu’une variable de type String, mettez la chaîne entre guillemets.
sensibleAlaCasse Une valeur booléenne spécifiant si le texte dans mon_snap doit
correspondre à la casse de la chaîne dans texteArechercher.
Renvoie
La position de l’index basé sur zéro de la première occurrence du texte spécifié ou -1.
Description
Méthode : recherche l’objet TextSnapshot spécifié et renvoie la position de la première occurrence
de texteArechercher trouvée au niveau de ou après indexDébut. Si texteArechercher n’est
pas trouvé, la méthode renvoie -1.
Consultez également
TextSnapshot.getText()
TextSnapshot.getCount()
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
maCapture.getCount()
TextSnapshot.setSelectColor() Spécifie la couleur à utiliser lors de la mise en surbrillance des
caractères qui ont été sélectionnés avec la commande
TextSnapshot.setSelected().
TextSnapshot.setSelected() Spécifie une plage de caractères à sélectionner ou à
désélectionner.
Méthode DescriptionTextSnapshot.getSelected() 719
Paramètres
Aucun.
Renvoie
Un entier représentant le nombre de caractères dans l’objet TextSnapshot spécifié.
Description
Méthode : renvoie le nombre de caractères dans un objet TextSnapshot.
Consultez également
TextSnapshot.getText()
TextSnapshot.getSelected()
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
maCapture.getSelected(de, a)
Paramètres
de Un entier indiquant la position du premier caractère de maCapture à examiner. Les valeurs
valides pour de sont comprises entre 0 etTextSnapshot.getCount()- 1. Si de est une valeur
négative, 0 est utilisé.
a Un entier égal à 1+ l’index du dernier caractère de maCapture à examiner. Les valeurs valides
pour à sont comprises entre 0 et TextSnapshot.getCount(). Le caractère indexé par le
paramètre a n’est pas inclus dans la chaîne extraite. Si ce paramètre est omis,
TextSnapshot.getCount() est utilisé. Si cette valeur est inférieure ou égale à la valeur de de,
de+1 est utilisé.
Renvoie
Une valeur booléenne true, si au moins un caractère de la plage donnée a été sélectionné par la
commande TextSnapshot.setSelected() correspondante, false dans les autres cas.
Description
Méthode : renvoie une valeur booléenne spécifiant si un objet TextSnapshot contient le texte
sélectionné dans la plage spécifiée.
Pour rechercher tous les caractères, affectez une valeur de 0 à de et une valeur
TextSnapshot.getCount() (ou tout nombre très grand) à a. Pour rechercher un caractère
unique, affectez une valeur de de+1 à a.
Consultez également
TextSnapshot.getSelectedText(), TextSnapshot.getText()720 Chapitre 12 : Dictionnaire ActionScript Présentation
TextSnapshot.getSelectedText()
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
maCapture.getSelectedText( [ inclureFinsDeLigne ] )
Paramètres
inclureFinsDeLigne Une valeur booléenne facultative spécifiant si les caractères newline sont
insérés dans la chaîne renvoyée, à l’emplacement approprié. La valeur par défaut est false.
Renvoie
Une chaîne contenant tous les caractères spécifiés par la commande
TextSnapshot.setSelected() correspondante.
Description
Méthode : renvoie une chaîne contenant tous les caractères spécifiés par la commande
TextSnapshot.setSelected() correspondante. Si aucun caractère n’est sélectionné, une chaîne
vide est renvoyée.
Si vous affectez une valeur true à inclureFinsDeLigne, les caractères newline sont insérés dans
la chaîne renvoyée à l’emplacement jugé approprié. Dans ce cas, la chaîne renvoyée peut être plus
longue que la plage saisie. Si inclureFinsDeLigne est défini sur false ou omis, le texte
sélectionné est renvoyé sans que des caractères soient ajoutés.
Consultez également
TextSnapshot.getSelected()
TextSnapshot.getText()
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
maCapture.getText(de, a [, inclureFinsDeLigne ] )
Paramètres
de Un entier indiquant la position du premier caractère de maCapture à inclure dans la chaîne
renvoyée. Les valeurs valides pour de sont comprises entre 0 et TextSnapshot.getCount()- 1.
Si de est une valeur négative, 0 est utilisé.TextSnapshot.hitTestTextNearPos() 721
a Un entier étant égal à 1+ l’index du dernier caractère de maCapture à examiner. Les valeurs
valides pour à sont comprises entre 0 et TextSnapshot.getCount(). Le caractère indexé par le
paramètre a n’est pas inclus dans la chaîne extraite. Si ce paramètre est omis,
TextSnapshot.getCount() est utilisé. Si cette valeur est inférieure ou égale à la valeur de de,
de+1 est utilisé.
inclureFinsDeLigne Une valeur booléenne facultative spécifiant si les caractères newline sont
insérés dans la chaîne renvoyée, à l’emplacement approprié. La valeur par défaut est false.
Renvoie
Une chaîne contenant les caractères de la plage spécifiée ou une chaîne vide si aucun caractère n’a
été trouvé dans cette plage.
Description
Méthode : renvoie une chaîne contenant tous les caractères spécifiés par les paramètres de et a. Si
aucun caractère n’est sélectionné, une chaîne vide est renvoyée.
Pour renvoyer tous les caractères, affectez une valeur de 0 pour de et TextSnapshot.getCount()
(ou tout nombre très grand) pour a. Pour renvoyer un caractère unique, affectez une valeur de+1
à a.
Si vous affectez une valeur true à inclureFinsDeLigne, les caractères newline sont insérés dans
la chaîne renvoyée à l’emplacement jugé approprié. Dans ce cas, la chaîne renvoyée peut être plus
longue que la plage saisie. Si inclureFinsDeLigne est défini sur false ou omis, le texte
sélectionné est renvoyé sans que des caractères soient ajoutés.
Consultez également
TextSnapshot.getSelectedText()
TextSnapshot.hitTestTextNearPos()
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
maCapture.hitTestTextNearPos(x, y [, distanceMax] )
Paramètres
x Un nombre qui représente la coordonnée x du clip contenant le texte de maCapture.
y Un nombre qui représente la coordonnée y du clip contenant le texte de maCapture.
distanceMax Un nombre facultatif qui représente la distance maximale depuis x, y pour
laquelle le texte est recherché. La distance est mesurée à partir du point central de chaque
caractère. La valeur par défaut est 0.
Renvoie
Un entier représentant la valeur d’index du caractère de maCapture qui est la plus proche des
coordonnées x, y spécifiées, ou -1 si aucun caractère n’est trouvé.722 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Méthode : vous permet de déterminer quel caractère d’un objet TextSnapshot se trouve sur ou
près des coordonnées x, y spécifiées pour le clip contenant le texte de maCapture.
Si vous omettez la valeur ou définissez distanceMax sur 0, l’emplacement spécifié par les
coordonnées x, y doit se trouver à l’intérieur du cadre de délimitation de maCapture.
Consultez également
MovieClip.getTextSnapshot(), MovieClip._x, MovieClip._y
TextSnapshot.setSelectColor()
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
maCapture.setSelectColor(CouleurHexa);
Paramètres
CouleurHexa La couleur utilisée pour la bordure placée autour des caractères sélectionnés par la
commande TextSnapshot.setSelected() correspondante, exprimée au format 0xRRGGBB.
Renvoie
Rien.
Description
Méthode : spécifie la couleur à utiliser lors de la mise en surbrillance des caractères qui ont été
sélectionnés avec la commande TextSnapshot.setSelected(). La couleur est toujours opaque ;
vous ne pouvez pas spécifier une valeur de transparence.
TextSnapshot.setSelected()
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
maCapture.setSelected(de, a, selection)
Paramètres
de Un entier indiquant la position du premier caractère de maCapture à sélectionner. Les
valeurs valides pour de sont comprises entre 0 et TextSnapshot.getCount()- 1. Si de est une
valeur négative, 0 est utilisé.this 723
a Un entier étant égal à 1+ l’index du dernier caractère de maCapture à examiner. Les valeurs
valides pour à sont comprises entre 0 et TextSnapshot.getCount(). Le caractère indexé par le
paramètre a n’est pas inclus dans la chaîne extraite. Si ce paramètre est omis,
TextSnapshot.getCount() est utilisé. Si cette valeur est inférieure ou égale à la valeur de de,
de+1 est utilisé.
selection Une valeur booléenne indiquant si le texte doit être sélectionné (true) ou
désélectionné (false).
Renvoie
Rien.

Description
Instruction : utilisée pour déclarer les variables locales ou du scénario.
• Si vous déclarez les variables dans une fonction, les variables sont locales. Elles sont définies
pour la fonction et expirent à la fin de l’appel de la fonction.
• Si les variables ne sont pas déclarées au sein d’un bloc ({}), mais que la liste d’actions a été
exécutée avec une action call(), les variables sont locales et expirent à la fin de la liste
courante.
• Si les variables ne sont pas déclarées au sein d’un bloc et que la liste des actions courantes n’a
pas été exécutée avec l’action call(), ces variables sont interprétées en tant que variables de
scénario. Vous n’avez pas à utiliser var pour déclarer les variables de scénario.
Vous ne pouvez pas déclarer une variable dont le domaine inclut un autre objet en tant que
variable locale :
mon_array.length = 25;     // ok
var mon_array.length = 25; // erreur de syntaxe
Si vous utilisez var, vous pouvez taper la variable de manière stricte ; voir Typage strict des données,
page 40
Remarque : Les classes définies dans les scripts externes prennent aussi en charge les étendues
des variables publiques, privées et statiques. Consultez le Chapitre 9, Création de classes avec
ActionScript 2.0, page 161 et private, public et static.
Classe Video
Disponibilité
Flash Player 6 ; la fonction de lecture des fichiers Flash Video (FLV) a été rajoutée dans
Flash Player 7.
Description
La classe Video vous permet d’afficher une vidéo en continu en direct sur la scène sans l’intégrer
dans votre fichier SWF. Vous capturez la vidéo en utilisant Camera.get(). Dans les fichiers
publiés pour Flash Player 7 et les versions ultérieures, vous pouvez également utiliser la classe
Video pour lire les fichiers Flash Video (FLV) à partir d’un serveur HTTP ou du système de
fichiers local. Pour plus d’informations, consultez Lecture dynamique des fichiers FLV externes,
page 205, Classe NetConnection et Classe NetStream.
Vous pouvez utiliser un objet Video comme un clip. Comme pour les autres objets placés dans la
scène, vous pouvez contrôler les différentes propriétés des objets Video. Par exemple, vous pouvez
déplacer l’objet Video autour de la scène à l’aide de ses propriétés _x et _y ; vous pouvez
également le redimensionner à l’aide de ses propriétés _height et _width.
Pour afficher le flux vidéo, placez dans un premier temps un objet Video sur la scène. Ensuite,
utilisez Video.attachVideo() pour rattacher le flux vidéo à l’objet Video. 736 Chapitre 12 : Dictionnaire ActionScript Présentation
Pour placer un objet Video sur la scène :
1 Si le panneau Bibliothèque n’est pas visible, sélectionnez Fenêtre > Bibliothèque pour l’afficher.
2 Ajoutez un objet Video intégrée à la bibliothèque en cliquant sur le menu d’options situé à
droite de la barre de titre du panneau Bibliothèque et en sélectionnant Nouvelle vidéo.
3 Déplacez l’objet Video sur la scène et servez-vous de l’inspecteur des propriétés pour lui
attribuer un nom d’occurrence unique tel que ma_video. (Ne l’appelez pas Video.)
Résumé des méthodes de la classe Video
Résumé des propriétés de la classe Video
Video.attachVideo()
Disponibilité
Flash Player 6 ; la possibilité de travailler avec les fichiers Flash Video (FLV) a été rajoutée dans
Flash Player 7.
Usage
ma_video.attachVideo(source)
Paramètres
source Un objet Camera qui capture les données vidéo ou un objet NetStream. Pour
interrompre la connexion à l’objet Video, choisissez null pour source.
Renvoie
Rien.
Description
Méthode : spécifie un flux vidéo (source) à afficher dans les limites de l’objet Video sur la scène.
Le flux vidéo est un fichier FLV en cours d’affichage via la commande NetStream.play(), un
objet Camera ou null. Si source est null, la vidéo n’est plus lue dans l’objet Video.
Méthode Description
Video.attachVideo() Spécifie un flux vidéo à afficher dans les limites de l’objet Video sur la scène.
Video.clear() Efface l’image courante affichée dans l’objet Video.
Propriété Description
Video.deblocking Spécifie le comportement du filtre de déblocage que le compresseur vidéo
applique, lorsque cela est nécessaire, à la lecture de la vidéo.
Video.height Lecture seule ; la hauteur du flux vidéo, en pixels.
Video.smoothing Spécifie si la vidéo doit être lissée (interpolée) lorsqu’elle est
redimensionnée.
Video.width Lecture seule ; la largeur du flux vidéo, en pixels.Video.deblocking 737
Vous n’avez pas besoin d’utiliser cette méthode si le fichier FLV contient uniquement des données
audio ; la partie audio d’un fichier FLV est lue automatiquement lorsque la commande
NetStream.play() est activée.
Pour contrôler les données audio associées à un fichier FLV, vous pouvez utiliser la méthode
MovieClip.attachAudio() pour acheminer ces données vers le clip ; vous pouvez ensuite créer
un objet Sound pour contrôler certains aspects de ces données audio. Pour plus d’informations,
consultez MovieClip.attachAudio().
Exemple
L’exemple suivant lit localement une vidéo en direct.
ma_cam = Camera.get();
ma_video.attachVideo(ma_cam); // ma_video est un objet Video sur la scène
L’exemple suivant montre la lecture d’un fichier précédemment enregistré nommé maVidéo.flv,
stocké dans le même dossier que le fichier SWF.
var nc:NetConnection = new NetConnection();
nc.connect(null);
var ns:NetStream = new NetStream(mon_nc);
ma_video.attachVideo(ns); // ma_video est un objet Video sur la scène
ns.play("myVideo.flv");
Consultez également
Classe Camera, Classe NetStream
Video.clear()
Disponibilité
Flash Player 6.
Usage
ma_video.clear()
Paramètres
Aucun.
Renvoie
Rien.
Description
Méthode : efface l’image courante affichée dans l’objet Video. Cela est utile, par exemple, si vous
voulez afficher des informations en attente sans masquer l’objet Video.
Consultez également
Video.attachVideo()
Video.deblocking
Disponibilité
Flash Player 6.738 Chapitre 12 : Dictionnaire ActionScript Présentation
Usage
ma_video.deblocking
ma_video.deblocking = paramètre
Description
Propriété : spécifie le comportement du filtre de déblocage que le compresseur vidéo applique,
lorsque cela est nécessaire, à la lecture de la vidéo. Les valeurs suivantes sont acceptables pour
paramètre :
• 0 (valeur par défaut) : Laisse le compresseur vidéo appliquer le filtre de déblocage lorsque cela
est nécessaire.
• 1 : N’utilise jamais le filtre de déblocage.
• 2 : Utilise toujours le filtre de déblocage.
Le filtre de déblocage a un effet sur l’ensemble de la performance de la lecture et il n’est
généralement pas nécessaire avec la vidéo à large bande. Si votre système n’est pas assez puissant,
vous pourriez rencontrer des difficultés lors de la lecture de la vidéo lorsque le filtre est activé.
Video.height
Disponibilité
Flash Player 6.
Usage
ma_video.height
Description
Propriété lecture seule ; un entier spécifiant la hauteur du flux vidéo, en pixels. Pour les flux vidéo
en direct, cette valeur est identique à la propriété Camera.height de l’objet Camera qui capture le
flux vidéo. Pour les fichiers FLV, cette valeur correspond à la hauteur du fichier exporté en tant
que fichier FLV.
Cette propriété peut vous servir, par exemple, à vous assurer que l’utilisateur regarde une vidéo
dont la taille correspond à la taille de la vidéo au moment de sa capture, quelle que soit la taille
réelle de l’objet Video sur la scène.
Exemple
Usage 1 : L’exemple suivant montre la définition des valeurs de hauteur et de largeur de l’objet
Video, en fonction des valeurs d’un fichier FLV. Vous devez appeler ce code après l’invocation de
NetStream.onStatus, lorsque la propriété code est définie sur NetStream.Buffer.Full. Si
vous appelez ce code alors que valeur de la propriété code est NetStream.Play.Start, les valeurs
de hauteur et de largeur sont 0, car l’objet Video n’a pas encore la hauteur et la largeur du fichier
FLV chargé.
// Clip est le nom d’occurrence du clip
// qui contient l’objet vidéo "ma_vidéo".
_root.Clip._width = _root.Clip.ma_video.width;
_root.Clip._height = _root.Clip.ma_video.height;
Usage 2 : L’exemple suivant permet à l’utilisateur d’appuyer sur un bouton pour ajuster la hauteur
et la largeur d’un flux vidéo affiché dans Flash Player avec une hauteur et une largeur égales à
celles de la vidéo lorsqu’elle a été capturée. void 739
on (release) {
_root.ma_video._width = _root.ma_video.width
_root.ma_video._height = _root.ma_video.height
}
Consultez également
MovieClip._height, Video.width
Video.smoothing
Disponibilité
Flash Player 6.
Usage
ma_video.smoothing
Description
Propriété : une valeur booléenne spécifiant si la vidéo doit être lissée (interpolée) lorsqu’elle est
redimensionnée. Pour que le lissage fonctionne, le lecteur doit être en mode haute qualité. La
valeur par défaut est false (aucun lissage).
Video.width
Disponibilité
Flash Player 6.
Usage
ma_video.width
Description
Propriété lecture seule ; un entier spécifiant la largeur du flux vidéo, en pixels. Pour les flux vidéo
en direct, cette valeur est identique à la propriété Camera.width de l’objet Camera qui capture le
flux vidéo. Pour les fichiers FLV, cette valeur correspond à la largeur du fichier exporté en tant que
fichier FLV.
Cette propriété peut vous servir, par exemple, à vous assurer que l’utilisateur regarde une vidéo
dont la taille correspond à la taille de la vidéo au moment de sa capture, quelle que soit la taille
réelle de l’objet Video sur la scène.
Exemple
Consultez les exemples pour Video.height.
void
Disponibilité
Flash Player 5.
Usage
void (expression)740 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Opérateur ; un opérateur unaire qui supprime la valeur expression et renvoie une valeur
indéfinie. L’opérateur void est généralement utilisé dans les comparaisons avec l’opérateur ==
pour tester des valeurs indéfinies.
while
Disponibilité
Flash Player 4.
Usage
while(condition) {
instruction(s);
}
Paramètres
condition Expression réévaluée chaque fois que l’action while est exécutée.
instruction(s) Les instructions à exécuter si la condition est évaluée comme true.
Renvoie
Rien.
Description
Instruction ; teste une expression et exécute une instruction ou une série d’instructions de
manière répétée dans une boucle aussi longtemps que l’expression est true.
La condition est testée avant l’exécution du bloc d’instructions : si le test renvoie true, le bloc
d’instructions est exécuté. Si la condition est false, le bloc d’instructions est ignoré et la première
instruction se trouvant après le bloc d’instructions de l’action while est exécutée.
La boucle est souvent utilisée pour répéter une action tant qu’une variable de compteur est
inférieure à une valeur spécifiée. Le compteur est incrémenté à la fin de chaque boucle, jusqu’à ce
que la valeur spécifiée soit atteinte. A ce moment-là, la condition n’est plus true et la boucle se
termine.
L’instruction while effectue la série d’étapes suivante. Chaque répétition des étapes 1–4 est
appelée une itération de la boucle. La condition est retestée au début de chaque itération, comme
dans les étapes suivantes :
1 L’expression condition est évaluée.
2 Si condition est true ou une valeur qui donne lieu par conversion à la valeur booléenne true,
comme un nombre non nul, passez à l’étape 3.
Sinon, l’instruction while est terminée et l’exécution continue à partir de l’instruction qui suit
la boucle while.
3 Exécutez le bloc d’instructions instruction(s).
4 Passez à l’étape 1.
Consultez également
do while, continue, for, for..inwith 741
with
Disponibilité
Flash Player 5.
Usage
with (objet) {
instruction(s);
}
Paramètres
objet Une occurrence d’un objet ActionScript ou d’un clip.
instruction(s) Une action ou un groupe d’actions renfermées dans des accolades.
Renvoie
Rien.
Description
Instruction : permet de spécifier un objet (un clip, par exemple) à l’aide du paramètre object et
d’évaluer des expressions et des actions à l’intérieur de cet objet avec le paramètre
instruction(s). Cela vous évite d’avoir à rédiger de façon répétée le nom de l’objet ou le
chemin de l’objet.
Le paramètre object devient le contexte dans lequel les propriétés, les variables et les fonctions de
instruction(s) sont lues. Par exemple, si objet est mon_array et si deux des propriétés
spécifiées sont length et concat, ces propriétés sont automatiquement lues comme
mon_array.length et mon_array.concat. Dans un autre exemple, si objet est
state.california, les actions ou instructions au sein de l’action with sont appelées depuis
l’occurrence california.
Pour trouver la valeur d’un identifiant dans le paramètre instruction(s), ActionScript démarre
au début de la chaîne de portée spécifiée par objet et recherche l’identifiant à chaque niveau de la
chaîne de portée, dans un ordre spécifique.
La chaîne de portée utilisée par l’action with pour traduire les identifiants commence par le
premier élément de la liste suivante et continue jusqu’au dernier :
• L’objet spécifié dans le paramètre objet est l’action with la plus intérieure.
• L’objet spécifié dans le paramètre objet est l’action with la plus extérieure.
• L’objet Activation. Un objet temporaire créé automatiquement lorsqu’une fonction est appelée
et qui contient les variables locales appelées dans la fonction.
• Le clip contenant le script en cours d’exécution.
• L’objet Global (des objets intégrés tels que Math et String).
Pour définir une variable dans une action with, la variable doit avoir été déclarée à l’extérieur de
l’action with ou vous devez entrer le chemin complet du scénario dans lequel vous souhaitez que
la variable existe. Si vous définissez une variable dans une action with sans l’avoir déclarée,
l’action with cherche la valeur selon la chaîne de plage. Si la variable n’existe pas déjà, la nouvelle
valeur sera définie dans le scénario à partir duquel l’action with a été appelée.742 Chapitre 12 : Dictionnaire ActionScript Présentation
Dans Flash 5 ou ultérieur, l’action with remplace l’action tellTarget. Nous vous
recommandons d’utiliser with au lieu de tellTarget, étant donné qu’il s’agit d’une extension
ActionScript standard de la norme ECMA-262. La principale différence entre les actions with et
tellTarget réside dans le fait que with utilise comme paramètre une référence à un clip ou à un
autre objet, tandis que tellTarget utilise une chaîne de chemin cible qui identifie un clip et ne
peut pas être utilisée pour cibler des objets.
Exemple
L’exemple suivant définit les propriétés _x et _y de l’occurrence autre_mc et indique ensuite à
autre_mc d’atteindre l’image 3 et de s’arrêter.
with (autre_mc) {
_x = 50;
_y = 100;
gotoAndStop(3);
}
Le fragment de code suivant montre comment vous auriez pu rédiger le code précédent sans
utiliser l’action with.
autre_mc._x = 50;
autre_mc._y = 100;
autre_mc.gotoAndStop(3);
Vous pourriez également rédiger ce code en utilisant l’action tellTarget. Cependant, si
autre_mc n’était pas un clip, mais un objet, vous ne pouvez pas utiliser l’action with.
tellTarget ("autre_mc") {
_x = 50;
_y = 100;
gotoAndStop(3);
}
L’action with est utile pour accéder simultanément à plusieurs éléments dans une liste de chaînes
de portée. Dans l’exemple suivant, l’objet intégré Math est placé au début de la chaîne de plage. La
définition de Math comme objet par défaut traduit les identifiants cos, sin et PI en Math.cos,
Math.sin et Math.PI, respectivement. Les identifiants a, x, y et r ne sont pas des méthodes ou
des propriétés de l’objet Math, mais puisqu’elles existent dans la plage d’activation d’objet de la
fonction polaire(), elles se traduisent en variables locales correspondantes.
function polaire(r) {
var a, x, y;
with (Math) {
a = PI * r * r;
x = r * cos(PI);
y = r * sin(PI/2);
}
trace("aire  = " +a);
trace("x = " + x);
trace("y = " + y);
}
Vous pouvez utiliser des actions with imbriquées pour accéder aux informations de plusieurs
portées. Dans l’exemple suivant, l’occurrence fresno et l’occurrence salinas sont les enfants de
l’occurrence california. L’instruction définit les valeurs _alpha de fresno et salinas sans
changer la valeur _alpha de california.
with (california){
with (fresno){Classe XML 743
_alpha = 20;
}
with (salinas){
_alpha = 40;
}
}
Consultez également
tellTarget
Classe XML
Disponibilité
Flash Player 5 (est devenu un objet natif dans Flash Player 6, améliorant ainsi les performances de
manière significative).
Description
Utilisez les méthodes et les propriétés de la classe XML pour charger, analyser, envoyer, construire
et manipuler des arborescences de documents XML.
Vous devez utiliser le constructeur new XML() pour créer un objet XML avant d’appeler les
méthodes de la classe XML.
Résumé des méthodes de la classe XML
Méthode Description
XML.addRequestHeader() Ajoute ou modifie les en-têtes HTTP pour les opérations POST.
XML.appendChild() Ajoute un nœud à la fin de la liste des enfants de l’objet spécifiée.
XML.cloneNode() Clone le nœud spécifié et, optionnellement, clone récursivement tous les
enfants.
XML.createElement Crée un élément XML.
XML.createTextNode Crée un nœud texte XML.
XML.getBytesLoaded() Renvoie le nombre d’octets chargés pour le document XML spécifié.
XML.getBytesTotal() Renvoie la taille du document XML, en octets.
XML.hasChildNodes() Renvoie true si le nœud spécifié a des nœuds enfants ; sinon, renvoie
false.
XML.insertBefore Insère un nœud devant un nœud existant dans la liste des enfants du
nœud spécifiée.
XML.load() Charge un document (spécifié par l’objet XML) depuis une URL.
XML.parseXML Analyse un document XML dans l’arborescence de l’objet XML spécifiée.
XML.removeNode Supprime le nœud spécifié de son parent.
XML.send Envoie l’objet XML spécifié à une URL.744 Chapitre 12 : Dictionnaire ActionScript Présentation
Résumé des propriétés de la classe XML
Résumé des collections de la classe XML
XML.sendAndLoad Envoie l’objet XML spécifié à une URL et charge la réponse du serveur
dans un autre objet XML.
XML.toString Convertit le nœud spécifié et ses enfants en texte XML.
Propriété Description
XML.contentType Indique le type MIME des données transmises au serveur.
XML.docTypeDecl Définit et renvoie les informations relatives à la déclaration DOCTYPE d’un
document XML.
XML.firstChild Lecture seule ; fait référence au premier enfant de la liste pour le nœud
spécifié.
XML.ignoreWhite Lorsque true, les nœuds texte qui ne contiennent que des espaces
vierges sont supprimés au cours de l’analyse.
XML.lastChild Fait référence au dernier enfant de la liste pour le nœud spécifié.
XML.loaded Lecture seule ; vérifie si l’objet XML spécifié a été chargé.
XML.nextSibling Lecture seule ; fait référence au frère suivant dans la liste pour le nœud
parent spécifié.
XML.nodeName Le nom de nœud d’un objet XML.
XML.nodeType Le type du nœud spécifié (élément XML ou nœud texte).
XML.nodeValue Le texte du nœud spécifié si le nœud est un nœud texte.
XML.parentNode Lecture seule ; fait référence au nœud parent du nœud spécifié.
XML.previousSibling Lecture seule ; fait référence au frère précédent dans la liste pour le nœud
parent spécifié.
XML.status Un code d’état numérique indiquant le succès ou l’échec d’une opération
d’analyse d’un document XML.
XML.xmlDecl Spécifie les informations concernant la déclaration XML d’un document.
Méthode Description
XML.attributes Renvoie un tableau associatif contenant tous les attributs du nœud
spécifié.
XML.childNodes Lecture seule ; renvoie un tableau contenant les références aux nœuds
enfants du nœud spécifié.
Méthode DescriptionXML.addRequestHeader() 745
Résumé des gestionnaires d’événement de la classe XML
Constructeur pour la classe XML
Disponibilité
Flash Player 5.
Usage
new XML([source])
Paramètres
source Texte XML analysé pour créer le nouvel objet XML.
Renvoie
Rien.
Description
Constructeur ; crée un nouvel objet XML. Vous devez utiliser le constructeur pour créer un objet
XML avant d’appeler les méthodes de la classe XML.
Remarque : Les méthodes createElement() et createTextNode() sont les méthodes
« constructeur » pour la création d’éléments et de nœuds texte dans une arborescence de
documents XML.
Exemple
Usage 1 : L’exemple suivant crée un nouvel objet XML vide.
mon_xml = new XML();
Usage 2 : L’exemple suivant crée construit un objet XML en analysant le texte XML spécifié dans
le paramètre source et remplit l’objet XML nouvellement créé avec l’arborescence XML
résultante.
unAutreXML = new XML("<état>Californie<ville>san francisco</ville></état>");
Consultez également
XML.createElement, XML.createTextNode
XML.addRequestHeader()
Disponibilité
Flash Player 6.
Gestionnaire
d’événement
Description
XML.onData Un gestionnaire d’événement invoqué lorsque du texte XML a été
complètement téléchargé du serveur ou lorsqu’une erreur se produit au
cours du téléchargement de texte XML depuis le serveur.
XML.onLoad Un gestionnaire d’événements qui renvoie une valeur booléenne
indiquant si l’objet XML a été chargé avec XML.load() ou
XML.sendAndLoad().746 Chapitre 12 : Dictionnaire ActionScript Présentation
Usage
xml.addRequestHeader(nomDentete, valeurDentete)
xml.addRequestHeader(["nomDentete_1", "valeurDentete_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.
Cette méthode ne permet pas d’ajouter ou de modifier les en-têtes standard HTTP suivants :
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.
Exemple
Cet exemple montre l’ajout d’un en-tête HTTP personnalisé nommé SOAPAction et ayant la
valeur Foo à un objet XML nommé mon_xml.
mon_xml.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 que paramètre à la méthode
addRequestHeader().
var en-têtes = ["Content-type", "texte/normal", "X-ClientAppVersion", "2.0"];
mon_xml.addRequestHeader(en-têtes);
Voir aussi
LoadVars.addRequestHeader()
XML.appendChild()
Disponibilité
Flash Player 5.
Usage
mon_xml.appendChild(nœudEnfant)XML.attributes 747
Paramètres
nœudEnfant Nœud enfant à ajouter à la liste des enfants de l’objet XML spécifiée.
Renvoie
Rien.
Description
Méthode : ajoute le nœud enfant spécifié à la fin de la liste des enfants de l’objet XML. Le nœud
enfant ajouté est placé dans l’arborescence une fois supprimé de son nœud parent existant (s’il y
en a un).
Exemple
L’exemple suivant clone le dernier nœud de doc1 et l’ajoute à la fin de doc2.
doc1 = new XML(src1);
doc2 = new XML();
node = doc1.lastChild.cloneNode(true);
doc2.appendChild(node);
XML.attributes
Disponibilité
Flash Player 5.
Usage
mon_xml.attributes
Paramètres
Aucun.
Renvoie
Un tableau.
Description
Propriété : un tableau associé contenant tous les attributs de l’objet XML spécifié.
Exemple
L’exemple suivant enregistre les noms des attributs XML dans le panneau de sortie.
str = "<nom maBalise=\"Val\"> Elément </maBalise>";
doc = new XML(str);
y = doc.firstChild.attributes.name;
trace (y);
doc.firstChild.attributes.order = "first";
z = doc.firstChild.attributes.order
trace(z);
Le résultat suivant est affiché dans la fenêtre Sortie :
Val
first748 Chapitre 12 : Dictionnaire ActionScript Présentation
XML.childNodes
Disponibilité
Flash Player 5.
Usage
mon_xml.childNodes
Paramètres
Aucun.
Renvoie
Un tableau.
Description
Propriété (lecture seule) : un tableau contenant les enfants de l’objet XML spécifié. Chaque
élément du tableau est une référence à un objet XML qui représente un nœud enfant. Cette
propriété est en lecture seule et ne peut pas être utilisée pour manipuler des nœuds enfants.
Utilisez XML.appendChild(), XML.insertBefore et XML.removeNode pour manipuler les
nœuds enfants.
Cette propriété n’est pas définie pour les nœuds de texte (nodeType == 3).
Consultez également
XML.nodeType
XML.cloneNode()
Disponibilité
Flash Player 5.
Usage
mon_xml.cloneNode(récursivement)
Paramètres
récursivement Une valeur booléenne spécifiant si les enfants de l’objet XML spécifié sont
clonés récursivement.
Renvoie
Un nœud XML.
Description
Méthode : construit et renvoie un nouveau nœud XML possédant les mêmes type, nom, valeur et
attributs que l’objet XML spécifié. Si récursivement est défini sur true, tous les nœuds enfants
sont récursivement clonés, obtenant ainsi une copie exacte de l’arborescence de documents de
l’objet original.
Le clone du nœud qui est renvoyé n’est plus associé à l’arborescence de l’élément cloné. Par
conséquent, frèreSuivant, nœudParent et frèrePrécédent ont tous une valeur null. Si
aucune copie de clip n’est réalisée, premierEnfant et dernierEnfant sont également null.XML.createTextNode 749
XML.contentType
Disponibilité
Flash Player 6.
Usage
mon_xml.contentType
Description
Propriété : le type MIME envoyé au serveur lorsque vous appelez la méthode XML.send
XML.send ou XML.sendAndLoad XML.sendAndLoad. La valeur par défaut est application/x-
www-urlform-encoded.
Consultez également
XML.send, XML.sendAndLoad
XML.createElement
Disponibilité
Flash Player 5.
Usage
mon_xml.createElement(nom)
Paramètres
nom Nom de balise de l’élément XML créé.
Renvoie
Un élément XML.
Description
Méthode : crée un élément XML portant le nom spécifié dans le paramètre. Le nouvel élément
n’a, au début, ni parent, ni enfants, ni frères. La méthode renvoie une référence à l’objet XML
nouvellement créé représentant l’élément. Cette méthode et createTextNode sont les méthodes
constructeur permettant de créer les nœuds d’un objet XML.
XML.createTextNode
Disponibilité
Flash Player 5.
Usage
mon_xml.createTextNode(texte)
Paramètres
texte Texte utilisé pour créer le nouveau nœud texte.750 Chapitre 12 : Dictionnaire ActionScript Présentation
Renvoie
Rien.
Description
Méthode : crée un nœud texte XML avec le texte spécifié. Le nouveau nœud n’a, au début, aucun
parent et les nœuds texte ne peuvent pas avoir d’enfants ou frères. Cette méthode renvoie une
référence à l’objet XML représentant le nouveau nœud texte. Cette méthode et
createElement() sont les méthodes constructeur permettant de créer les nœuds d’un objet
XML.
XML.docTypeDecl
Disponibilité
Flash Player 5.
Usage
mon_xml.XMLdocTypeDecl
Description
Propriété : spécifie les informations concernant la déclaration DOCTYPE du document XML. Une
fois le texte XML analysé dans un objet XML, la propriété XML.docTypeDecl de l’objet XML est
définie sur le texte de la déclaration DOCTYPE du document XML. Par exemple, <!DOCTYPE
greeting SYSTEM>"Bonjour.dtd". Cette propriété est définie avec une représentation chaîne de
la déclaration DOCTYPE et non un objet nœud XML.
Le programme d’analyse XML d’ActionScript n’est pas un programme d’analyse de validation. La
déclaration DOCTYPE est lue par le programme d’analyse et stockée dans la propriété
docTypeDecl, mais aucune validation DTD n’est effectuée.
Si aucune déclaration DOCTYPE n’a été rencontrée pendant l’analyse, XML.docTypeDecl est défini
sur undefined. XML.toString produit le contenu de XML.docTypeDecl immédiatement après la
déclaration XML stockée dans XML.xmlDecl et avant tout autre texte dans l’objet XML. Si
XML.docTypeDecl est indéfini, aucune déclaration DOCTYPE n’est sortie.
Exemple
L’exemple suivant utilise XML.docTypeDecl pour définir la déclaration DOCTYPE d’un objet
XML :
mon_xml.docTypeDecl = "<!DOCTYPE greeting SYSTEM \"Bonjour.dtd\">";
Consultez également
XML.toString, XML.xmlDecl
XML.firstChild
Disponibilité
Flash Player 5.
Usage
mon_xml.firstChildXML.getBytesTotal() 751
Description
Propriété (lecture seule) : évalue l’objet XML spécifié et fait référence au premier enfant de la liste
des enfants du nœud parent. Cette propriété est null si le nœud n’a pas d’enfant. Cette propriété
est undefined si le nœud est un nœud texte. Cette propriété est en lecture seule et ne peut pas être
utilisée pour manipuler des nœuds enfants. Utilisez les méthodes appendChild(),
insertBefore() et removeNode() pour manipuler les nœuds enfants.
Consultez également
XML.appendChild(), XML.insertBefore, XML.removeNode
XML.getBytesLoaded()
Disponibilité
Flash Player 6.
Usage
mon_xml.getBytesLoaded()
Paramètres
Aucun.
Renvoie
Un entier indiquant le nombre d’octets chargés.
Description
Méthode : renvoie le nombre d’octets chargés (en flux continu) pour le document XML. Vous
pouvez comparer la valeur de getBytesLoaded() avec celle de getBytesTotal() pour
déterminer le pourcentage d’un document XML qui a été chargé.
Consultez également
XML.getBytesTotal()
XML.getBytesTotal()
Disponibilité
Flash Player 6.
Usage
mon_xml.getBytesTotal()
Paramètres
Aucun.
Renvoie
Un entier.
Description
Méthode : renvoie la taille, en octets, du document XML spécifié.752 Chapitre 12 : Dictionnaire ActionScript Présentation
Consultez également
XML.getBytesLoaded()
XML.hasChildNodes()
Disponibilité
Flash Player 5.
Usage
mon_xml.hasChildNodes()
Paramètres
Aucun.
Renvoie
Une valeur booléenne.
Description
Méthode : renvoie true si l’objet XML spécifié a des nœuds enfants ; sinon, renvoie false.
Exemple
L’exemple suivant utilise les informations de l’objet XML dans une fonction définie par
l’utilisateur.
if (rootNode.hasChildNodes()) {
maFonc (rootNode.firstChild);
}
XML.ignoreWhite
Disponibilité
Flash Player 5.
Usage
mon_xml.ignoreWhite = boolean
XML.prototype.ignoreWhite = boolean
Paramètres
booléen Une valeur booléenne (true ou false).
Description
Propriété : le paramètre par défaut est false. Lorsque true, les nœuds texte qui ne contiennent
que des espaces vierges sont supprimés au cours de l’analyse. Les nœuds de texte qui contiennent
un espace vierge avant ou après leur nom ne sont pas affectés.
Usage 1 : Vous pouvez définir la propriété ignoreWhite pour des objets XML individuels,
comme dans l’exemple suivant :
mon_xml.ignoreWhite = trueXML.load() 753
Usage 2 : Vous pouvez définir la propriété ignoreWhite pour des objets XML individuels,
comme dans l’exemple suivant :
XML.prototype.ignoreWhite = true
XML.insertBefore
Disponibilité
Flash Player 5.
Usage
mon_xml.insertBefore(nœudEnfant, nœudAvant)
Paramètres
nœudEnfant Le nœud à insérer.
nœudAvant Le nœud avant le point d’insertion de nœudEnfant.
Renvoie
Rien.
Description
Méthode : insère un nouveau nœud enfant dans la liste des enfants de l’objet XML, avant le nœud
nœudAvant. Si le paramètre nœudAvant est indéfini ou null, le nœud est ajouté à l’aide de
appendChild(). Si nœudAvant n’est pas un enfant de mon_xml, l’insertion échoue.
XML.lastChild
Disponibilité
Flash Player 5.
Usage
mon_xml.lastChild
Description
Propriété (lecture seule) : évalue l’objet XML et fait référence au dernier enfant de la liste des
enfants du nœud parent. Cette méthode renvoie null si le nœud ne possède pas d’enfants. Cette
propriété est en lecture seule et ne peut pas être utilisée pour manipuler des nœuds enfants.
Utilisez les méthodes appendChild(), insertBefore() et removeNode() pour manipuler les
nœuds enfants.
Consultez également
XML.appendChild(), XML.insertBefore, XML.removeNode
XML.load()
Disponibilité
Flash Player 5 ; comportement mis à jour dans Flash Player 7.754 Chapitre 12 : Dictionnaire ActionScript Présentation
Usage
mon_xml.load(url)

Exemple
L’exemple suivant utilise XMLSocket.connect() pour établir une connexion à l’hôte du fichier
SWF et utilise trace pour afficher la valeur renvoyée indiquant le succès ou l’échec de la
connexion.
function maOnConnect(succès) {
if (succès) {
trace ("Connexion réussie !")
  } else {
trace ("Echec de la connexion !")
}
}
socket = new XMLSocket()
socket.onConnect = maOnConnect
if (!socket.connect(null, 2000)) {
trace ("Echec de la connexion !")
}
Consultez également
function, XMLSocket.onConnect
XMLSocket.onClose
Disponibilité
Flash Player 5.
Usage
maXMLSocket.onClose() = function() {
// vos instructions
}
Paramètres
Aucun.768 Chapitre 12 : Dictionnaire ActionScript Présentation
Renvoie
Rien.
Description
Gestionnaire d’événements : invoqué uniquement lorsqu’une connexion ouverte est fermée par le
serveur. L’implémentation par défaut de cette méthode n’effectue aucune action. Pour avoir la
priorité sur l’implémentation par défaut, vous devez affecter une fonction contenant vos propres
actions.
Consultez également
function, XMLSocket.onConnect
XMLSocket.onConnect
Disponibilité
Flash Player 5.
Usage
monSocketXML.onConnect(succès)
// vos instructions
}
Paramètres
succès Une valeur booléenne indiquant si une connexion socket a été établie avec succès (true
ou false).
Renvoie
Rien.
Description
Gestionnaire d’événements : invoqué par Flash Player lorsqu’une requête de connexion initialisée
via XMLSocket.connect réussit ou échoue. Si la connexion réussit, le paramètre succès est
true ; sinon, le paramètre succès est false.
L’implémentation par défaut de cette méthode n’effectue aucune action. Pour avoir la priorité sur
l’implémentation par défaut, vous devez affecter une fonction contenant vos propres actions.
Exemple
L’exemple suivant illustre le processus de spécification d’une fonction de remplacement pour la
méthode onConnect dans une simple application de dialogue en ligne.
La fonction contrôle l’écran auquel les utilisateurs sont dirigés selon que la connexion a été établie
avec succès ou non. Si la connexion est établie avec succès, les utilisateurs sont dirigés vers l’écran
de dialogue principal de l’image nommée débutDiscussion. Si la connexion est un échec, les
utilisateurs sont dirigés vers un écran d’informations de dépannage dans l’image nommée
connectionFailed.
function maOnConnect(succès) {
if (succès) {
gotoAndPlay("débutDiscussion")
} else {XMLSocketXML.onData() 769
gotoAndStop("échecDeLaConnexion")
}
}
Une fois l’objet XMLSocket créé à l’aide de la méthode constructeur, le script installe la méthode
onConnect en utilisant l’opérateur d’affectation :
socket = new XMLSocket()
socket.onConnect = maOnConnect
Pour finir, la connexion est initiée. Si connect() renvoie false, le fichier SWF est envoyé
directement vers l’image nommée EchecDeLaConnexion et onConnect n’est jamais invoqué. Si
connect() renvoie true, le fichier SWF est envoyé vers une image appelée
attenteDeConnexion, qui correspond à l’écran affichant un message d’attente. Le fichier SWF
reste sur l’image attenteDeConnexion jusqu’à ce que le gestionnaire onConnect soit invoqué, ce
qui arrive à un moment ultérieur, selon le délai d’attente du réseau.
if (!socket.connect(null, 2000)) {
gotoAndStop("échecDeLaConnexion")
} else {
gotoAndStop("attenteDeConnexion")
}
Consultez également
function, XMLSocket.connect
XMLSocketXML.onData()
Disponibilité
Flash Player 5.
Usage
XMLSocket.onData = function(src) {
// vos instructions
}
Paramètres
src Une chaîne contenant les données envoyées par le serveur.
Renvoie
Rien.
Description
Gestionnaire d’événement : invoqué lorsqu’un message XML a été téléchargé du serveur, terminé
par un octet zéro. Vous pouvez passer outre XMLSocket.onData pour intercepter les données
envoyées par le serveur sans les analyser au format XML. Cette opération est utile si vous
transférez des paquets de données formatés arbitrairement et que vous souhaitez manipuler les
données directement lors de leur réception, sans que Flash Player ne les analyse au format XML.
Par défaut, la méthode XMLSocket.onData invoque la méthode XMLSocket.onXML. Si vous
annulez XMLSocket.onData en utilisant votre propre comportement, XMLSocket.onXML n’est
plus appelé si vous n’appelez pas votre propre implémentation de XMLSocket.onData.
XMLSocket.prototype.onData = function (src) {770 Chapitre 12 : Dictionnaire ActionScript Présentation
  this.onXML(new XML(src));
}
Dans l’exemple ci-dessus, le paramètre src est une chaîne XML contenant du texte récupéré du
serveur. La terminaison à octet zéro n’est pas incluse dans la chaîne.
XMLSocket.onXML
Disponibilité
Flash Player 5.
Usage
maXMLSocket.onXML(objet) = function() {
// vos instructions
}
Paramètre
objet Un objet XML contenant un document XML analysé reçu d’un serveur. 
Renvoie
Rien.
Description
Gestionnaire d’événements : invoqué par Flash Player lorsque l’objet XML spécifié contenant un
document XML arrive sur une connexion XMLSocket ouverte. Une connexion XMLSocket peut
être utilisée pour transférer un nombre illimité de documents XML entre le client et le serveur.
Chaque document est terminé par un octet zéro. Lorsque Flash Player reçoit l’octet zéro, il analyse
tout le code XML reçu depuis l’octet zéro précédent ou depuis que la connexion a été établie, s’il
s’agit du premier message reçu. Chaque lot de code XML analysé est traité comme un seul
document XML et transmis à la méthode onXML.
L’implémentation par défaut de cette méthode n’effectue aucune action. Pour annuler
l’implémentation par défaut, vous devez affecter une fonction contenant vos propres actions.
Exemple
La fonction suivante prend la priorité sur l’implémentation par défaut de la méthode onXML dans
une simple application de dialogue en ligne. La fonction myOnXML indique à l’application de
dialogue en ligne de reconnaître un seul élément XML, MESSAGE, au format suivant :
<MESSAGE USER="John" TEXT="Bonjour, je m’appelle John !" />.
Le gestionnaire onXML doit d’abord être installé dans l’objet XMLSocket de la façon suivante :
socket.onXML = myOnXML;
La fonction displayMessage() est considérée comme étant définie par l’utilisateur et affichant le
message reçu par l’utilisateur.
function monOnXML(doc) {
var e = doc.firstChild;
if (e != null && e.nodeName == "MESSAGE") {
afficherMessage(e.attributes.user, e.attributes.text);
}
}XMLSocket.send 771
Consultez également
function
XMLSocket.send
Disponibilité
Flash Player 5.
Usage
monSocketXML.send(objet)
Paramètres
objet Objet XML ou autres données à transmettre au serveur.
Renvoie
Rien.
Description
Méthode : convertit l’objet XML ou les données spécifiés dans l’objet objet en chaîne et la
transmet au serveur, suivie d’un octet zéro. Si objet est un objet XML, la chaîne est la
représentation textuelle XML de l’objet XML. L’opération d’envoi est asynchrone ; les résultats
sont renvoyés immédiatement, mais les données peuvent être transmises plus tard. La méthode
XMLSocket.send() ne renvoie pas de valeur indiquant si les données ont été transmises.
Si l’objet monSocketXML n’est pas connecté au serveur (avec XMLSocket.connect), l’opération
XMLSocket.send() échoue.
Exemple
L’exemple suivant illustre comment spécifier un nom d’utilisateur et un mot de passe pour
envoyer l’objet XML mon_xml au serveur :
var mon_xml = new XML();
var monLogin = mon_xml.createElement("login");
monLogin.attributes.nomDutilisateur = champDeTexteNomDutilisateur;
monLogin.attributes.motDePasse = champDeTexteNomMotDePasse;
mon_xml.appendChild(myLogin);
monXMLSocket.send(mon_xml);
Consultez également
XMLSocket.connect772 Chapitre 12 : Dictionnaire ActionScript Présentation773
ANNEXE A
Messages d’erreur
Macromedia Flash MX 2004 et Macromedia Flash MX Professionnel 2004 proposent des
fonctions avancées de signalisation d’erreur de compilation si vous spécifiez ActionScript2.0
(valeur par défaut) lorsque vous publiez un fichier. Le tableau suivant contient la liste des
messages d’erreur que le compilateur Flash est susceptible de générer.     
Numéro de
l’erreur
Texte du message
1093 Un nom de classe était attendu.
1094 Un nom de classe de base est attendu après le mot-clé ’extends’.
1095 Utilisation incorrecte d’un attribut de membre.
1096 Impossible d’utiliser un nom de membre plusieurs fois.
1097 Toutes les fonctions de membre doivent avoir des noms.
1099 Cette instruction est interdite dans une définition de classe.
1100 Une classe ou une interface de ce nom est déjà définie.
1101 Incompatibilité de types.
1102 Il n’existe aucune classe nommée ’<nomClasse>’.
1103 Il n’existe aucune propriété nommée ’<nomPropriete>’. 
1104 Un appel de fonction pour un élément autre qu’une fonction a été tenté.
1105 Incompatibilité de types dans l’instruction d’affectation : [lhs-type] détecté au lieu
de [rhs-type].
1106 Le membre est privé : accès impossible.
1107 Déclarations de variables interdites dans les interfaces.
1108 Déclarations d’événements interdites dans les interfaces.
1109 Déclarations de lecture/définitions interdites dans les interfaces.
1110 Membres privés interdits dans les interfaces.
1111 Corps de fonctions interdits dans les interfaces.
1112 Une classe ne peut pas s’étendre.774 Annexe A :  Messages d’erreur
1113 Une interface ne peut pas s’étendre.
1114 Aucune interface de ce nom n’est définie.
1115 Une classe ne peut pas étendre une interface.
1116 Une interface ne peut pas étendre une classe.
1117 Un nom d’interface est attendu après le mot-clé ’implements’.
1118 Une classe ne peut pas implémenter une autre classe, mais uniquement des
interfaces.
1119 La classe doit implémenter la méthode ‘nomMethode’ depuis l’interface
‘nomInterface’.
1120 La mise en œuvre d’une méthode d’interface doit être une méthode et non une
propriété.
1121 Une classe ne peut pas étendre la même interface plusieurs fois.
1122 La mise en œuvre de la méthode d’interface ne correspond pas à sa définition.
1123 Cet élément est disponible uniquement dans ActionScript 1.0.
1124 Cet élément est disponible uniquement dans ActionScript 2.0.
1125 Membres statiques interdits dans les interfaces.
1126 L’expression renvoyée doit correspondre au type de renvoi de la fonction.
1127 Une instruction RETURN est requise dans cette fonction.
1128 Attribut utilisé en dehors de la classe.
1129 Une fonction dont le type de renvoi est Void ne renvoie aucune valeur.
1130 La clause ’extends’ doit précéder la clause ’implements’.
1131 Un identifiant de type est attendu après ’:’.
1132 Les interfaces doivent utiliser le mot-clé ’extends’, et non pas ’implements’.
1133 Une classe ne peut pas étendre plus d’une classe.
1134 Une interface ne peut pas étendre plus d’une interface.
1135 La méthode nommée ’<nomMethode>’ n’existe pas.
1136 Instruction interdite dans une définition d’interface.
1137 Une fonction set requiert un seul paramètre.
1138 Une fonction get ne requiert aucun paramètre.
1139 Les classes ne peuvent être définies que dans des scripts de classe ActionScript
2.0 externes.
1140 Les scripts de classe ActionScript 2.0 peuvent définir uniquement des éléments de
classe ou d’interface.
Numéro de
l’erreur
Texte du message775
1141 Le nom de cette classe, ‘<A.B.C>’, n’est pas compatible avec le nom d’une autre
classe chargée, ‘<A.B>’.
1142 Impossible de charger la classe ‘<nomClasse>’.
1143 Les interfaces ne peuvent être définies que dans des scripts de classe ActionScript
2.0 externes.
1144 Il est impossible d’accéder aux variables d’occurrence dans des fonctions statiques.
1145 Impossible d’imbriquer les définitions de classe et d’interface.
1146 La propriété référencée ne contient aucun attribut statique.
1147 L’appel de l’opérateur de superclasse ne correspond pas au superconstructeur.
1148 Seul l’attribut public est autorisé pour les méthodes d’interface.
1149 Impossible d’utiliser le mot-clé import en tant que directive.
1150 Vous devez exporter votre animation au format Flash 7 pour utiliser cette action.
1151 Vous devez exporter votre animation au format Flash 7 pour utiliser cette
expression.
1152 Cette clause d’exception n’est pas placée correctement.
1153 Une classe doit comporter un seul constructeur.
1154 Un constructeur ne peut pas renvoyer de valeur.
1155 Un constructeur ne peut pas spécifier de type de renvoi.
1156 Une variable ne peut pas être de type Void.
1157 Un paramètre de fonction ne peut pas être de type Void.
1158 Accès aux membres statiques uniquement via les classes.
1159 Plusieurs interfaces mises en œuvre contiennent la même méthode avec des types
différents.
1160 Une classe ou une interface de ce nom existe déjà.
1161 Impossible de supprimer les classes, les interfaces et les types intégrés.
1162 Il n’existe aucune classe de ce nom.
1163 Le mot-clé ‘<mot-cle>’ est réservé à une utilisation avec ActionScript 2.0 et ne peut
pas être utilisé ici.
1164 La définition de l’attribut personnalisé n’est pas terminée.
1165 Une seule classe ou interface peut être définie par fichier .as ActionScript 2.0.
1166 La classe en cours de compilation, ‘<A.b>’, ne correspond pas à la classe importée,
‘<A.B>’.
1167 Vous devez indiquer un nom de classe.
1168 Le nom de classe que vous avez entré présente une erreur de syntaxe.
Numéro de
l’erreur
Texte du message776 Annexe A :  Messages d’erreur
1169 Le nom d’interface que vous avez entré présente une erreur de syntaxe.
1170 Le nom de classe de base que vous avez entré présente une erreur de syntaxe.
1171 Le nom d’interface de base que vous avez entré présente une erreur de syntaxe.
1172 Vous devez indiquer un nom d’interface.
1173 Vous devez indiquer un nom de classe ou d’interface.
1174 Le nom de classe ou d’interface que vous avez entré présente une erreur de
syntaxe.
1175 ‘variable’ n’est pas accessible dans cette étendue.
1176 Plusieurs occurrences de l’attribut ‘get/set/private/public/static’ ont été trouvées.
1177 Un attribut de classe a été utilisé de manière incorrecte.
1178 Les variables et les fonctions d’occurrence ne peuvent pas être utilisées pour
l’initialisation de variables statiques.
1179 Des circularités d’exécution ont été détectées entre les classes suivantes :%1
1180 La version Flash Player ciblée ne prend pas en charge le débogage.
1181 La version Flash Player ciblée ne prend pas en charge l’événement releaseOutside.
1182 La version Flash Player ciblée ne prend pas en charge l’événement dragOver.
1183 La version Flash Player ciblée ne prend pas en charge l’événement dragOut.
1184 La version Flash Player ciblée ne prend pas en charge les actions de déplacement.
1185 La version Flash Player ciblée ne prend pas en charge l’action loadMovie.
1186 La version Flash Player ciblée ne prend pas en charge l’action getURL.
1187 La version Flash Player ciblée ne prend pas en charge l’action FSCommand.
1188 Les instructions d’importation ne sont pas autorisées dans les définitions de classe
ou d’interface.
1189 La classe ‘<A.B>’ ne peut pas être importée, car son nom de feuille est déjà en cours
de résolution dans la classe en cours de définition, ‘<C.B>’.
1190 La classe ‘<A.B>’ ne peut pas être importée, car son nom de feuille est déjà en cours
de résolution dans la classe importée ‘<C.B>’.
1191 Les variables d’occurrence d’une classe peuvent être initialisées uniquement dans
des expressions constantes de compilation.
1192 Les fonctions des membres de classe ne peuvent pas porter le même nom qu’une
fonction de constructeur de superclasse.
1193 Le nom de la classe, ’<nomClasse>’, est en conflit avec le nom d’une autre classe
chargée.
1194 Le corps d’un constructeur doit d’abord contenir un appel au superconstructeur.
1195 L’identifiant ‘<nomClasse>’ n’est pas résolu dans un objet intégré ‘<nomClasse>’ lors
de l’exécution.
Numéro de
l’erreur
Texte du message777
1196 La classe ‘<A.B.nomClasse>’ doit être définie dans un fichier dont le chemin d’accès
relatif est <‘A.B>’.
1197 Le caractère générique ’*’ est utilisé de manière incorrecte dans le nom de classe
’<nomClasse>’.
1198 La fonction de membre ’<nomClasse>’ a une casse différente de celle du nom de la
classe en cours de définition, ’<nomClasse>’, et ne sera pas traitée en tant que
constructeur de classe à l’exécution.
1199 Le seul type d’itérateur de boucle for-in accepté est le type Chaîne.
1200 Une fonction de définition ne peut pas renvoyer de valeur.
1201 Les seuls attributs autorisés pour les fonctions constructeur sont public et private.
Numéro de
l’erreur
Texte du message778 Annexe A :  Messages d’erreur779
ANNEXE B
Priorité et associativité des opérateurs
Ce tableau répertorie l’ensemble des opérateurs ActionScript et leur associativité et les classe par
ordre de priorité décroissante.       
Opérateur Description Associativité
Priorité la plus élevée
+ Unaire plus Droite à gauche
- Unaire moins Droite à gauche
~ NOT au niveau du bit Droite à gauche
! NOT logique Droite à gauche
not NOT logique (style Flash 4) Droite à gauche
++ Post-incrémentation Gauche à droite
-- Post-décrémentation Gauche à droite
( ) Appel de fonction Gauche à droite
[ ] Elément de tableau Gauche à droite
. Membre de structure Gauche à droite
++ Pré-incrémentation Droite à gauche
-- Pré-décrémentation Droite à gauche
new Affectation d’objet Droite à gauche
delete Désaffectation d’objet Droite à gauche
typeof Type d’objet Droite à gauche
void Renvoie une valeur non définie Droite à gauche
* Multiplier Gauche à droite
/ Diviser Gauche à droite
% Modulo Gauche à droite
+ Additionner Gauche à droite780 Annexe B :  Priorité et associativité des opérateurs
add Concaténation de chaîne (auparavant &) Gauche à droite
- Soustraire Gauche à droite
<< Décalage gauche au niveau du bit Gauche à droite
>> Décalage droit au niveau du bit Gauche à droite
>>> Décalage droit au niveau du bit (non signé) Gauche à droite
< Inférieur à Gauche à droite
<= Inférieur ou égal à Gauche à droite
> Supérieur à Gauche à droite
>= Supérieur ou égal à Gauche à droite
instanceof Occurrence de Gauche à droite
lt Inférieur à (version chaîne) Gauche à droite
le Inférieur ou égal à (version chaîne) Gauche à droite
gt Supérieur à (version chaîne) Gauche à droite
ge Supérieur ou égal à (version chaîne) Gauche à droite
== Egal Gauche à droite
!= Différent Gauche à droite
eq Egal (version chaîne) Gauche à droite
ne Différent (version chaîne) Gauche à droite
& AND au niveau du bit Gauche à droite
^ XOR au niveau du bit Gauche à droite
| OR au niveau du bit Gauche à droite
&& AND logique Gauche à droite
and AND logique (Flash 4) Gauche à droite
|| OR logique Gauche à droite
or OR logique (Flash 4) Gauche à droite
?: Conditionnel Droite à gauche
= Affectation Droite à gauche
*=, /=, %=, +=, -=, &=,
|=, ^=, <<=, >>=, >>>=
Affectation de composant Droite à gauche
, Virgule Gauche à droite
Priorité la moins élevée
Opérateur Description Associativité781
ANNEXE C
Touches du clavier et valeurs de code
correspondantes
Les tableaux suivants répertorient toutes les touches d’un clavier standard et les valeurs de code
ASCII correspondantes utilisées pour identifier les touches dans ActionScript. Pour plus
d’informations, Classe Key consultez l’entrée dans le Chapitre 12, Dictionnaire ActionScript
Présentation, page 211.
Lettres A à Z et chiffres (clavier standard) de 0 à 9
Le tableau suivant répertorie toutes les touches d’un clavier standard pour les lettres de A à Z et les
chiffres de 0 à 9, avec les valeurs de code ASCII correspondantes utilisées pour identifier les
touches dans ActionScript.   
Touche alphabétique
ou numérique
Code de touche
A65
B66
C67
D68
E69
F70
G71
H72
I73
J74
K75
L76
M77
N78
O79782 Annexe C :  Touches du clavier et valeurs de code correspondantes
Touches du clavier numérique
Le tableau suivant répertorie les touches d’un clavier numérique et indique les valeurs de code
ASCII correspondantes permettant d’identifier les touches dans ActionScript.   
P80
Q81
R82
S83
T84
U85
V86
W87
X88
Y89
Z90
048
149
250
351
452
553
654
755
856
957
Touche du clavier
numérique
Code de touche
0 (clavier numérique) 96
1 (clavier numérique) 97
2 (clavier numérique) 98
3 (clavier numérique) 99
4 (clavier numérique) 100
5 (clavier numérique) 101
Touche alphabétique
ou numérique
Code de toucheTouches de fonction 783
Touches de fonction
Le tableau suivant répertorie les touches de fonction d’un clavier standard et indique les valeurs de
code ASCII correspondantes permettant d’identifier les touches dans ActionScript.   
6 (clavier numérique) 102
7 (clavier numérique) 103
8 (clavier numérique) 104
9 (clavier numérique) 105
Multiplier 106
Additionner 107
Entrée 108
Soustraire 109
Décimal 110
Diviser 111
Touche de fonction Code de touche
F1 112
F2 113
F3 114
F4 115
F5 116
F6 117
F7 118
F8 119
F9 120
F10 121
F11 122
F12 123
F13 124
F14 125
F15 126
Touche du clavier
numérique
Code de touche784 Annexe C :  Touches du clavier et valeurs de code correspondantes
Autres touches
Le tableau suivant répertorie les touches d’un clavier standard autres que les lettres, les nombres,
les touches de fonction et les touches du clavier numérique, et indique les valeurs de code ASCII
correspondantes permettant d’identifier les touches dans ActionScript.
Touche Code de touche
Retour arrière 8
Tab 9
Effacer 12
Entrée 13
Maj 16
Contrôle 17
Alt 18
Verr Maj 20
Echap 27
Espace 32
Pg. Préc. 33
Pg. Suiv. 34
Fin 35
Origine 36
Flèche gauche 37
Flèche vers le haut 38
Flèche droite 39
Flèche vers le bas 40
Insertion 45
Suppr 46
Aide 47
Verr num 144
; : 186
= + 187
- _ 189
/ ? 191
` ~ 192
[ { 219
\ | 220Autres touches 785
] } 221
" ’ 222
Touche Code de touche786 Annexe C :  Touches du clavier et valeurs de code correspondantes787
ANNEXE D
Ecriture de scripts destinés à des versions
antérieures de Flash Player
ActionScript a considérablement changé lors de la publication de Macromedia Flash MX 2004 et
de Macromedia Flash MX Professionnel 2004. Lorsque vous créez un contenu pour Flash
Player 7, vous exploitez pleinement la puissance d’ActionScript. Bien qu’il soit toujours possible
de créer dans Flash MX 2004 du contenu destiné à des versions antérieures de Flash Player, vous
ne pourrez pas utiliser tous les éléments d’ActionScript.
Ce chapitre donne des conseils pour écrire des scripts corrects syntaxiquement pour la version de
Flash Player ciblée.
A propos du ciblage d’anciennes versions de Flash Player
Lorsque vous écrivez vos scripts, utilisez les informations de disponibilité des éléments du
dictionnaire ActionScript (consultez le Chapitre 12, Dictionnaire ActionScript Présentation,
page 211) pour déterminer si l’élément que vous voulez utiliser est pris en charge par la version de
Flash Player que vous ciblez. Pour identifier les éléments disponibles, vous pouvez également
afficher la boîte à outils Actions. Les éléments non pris en charge par votre version cible y sont
surlignés en jaune.
Si vous créez du contenu pour Flash Player 6 ou Flash Player 7, utilisez de préférence
ActionScript 2.0, qui propose un certain nombre de fonctions importantes qui ne sont pas
disponibles dans ActionScript 1, notamment de meilleures fonctions de signalisation des erreurs
de compilation et des capacités de programmation orientée objet plus robustes.
Pour connaître les différences entre la manière dont certaines fonctions sont implémentées lors de
la publication de fichiers pour Flash Player 7 et la manière dont les fonctions sont implementées
dans les fichiers publiés pour des versions antérieures, consultez Portage de scripts existants sur Flash
Player 7, page 17.
Pour indiquer la version de Flash Player et d’ActionScript à utiliser lors de la publication d’un
document, choisissez Fichier > Paramètres de publication, puis activez les options appropriées
dans l’onglet Flash. Si vous devez cibler Flash Player 4, consultez la section suivante.
Utilisation de Flash MX 2004 pour créer du contenu destiné à
Flash Player 4
Pour utiliser Flash MX 2004 pour créer du contenu destiné à Flash Player 4, activez l’option
FlashPlayer 4 dans l’onglet Flash de la boîte de dialogue Paramètres de publication (Fichier >
Paramètres de publication). 788 Annexe D :  Ecriture de scripts destinés à des versions antérieures de Flash Player
Le langage ActionScript de Flash Player 4 ne possède qu’un seul type de données de base, qui est
utilisé pour les manipulations de chaînes et de nombres. Lorsque vous développez une application
pour Flash Player 4, vous devez utiliser les opérateurs de chaîne déconseillés indiqués dans la
catégorie Eléments déconseillés > Opérateurs de la boîte à outils Actions.
Lorsque vous effectuez une publication pour Flash Player 4, vous pouvez utiliser les fonctions
suivantes de Flash MX 2004 :
• L’opérateur d’accès tableau et objet ([]).
• L’opérateur point (.).
• Les opérateurs logiques, d’affectation, de pré-incrémentation et de post-incrémentation/
décrémentation.
• L’opérateur modulo (%), et toutes les méthodes et propriétés de la classe Math.
Les éléments de langage suivants ne sont pas pris en charge de façon native par Flash Player 4.
Flash MX 2004  les exporte sous la forme d’une série d’approximations, qui crée des résultats
moins précis numériquement. De plus, du fait de l’ajout de séries d’approximations dans le
fichier SWF, ces éléments de langage occupent plus d’espace dans les fichiers SWF de Flash
Player 4 qu’ils n’en occupent dans Flash Player 5 ou dans les fichiers SWF d’une version
ultérieure.
• Les actions for, while, do..while, break et continue.
• Les actions print() et printAsBitmap().
• L’action switch.
Pour plus d’informations, consultez A propos du ciblage d’anciennes versions de Flash Player,
page 787.
Utilisation de Flash MX 2004 pour ouvrir des fichiers Flash 4
Le code ActionScript de Flash 4 ne possédait qu’un seul véritable type de données : les chaînes. Il
utilisait différents types d’opérateurs dans les expressions pour indiquer si la valeur devait être
traitée comme une chaîne ou comme un nombre. Dans les versions ultérieures de Flash, vous
pouvez utiliser un ensemble d’opérateurs sur tous les types de données.
Si vous utilisez la version 5 (ou ultérieure) de Flash pour ouvrir un fichier créé dans Flash 4, Flash
convertit automatiquement les expressions ActionScript afin de les rendre compatibles avec la
nouvelle syntaxe. Dans votre code ActionScript, vous remarqueriez alors les conversions suivantes
des type de données et d’opérateurs :
• L’opérateur = de Flash 4 était utilisé pour des égalités numériques. Dans la version 5 (et les
versions ultérieures) de Flash, == est l’opérateur d’égalité et = est l’opérateur d’affectation. Tous
les opérateurs = des fichiers Flash 4 sont automatiquement convertis en ==.
• Flash effectue automatiquement les conversions pour assurer le bon fonctionnement des
opérateurs. L’introduction de plusieurs types de données donne une nouvelle signification aux
opérateurs suivants :
+, ==, !=, <>, <, >, >=, <=
Dans ActionScript de Flash 4 , ces opérateurs étaient toujours des opérateurs numériques.
Dans la version 5 (et ultérieures) de Flash, ils se comportent différemment, selon le type de
données des opérandes. Pour éviter toutes différences sémantiques dans les fichiers importés, la
fonction Number() est insérée autour des opérandes de ces opérateurs. (Les nombres constants
sont déjà des nombres évidents et ne sont donc pas encadrés de Number()).Utilisation de Flash MX 2004 pour créer du contenu destiné à Flash Player 4 789
• Dans Flash 4, la séquence d’échappement \n générait le caractère de retour chariot (ASCII 13).
Dans la version 5 (et ultérieures) de Flash, pour respecter la norme ECMA-262, \n génère le
caractère de changement de ligne (ASCII 10). Une séquence \n dans les fichiers FLA de Flash
4 est automatiquement convertie en \r.
• L’opérateur & de Flash 4 était utilisé pour les additions de chaînes. Dans la version 5 (et
ultérieures) de Flash, & est l’opérateur AND au niveau du bit. L’opérateur d’addition de chaînes
est maintenant appelé add. Tous les opérateurs & des fichiers de Flash 4 sont automatiquement
convertis en opérateurs add.
• De nombreuses fonctions de Flash 4 ne nécessitaient pas l’usage de parenthèses de fermeture
(par exemple, Get Timer, Set Variable, Stop et Play). Pour créer une syntaxe cohérente, la
fonction getTimer et toutes les actions nécessitent maintenant l’usage de parenthèses de
fermeture. Ces parenthèses sont automatiquement ajoutées lors de la conversion.
• Dans la version 5 (et ultérieures) de Flash, lorsque la fonction getProperty est exécutée sur un
clip qui n’existe pas, elle renvoie la valeur undefined et non 0. L’instruction undefined == 0
est false dans ActionScript après Flash 4 (dans Flash 4, undefined == 1). Pour résoudre ce
problème lors de la conversion de fichiers Flash 4, insérez la fonction Number() dans les
comparaisons d’égalité. Dans l’exemple suivant, Number() oblige à la conversion de
undefined en 0 pour permettre la comparaison :
getProperty("clip", _width) == 0
Number(getProperty("clip", _width)) == Number(0)
Remarque : Si vous utilisez des mots-clés de Flash 5 ou d’une version ultérieure en tant que noms de
variable dans votre code ActionScript Flash 4, la syntaxe renvoie une erreur lors de sa compilation
dans Flash MX 2004. Pour résoudre ce problème, renommez toutes vos variables. Consultez Mots-
clés, page 35 et Affectation d’un nom à une variable, page 43.
Utilisation de la syntaxe à barre oblique
La syntaxe à barre oblique était utilisée dans Flash 3 et 4 pour indiquer le chemin cible d’un clip
ou d’une variable. Dans la syntaxe à barre oblique, les barres obliques sont utilisées à la place de
points. Pour indiquer une variable, vous la précédez d’un deux-points :
monClip/clipEnfant:maVariable
Pour rédiger le même chemin cible en syntaxe à point (consultez Syntaxe pointée, page 32), qui est
supportée dans Flash Player 5 (et versions ultérieures), utilisez le code suivant :
monClip.clipEnfant.maVariable
La syntaxe à barre oblique était le plus souvent utilisée avec l’action tellTarget dont l’utilisation
n’est plus recommandée. L’action with est maintenant préférée à tellTarget pour des raisons de
compatibilité avec la syntaxe à point. Pour plus d’informations, consultez tellTarget et with
dans le Chapitre 12, Dictionnaire ActionScript Présentation, page 211. 790 Annexe D :  Ecriture de scripts destinés à des versions antérieures de Flash Player791
ANNEXE E
Programmation orientée objet avec ActionScript 1
Les informations contenues dans cette annexe sont tirées de la documentation de Macromedia
Flash MX et concernent l’utilisation du modèle d’objet ActionScript 1 permettant l’écriture de
scripts. Elles sont ci-incluses pour les raisons suivantes :
• L’écriture de scripts orientés objet supportant Flash Player 5 requiert l’utilisation
d’ActionScript 1.
• Si vous utilisez déjà ActionScript 1 pour l’écriture de scripts orientés objet, mais que vous n’êtes
pas prêt à passer à ActionScript 2.0, cette annexe vous permettra de trouver les informations
nécessaires à l’écriture de scripts avec ActionScript 1.
Si vous n’avez jamais utilisé ActionScript pour écrire des scripts orientés objet et que vous n’avez
pas besoin de Flash Player 5, ne tenez pas compte des informations contenues dans cette annexe,
car l’écriture de scripts orientés objet à l’aide d’ActionScript 1 n’est pas conseillée. Veuillez alors
consulter le Chapitre 9, Création de classes avec ActionScript 2.0, page 161 pour plus
d’informations sur l’utilisation d’ActionScript 2.0.
Remarque : Certains exemples de cette annexe utilisent la méthode Object.RegisterClass(). Cette
dernière n’est supportée que par Flash Player 6 et les versions ultérieures ; veuillez ne pas l’utiliser
avec Flash Player 5.
A propos d’ActionScript 1
ActionScript est un langage de programmation orienté objet. La programmation orientée objet
utilise des objets, ou structures de données, afin de regrouper les propriétés et les méthodes
contrôlant le comportement ou l’apparence de l’objet. Les objets permettent d’organiser et de
réutiliser le code. Après avoir défini un objet, il est possible de se référer à ce dernier grâce à son
nom, sans avoir à le redéfinir à chaque utilisation.
Une classe est une catégorie générique d’objets. Une classe définit une série d’objets ayant des
propriétés communes et pouvant être contrôlés de la même manière. Les propriétés sont des
attributs définissant un objet, tels que la taille, la position, la couleur, la transparence, etc. Les
propriétés sont définies par classe ; les valeurs des propriétés sont définies pour chaque objet d’une
classe. Les méthodes sont des fonctions pouvant définir ou rechercher les propriétés d’un objet.
Par exemple, vous pouvez définir une méthode permettant de calculer la taille d’un objet. Tout
comme les propriétés, les méthodes sont définies pour chaque classe d’objets, puis appelées pour
chaque objet d’une classe.