Forums d'entraide informatique - Astuces - Conseils

Création de nouveaux styles avec ActionScript
Vous pouvez créer de nouveaux styles de texte avec ActionScript en utilisant la méthode
setStyle() de la classe TextField.StyleSheet. Cette méthode prend deux paramètres : le nom du
style et un objet qui définit les propriétés de ce style. 
Par exemple, le code suivant crée un objet feuille de style nommé styles qui définit deux styles
identiques à ceux que vous avez importés (consultez Chargement de fichiers CSS externes,
page 145).
var styles = new TextField.StyleSheet();
styles.setStyle("bodyText",
{fontFamily: ’Arial,Helvetica,sans-serif’,
fontSize: ’12px’}
);
styles.setStyle("titre",
{fontFamily: ’Arial,Helvetica,sans-serif’,
fontSize: ’24px’}
);
Application de styles à un objet TextField
Pour appliquer un objet feuille de style à un champ de texte, affectez cet objet à la propriété
styleSheet de l’objet champ de texte.
textObj_txt.styleSheet = styleSheetObj;
Remarque : Evitez de confondre la propriété TextField.styleSheet avec la classe
TextField.StyleSheet. Les majuscules les distinguent.
Lorsque vous affectez un objet feuille style à un objet TextField, le comportement normal du
champ de texte est modifié de la manière suivante :
• Les propriétés text et htmlText du champ de texte et toute variable associée au champ de
texte, contiennent toujours la même valeur et se comportent toujours de la même façon.
• Le champ de texte est en lecture seule et ne peut plus être modifié par l’utilisateur.
• Les méthodes setTextFormat() et replaceSel() de la classe TextField ne fonctionnent plus
avec le champ de texte. La seule façon de modifier le champ consiste à changer les propriétés
text ou htmlText du champ de texte ou à modifier les variables associées au champ de texte.
• Tout texte affecté à la propriété text, à la propriété htmlText ou aux variables associées du
champ de texte est stocké textuellement. Tout ce qui est écrit dans l’une de ces propriétés peut
être récupéré dans la forme originale du texte.Formatage de texte avec les feuilles de style en cascade 147
Association de styles
Les styles CSS dans Flash Player sont additionnels, c’est-à-dire que lorsque les styles sont
imbriqués, chaque niveau d’imbrication peut fournir des informations de style supplémentaires,
qui sont ajoutées les unes aux autres pour donner le formatage final.
Par exemple, voici des données XML affectées à un champ de texte :
<sectionHeading>Ceci est une section</sectionHeading>
<mainBody>Ceci est le corps principal du texte, avec un
<emphasized>mot</emphasized> emphatique.</mainBody>
Pour le mot emphatique du texte ci-dessus, le style emphasized est imbriqué dans le style
mainBody. Le style mainBody fournit les règles de couleur, de taille de police et de décoration. Le
style emphasized ajoute une règle d’épaisseur de police à ces règles. Le mot emphatique sera
formaté en associant les règles spécifiées par mainBody et emphasized.
Utilisation des classes de style
Vous pouvez créer des classes de style que vous pouvez appliquer à une balise <p> ou <span> en
utilisant l’attribut de classe de l’une des balises. Lorsqu’une balise <p> est appliquée, le style affecte
tout le paragraphe. Vous pouvez également appliquer un style à une plage de texte qui utilise une
classe de style à l’aide de la balise <span>.
Par exemple, la feuille de style suivante définit deux classes de style : mainBody et emphasis.
.mainBody {
font-family: Arial,Helvetica,sans-serif;
font-size: 24px;
}
.emphasis {
color: #666666;
font-style: italic;
}
A l’intérieur du texte HTML que vous affectez à un champ de texte, vous pouvez appliquer ces
styles aux balises <p> et <span> comme expliqué ci-dessous :
<p class="mainBody">C’est <span class="emphasis">très motivant !</span></p>
Définition du style de balises HTML intégrées
Flash Player supporte un sous-ensemble de balises HTML. Pour plus d’informations, consultez
Utilisation de texte au format HTML, page 151. Vous pouvez affecter un style CSS à chaque
occurrence d’une balise HTML intégrée qui apparaît dans un champ de texte. Par exemple, le
code suivant définit un style pour la balise HTML intégrée <p>. Toutes les occurrences de cette
balise verront leur style défini de la manière spécifiée par la règle de style :
p {
font-family: Arial,Helvetica,sans-serif;
font-size: 12px;
display: inline;
}148 Chapitre 8 :  Utilisation du texte
Le tableau suivant indique les balises HTML intégrées dont le style peut être défini, et la façon
dont chaque style est appliqué :
Exemple d’utilisation de styles avec HTML
Cette section présente un exemple de l’utilisation des styles avec des balises HTML. Vous créez
une feuille de style qui définit le style de certaines balises intégrées ainsi que certaines classes de
style. Vous appliquez ensuite cette feuille de style à un objet TextField qui contient du texte au
format HTML.
Pour formater un HTML à l’aide d’une feuille de style, effectuez les opérations suivantes :
1 Créez un fichier dans l’éditeur de texte de votre choix.
2 Ajoutez la définition de feuille de style suivante dans le fichier :
p {
color: #000000;
font-family: Arial,Helvetica,sans-serif;
font-size: 12px;
display: inline;
}
a:link {
color: #FF0000;
}
a:hover{
text-decoration: underline;
}
.headline {
color: #000000;
font-family: Arial,Helvetica,sans-serif;
font-size: 18px;
font-weight: bold;
display: block;
}
Nom de style Comment le style est appliqué
p Affecte toutes les balises <p>.
body Affecte toutes les balises <body>. S’il est spécifié, le style p est prioritaire par rapport
au style body.
li Affecte toutes les balises à puce <li>.
a Affecte toutes les balises d’ancrage <a>.
a:link Affecte toutes les balises d’ancrage <a>. Ce style est appliqué après tout style a.
a:hover Appliqué à une balise d’ancrage <a> lorsque la souris se déplace sur le lien. Ce style
est appliqué après tout style a et a:link.
Une fois que la souris s’éloigne du lien, le style a:hover est supprimé du lien.
a:active Appliqué à une balise d’ancrage <a> lorsque l’utilisateur clique avec la souris sur le
lien. Ce style est appliqué après tout style a et a:link.
Une fois que le bouton de la souris est relâché, le style a:active est supprimé du
lien.Formatage de texte avec les feuilles de style en cascade 149
.byline {
color: #666600;
font-style: italic;
font-weight: bold;
display: inline;
}
Cette feuille de style définit des styles pour deux balises HTML intégrées (<p> et <a>) qui
seront appliqués à toutes les occurrences de ces balises. Elle définit également deux classes de
style (.headline et .byline) qui seront appliquées à des paragraphes et à des plages de texte
spécifiques.
3 Enregistrez le fichier sous html_styles.css.
4 Dans Flash, créez un fichier FLA.
5 A l’aide de l’outil Texte, créez un champ de texte d’environ 400 pixels de large et 300 pixels de
haut.
6 Ouvrez l’inspecteur des propriétés (Fenêtre > Propriétés) et sélectionnez le champ de texte.
7 Dans l’inspecteur des propriétés, sélectionnez Texte dynamique dans le menu Type de texte,
sélectionnez Multiligne dans le menu Type de ligne, sélectionnez l’option Rendre le texte au
format HTML et tapez news_txt dans la zone de texte Nom de l’occurrence.
8 Sélectionnez la première image dans le calque 1 du scénario (Fenêtre > Scénario).
9 Ouvrez le panneau Actions (Fenêtre > Panneaux de développement > Actions) et ajoutez-lui le
code suivant :
// Créez un objet feuille de style
var feuille_style = new TextField.StyleSheet();
// Emplacement du fichier CSS qui définit les styles
var css_url = "html_styles.css";
// Créez du texte HTML à afficher
var storyText:String = "<p class=’headline’>Flash Player supporte désormais
les feuilles de style en cascade !</p><p><span class=’byline’>San
Francisco, Californie</span>--Macromedia Inc. annonce aujourd’hui une
nouvelle version de Flash Player qui supporte les styles de texte de
feuilles de style en cascade (CSS). Pour plus d’informations, visitez le
<a href=’http://www.macromedia.com’>site web Macromedia Flash.</a></p>";
// Chargez le fichier CSS et définissez le gestionnaire onLoad :
feuille_style.load(css_url);
feuille_style.onLoad = function(ok) {
if (ok) {
// Si la feuille de style a été chargée sans erreur,
// affectez-la à l’objet texte,
// et affectez le texte HTML au champ de texte.
news_txt.styleSheet = style_sheet;
news_txt.text = storyText;
}
};
Remarque : Pour plus de simplicité, le texte HTML dont le style doit être défini est « codé en dur »
dans le script. Dans une application réelle, vous chargeriez le texte à partir d’un fichier externe. Pour
plus d’informations sur le chargement de données externes, consultez le Chapitre 10, Utilisation de
données externes, page 185.
10 Enregistrez le fichier sous news_html.fla dans le même répertoire que celui contenant le fichier
CSS que vous avez créé précédemment.
11 Exécutez l’animation (Contrôle > Tester l’animation) pour voir les styles appliqués au texte
HTML automatiquement.150 Chapitre 8 :  Utilisation du texte
Utilisation de styles pour définir de nouvelles balises
Si vous définissez un nouveau style dans une feuille de style, ce style peut être utilisé comme
balise, comme vous utiliseriez une balise HTML intégrée. Par exemple, si une feuille de style
définit un style CSS nommé sectionHeading, vous pouvez utiliser <sectionHeading> comme
élément dans tout champ de texte associé à la feuille de style. Cette fonction vous permet
d’affecter directement du texte aléatoire au format XML dans un champ de texte, afin que le texte
soit automatiquement formaté en utilisant les règles de la feuille de style.
Par exemple, la feuille de style suivante crée les nouveaux styles sectionHeading, mainBody et
emphasized.
sectionHeading {
font-family: Verdana, Arial, Helvetica, sans-serif;
font-size: 18px; display: block
}
mainBody {
color: #000099;
text-decoration: underline;
font-size: 12px; display: block
}
emphasized {
font-weight: bold; display: inline
}
Vous pouvez ensuite remplir un champ de texte associé à cette feuille de style avec le texte au
format XML suivant :
<sectionHeading>Ceci est une section</sectionHeading>
<mainBody>Ceci est le corps principal du texte,
avec un <emphasized>mot</emphasized> emphatique.
</mainBody>
Exemple d’utilisation de styles avec XML
Dans cette section, vous créez le même fichier FLA que précédemment (consultez Exemple
d’utilisation de styles avec HTML, page 148), mais avec du texte au format XML. Dans cet
exemple, cependant, vous créez la feuille de style en utilisant ActionScript au lieu d’importer des
styles à partir d’un fichier CSS.
Pour formater du XML avec une feuille de style :
1 Dans Flash, créez un fichier FLA.
2 A l’aide de l’outil Texte, créez un champ de texte d’environ 400 pixels de large et 300 pixels de
haut.
3 Ouvrez l’inspecteur des propriétés (Fenêtre > Propriétés) et sélectionnez le champ de texte.
4 Dans l’inspecteur des propriétés, sélectionnez Texte dynamique dans le menu Type de texte,
sélectionnez Multiligne dans le menu Type de ligne, sélectionnez l’option Rendre le texte au
format HTML et tapez news_txt dans la zone de texte Nom de l’occurrence.
5 Dans le calque 1 du scénario (Fenêtre > Scénario), sélectionnez la première image.
6 Pour créer l’objet feuille de style, ouvrez le panneau Actions (Fenêtre > Panneaux de
développement > Actions) et ajoutez le code suivant au panneau Actions :
var xml_styles = new TextField.StyleSheet();
xml_styles.setStyle("mainBody", {
color:’#000000’,
fontFamily:’Arial,Helvetica,sans-serif’, Utilisation de texte au format HTML 151
fontSize:’12’,
display:’block’
});
xml_styles.setStyle("title", {
color:’#000000’,
fontFamily:’Arial,Helvetica,sans-serif’,
fontSize:’18’,
display:’block’,
fontWeight:’bold’
});
xml_styles.setStyle("byline", {
color:’#666666’,
fontWeight:’bold’,
fontStyle:’italic’,
display:’inline’
});
xml_styles.setStyle("a:link", {
color:’#FF0000’
});
xml_styles.setStyle("a:hover", {
textDecoration:’underline’
});
Ce code crée un nouvel objet feuille de style nommé xml_styles qui définit les styles à l’aide
de la méthode setStyle(). Les styles correspondent exactement à ceux que vous avez créés
dans un fichier CSS externe, précédemment dans ce même chapitre.
7 Pour créer du texte XML à affecter au champ de texte, ajoutez le code suivant au panneau
Actions :
var storyText = "<title>Flash Player supporte désormais CSS</
title><mainBody><byline>San Francisco, Californie</byline>--Macromedia
Inc. annonce aujourd’hui une nouvelle version de Flash Player qui prend en
charge les styles de texte de feuilles de style en cascade (CSS). Pour
plus d’informations, visitez le <a href=\"http://www.macromedia.com\">site
web de Macromedia Flash</a></mainBody>";
8 Enfin, ajoutez le code suivant pour appliquer l’objet feuille de style à la propriété styleSheet
du champ de texte et affectez le texte XML au champ de texte.
news_txt.styleSheet = xml_styles;
news_txt.text = storyText;
9 Enregistrez le fichier sous news_xml.fla.
10 Exécutez l’animation (Contrôle > Tester l’animation) pour voir les styles automatiquement
appliqués au texte dans le champ.
Utilisation de texte au format HTML
Flash Player supporte un sous-ensemble de balises HTML comme <p> et <li> que vous pouvez
utiliser pour attribuer un style à un texte dans un champ de texte dynamique ou de saisie. Dans
Flash Player 7 et les versions ultérieures, les champs de texte prennent également en charge la
balise <img>, qui vous permet d’intégrer les fichiers JPEG, SWF et les clips vidéo, dans un champ
de texte. Dans Flash Player, le texte enveloppe automatiquement les images intégrées dans les
champs de texte, de la même manière qu’un navigateur web enveloppe le texte autour des images
intégrées dans un document HTML. Pour plus d’informations, consultez Intégration des images,
fichiers SWF et des clips dans les champs de texte, page 156. 152 Chapitre 8 :  Utilisation du texte
Flash Player prend également en charge la balise <textformat>, qui vous permet d’appliquer les
styles de formatage de paragraphe de la classe TextFormat aux champs de texte HTML. Pour plus
d’informations, consultez Utilisation de la classe TextFormat, page 141.
Présentation de l’utilisation du texte au format HTML
Pour utiliser le format HTML dans un champ de texte, vous devez activer le formatage HTML
du champ de texte en sélectionnant l’option Rendre le texte au format HTML dans l’inspecteur
des propriétés ou en définissant la propriété html du champ de texte sur true. Pour insérer du
texte HTML dans un champ de texte, utilisez la propriété TextField.htmlText.
Par exemple, le code suivant active le formatage HTML pour un champ de texte nommé
titre_txt, puis lui affecte du texte HTML.
titre_txt.html = true;
titre_txt.htmlText = "<font face=’Times New Roman’ size=’24’>Voici comment
affecter du texte HTML à un champ de texte.</font>";
Les attributs des balises HTML doivent être encadrés de guillemets simples ou doubles. Les
valeurs des attributs dépourvues de guillemets peuvent engendrer des résultats inattendus, comme
le rendu incorrect du texte. Par exemple, le fragment de code HTML suivant ne sera pas rendu
correctement par Flash Player, car la valeur affectée à l’attribut align (left) n’est pas encadrée de
guillemets :
textField.htmlText = "<p align=left>Texte aligné sur la gauche</p>";
Si vous encadrez les valeurs d’attribut à l’aide de guillemets doubles, vous devez utiliser la fonction
d’échappement pour les guillemets (\"). Par exemple, l’une des solutions suivantes est possible :
textField.htmlText = "<p align=’left’>Guillemets simples utilisés</p>";
textField.htmlText = "<p align=\"left\">Guillemets doubles échappés</p>";
Il n’est pas nécessaire d’utiliser la fonction d’échappement pour les guillemets doubles si vous
chargez du texte à partir d’un fichier externe. Cette action est uniquement nécessaire pour
l’affectation des chaînes de texte dans ActionScript.
Balises HTML prises en charge
Cette section répertorie les balises HTML intégrées prises en charge par Flash Player. Vous pouvez
également créer de nouveaux styles et balises en utilisant les feuilles de style en cascade (consultez
Formatage de texte avec les feuilles de style en cascade, page 143).
balise d’ancrage (<a>)
La balise <a> crée un hyperlien et prend en charge les attributs suivants :
• href Spécifie l’URL de la page à charger dans le navigateur. L’URL peut être absolue ou
relative à l’emplacement du fichier SWF qui charge la page.
• target Spécifie le nom de la fenêtre cible dans laquelle charger la page.
Par exemple, le fragment de code HTML suivant crée le lien « Accueil », qui ouvre
www.macromedia.com dans une nouvelle fenêtre du navigateur.
<a href="../home.htm" target="_blank">Accueil</a>
Vous pouvez également définir des styles a:link, a:hover et a:active pour les balises d’ancrage
en utilisant les feuilles de style. Pour plus d’informations, consultez Définition du style de balises
HTML intégrées, page 147.Utilisation de texte au format HTML 153
Balise Bold (<b>)
La balise <b> rend le texte en caractères gras. Les caractères gras doivent être disponibles dans la
police utilisée pour afficher le texte.
<b>Ceci est du texte en gras.</b>
Balise Break (<br>)
La balise <br> crée un saut de ligne dans le champ de texte, comme indiqué dans l’exemple
suivant :
Une ligne de texte<br>Une autre ligne de texte<br>
Balise Font (<font>)
La balise <font> spécifie une police ou une liste de polices pour l’affichage du texte.
La balise font prend en charge les attributs suivants :
• color Seules les valeurs de couleur hexadécimales (#FFFFFF) sont prises en charge. Par
exemple, le code HTML suivant crée du texte rouge.
<font color="#FF0000">Texte rouge</font>
• face Spécifie le nom de la police à utiliser. Vous pouvez également spécifier une liste de
noms de polices séparés par des virgules, auquel cas Flash Player choisit la première police
disponible. Si la police spécifiée n’est pas installée sur le système de lecture ou si elle n’est pas
intégrée dans le fichier SWF, Flash Player choisit une police de remplacement.
Exemple :
<font face="Times, Times New Roman">Il s’agit soit de la police Times, soit
de la police Times New Roman..</font>
Pour plus d’informations sur l’intégration des polices dans les applications Flash, consultez
TextField.embedFonts, page 680 et « Définition des options de texte dynamique et de
saisie », dans le guide Utilisation de Flash de l’aide.
• size Spécifie la taille de la police, en pixels. Vous pouvez également utiliser des tailles de
points relatives (+2 ou -4).
<font size="24" color="#0000FF">Texte vert à 24 points </font>
balise image (<img>)
La balise <img> vous permet d’intégrer des fichiers JPEG, SWF et des clips externes à l’intérieur
des champs de texte. Le texte se déroule automatiquement autour des images intégrées dans les
champs de texte. Cette balise est prise en charge uniquement dans les champs de texte dynamique
et de saisie multilignes avec retour à la ligne automatique. 
Pour créer un champ de texte multiligne avec retour à la ligne automatique, effectuez l’une
des opérations suivantes :
• Dans l’environnement auteur Flash, sélectionnez un champ de texte sur la scène, puis, dans
l’inspecteur des propriétés, sélectionnez Multiligne dans le menu contextuel Type de texte.
• Pour un champ de texte créé à l’exécution avec MovieClip.createTextField(), définissez les
propriétés TextField.multiline et TextField.wordWrap de la nouvelle occurrence du
champ de texte sur true.154 Chapitre 8 :  Utilisation du texte
La balise <img> a un attribut requis, src, qui spécifie le chemin vers un fichier JPEG, un fichier
SWF ou l’identifiant de liaison d’un symbole de clip. Tous les autres attributs sont facultatifs.
Les balises <img> prennent en charge les attributs suivants :
• src  Spécifie l’URL vers un fichier JPEG ou SWF, ou l’identifiant de liaison pour un
symbole de clip dans la bibliothèque. Cet attribut est requis ; tous les autres attributs sont
facultatifs. Les fichiers externes (JPEG et SWF) ne s’affichent pas tant qu’ils ne sont pas
entièrement téléchargés.
Remarque : Flash ne supporte pas les fichiers JPEG tridimensionnels.
• id Spécifie le nom d’une occurrence de clip (créée par Flash Player) contenant le fichier
JPEG, SWF ou le clip intégré. Cette fonction s’avère utile pour contrôler le contenu intégré
avec ActionScript.
• width Largeur de l’image, du fichier SWF ou du clip, en pixels.
• height Hauteur de l’image, du fichier SWF ou du clip, en pixels.
• align Spécifie l’alignement horizontal de l’image intégrée dans le champ de texte. Les valeur
valides sont left et right. La valeur par défaut est left.
• hspace Spécifie l’espace horizontal qui entoure l’image là où aucun texte n’apparaît. La
valeur par défaut est 8.
• vspace Spécifie l’espace vertical qui entoure l’image là où aucun texte n’apparaît. La valeur
par défaut est 8.
Pour plus d’informations et d’exemples sur l’utilisation de la balise <img>, consultez Intégration
des images, fichiers SWF et des clips dans les champs de texte, page 156.
Balise Italic (<i>)
La balise <i> affiche le texte balisé en italique. Des caractères italiques doivent être disponibles
dans la police utilisée.
C’est très <i>intéressant</i>.
Le code ci-dessus serait rendu de la manière suivante :
C’est très intéressant.
Balise List item (<li>)
La balise <li> place une puce devant le texte qu’elle encadre.
Liste de courses :
<li>Pommes</li>
<li>Oranges</li>
<li>Citrons</li>
Le code ci-dessus serait rendu de la manière suivante :
Liste de courses :
■ Pommes
■ Oranges
■ CitronsUtilisation de texte au format HTML 155
Balise Paragraph (<p>)
La balise <p> crée un paragraphe. Elle prend en charge les attributs suivants :
• align Spécifie l’alignement du texte dans le paragraphe. Les valeurs valides sont left, right
et center.
• class Spécifie une classe de style CSS définie par un objet TextField.StyleSheet. Pour plus
d’informations, consultez Utilisation des classes de style, page 147.
L’exemple suivant utilise l’attribut align pour aligner le texte sur le côté droit d’un champ de
texte.
textField.htmlText = "<p align=’right’>Ce texte est aligné sur la droite
dans le champ de texte</p>";
L’exemple suivant utilise l’attribut class pour affecter une classe de style de texte à une balise
<p>.
var maFeuilleDeStyle = new TextField.StyleSheet();
maFeuilleDeStyle.secreateTextField("test", 10, 0,0, 300,100);
createTextField("test", 10, 0,0, 300,100);
test.styleSheet = maFeuilleDeStyle;
test.htmlText = "<p class=’body’>Ceci est du texte de style corps.</p>.";
Balise Span (<span>)
La balise <span> peut uniquement être utilisée avec les styles de texte CSS. Pour plus
d’informations, consultez Formatage de texte avec les feuilles de style en cascade, page 143. Elle
prend en charge les attributs suivants :
• class Spécifie une classe de style CSS définie par un objet TextField.StyleSheet. Pour plus
d’informations sur la création de classes de style, consultez Utilisation des classes de style,
page 147.
Balise Text format (<textformat>)
La balise <textformat> permet d’utiliser un sous-ensemble de propriétés de formatage des
paragraphes de la classe TextFormat dans les champs de texte HTML, y compris l’interlignage, le
retrait, les marges et les taquets de tabulation. Vous pouvez associer des balises <textformat> aux
balises HTML intégrées.
La balise <textformat> possède les attributs suivants :
• blockindent Spécifie l’indentation d’un bloc, en points. Correspond à
TextFormat.blockIndent. Pour plus d’informations, consultez TextFormat.blockIndent,
page 711.
• indent Spécifie l’indentation, de la marge gauche au premier caractère du paragraphe.
Correspond à TextFormat.indent. Pour plus d’informations, consultez TextFormat.indent,
page 714.
• leading Spécifie l’espace séparant les lignes (espace vertical). Correspond à
TextFormat.leading. Pour plus d’informations, consultez TextFormat.leading, page 715.
• leftmargin Spécifie la marge gauche du paragraphe, en points. Correspond à
TextFormat.leftMargin. Pour plus d’informations, consultez TextFormat.leftMargin,
page 715.156 Chapitre 8 :  Utilisation du texte
• rightmargin Spécifie la marge droite du paragraphe, en points. Correspond à
TextFormat.rightMargin. Pour plus d’informations, consultez TextFormat.rightMargin,
page 715.
• tabstops Spécifie des taquets de tabulation personnalisés, sous forme d’un tableau d’entiers
non négatifs. Correspond à TextFormat.tabStops. Pour plus d’informations, consultez
TextFormat.tabStops, page 716.
L’exemple de code suivant utilise l’attribut tabstops de la balise <textformat> pour créer un
tableau de données avec des en-têtes de lignes en gras, comme indiqué ci-dessous :
Pour créer un tableau de données formaté en utilisant des taquets de tabulation :
1 Utilisez l’outil Texte pour créer un champ de texte dynamique d’environ 300 pixels de largeur
et 100 pixels de hauteur.
2 Dans l’inspecteur des propriétés, saisissez tableau_txt dans le champ de texte Nom de
l’occurrence, sélectionnez Multiligne dans le menu Type de ligne et choisissez l’option Rendre
le texte au format HTML.
3 Dans le scénario, sélectionnez la première image sur le Calque 1.
4 Ouvrez le panneau Actions (Fenêtre > Panneaux de développement > Actions) et ajoutez-lui le
code suivant :
var rowHeaders = "<b>Nom\t</b><b>Age\t</b><b>Service";
var row_1 = "Thomas\t31\tIMD";
var row_2 = "Eluard\t42\tQA";
tableau_txt.htmlText = "<textformat tabstops=’[100, 200]’>";
tableau_txt.htmlText += rowHeaders;
tableau_txt.htmlText += row_1;
tableau_txt.htmlText += row_2 ;
tableau_txt.htmlText += "</textformat>";
Remarquez l’utilisation de la séquence d’échappement des caractères de tabulation (\t) pour
ajouter des tabulations entre chaque « colonne » dans le tableau.
5 Choisissez Contrôle > Tester l’animation pour tester l’animation.
Balise Underline (<u>)
La balise <u> souligne le texte balisé.
Ce texte est <u>souligné</u>.
Le code ci-dessus serait rendu de la manière suivante :
Ce texte est souligné.
Intégration des images, fichiers SWF et des clips dans les champs de texte
Dans Flash Player 7 et les versions ultérieures, vous pouvez utiliser la balise <img> pour intégrer
les fichiers JPEG, les fichiers SWF, ainsi que les clips, dans les champs de texte dynamique et de
saisie. (pour obtenir la liste complète des attributs de la balise <img>, consultez balise image
(<img>), page 153).
Nom Age Service
Thomas 32 IMD
Eluard 46 IngénierieUtilisation de texte au format HTML 157
Par défaut, Flash affiche le média intégré dans un champ de texte, à sa taille normale. Pour
spécifier les dimensions du média intégré, utilisez les attributs height et width de la balise <img>.
Pour plus d’informations, consultez Spécification des valeurs de hauteur et de largeur, page 157.
En général, une image intégrée dans un champ de texte apparaît sur la ligne qui suit la balise
<img>. Cependant, lorsque la balise <img> est le premier caractère dans le champ de texte, l’image
apparaît sur la première ligne du champ de texte.
Intégration des fichiers SWF et JPEG
Pour intégrer un fichier JPEG ou SWF dans un champ de texte, spécifiez le chemin absolu ou
relatif qui mène au fichier JPEG ou SWF dans l’attribut src de la balise <img>. Par exemple, le
code suivant insère un fichier JPEG situé dans le même répertoire que le fichier SWF.
textField_txt.htmlText = "<p>Voici une photo de mes dernières vacances :<img
src=’plage.jpg’>";
Intégration de symboles de clip
Pour intégrer un symbole de clip dans un champ de texte, spécifiez l’identifiant de liaison du
symbole pour l’attribut src de la balise <img> (pour plus d’informations sur la définition d’un
identifiant de liaison, consultez Association d’un symbole de clip à la scène, page 131).
Par exemple, le code suivant insère un symbole de clip dont l’idenfiant de liaison est symbol_ID.
textField_txt.htmlText = "<p>Voici un symbole de clip :<img src=’symbol_ID’>";
Pour qu’un clip intégré soit correctement et entièrement affiché, le point d’alignement de son
symbole doit être (0,0).
Spécification des valeurs de hauteur et de largeur
Si vous spécifiez les attributs width et height d’une balise <img>, un espace est réservé dans le
champ de texte pour le fichier JPEG, SWF ou le clip. Une fois le fichier JPEG ou SWF
entièrement téléchargé, il est affiché dans l’espace réservé. Flash modifie la taille du média en
fonction des valeurs height et width.
Si vous ne spécifiez pas de valeurs height et width, aucun espace n’est réservé au média intégré.
Une fois le fichier JPEG ou SWF téléchargé, Flash l’insère dans le champ de texte à sa taille
normale et sépare de nouveau le texte autour de lui.
Contrôle du média intégré avec ActionScript
Flash Player crée un nouveau clip pour chaque balise <img> et l’intègre dans l’objet TextField.
L’attribut id de la balise <img> permet d’affecter un nom d’occurrence au clip créé et de contrôler
ainsi le clip avec ActionScript.
Le clip créé par Flash Player est ajouté en tant que clip enfant du champ de texte contenant
l’image.
Par exemple, le code suivant intègre un fichier SWF nommé animation.swf dans le champ de
texte nommé textField_txt au niveau 0 et affecte le nom d’occurrence animation_mc au clip
contenant le fichier SWF.
_level0.textField_txt.htmlText = "Voici une animation intéressante : <img
src=’animation.swf’ id=’animation_mc’>158 Chapitre 8 :  Utilisation du texte
Dans ce cas, le chemin entièrement qualifié vers le nouveau clip créé est
_level0.textField_txt.animation_mc. Vous pouvez, par exemple, associer le code suivant à
un bouton (dans le même scénario que textField_txt) afin d’arrêter la tête de lecture du fichier
SWF intégré.
on(press) {
textField_txt.animation_mc.stop();
}
Création d’hyperliens à partir d’un média intégré
Pour créer un hyperlien à partir d’un fichier JPEG, SWF ou d’un clip intégré, incluez la balise
<img> dans une balise <a> :
textField.htmlText = "Cliquez sur l’image pour retourner à la page d’accueil<a
href=’accueil.htm’><img src=’accueil.jpg’></a>";
Lorsque le pointeur de la souris survole une image, un fichier SWF ou un clip que vous avez placé
entre des balises <a>, il prend la forme d’une « main », à l’instar des hyperliens standard.
L’interactivité, telle que les clics de souris et la pression sur les touches du clavier, n’est pas
enregistrée dans les fichiers SWF et les clips placés entre les balises <a>.
Création de texte défilant
Il existe plusieurs manières de créer du texte défilant dans Flash. Pour faire défiler des champs de
texte dynamique et de saisie, vous pouvez sélectionner l’option Défilant dans le menu Texte ou le
menu contextuel, ou double-cliquer sur la poignée du bloc de texte tout en maintenant la touche
Maj enfoncée.
Vous pouvez utiliser les propriétés scroll et maxscroll de l’objet TextField pour contrôler le
défilement vertical et les propriétés hscroll et maxhscroll pour contrôler le défilement
horizontal d’un bloc de texte. Les propriétés scroll et hscroll spécifient respectivement les
positions de défilement vertical et horizontal ; vous pouvez lire et rédiger ces propriétés. Les
propriétés maxscroll et maxhscroll spécifient respectivement les positions verticales et
horizontales maximales ; vous pouvez uniquement lire ces propriétés.
Le composant TextArea de Flash MX 2004 offre un moyen aisé de créer un champ de texte
défilant avec un minimum de programmation. Pour plus d’informations, consultez l’entrée
relative au composant TextArea, dans le guide Utilisation des composants de l’aide.
Pour créer un bloc de texte dynamique défilant, effectuez l’une des opérations suivantes :
• Double-cliquez sur la poignée du bloc de texte dynamique tout en maintenant la touche maj
enfoncée.
• Sélectionnez le bloc de texte dynamique à l’aide de l’outil Flèche et choisissez Texte > Défilant.
• Sélectionnez le bloc de texte dynamique avec l’outil Flèche. Cliquez avec le bouton droit de la
souris (Windows) ou cliquez en appuyant sur la touche Control (Macintosh) sur le bloc de
texte dynamique, puis sélectionnez Texte > Défilant.
Pour utiliser la propriété scroll afin de créer du texte défilant :
1 Effectuez l’une des opérations suivantes :
■ Sélectionnez l’outil Texte et tracez un champ de texte sur la scène. Affectez le nom
d’occurrence textField au champ de texte dans l’inspecteur des propriétés.Création de texte défilant 159
■ Utilisez ActionScript pour créer un champ de texte dynamiquement à l’aide de la méthode
MovieClip.createTextField(). Affectez le nom d’occurrence textField au champ de
texte en tant que paramètre de la méthode.
2 Créez un bouton Vers le haut et un bouton Vers le bas ou choisissez Fenêtre > Autres panneaux
> Bibliothèques communes > Boutons, puis faites glisser vos boutons sur la scène.
Vous utiliserez ces boutons pour faire défiler le texte vers le haut et vers le bas.
3 Sélectionnez le bouton Vers le bas sur la scène.
4 Dans le panneau Actions (Fenêtre > Panneaux de développement > Actions), entrez le code
suivant pour faire défiler le texte vers le bas dans le champ de texte :
on (press) {
textField.scroll += 1;
}
5 Sélectionnez le bouton Vers le haut sur la scène.
6 Dans le panneau Actions, entrez le code suivant pour faire défiler le texte vers le haut :
on (press) {
textField.scroll += 1;
}
Close collapsed procedure160 Chapitre 8 :  Utilisation du texte161
CHAPITRE 9
Création de classes avec ActionScript 2.0
ActionScript 2.0 est une restructuration du langage ActionScript. Il offre de nouvelles fonctions
de programmation, déjà disponibles dans d’autres langages, tels que Java. ActionScript 2.0
encourage les structures de programme réutilisables, évolutives, robustes et pouvant être gérées. Il
permet également de réduire le temps imparti au développement, en offrant aux utilisateurs une
aide à la programmation et des informations de débogage approfondies. ActionScript 2.0 respecte
les normes existantes. Il est basé sur le projet ECMAScript 4 (www.mozilla.org/js/language/es4/).
ActionScript 2.0 est disponible dans Macromedia Flash MX 2004 et Macromedia Flash MX
Professionnel 2004.
Les fonctionnalités d’ActionScript 2.0 sont décrites ci-dessous.
Modèle familier de programmation orientée objet (OOP) La principale fonction
d’ActionScript 2.0 est un modèle familier pour la création de programmes orientés objet.
ActionScript 2.0 introduit plusieurs nouveaux concepts et mots-clés orientés objet, tels que class,
interface et packages qui vous sembleront familiers si vous avez déjà programmé en Java.
Le modèle OOP d’ActionScript 2.0 est une « formalisation syntaxique » de la méthode de
chaînage de prototype utilisée dans les précédentes versions de Macromedia Flash pour créer des
objets et établir une relation d’héritage.
Typage strict des données  ActionScript 2.0 vous permet également de spécifier explicitement
des types de données pour les variables, paramètres de fonction et types de retour de fonction. Par
exemple, le code suivant déclare une variable appelée nomDutilisateur de type chaîne (un type
de données ActionScript intégré ou une classe).
var nomDutilisateur:String = "";
Avertissements et messages d’erreur du compilateur  Les deux précédentes fonctions
permettent à l’outil de programmation et au compilateur de générer des avertissements et
messages d’erreur qui vous aident à localiser les bogues de vos applications dans Flash plus
rapidement qu’auparavant.
Attention : Si vous souhaitez utiliser la syntaxe d’ActionScript 2.0, vérifiez que les paramètres de
publication du fichier FLA indiquent ActionScript 2.0. Il s’agit de la configuration par défaut pour les
fichiers créés dans Flash MX 2004. Toutefois, si vous ouvrez un ancien fichier FLA qui utilise
ActionScript 1 et que vous commencez à le réécrire dans ActionScript 2.0, vous devez régler les
paramètres de publication du fichier FLA sur ActionScript 2.0. Sinon, votre fichier FLA ne sera pas
compilé correctement et aucune erreur ne sera générée. 162 Chapitre 9 :  Création de classes avec ActionScript 2.0
Principes de la programmation orientée objet
Cette section est une rapide introduction aux principes du développement de programmes
orientés objet. Ces principes sont présentés de façon plus approfondie dans le présent chapitre ;
leur implémentation dans Macromedia Flash MX 2004 et Macromedia Flash MX
Professionnel 2004 est notamment expliquée en détail.
Objets
Pensez à un « objet » du monde réel, un chat, par exemple. Supposons qu’un chat ait des
propriétés (ou états) telles que nom, âge et couleur, et des comportements tels que dormir, manger
et ronronner. Dans le monde de la programmation orientée objet, les objets ont également des
propriétés et des comportements. En utilisant les techniques de programmation orientée objet,
vous pouvez modeler un objet du monde réel (comme un chat) ou quelque chose de plus abstrait
(un processus chimique, par exemple).
Classes et membres de classe
Continuons, si vous le voulez bien, avec l’analogie du monde réel. Supposons qu’il existe des chats
de couleur, d’âge et de nom différents, qui mangent et ronronnent de façon différente. Mais tous
les chats appartiennent à une certaine classe d’objet, un objet de type « chat ». Chaque chat
(monde réel), considéré individuellement, est une occurrence du type de la classe chat. 
De la même façon, dans la programmation orientée objet, une classe définit un modèle pour un
type d’objet. Les caractéristiques et comportements qui appartiennent à une classe sont appelés
membres de cette classe. Les caractéristiques (dans l’exemple du chat, nom, âge et couleur) sont
appelées propriétés de la classe. Elles sont représentées sous forme de variables. Les comportements
(manger, dormir) sont appelés méthodes de la classe ; ils sont représentés sous forme de fonctions.
Par exemple, vous pouvez créer une classe Personne, puis créer une personne individuelle
correspondant à une occurrence de cette classe, appelée objet Personne. L’objet Personne contient
l’ensemble des propriétés et méthodes de la classe Personne.
Dans ActionScript, vous définissez une classe à l’aide de l’instruction class (consultez Création et
utilisation de classes, page 167). ActionScript inclut plusieurs classes intégrées, telles que les classes
MovieClip, TextField et String. Pour plus d’informations, consultez le Chapitre 6, Utilisation des
classes intégrées, page 117.
Héritage
L’un des principaux avantages de la programmation orientée objet est que vous pouvez créer des
sous-classes de classe. La sous-classe hérite alors de l’ensemble des propriétés et méthodes de la
superclasse. La sous-classe définit en général des méthodes et propriétés supplémentaires ou permet
d’étendre la superclasse. Les sous-classes peuvent également supplanter (apporter leurs propres
définitions) des méthodes héritées d’une superclasse.
Par exemple, vous créez une classe Mammifère qui définit certaines propriétés et certains
comportements communs à tous les mammifères. Vous pouvez alors créer une classe Chat qui
permet d’étendre la classe Mammifère. De cette manière, l’héritage peut promouvoir la
réutilisation du code : au lieu de créer à nouveau le code commun aux deux classes, il vous suffit
d’étendre la classe existante. Une autre sous-classe peut, à son tour, étendre la classe Chat, et ainsi
de suite. Dans une application complexe, la définition de la structure hiérarchique des classes
représente une grande partie du processus de création.Utilisation des classes : un exemple simple 163
Dans ActionScript, utilisez le mot-clé extends pour créer une relation d’héritage entre une classe
et sa superclasse. Pour plus d’informations, consultez Création de sous-classes, page 169.
Interfaces
Les interfaces, dans le cadre de la programmation orientée objet, peuvent être décrites comme des
classes dont les méthodes ne sont pas implémentées (définies). Une autre classe peut implémenter
les méthodes déclarées par l’interface.
Une interface peut également être vue comme un « contrat de programmation » pouvant être
utilisé pour appliquer des relations entre des classes sans lien. Par exemple, supposons que vous
travaillez avec une équipe de programmeurs et que chacun de vous travaille sur une partie (classe)
différente de la même application. Lors de la réalisation de l’application, vous vous mettez
d’accord sur un ensemble de méthodes que les différentes classes utiliseront pour communiquer.
Ainsi, vous créez une interface qui déclare ces méthodes, leurs paramètres et leurs types de retour.
Toute classe qui implémente cette interface doit fournir des définitions pour ces méthodes ; dans
le cas contraire, une erreur du compilateur se produira.
Vous pouvez également utiliser les interfaces pour créer une forme limitée d’« héritage multiple »,
ce qui n’est pas autorisé dans ActionScript 2.0. Dans le cas d’un héritage multiple, une classe
s’étend sur plusieurs classes. Par exemple, en C++, la classe Chat peut étendre la classe
Mammifère, ainsi que la classe Espiègle, qui a les méthodes CourirAprèsQueue et
FaireUnSomme. ActionScript 2.0, comme Java, n’autorise pas qu’une classe étende plusieurs
classes directement. Toutefois, vous pouvez créer une interface Espiègle qui déclare les méthodes
CourirAprèsQueue et FaireUnSomme. Une classe Chat ou toute autre classe peut alors
implémenter cette interface et fournir des définitions pour ces méthodes.
Pour plus d’informations, consultez Création d’une interface, page 174.
Utilisation des classes : un exemple simple
Pour ceux qui débutent dans la programmation orientée objet, cette section est une présentation
des tâches liées à la création et à l’utilisation des classes dans Flash. Le flux de travail implique les
étapes suivantes (au minimum) :
1 Définition d’une classe dans un fichier de classe ActionScript externe.
2 Enregistrement du fichier de classe dans un répertoire de chemin de classe désigné (un
emplacement où Flash va chercher les classes).
3 Création d’une occurrence de la classe dans un autre script, soit dans un document Flash (FLA),
soit dans un fichier de script externe, ou création d’une sous-classe basée sur la classe d’origine.
Cette section présente également une nouvelle fonction d’ActionScript 2.0, appelée typage strict
des données. Elle vous permet de spécifier le type de données d’une variable, d’un paramètre de
fonction ou d’un type de renvoi de fonction.
Bien que cette section n’aborde que les classes, le déroulement général du travail est le même pour
l’utilisation des interfaces. Pour plus d’informations, consultez Création et utilisation d’interfaces,
page 173.164 Chapitre 9 :  Création de classes avec ActionScript 2.0
Création d’un fichier de classe
Pour créer une classe, vous devez tout d’abord créer un fichier ActionScript (AS) externe. Classes
(et interfaces) peuvent uniquement être définies dans des fichiers de script externes. Par exemple,
vous ne pouvez pas définir une classe dans un script associé à une image ou à un bouton dans un
document Flash (FLA). Pour créer un fichier AS externe, utilisez l’éditeur ActionScript inclus
dans Flash, ou l’éditeur de code ou de texte de votre choix.   
Remarque : Le code ActionScript dans les fichiers externes est compilé dans un fichier SWF lors de
la publication, de l’exportation, du test ou du débogage d’un fichier FLA. Cela signifie que si vous
apportez des modifications à un fichier externe, vous devez enregistrer le fichier et recompiler tous
les fichiers FLA qui l’utilisent.
Dans les étapes suivantes, vous allez créer une classe appelée Personne, contenant deux propriétés
(âge et nom) et une seule méthode (showInfo()) qui affiche les valeurs de ces propriétés dans le
panneau de sortie.
Pour créer le fichier de classe :
1 Créez un nouveau répertoire sur votre disque dur et nommez-le FichiersPersonne. Ce répertoire
comprendra tous les fichiers de ce projet.
2 Effectuez l’une des opérations suivantes :
■ Créez un fichier dans l’éditeur de texte ou de code de votre choix.
■ (Flash MX Professionnel uniquement) Pour ouvrir la boîte de dialogue Nouveau document,
choisissez Fichier > Nouveau, choisissez Fichier ActionScript dans la liste des types de
fichier, puis cliquez sur OK. La fenêtre de script s’ouvre sur un fichier vide.
3 Enregistrez le fichier sous Personne.as dans le répertoire FichiersPersonne.
4 Dans la fenêtre de script, entrez le code suivant :
class Personne {
}
Cela s’appelle la déclaration de classe. Dans sa forme la plus simple, une déclaration de classe
comprend le mot-clé class, suivi du nom de la classe (Personne, dans ce cas), puis des
accolades d’ouverture et de fermeture ({}). Tout ce qui est compris dans les accolades est appelé
corps de la classe et c’est à cet endroit que les propriétés et méthodes de la classe sont définies.
Remarque : Le nom de la classe (Personne) correspond au nom du fichier AS qui la contient
(Personne.as). Cela est très important. Si ces deux noms ne correspondent pas, la compilation de
classe échoue.
5 Pour créer les propriétés de la classe Personne, utilisez le mot-clé var pour définir deux variables
appelées âge et nom, comme indiqué ci-dessous.Utilisation des classes : un exemple simple 165
class Personne {
var âge:Number;
var nom:String;
}
Conseil : Par convention, les propriétés de la classe sont définies au-dessus du corps de la classe,
ce qui facilite la compréhension du code. Mais ce n’est pas obligatoire.
Notez bien la présence des deux-points dans la syntaxe (var âge:Number et var nom:String)
utilisée pour la déclaration des variables. Ceci est un exemple de typage strict des données.
Lorsque vous tapez une variable de cette façon, (var nomDeVariable:TypeDeVariable), le
compilateur ActionScript 2.0 s’assure que la valeur affectée à cette variable correspond au type
spécifié. Bien que cette syntaxe ne soit pas obligatoire, il est recommandé de la respecter. Elle
peut d’ailleurs vous permettre de déboguer plus facilement vos scripts. Pour plus
d’informations, consultez Typage strict des données, page 40.
6 Ensuite, créez la méthode showInfo(), qui renvoie une chaîne pré-formatée contenant les
valeurs des propriétés âge et nom. Ajoutez la définition de fonction showInfo() au corps de la
classe, comme indiqué ci-dessous.
class Personne {
var âge:Number;
var nom:String;
// Méthodes pour renvoyer les valeurs des propriétés
function showInfo():String {
return("Bonjour, je m’appelle" + nom + " et j’ai " + âge + " ans.");
}
}
Notez l’utilisation du typage des données (facultatif, mais recommandé) dans la définition de la
fonction.
function showInfo():String {...}
Dans ce cas, c’est la valeur renvoyée (chaîne) de la fonction showInfo() qui est typée.
7 La dernière partie de code que vous ajoutez dans cette section concerne une fonction spéciale
appelée fonction constructeur. En programmation orientée objet, la fonction constructeur
initialise toutes les nouvelles occurrences d’une classe.
La fonction constructeur a toujours le même nom que la classe. Pour créer la fonction
constructeur de la classe, ajoutez le code suivant :
class Personne {
var âge:Number;
var nom:String;
// Méthodes pour renvoyer les valeurs des propriétés
function showInfo():String {
return("Bonjour, je m’appelle " + nom + " et j’ai " + âge + " ans.");
}
// Fonction constructeur
function Personne (monNom:String, monAge:Number) {
nom = monNom;
âge = monAge;
}
}166 Chapitre 9 :  Création de classes avec ActionScript 2.0
La fonction constructeur Personne() prend en compte deux paramètres, monNom et monAge, et
affecte ces paramètres aux propriétés nom et âge. Les deux paramètres de la fonction sont
strictement typés, respectivement comme chaîne et nombre. Pour plus d’informations sur les
fonctions constructeur, consultez Fonctions constructeur, page 170.
Remarque : Si vous ne créez pas de fonction constructeur, une fonction constructeur vide est
automatiquement créée pendant la compilation.
8 Enregistrez le fichier sous Personne.as dans le répertoire FichiersPersonne que vous avez créé à
l’étape 1.
Si vous utilisez Flash MX 2004 (et non Flash Professionnel), passez à la section suivante.
9 (Flash Professionnel uniquement) Vérifiez la syntaxe du fichier de classe en choisissant Outils >
Vérifier la syntaxe, ou en appuyant sur Ctrl+T (Windows) ou Commande+T (Macintosh).
Si des erreurs sont signalées dans le panneau de sortie, comparez le code de votre script au code
final de l’étape 7, ci-dessus. Si vous ne pouvez pas corriger les erreurs de code, copiez le code
terminée à l’étape 7, à partir de panneau d’aide.
Création d’une occurrence de la classe Personne
L’étape suivante permet de créer une occurrence de la classe Personne dans un autre script, tel
qu’un script d’image dans un document Flash (FLA) ou dans un autre script AS, et de l’affecter à
une variable. Pour créer une occurrence de classe personnalisée, utilisez l’opérateur new, comme
pour créer une occurrence de classe ActionScript intégrée (telle que les classes XML ou TextField).
Par exemple, le code suivant crée une occurrence de la classe Personne et l’affecte à la variable
nouvellePersonne.
var nouvellePersonne:Person = new Personne("Nadine", 32);
Cette classe invoque la fonction constructeur de la classe Personne, en transmettant comme
paramètres les valeurs "Nadine" et 32.
La variable nouvellePersonne est typée en tant qu’objet Personne. Cette manière de typer les
objets permet au compilateur de s’assurer que vous n’essayez pas d’accéder aux propriétés ou aux
méthodes qui ne sont pas définies dans cette classe (sauf si vous déclarez que la classe est
dynamique en utilisant le mot clé dynamic). Pour plus d’informations, consultez Création de
classes dynamiques, page 180.
Pour créer une occurrence de la classe Personne dans un document Flash :
1 Dans Flash, choisissez Fichier > Nouveau, choisissez Document Flash dans la liste des types de
documents, et cliquez sur OK.
2 Enregistrez le fichier sous créerPersonne.fla dans le répertoire FichiersPersonne que vous avez
créé précédemment.
3 Dans le scénario, choisissez Calque 1, puis ouvrez le panneau Actions (Fenêtre > Panneaux de
développement > Actions).
4 Dans le panneau Actions, entrez le code suivant :
var Personne_1:Person = new Personne("Nadine", 32);
var personne_2:Person = new Personne("Julie", 28);
trace(personne_1.showInfo());
trace(personne_2.showInfo());
Le code ci-dessus permet de créer deux occurrences de la classe Personne, personne_1 et
personne_2, et d’appeler la méthode showInfo() sur chaque occurrence.Création et utilisation de classes 167
5 Enregistrez votre travail, puis choisissez Contrôle > Tester l’animation. Les informations
suivantes doivent s’afficher dans le panneau de sortie :
Bonjour, je m’appelle Nadine et j’ai 32 ans.
Bonjour, je m’appelle Julie et j’ai 28 ans.
Lorsque vous créez une occurrence de classe en appelant sa fonction constructeur, Flash recherche
un fichier AS portant le même nom que le constructeur dans un ensemble prédéterminé
d’emplacements de répertoires. Cet ensemble d’emplacements de répertoires est appelé chemin de
classe (consultez Compréhension du chemin de classe, page 175).
A présent, vous devriez avoir une vision globale de la création et de l’utilisation des classes dans les
documents Flash. La suite de ce chapitre aborde plus en détail les classes et les interfaces.
Création et utilisation de classes
Comme nous avons l’avons vu précédemment, une classe se compose de deux parties : la
déclaration et le corps. La déclaration de la classe comporte au minimum l’instruction class,
suivie de l’identifiant du nom de la classe, puis des accolades d’ouverture et de fermeture. Tout ce
qui est compris dans les accolades constitue le corps de la classe.
class nomDeLaClasse {
// corps de la classe
}

Les occurrences de la classe Personne peuvent désormais ajouter et accéder aux propriétés et
méthodes qui ne sont pas définies dans la classe originale.
var une_personne:Personne = new Personne();
une_personne.couleurCheveux = "bleu"; // aucune erreur de compilation car
cette classe est dynamique
Les sous-classes des classes dynamiques sont également des classes dynamiques.
Compilation et exportation des classes
Par défaut, les classes utilisées par un fichier SWF sont mises en paquets et exportées vers la
première image du fichier SWF. Vous pouvez également spécifier l’image où vos classes sont mises
en paquets et exportées. Cette option est très pratique, par exemple lorsqu’un fichier SWF utilise
de nombreuses classes longues à télécharger. Si les classes sont exportées vers la première image,
l’utilisateur doit attendre que tout le code de classe soit téléchargé avant de voir apparaître cette
image. En spécifiant une image ultérieure dans le scénario, vous pouvez afficher une courte
animation de chargement dans les premières images du scénario, pendant le téléchargement du
code de classe dans l’image ultérieure.   
Pour spécifier l’image à exporter pour les classes d’un document Flash :
1 Lorsqu’un fichier FLA est ouvert, choisissez Fichier > Paramètres de publication.
2 Dans la boîte de dialogue Paramètres de publication, cliquez sur l’onglet Flash.
3 Cliquez sur le bouton Paramètres qui se trouve en regard du menu contextuel de la version
ActionScript pour ouvrir la boîte de dialogue Paramètres ActionScript.
4 Dans le champ de texte Exporter l’image pour les classes, saisissez le numéro de l’image où vous
voulez exporter votre code de classe.
Si l’image spécifiée n’existe pas dans le scénario, un message d’erreur apparaît lors de la
publication du fichier SWF.
5 Cliquez sur OK pour fermer la boîte de dialogue Paramètres ActionScript, puis cliquez de
nouveau sur OK pour fermer la boîte de dialogue Paramètres de publication.182 Chapitre 9 :  Création de classes avec ActionScript 2.0PARTIE IV
Utilisation des données et des médias externes
Cette section présente l’intégration de données et de médias externes dans vos applications
Macromedia Flash.
Chapitre 10: Utilisation de données externes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Chapitre 11: Utilisation de médias externes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
PARTIE  IV185
CHAPITRE 10
Utilisation de données externes
Dans Macromedia Flash MX 2004 et Macromedia Flash MX Professionnel 2004, vous pouvez
utiliser ActionScript pour charger des données provenant de sources externes dans un
fichier SWF. Vous pouvez également envoyer des données de fichier SWF afin qu’elles soient
traitées par un serveur d’application (comme Macromedia ColdFusion MX ou Macromedia
JRun) ou par un autre type de script côté serveur comme PHP ou Perl. Flash Player peut envoyer
et charger des données sur HTTP, HTTPS ou à partir d’un fichier texte local. Vous pouvez
également créer des connexions socket TCP/IP persistantes pour des applications qui requièrent
un court délai (ex. : applications de dialogue en ligne ou services de devis).
Il est possible de formater les données que vous chargez ou que vous envoyez à partir d’un fichier
SWF sous forme d’un fichier XML (Extensible Markup Language) ou de paires nom-valeur.
Flash Player peut également échanger des données avec son environnement hôte (un navigateur
web, par exemple) ou avec une autre occurrence de Flash Player sur le même ordinateur.
Par défaut, un fichier SWF peut seulement accéder à des données se trouvant sur le même
domaine que le domaine d’origine du clip Flash (par exemple, www.macromedia.com). Pour plus
d’informations, consultez Fonctions de sécurité de Flash Player, page 196.
Echange de variables avec une source distante
Un fichier SWF est une fenêtre permettant de saisir et d’afficher des informations, un peu comme
une page HTML. Cependant, les fichiers SWF peuvent rester chargés dans le navigateur et être
mis à jour en permanence à l’aide de nouvelles informations sans qu’il soit nécessaire d’actualiser
toute la page. Grâce aux fonctions et méthodes d’ActionScript, vous pouvez envoyer et recevoir
des informations à partir de scripts côté serveur, de fichiers texte et de fichiers XML.     
En outre, les scripts côté serveur peuvent demander des informations précises à une base de
données et les transmettre à un fichier SWF. Les scripts côté serveur peuvent être rédigés en
plusieurs langages, les plus communs étant CFML, Perl, ASP (Microsoft Active Server Pages) et
PHP. Le stockage et l’extraction des informations par le biais d’une base de données vous permet
de créer un contenu dynamique et personnalisé pour votre fichier SWF. Par exemple, vous
pourriez créer un tableau de messages, des profils personnels pour les utilisateurs ou un panier
suivant ce qu’un utilisateur a acheté afin de déterminer ses préférences.
Plusieurs fonctions et méthodes d’ActionScript vous permettent d’échanger des informations avec
un fichier SWF. Chaque fonction ou chaque méthode utilise un protocole pour transférer les
informations, dont le format doit être spécifique.    186 Chapitre 10 :  Utilisation de données externes
• Les fonctions et les méthodes MovieClip utilisant le protocole HTTP ou HTTPS pour
envoyer des informations au format de code URL sont getURL(), loadVariables(),
loadVariablesNum(), loadMovie() et loadMovieNum().   
• Les méthodes LoadVars utilisant le protocole HTTP ou HTTPS pour échanger des
informations au format de code URL sont load(), send() et sendAndLoad().
• Les méthodes utilisant le protocole HTTP ou HTTPS pour échanger des informations sous
forme de fichiers XML sont XML.send(), XML.load() et XML.sendAndLoad().
• Les méthodes qui créent et utilisent une connexion socket TCP/IP pour échanger des
informations sous forme de fichiers XML sont XMLSocket.connect() et XMLSocket.send().
Vérification des données chargées
Chaque fonction ou méthode qui charge des données vers un fichier SWF (sauf
XMLSocket.send()) est asynchrone : les résultats de l’action sont renvoyés à un moment
indéterminé.     
Avant de pouvoir utiliser les données chargées dans un fichier SWF, vous devez d’abord vérifier si
elles ont bien été chargées. Par exemple, vous ne pouvez pas charger des variables et en manipuler
les valeurs dans le même script. Dans le script suivant, vous ne pouvez pas utiliser la variable
dernièreImageConsultée tant que vous n’êtes pas certain que la variable a été chargée depuis le
fichier mesDonnées.txt : 
loadVariables("mesDonnées.txt", 0);
gotoAndPlay(dernièreImageConsultée);
Chaque fonction ou méthode possède une technique spécifique que vous pouvez utiliser pour
vérifier les données qui ont été chargées. Si vous utilisez loadVariables() ou loadMovie(),
vous pouvez charger des informations dans une cible de clip et utiliser l’événement data du
gestionnaire onClipEvent() pour exécuter un script. Si vous utilisez loadVariables() pour
charger les données, le gestionnaire onClipEvent(data) est exécuté une fois la dernière variable
chargée. Si vous utilisez loadMovie() pour charger les données, le gestionnaire
onClipEvent(data) est exécuté chaque fois qu’une partie du fichier SWF est transmise à Flash
Player.   
Par exemple, l’action de bouton suivante charge les variables depuis le fichier mesDonnées.txt
dans le clip cibleChargeMC :
on (release) {
loadVariables("mesDonnées.txt", _root.cibleChargeMC);
}
Un gestionnaire onClipEvent() affecté à l’occurrence cibleChargeMC utilise la variable
dernièreImageConsultée, chargée depuis le fichier mesDonnées.txt. L’action suivante n’est
exécutée qu’une fois que toutes les variables, y compris dernièreImageConsultée, sont
chargées :
onClipEvent(data) {
goToAndPlay(dernièreImageConsultée);
}Echange de variables avec une source distante 187
Si vous utilisez les méthodes XML.load(), XML.sendAndLoad() et XMLSocket.connect(), vous
devez définir un gestionnaire qui traitera les données dès leur arrivée. Ce gestionnaire est une
propriété d’un objet XML ou XMLSocket auquel vous affectez une fonction que vous avez
définie. Les gestionnaires sont automatiquement appelés lorsque les informations sont reçues.
Pour l’objet XML, utilisez XML.onLoad() ou XML.onData(). Pour l’objet XMLSocket, utilisez
XMLSocket.onConnect().
Pour plus d’informations, consultez Utilisation de la classe XML, page 189, et Utilisation de la
classe XMLSocket, page 192.
Utilisation du protocole HTTP pour les connexions aux scripts côté serveur
Les fonctions loadVariables(), loadVariablesNum(), getURL(), loadMovie() et
loadMovieNum(), ainsi que les méthodes MovieClip.loadVariables(),
MovieClip.loadMovie() et MovieClip.getURL() peuvent toutes communiquer avec des scripts
côté serveur sur des protocoles HTTP ou HTTPS. Ces fonctions envoient toutes les variables du
scénario auquel la fonction est associée. Lorsqu’elles sont utilisées comme méthodes de l’objet
MovieClip, les fonctions loadVariables(), getURL() et loadMovie() envoient toutes les
variables du clip indiqué ; chaque fonction (ou méthode) traite sa réponse de la manière suivante : 
• getURL() renvoie les informations dans une fenêtre de navigateur et non dans Flash Player.
• loadVariables() charge les variables dans un scénario ou niveau spécifié de Flash Player.
• loadMovie() charge un fichier SWF dans un clip ou niveau spécifié dans Flash Player.
Lorsque vous utilisez loadVariables(), getURL() ou loadMovie(), vous pouvez spécifier
plusieurs paramètres :
• URL est le fichier dans lequel se trouvent les variables distantes.
• Emplacement est le niveau ou la cible dans le fichier SWF qui reçoit les variables. (La fonction
getURL ne prend pas ce paramètre.)
Pour plus d’informations sur les niveaux et les cibles, consultez A propos des scénarios et des
niveaux dans le guide Utilisation de Flash de l’aide.
• Variables définit la méthode HTTP, GET ou POST, avec laquelle les variables seront envoyées.
Lorsqu’elles sont omises, Flash Player utilise par défaut la méthode GET, mais aucune variable
n’est envoyée.
Par exemple, pour suivre les meilleurs scores d’un jeu, vous pouvez stocker les scores sur un
serveur et utiliser une fonction loadVariables() pour les charger dans le fichier SWF chaque
fois que quelqu’un joue à ce jeu. L’appel de fonction pourrait avoir l’aspect suivant :
loadVariables("http://www.monSite.com/scripts/meilleur_score.php",
_root.clipDeScore, GET);
Cet exemple charge les variables du script PHP meilleur_score.php dans l’occurrence de clip
clipDeScore en utilisant la méthode HTTP GET.188 Chapitre 10 :  Utilisation de données externes
Les variables chargées à l’aide de la fonction loadVariables doivent être au format MIME
standard application/x-www-form-urlencoded (un format standard utilisé par les scripts CGI). Le
fichier que vous spécifiez dans le paramètre URL de l’action loadVariables() doit écrire les paires
de variables et valeurs dans ce format pour que Flash puisse les lire. Ce fichier peut spécifier
n’importe quel nombre de variables, les paires variable et valeur devant être séparées par une
esperluette (&) et les mots à l’intérieur d’une valeur devant être séparés par le signe plus (+). Par
exemple, cette séquence définit plusieurs variables :
meilleurScore1=54000&nomDuJoueur1=rockin+good&meilleurScore2=53455&nomDuJoueur
2=
bonehelmet&meilleurScore3=42885&nomDuJoueur3=soda+pop
Pour plus d’informations, consultez loadVariables(), page 423, getURL(), page 394,
loadMovie(), page 420 et l’entrée Classe LoadVars dans le Chapitre 12, Dictionnaire ActionScript
Présentation, page 211.
Utilisation de la classe LoadVars
Vous pouvez utiliser la classe LoadVars au lieu de la classe loadVariables() pour transférer des
variables entre un fichier SWF et un serveur. La classe LoadVars permet d’envoyer toutes les
variables d’un objet à une adresse URL déterminée et de charger toutes les variables d’une adresse
URL déterminée dans un objet. La réponse du serveur déclenche la méthode
LoadVars.onLoad() et définit les variables de la cible. Vous pouvez utiliser l’objet LoadVars pour
obtenir des informations sur les erreurs et des indicateurs d’avancement, ainsi que pour diffuser
les données pendant leur téléchargement.   
La classe LoadVars est similaire à la classe XML et utilise les méthodes load(), send() et
sendAndLoad() pour établir la communication avec le serveur. La principale différence entre les
classes LoadVars et XML réside dans le fait que les données LoadVars sont une propriété de l’objet
LoadVars, et non une arborescence DOM (Document Object Model) XML stockée dans l’objet
XML.
Vous devez créer un objet LoadVars pour appeler ses méthodes. Cet objet est un conteneur qui
stocke les données chargées.
La procédure suivante montre comment utiliser un objet LoadVars pour charger des variables à
partir d’un fichier texte et les afficher dans un champ de texte.
Pour charger des données avec l’objet LoadVars :
1 Dans un éditeur de texte comme Notepad ou SimpleText, créez un fichier texte et ajoutez-lui
le texte suivant :
jour=11&mois=juillet&année=2003
2 Enregistrez le fichier sous date.txt.
3 Dans Flash, créez un document.
4 Créez un champ de texte dynamique sur la scène et donnez-lui le nom d’occurrence date_txt.
5 Sélectionnez l’image 1 dans le scénario et ouvrez le panneau Actions (Fenêtre > Panneaux de
développement > Actions) si ce dernier n’est pas déjà visible.
6 Entrez le code suivant dans le panneau Actions :
var dateVars = new LoadVars();
dateVars.onLoad = function(ok) {
if (ok) {
date_txt.text = dateVars.day+"/"+dateVars.month+"/"+dateVars.year;Echange de variables avec une source distante 189
}
};
dateVars.load("date.txt");
Ce code charge les variables dans le fichier data.txt (jour, mois, année), puis il les formate et
les affiche dans le champ de texte date_txt.
7 Enregistrez le document sous le nom dateReader.fla dans le répertoire contenant le fichier
date.txt (le fichier texte que vous avez enregistré à l’étape 3).
8 Choisissez Contrôle > Tester l’animation pour tester le document.
Pour plus d’informations, consultez l’entrée Classe LoadVars du Chapitre 12, Dictionnaire
ActionScript Présentation, page 211.
A propos du langage XML
Le langage XML (Extensible Markup Language) est en passe de devenir le standard d’échange de
données structurées dans les applications Internet. Vous pouvez intégrer les données de Flash avec
des serveurs qui utilisent la technologie XML pour construire des applications sophistiquées telles
que des services de dialogue en ligne ou de courtage. 
En XML, tout comme en HTML, vous utilisez des balises pour marquer, ou définir, une chaîne
de texte. Dans le langage HTML, vous utilisez des balises prédéfinies pour indiquer la façon dont
le texte doit apparaître dans un navigateur web (par exemple, la balise <b> indique que le texte
doit être en gras). Dans le langage XML, vous définissez des balises qui identifient le type d’une
partie de données (par exemple, <motDePasse>monSecret</motDePasse>). Le langage XML
sépare la structure des informations de leur mode d’affichage, ce qui permet de réutiliser un même
document XML dans des environnements différents.
Chaque balise XML est appelée nœud ou élément. Chaque nœud possède un type (1, qui indique
un élément XML ou 3, qui indique un nœud texte) et les éléments peuvent également posséder
des attributs. Un nœud imbriqué dans un autre est appelé nœud enfant. Cette structure
hiérarchique de nœuds est appelée DOM (Document Object Model) XML, un peu comme le
DOM JavaScript, qui correspond à la structure des éléments dans un navigateur web.
Dans l’exemple suivant, <PORTEFEUILLE> est le nœud parent ; il ne possède pas d’attributs et
contient le nœud enfant <EFFET> qui possède les attributs SYMBOLE, QTÉ, PRIX et VALEUR :
<PORTEFEUILLE>
<EFFET SYMBOLE ="RICHE"
QTÉ="75"
PRIX="245.50"
VALEUR="18412.50" />
</PORTEFEUILLE>
Utilisation de la classe XML
Les méthodes de la classe XML ActionScript (par exemple, appendChild(), removeNode() et
insertBefore()) permettent de structurer les données XML dans Flash qui doivent être
envoyées à un serveur et de manipuler et interpréter les données XML téléchargées.   
Les méthodes de la classe XML suivantes permettent d’échanger des données XML avec un
serveur à l’aide de la méthode HTTP POST :
• La méthode load() télécharge le code XML depuis une URL et le place dans un objet XML
ActionScript.190 Chapitre 10 :  Utilisation de données externes
• La méthode send() transmet un objet XML à une URL. Toutes les informations renvoyées
sont affichées dans une fenêtre de navigateur.
• La méthode sendAndLoad() envoie un objet XML à une URL. Toutes les informations
renvoyées sont placées dans un objet XML ActionScript.
Par exemple, vous pourriez créer un système de courtage qui stockerait toutes ses informations
(noms d’utilisateur, mots de passe, identifiants de session, contenu des portefeuilles et
informations de transaction) dans une base de données.
Le script côté serveur qui transmet les informations entre Flash et la base de données lit et écrit les
données au format XML. Vous pouvez utiliser ActionScript pour convertir les informations
récupérées dans le fichier SWF (par exemple, un nom d’utilisateur et un mot de passe) en un
objet XML et envoyer ensuite les données au script côté serveur sous forme de document XML.
Vous pouvez également utiliser ActionScript pour charger le document XML que le serveur
renvoie dans un objet XML à utiliser dans le fichier SWF.
Flux et conversion des données entre une animation Flash, un script côté serveur et une base de données
La validation du mot de passe pour le système de courtage nécessite deux scripts : une fonction
définie sur l’image 1 et un script qui crée et envoie les objets XML associés au bouton Envoyer du
formulaire.
Lorsqu’un utilisateur entre des informations dans les champs de texte du fichier SWF avec les
variables nomDutilisateur et motDePasse, les variables doivent être converties au format XML
avant d’être transmises au serveur. La première section du script charge les variables dans un objet
XML nouvellement créé et appelé XMLDouvertureDeSession. Lorsqu’un utilisateur clique sur le
bouton Envoyer, l’objet XMLDouvertureDeSession est converti en une chaîne XML et envoyé au
serveur. 
Le script suivant est associé au bouton Envoyer. Pour comprendre le script, vous pourrez vous
aider des commentaires (indiqués par les caractères //) :
on (release) {
// A. Construire un document XML avec un élément d’ouverture de session
XMLDouvertureDeSession = new XML();
élémentDouvertureDeSession = XMLDouvertureDeSession.createElement("LOGIN");
élémentDouvertureDeSession.attributes.nomDutilisateur = nomDutilisateur;
élémentDouvertureDeSession.attributes.motDePasse = motDePasse;
XMLDouvertureDeSession.appendChild(élémentDouvertureDeSession);
// B. Construire un objet XML contenant la réponse du serveur
XMLréponseDouv = new XML();
XMLréponseDouv.onLoad = pourRéponseDouv;Echange de variables avec une source distante 191
// C. Envoyer l’élément LOGIN au serveur,
//    placer la réponse dans XMLréponseDouv
XMLDouvertureDeSession.sendAndLoad("https://www.imexstocks.com/main.cgi",
XMLréponseDouv);
}
La première section du script génère le code XML suivant lorsque l’utilisateur clique sur le bouton
Envoyer:
<LOGIN NOMDUTILISATEUR="JeanSmith" MOTDEPASSE="monSecret" />
Le serveur reçoit le code XML, génère une réponse XML et la renvoie au fichier SWF. Si le mot de
passe est accepté, le serveur envoie la réponse suivante :
<REPONSELOGIN ETAT="OK" SESSION="rnr6f7vkj2oe14m7jkkycilb" />
Ce code XML comprend un attribut SESSION qui contient une ID de session aléatoire unique et
qui sera utilisée dans toutes les communications entre le client et le serveur pour le reste de la
session. Si le mot de passe est rejeté, le serveur répond par le message suivant :
<REPONSELOGIN ETAT="ECHEC" />
Le nœud XML REPONSELOGIN doit être chargé dans un objet XML vide du fichier SWF.
L’instruction suivante crée l’objet XML XMLréponseDouv pour recevoir le nœud XML :
// B. Construire un objet XML contenant la réponse du serveur
XMLréponseDouv = new XML();
XMLréponseDouv.onLoad = pourRéponseDouv;
La seconde instruction affecte la fonction pourRéponseDouv() au gestionnaire
XMLréponseDouv.onLoad.
L’élément XML REPONSELOGIN arrive de manière asynchrone, un peu comme les données d’une
fonction loadVariables() et est chargé dans l’objet XMLréponseDouv. Lorsque les données
arrivent, le gestionnaire onLoad de l’objet XMLréponseDouv est appelé. Vous devez définir la
fonction pourRéponseDouv() et l’affecter au gestionnaire XMLréponseDouv.onLoad pour qu’il
puisse traiter l’élément REPONSELOGIN. Vous devez également affecter la fonction
pourRéponseDouv() à l’image contenant le bouton Envoyer.192 Chapitre 10 :  Utilisation de données externes
La fonction pourRéponseDouv() est définie dans la première image du fichier SWF. Pour
comprendre le script, vous pourrez vous aider des commentaires.
function pourRéponseDouv() {
// Récupérer le premier élément XML
var e = this.premierEnfant;
// Si le premier élément XML est un élément REPONSELOGIN avec
// OK pour état, ouvrir l’écran de portefeuille. Sinon,
// ouvrir l’écran d’échec et laisser l’utilisateur réessayer.
if (e.nomDeNoeud == "REPONSELOGIN" && e.attributes.état == "OK") {
// Enregistrer l’identifiant de session pour les futures communications avec le
serveur
idSession = e.attributes.session;
// Ouvrir l’écran de portefeuille
gotoAndStop("écranPortefeuille");
} else {
// L’ouverture de session a échoué !  Ouvrir l’écran d’échec.
gotoAndStop("échecOuvSession");
}
}
La première ligne de cette fonction, var e = this.premierEnfant, utilise le mot-clé this pour
faire référence à l’objet XML XMLréponseDouv qui vient d’être chargé avec XML depuis le
serveur. Vous pouvez utiliser this car pourRéponseDouv() a été invoquée sous la forme
XMLréponseDouv.onLoad, et donc, même si pourRéponseDouv() se révèle être une fonction
normale, elle se comporte en fait comme une méthode de XMLréponseDouv.
Pour envoyer le nom d’utilisateur et le mot de passe au format XML au serveur et pour charger
une réponse XML dans le fichier SWF, vous pouvez utiliser la méthode sendAndLoad(), comme
dans l’exemple suivant :
// C. Envoyer l’élément LOGIN au serveur,
//    placer la réponse dans XMLréponseDouv
XMLDouvertureDeSession.sendAndLoad("https://www.imexstocks.com/main.cgi",
XMLréponseDouv);
Remarque : Cette démonstration n’est qu’un exemple et Macromedia ne garantit pas le niveau de
sécurité fourni. Si vous implémentez un système sécurisé protégé par mot de passe, assurez-vous de
bien comprendre la sécurité réseau.
Pour plus d’informations, consultez Intégration de XML et de Flash dans une application web sur
le site www.macromedia.com/support/flash/interactivity/xml/ et l’entrée Classe XML dans le
Chapitre 12, Dictionnaire ActionScript Présentation, page 211.
Utilisation de la classe XMLSocket
ActionScript fournit une classe XMLSocket intégrée qui vous permet d’établir une connexion
continue avec un serveur. Une connexion socket permet au serveur de publier l’information au
client dès qu’elle est disponible. Sans connexion continue, le serveur devra attendre une
requête HTTP. Cette connexion ouverte supprime les périodes d’attente et est souvent utilisée
dans des applications en temps réel telles que les dialogues en ligne. Les données sont envoyées sur
la connexion socket sous forme d’une chaîne et doivent être au format XML. Vous pouvez utiliser
la classe XML pour structurer les données.     
Pour créer une connexion socket, vous devez créer une application côté serveur qui attendra la
requête de connexion socket et enverra une réponse au fichier SWF. Ce type d’applications côté
serveur peut être écrit dans un langage tel que Java. Echange de messages avec Flash Player 193
Vous pouvez utiliser les méthodes connect() et send() de la classe XMLSocket pour transférer
un objet XML vers et à partir d’un serveur sur une connexion socket. La méthode connect()
établit une connexion socket avec le port d’un serveur web. La méthode send() transmet un objet
XML au serveur spécifié dans la connexion socket.
Lorsque vous invoquez la méthode connect(), Flash Player ouvre une connexion TCP/IP avec le
serveur et garde cette connexion ouverte jusqu’à ce qu’un des événements suivants se produise :
• La méthode close() de la classe XMLSocket est appelée.
• Il n’existe plus aucune référence à l’objet XMLSocket.
• Flash Player se ferme.
• La connexion est rompue (le modem est déconnecté, par exemple).
L’exemple suivant crée une connexion socket XML et envoie les données de l’objet XML
monCodeXML. Pour comprendre le script, vous pourrez vous aider des commentaires (indiqués par
les caractères //):
// Créer un objet XMLSocket
sock = new XMLSocket();
// Appeler sa méthode connect() pour établir une connexion au port 1024
// du serveur à l’URL
sock.connect("http://www.monServeur.fr", 1024);
// Définir une fonction à affecter à l’objet socket gérant
// la réponse du serveur. Si la connexion réussit, envoyer
// l’objet monCodeXML. Sinon, afficher un message d’erreur dans un
// champ de texte.
function onSockConnect(succès){
if (succès){
sock.send(monCodeXML);
} else {
msg="Une erreur de connexion s’est produite avec "+serverName;
}
}
// Affecter la fonction onSockConnect() à la propriété onConnect
sock.onConnect = onSockConnect;
Pour plus d’informations, consultez l’entrée Classe XMLSocket du Chapitre 12, Dictionnaire
ActionScript Présentation, page 211.
Echange de messages avec Flash Player
Pour envoyer des messages depuis un fichier SWF vers son environnement hôte (par exemple, un
navigateur web, une animation Macromedia Director ou Flash Player autonome), vous pouvez
utiliser la fonction fscommand(). Cette fonction vous permet d’étendre votre fichier SWF à l’aide
des capacités de l’hôte. Par exemple, vous pouvez transmettre une fonction fscommand() à une
fonction JavaScript dans une page HTML qui ouvre une nouvelle fenêtre de navigateur avec des
propriétés spécifiques.   
Pour contrôler un fichier SWF dans Flash Player avec des langages tels que JavaScript, VBScript et
Microsoft JScript, vous pouvez utiliser les méthodes Flash Player (fonctions qui envoient des
messages depuis un environnement hôte vers le fichier SWF). Par exemple, vous pouvez disposer
d’un lien dans une page HTML qui envoie votre fichier SWF vers un cadre spécifique.194 Chapitre 10 :  Utilisation de données externes
Utilisation de fscommand()
Utilisez la fonction fscommand() pour envoyer un message au programme hébergeant Flash
Player. La fonction fscommand() dispose de deux paramètres : commande et arguments. Pour
envoyer un message à la version autonome de Flash Player, vous devez utiliser des commandes et
des arguments prédéfinis. Par exemple, l’action suivante définit le lecteur autonome pour qu’il
affiche le fichier SWF en taille plein écran lorsque le bouton est relâché :
on (release) {
fscommand("fullscreen", "true");
}
Le tableau suivant indique les valeurs que vous pouvez spécifier pour les paramètres commande et
arguments de la fonction fscommand() pour contrôler un fichier SWF lu dans le lecteur
autonome (y compris les projections) :
Pour utiliser fscommand() pour envoyer un message à un langage de programmation tel que
JavaScript dans un navigateur web, vous pouvez transmettre deux arguments quelconques dans les
paramètres commande et arguments. Ces paramètres peuvent être des chaînes ou des expressions
et seront utilisés dans une fonction JavaScript qui traite la fonction fscommand().
Une fonction fscommand() invoque la fonction JavaScript nomDeLanimation_DoFSCommand
dans la page HTML qui contient le fichier SWF, où nomDeLanimation est le nom de Flash Player
tel qu’il est affecté par l’attribut NAME de la balise EMBED ou par l’attribut ID de la balise OBJECT . Si
le nom monAnimation a été affecté à Flash Player, la fonction JavaScript invoquée est
monAnimation_DoFSCommand.
Pour utiliser fscommand() afin d’ouvrir une boîte de message à partir d’un fichier SWF dans la
page HTML à l’aide de JavaScript :
1 Dans la page HTML qui contient le fichier SWF, ajoutez le code JavaScript suivant :
function Lanimation_DoFSCommand(commande, args) {
if (commande == "fenêtreMessage") {
alert(args);
}
}
Commande Arguments Objectif
quit Aucun Ferme la projection.
fullscreen  true ou false La spécification de true définit Flash Player en mode plein
écran. La spécification de false renvoie le lecteur en affichage
normal du menu.
allowscale true ou false La spécification de false définit le lecteur de sorte que le fichier
SWF soit toujours affiché dans sa taille originale et que son
échelle ne soit jamais modifiée. La spécification de true oblige
le fichier SWF à adopter l’échelle 100% du lecteur.
showmenu true ou false La spécification de true active le jeu complet des éléments de
menu contextuel. La spécification de false masque tous les
éléments de menu contextuel, à l’exception de Paramètres et A
propos de Flash Player.
exec Chemin de
l’application
Exécute une application depuis la projection.Echange de messages avec Flash Player 195
Si vous publiez votre fichier SWF en utilisant Flash avec le modèle FSCommand disponible
dans les paramètres de publication HTML, ce code s’insère automatiquement. Les attributs
NAME et ID du fichier SWF constitueront le nom du fichier. Par exemple, pour le fichier
monAnimation.fla, les attributs seront définis avec monAnimation. (Pour plus d’informations
sur la publication, consultez Publication dans le guide Utilisation de Flash de l’aide.)
Alternativement, pour les applications Microsoft Internet Explorer, vous pouvez associer un
gestionnaire d’événement directement dans la balise <SCRIPT>, comme l’illustre cet exemple :
<Script Language = "JavaScript" event="FSCommand (commande, args)" for=
"Lanimation">
...
</Script>
2 Dans le document Flash, ajoutez la fonction fscommand() à un bouton, comme dans l’exemple
suivant :
on (press) {
fscommand("fenêtreMessage", "Ceci est une fenêtre de message invoquée
depuis Flash.");
}
Vous pouvez également utiliser des expressions pour la fonction fscommand() et des
paramètres, comme dans l’exemple suivant :
fscommand("boîteDeMessage", "Bonjour, " + nom + ", bienvenue sur notre site
web!")
3 Choisissez Fichier > Aperçu avant publication > HTML pour tester le document.
La fonction fscommand() peut envoyer des messages à Macromedia Director qui sont interprétés
par Lingo comme des chaînes, des événements ou un code exécutable Lingo. Si le message est une
chaîne ou un événement, vous devez écrire le code Lingo pour le recevoir depuis la fonction
fscommand() et entraîner une action dans Director. Pour plus d’informations, consultez le centre
de support de Director à l’adresse www.macromedia.com/support/director.
En Visual Basic, Visual C++, et dans d’autres programmes pouvant héberger les contrôles
ActiveX, fscommand envoie un événement VB avec deux chaînes qui peut être traité dans
l’environnement du langage de programmation. Pour plus d’informations, utilisez les mots-clés
méthode Flash pour effectuer une recherche sur le centre de support de Flash à l’adresse
www.macromedia.com/support/flash.
A propos des méthodes Flash Player
Vous pouvez utiliser les méthodes Flash Player pour contrôler un fichier SWF dans Flash Player
avec des langages tels que JavaScript et VBScript. Comme avec les autres méthodes, vous pouvez
utiliser les méthodes Flash Player pour envoyer des appels à des fichiers SWF depuis un
environnement de programmation autre qu’ActionScript. Chaque méthode possède un nom et la
plupart prennent des paramètres. Un paramètre spécifie une valeur sur laquelle opère la méthode.
Le calcul effectué par certaines méthodes renvoie une valeur qui peut être utilisée par
l’environnement de programmation.
Deux technologies différentes permettent la communication entre le navigateur et Flash Player :
LiveConnect (Netscape Navigator 3.0 et versions ultérieures sous Windows 95/98/2000/NT ou
Power Macintosh) et ActiveX (Internet Explorer 3.0 et versions ultérieures sous Windows 95/98/
2000/NT). Bien que les techniques de programmation soient équivalentes pour tous les
navigateurs et les langages, des propriétés et événements supplémentaires sont disponibles pour
l’utilisation des contrôles ActiveX. 196 Chapitre 10 :  Utilisation de données externes
Pour obtenir plus d’informations, ainsi que la liste complète des méthodes de programmation de
Flash Player, utilisez les mots-clés méthode Flash pour rechercher le centre de support de Flash à
l’adresse www.macromedia.com/support/flash.
A propos de l’utilisation des méthodes Flash JavaScript avec Flash Player
Flash Player 6 version 40 et ultérieures prennent en charge les méthodes Flash Java Script et
FSCommand dans Netscape 6.2 et versions ultérieures. Les versions antérieures ne prennent pas
en charge les méthodes Flash JavaScript et FSCommand dans Netscape 6.2 ou versions
ultérieures.
Pour Netscape 6.2 et versions ultérieures, vous n’avez pas besoin de définir l’objet swLiveConnect
sur la valeur true. Cependant, la définition de swLiveConnect sur la valeur true n’a aucune
incidence.
Fonctions de sécurité de Flash Player
Par défaut, Flash Player 7 et ses versions ultérieures empêchent un fichier SWF servi par un
domaine d’accéder aux données, objets ou variables de fichiers SWF servis par des domaines
différents. En outre, le contenu chargé à l’aide de protocoles non sécurisés (non-HTTPS) ne peut
pas accéder au contenu chargé à l’aide d’un protocole sécurisé (HTTPS), même s’ils sont tous les
deux situés exactement dans le même domaine. Par exemple, un fichier SWF situé à l’adresse
http://www.macromedia.com/main.swf ne peut pas charger de données à partir de l’adresse
https://www.macromedia.com/data.txt sans autorisation explicite. De même, un fichier SWF
servi par un domaine ne peut pas charger les données (à l’aide de loadVariables(), par exemple)
d’un autre domaine. 
Les adresses IP numériques identiques sont compatibles. Cependant, un nom de domaine n’est
pas compatible avec une adresse IP, même si le nom de domaine renvoie à la même adresse IP. 
Le tableau suivant présente des exemples de domaines compatibles :
Le tableau suivant présente des exemples de domaines incompatibles :
www.macromedia.com www.macromedia.com
data.macromedia.com data.macromedia.com
65.57.83.12 65.57.83.12
www.macromedia.com data.macromedia.com
macromedia.com www.macromedia.com
www.macromedia.com macromedia.com
65.57.83.12 www.macromedia.com (même si ce domaine correspond à l’adresse
65.57.83.12)
www.macromedia.com 65.57.83.12 (même si www.macromedia.com correspond à cette
adresse IP)Fonctions de sécurité de Flash Player 197
Pour plus d’informations sur la façon de permettre à un fichier SWF servi par un domaine
d’accéder aux données, objets ou variables de fichiers SWF qui sont servis par un autre domaine,
consultez A propos de l’autorisation d’accès aux données entre des fichiers SWF inter-domaines,
page 197. Pour plus d’informations sur la façon de permettre à un fichier SWF servi par un
protocole sécurisé (HTTPS) d’accéder aux données, objets ou variables de fichiers SWF qui sont
servis par des protocoles non sécurisés, consultez A propos de l’autorisation d’accès du protocole
HTTP à HTTPS entre fichiers SWF , page 198. Pour plus d’informations sur la façon de permettre
à un fichier SWF servi par un domaine de charger des données (à l’aide de loadVariables() par
exemple) d’un autre domaine, consultez A propos de l’autorisation de chargement de données inter-
domaines, page 198.
Pour plus d’informations sur la manière dont ces changements de sécurité ont des répercussions
sur le contenu dans Flash MX et dans les versions précédentes, consultez A propos de la
compatibilité avec les précédents modèles de sécurité Flash Player, page 199.
A propos de l’autorisation d’accès aux données entre des fichiers SWF inter-
domaines
Un fichier SWF peut charger un autre fichier SWF depuis n’importe quel emplacement sur
Internet. Cependant, pour que chacun des deux fichiers SWF puisse accéder aux données
(variables et objets) de l’autre, ils doivent provenir du même domaine. Par défaut, dans Flash
Player 7 et versions ultérieures, les deux domaines doivent correspondre exactement pour que les
deux fichiers partagent des données. Un fichier SWF peut cependant accéder aux fichiers SWF
servis par des domaines spécifiques en appelant LocalConnection.allowDomain ou
System.security.allowDomain(). 
Par exemple, supposons que le fichier main.swf soit servi à partir de www.macromedia.com. Ce
fichier SWF charge alors un autre fichier SWF (data.swf ) à partir de data.macromedia.com vers
une occurrence de clip (target_mc).
// Dans macromedia.swf
target_mc.loadMovie("http://data.macromedia.com/data.swf");
De plus, supposons que le fichier data.swf définisse une méthode appelée getData() sur son
scénario principal. Par défaut, le fichier main.swf ne peut pas appeler la méthode getData()
définie dans le fichier data.swf, une fois que ce fichier a été chargé. Cela est dû au fait que les deux
fichiers SWF ne résident pas sur le même domaine. En ce sens, l’appel de méthode suivant dans
main.swf, une fois le chargement de data.swf effectué, échouera.
// Dans macromedia.swf, après le chargement de data.swf :
target_mc.getData(); // Cette méthode d’appel va échouer
Cependant, le fichier data.swf peut accéder à des fichiers SWF servis à partir de
www.macromedia.com à l’aide du gestionnaire LocalConnection.allowDomain ou de la
méthode System.security.allowDomain(), selon le type d’accès nécessaire. Le code suivant,
ajouté au fichier data.swf, permet à un fichier SWF servi à partir de www.macromedia.com
d’accéder à ses variables et méthodes :
// Dans data.swf
System.security.allowDomain("www.macromedia.com");
ma_lc.allowDomain = function(domaineDenvoi) {
return(domaineDenvoi=="www.macromedia.com");
}198 Chapitre 10 :  Utilisation de données externes
Notez que la commande allowDomain permet à tout fichier SWF du domaine autorisé de
programmer tout autre fichier SWF dans le domaine qui autorise l’accès, à moins que le fichier
SWF accédé soit hébergé sur un site utilisant un protocole sécurisé (HTTPS).  Dans ce cas, vous
devez utiliser la commande allowInsecureDomain plutôt que allowDomain ; consultez A propos
de l’autorisation d’accès du protocole HTTP à HTTPS entre fichiers SWF ci-dessous.
Pour plus d’informations sur la mise en correspondance des noms de domaines,
consultez Fonctions de sécurité de Flash Player, page 196.
A propos de l’autorisation d’accès du protocole HTTP à HTTPS entre fichiers
SWF
Comme indiqué dans la section précédente, vous devez utiliser un gestionnaire ou une méthode
allowDomain pour permettre à un fichier SWF d’un domaine d’accéder à un fichier SWF d’un
autre domaine. Cependant, si le fichier SWF accédé est hébergé sur un site utilisant un protocole
sécurisé (HTTPS), le gestionnaire ou la méthode allowDomain ne permet pas l’accès à partir du
fichier SWF hébergé sur un site utilisant un protocole non sécurisé. Pour autoriser un tel accès,
vous devez utiliser les instructions LocalConnection.allowInsecure Domain() ou
System.security.allowInsecureDomain().
Par exemple, si un fichier SWF à l’adresse http://www.unSite.com doit pouvoir accéder au fichier
SWF à l’adresse https://www.unSite.com/data.swf, ajoutez le code suivant au fichier data.swf :
// Dans data.swf
System.security.allowInsecureDomain("www.unSite.com");
ma_lc.allowInsecureDomain = function(domaineDenvoi) {
return(domaineDenvoi=="www.unSite.com");
}
A propos de l’autorisation de chargement de données inter-domaines
Un document Flash peut charger les données depuis une source externe à l’aide de l’un des appels
de chargement de données suivants : XML.load(), XML.sendAndLoad(), LoadVars.load(),
LoadVars.sendAndLoad(), loadVariables() et loadVariablesNum(). De plus, un fichier
SWF peut importer des bibliothèques partagées à l’exécution ou des actifs définis dans un autre
fichier SWF, au moment de l’exécution. Par défaut, les données ou le support SWF (dans le cas de
bibliothèques partagées à l’exécution) doivent résider dans le même domaine que le fichier SWF
qui charge ces données externes ou ce support.
Pour que les fichiers SWF situés dans différents domaines puissent accéder aux données et aux
actifs contenus dans des bibliothèques partagées à l’exécution, utilisez un fichier de régulation
inter-domaines. Il s’agit d’un fichier XML qui permet au serveur d’indiquer que ses données et ses
documents sont disponibles pour les fichiers SWF servis par certains domaines ou par tous les
domaines. Tout fichier SWF servi par un domaine spécifié par le fichier de régulation du serveur
peut accéder aux données et aux actifs de ce serveur.   
Lorsqu’un document Flash tente d’accéder aux données depuis un autre domaine, Flash Player
essaie automatiquement de charger un fichier de régulation depuis ce domaine. Si le domaine du
document Flash qui tente d’accéder aux données est inclus dans le fichier de régulation les
données sont automatiquement accessibles.Fonctions de sécurité de Flash Player 199
Les fichiers de régulation doivent être nommés interdomaine.xml et se trouvent dans le répertoire
racine du serveur qui sert les données. Les fichiers de régulation ne fonctionnent que sur des
serveurs communiquant en HTTP, HTTPS, ou FTP. Le fichier de régulation est spécifique au
port et au protocole du serveur dans lequel il réside.
Par exemple, un fichier de régulation situé dans https://www.macromedia.com:8080/
interdomaine.xml ne s’appliquera qu’aux appels de chargement de données passés vers
www.macromedia.com sur HTTPS au port 8080.
Cette règle a une exception : lorsque vous utilisez un objet XMLSocket pour vous connecter à un
serveur socket dans un autre domaine. Dans ce cas, un serveur HTTP exécuté sur le port 80 du
même domaine que le serveur socket doit fournir le fichier de régulation pour l’appel de la
méthode.
Un fichier de régulation XML contient une seule balise <régulation-inter-domaine>, qui
contient elle-même aucune ou plusieurs balises <autoriser-accès-depuis>. Chaque balise
<autoriser-accès-depuis> contient un attribut, domaine, qui spécifie une adresse IP exacte,
un domaine exact ou un domaine générique (domaine quelconque). Les domaines génériques
sont indiqués par un astérisque (qui correspond à tous les domaines et à toutes les adresses IP) ou
par un astérisque (*) suivi d’un suffixe, qui correspond uniquement aux domaines se terminant
par le suffixe spécifié. Les suffixes doivent commencer par un point. Cependant, les domaines
génériques suivis de suffixes peuvent correspondre à des domaines qui sont composés uniquement
du suffixe sans le point de séparation. Par exemple, foo.com est considéré comme un élément de
*.foo.com. Les caractères génériques ne sont pas autorisés dans les spécifications de domaine IP.
Si vous spécifiez une adresse IP, seuls les fichiers SWF chargés depuis cette adresse IP à l’aide de la
syntaxe IP (par exemple, http://65.57.83.12/flashmovie.swf ) sont accessibles ; les fichiers chargés
à l’aide d’une syntaxe domaine-nom ne sont pas accessibles. Flash Player n’effectue pas de
résolution DNS.
Voici un exemple de fichier de régulation permettant d’accéder à des documents Flash qui
proviennent de foo.com, amiDeFoo.com, *.foo.com et 105.216.0.40, depuis un document Flash
situé sur foo.com :
<?xml version="1.0" ? >
<!-- http://www.foo.com/interdomaine.xml -->
<régulation-inter-domaines>
  <autoriser-accès-depuis domaine="www.amiDeFoo.com" />
  <autoriser-accès-depuis domaine="*.foo.com" />
  <autoriser-accès-depuis domaine="105.216.0.40" />
</régulation-inter-domaines>
Un fichier de régulation ne contenant aucune balise <autoriser-accès-depuis> revient à ne
pas avoir de régulation sur un serveur.
A propos de la compatibilité avec les précédents modèles de sécurité Flash
Player
Suite aux changements des fonctions de sécurité dans Flash Player (consultez Fonctions de sécurité
de Flash Player, page 196), un contenu exécuté correctement sous Flash Player 6 ou antérieur peut
ne pas s’exécuter correctement sous Flash Player 7 ou ultérieur.  200 Chapitre 10 :  Utilisation de données externes
Par exemple, dans Flash Player 6, un fichier SWF se trouvant dans www.macromedia.com peut
accéder à des données sur un serveur situé à l’adresse data.macromedia.com. Ainsi, Flash Player 6
a autorisé un fichier SWF provenant d’un domaine à charger des données à partir d’un domaine
« similaire ».
Dans Flash Player 7 et ultérieur, si un fichier SWF version 6 (ou antérieure) tente de charger des
données à partir d’un serveur se trouvant dans un autre domaine, et que ce serveur ne fournit
aucun fichier de régulation autorisant l’accès à partir du domaine de ce fichier SWF, la boîte de
dialogue Paramètres de Macromedia Flash Player apparaît. Elle demande à l’utilisateur d’autoriser
ou de refuser l’accès aux données interdomaines.
Si l’utilisateur clique sur Autoriser, le fichier SWF peut accéder aux données requises ; s’il clique
sur Refuser, le fichier SWF ne peut pas accéder aux données requises.
Pour empêcher l’apparition de cette boîte de dialogue, créez un fichier de régulation de sécurité
sur le serveur fournissant les données. Pour plus d’informations, consultez A propos de
l’autorisation de chargement de données inter-domaines, page 198. 201
CHAPITRE 11
Utilisation de médias externes
Si vous importez une image ou un son pendant la création d’un document dans Macromedia
Flash MX 2004 ou Macromedia Flash MX Professionnel 2004, cette image ou ce son est placé
dans le fichier SWF lorsque vous le publiez. En plus de l’importation de médias pendant la
programmation, vous pouvez charger un média externe à l’exécution. Il existe plusieurs raisons
pour lesquelles il est souhaitable de conserver les médias en dehors d’un document Flash.
Réduire la taille des fichiers En conservant les fichiers média volumineux en dehors de votre
document Flash et en les chargeant à l’exécution, vous pouvez réduire le délai initial de
téléchargement de vos applications et présentations, particulièrement dans le cas de connexions
Internet lentes.
Modulariser les présentations volumineuses Vous pouvez diviser une présentation ou une
application volumineuse en fichiers SWF séparés, puis les charger au fur et à mesure à l’exécution.
Cela permet non seulement de réduire le délai initial de téléchargement, mais également de
conserver et de mettre à jour les contenus de la présentation plus facilement.
Séparer le contenu de la présentation Cela est très commun dans le développement
d’applications, particulièrement les applications orientées données. Par exemple, une application
avec un panier pourrait afficher une image JPEG de chaque produit. En chargeant les fichiers
JPEG de chaque image à l’exécution, vous pouvez facilement mettre à jour l’image d’un produit
sans modifier le fichier FLA d’origine.
Bénéficier des fonctions d’exécution seule Certaines fonctions, telles que la lecture en
continu des fichiers FLV et MP3, ne sont utilisables qu’à l’exécution dans ActionScript.
Aperçu du chargement de média externe
Vous pouvez charger quatre types de fichiers média dans une application Flash lors de
l’exécution : les fichiers SWF, MP3, JPEG et FLV. Flash Player peut charger un média externe
depuis n’importe quelle adresse HTTP ou FTP, un disque local utilisant un chemin relatif ou à
l’aide du protocole file://.
Pour charger des fichiers SWF et JPEG externes, vous pouvez utiliser la fonction loadMovie() ou
loadMovieNum() , ou bien la méthode MovieClip.loadMovie(). Lorsque vous chargez un
fichier SWF ou JPEG, vous spécifiez un clip ou un niveau d’animation comme cible de ce média.
Pour plus d’informations sur le chargement des fichiers SWF et JPEG, consultez Chargement de
fichiers SWF et JPEG externes, page 202.202 Chapitre 11 :  Utilisation de médias externes
Pour lire un fichier MP3 (MPEG Couche 3) externe, utilisez la méthode loadSound() de la
classe Sound. Cette méthode vous permet de spécifier si le fichier MP3 doit être diffusé en flux
continu ou complètement téléchargé avant de démarrer la lecture. Vous pouvez également lire les
informations ID3 intégrées dans les fichiers MP3, si elles sont disponibles. Pour plus
d’informations, consultez Lecture des balises ID3 dans les fichiers MP3, page 204.
Flash Video (FLV) est le format vidéo natif utilisé par Flash Player. Vous pouvez lire les fichiers
FLV sur HTTP ou sur le système de fichiers local. La lecture des fichiers FLV externes offre
plusieurs avantages par rapport à l’intégration de vidéo dans un document Flash : performances et
gestion de la mémoire améliorées, indépendance des cadences vidéo et Flash. Pour plus
d’informations, consultez Lecture dynamique des fichiers FLV externes, page 205.
Vous pouvez également précharger ou suivre la progression du téléchargement d’un média
externe. Flash Player 7 introduit la classe MovieClipLoader que vous pouvez utiliser pour suivre la
progression du téléchargement de fichiers SWF ou JPEG. Pour précharger des fichiers MP3 FLV,
vous pouvez utiliser la méthode getBytesLoaded() de la classe Sound et la propriété
bytesLoaded de la classe NetStream. Pour plus d’informations, consultez Préchargement de média
externe, page 206.
Chargement de fichiers SWF et JPEG externes
Pour charger un fichier SWF ou JPEG, utilisez la fonction globale loadMovie() ou
loadMovieNum() ou la méthode loadMovie() de la classe MovieClip. Pour charger un fichier
SWF ou JPEG dans un niveau de Flash Player, utilisez loadMovieNum(). Pour charger un fichier
SWF or JPEG dans une cible de clip, utilisez la fonction ou la méthode loadMovie(). Dans les
autres cas, le contenu chargé remplace le contenu du niveau ou du clip cible spécifié. 
Lorsque vous chargez un fichier SWF ou JPEG dans un clip cible, le coin supérieur gauche du
fichier SWF ou de l’image JPEG est placé sur le point d’alignement du clip. Ce point se trouvant
souvent au centre du clip, il se peut que le contenu chargé ne soit pas centré. De même, lorsque
vous chargez un fichier SWF ou une image JPEG dans un scénario racine, son coin supérieur
gauche est placé sur le coin supérieur gauche de la scène. Le contenu chargé hérite de la rotation et
de la mise à l’échelle du clip, mais le contenu d’origine du clip est supprimé.
Vous pouvez éventuellement envoyer les variables ActionScript en appelant la fonction
loadMovie() ou loadMovieNum(). Cela est particulièrement utile si, par exemple, l’URL
spécifiée dans l’appel d’une méthode est un script côté serveur qui renvoie une image JPEG ou un
fichier SWF en fonction des données transmises depuis l’application Flash.
En ce qui concerne les fichiers d’image, Flash ne supporte que le type de fichier d’image JPEG
standard, et non les fichiers JPEG progressifs.
Lorsque vous utilisez la fonction globale loadMovie() ou loadMovieNum(), spécifiez le niveau ou
le clip cible en tant que paramètre. Par exemple, le code suivant permet de charger le fichier
d’animation Flash contenu.swf dans l’occurrence de clip appelée cible_mc :
loadMovieNum("contenu.swf", cible_mc);
De même, vous pouvez utilisez Clip.loadMovie() pour obtenir le même résultat :
cible_mc.loadMovie("contenu.swf");
Le code suivant charge l’image JPEG fleurs.jpg dans l’occurrence de clip image_clip :
image_clip.loadMovie("fleurs.jpg");Chargement des fichiers externes MP3 203
Pour plus d’informations sur loadMovie(), loadMovieNum() et MovieClip.loadMovie,
consultez les entrées correspondantes du Chapitre 12, Dictionnaire ActionScript Présentation,
page 211.
A propos des fichiers SWF chargés et du scénario racine
La propriété ActionScript _root spécifie ou renvoie une référence au scénario racine d’un
fichier SWF. Si vous chargez un fichier SWF dans le clip d’un autre fichier SWF, les références à
_root dans le fichier SWF chargé se traduisent dans le scénario racine du fichier SWF hôte et non
pas dans celui du fichier SWF chargé. Cela peut parfois engendrer un comportement inattendu à
l’exécution, par exemple, si le fichier SWF hôte et le fichier SWF chargé utilisent tous les deux
_root pour spécifier une variable.
Dans Flash Player 7 et ses versions ultérieures, vous pouvez utiliser la propriété
MovieClip._lockroot pour obliger les références à _root réalisées dans un clip à se traduire
dans son propre scénario, plutôt que dans celui de l’animation contenant le clip. Pour plus
d’informations, consultez Spécification d’un scénario racine pour les fichiers SWF chargés, page 127.
A propos de l’accès aux données des fichiers SWF chargés
Un fichier SWF peut charger un autre fichier SWF depuis n’importe quel emplacement sur
Internet. Cependant, pour qu’un fichier SWF accède aux données (variables, méthodes, etc.)
définies dans l’autre fichier SWF, les deux fichiers doivent provenir du même domaine. Dans
Flash Player 7 et ses versions ultérieures, toute écriture de scripts inter-domaines est interdite sauf
si le fichier SWF chargé en décide autrement en appelant System.security.allowDomain().
Pour plus d’informations, consultez Fonctions de sécurité de Flash Player, page 196 et
System.security.allowDomain() dans le Chapitre 12, Dictionnaire ActionScript Présentation,
page 211.
Chargement des fichiers externes MP3
Pour charger des fichiers MP3 à l’exécution, utilisez la méthode loadSound() de la classe Sound.
Créez tout d’abord un objet Sound :   
var chanson_1_sound = new Sound();
Utilisez ensuite le nouvel objet pour appeler la méthode loadSound() et charger un événement
ou un son lu en flux continu. Alors que les sons d’événement sont entièrement chargés avant leur
lecture, les sons lus en flux continu sont lus pendant leur téléchargement. Vous pouvez définir le
paramètre isStreaming de la méthode loadSound() de manière à définir un son comme étant
un son d’événement ou un son lu en flux continu. Après avoir chargé un son d’événement, vous
devez appeler la méthode start() de la classe Sound pour lancer sa lecture. La lecture des sons
lus en flux continu débute dès qu’une quantité suffisante de données a été chargée dans le
fichier SWF et il n’est pas nécessaire d’utiliser la méthode start().
Par exemple, le code suivant crée un objet Sound nommé classique et charge ensuite un fichier
MP3 nommé beethoven.mp3 :
var classique.Sound = new Sound();
classique.loadSound("http://server.com/mp3s/beethoven.mp3", true);204 Chapitre 11 :  Utilisation de médias externes
Dans la plupart des cas, définissez le paramètre isStreaming sur la valeur true, particulièrement
si vous chargez des fichiers sons volumineux qui doivent démarrer dès que possible, par exemple,
lorsque vous créez une application « juke-box » MP3. Cependant, si vous téléchargez des clips son
moins volumineux et devez les exécuter à un moment précis (par exemple, lorsqu’un utilisateur
clique sur un bouton), définissez le paramètre isStreaming sur la valeur false.
Pour déterminer la fin du téléchargement d’un son, utilisez le gestionnaire d’événement
Son.onLoad. Ce gestionnaire d’événement reçoit automatiquement une valeur booléenne (true
ou false) qui indique si le fichier a bien été téléchargé correctement.
Par exemple, supposez que vous créez un jeu en ligne qui utilise différents sons en fonction du
niveau atteint par l’utilisateur dans ce jeu. Le code suivant charge un fichier MP3 (blastoff.mp3)
dans un objet Sound appelé sonJeu, puis lit le son à la fin du téléchargement :
var sonJeu = new Sound();
sonJeu.onLoad = function (chargementOK) {
if(chargementOK) {
sonJeu.start();
}
}
sonJeu.loadSound("http://server.com/sounds/blastoff.mp3", false);
Pour les fichiers son, Flash Player ne supporte que le type de fichier MP3.
Pour plus d’informations, consultez Sound.loadSound, Sound.start() et Sound.onLoad dans
le Chapitre 12, Dictionnaire ActionScript Présentation, page 211.
Lecture des balises ID3 dans les fichiers MP3
Les balises ID3 sont des champs de données ajoutés à un fichier MP3 contenant des informations
sur ce fichier, comme le nom de la chanson, le nom de l’album et de l’artiste.
Pour lire les balises ID3 d’un fichier MP3, utilisez la propriété Sound.ID3, dont les propriétés
correspondent aux noms des balises ID3 incluses dans le fichier MP3 en cours de téléchargement.
Pour déterminer la disponibilité des balises ID3 pour télécharger un fichier MP3, utilisez le
gestionnaire d’événement Sound.onID3. Flash Player7 prend en charge les balises des versions
1.0, 1.1, 2.3 et 2.4 ; les balises de la version 2.2 ne sont pas prises en charge.
Par exemple, le code suivant charge un fichier MP3 nommé chansonPreferee.mp3 dans l’objet
Sound nommé chanson. Lorsque les balises ID3 sont disponibles pour le fichier, un champ de
texte nommé affichage_txt affiche le nom de l’artiste et de la chanson.
var chanson = new Sound();
chanson.onID3 = function () {
affichage_txt.text = "Artiste : " + song.id3.TCOM + newline;
affichage_txt.text += "Chanson : " + song.id3.TIT2);
}
son.loadSound("mp3s/chansonPreferee.mp3, true");
Les balises ID3 2.0 se trouvant au début d’un fichier MP3 (avant les données audio), elles sont
disponibles dès que le fichier démarre le téléchargement. Cependant, les balises ID3 1.0 se
trouvent à la fin du fichier (après les données audio) ; elles ne sont pas disponibles tant que le
téléchargement du fichier MP3 n’est pas terminé.
Le gestionnaire d’événement onID3 est appelé à chaque fois que de nouvelles données ID3 sont
disponibles. Cela signifie que si un fichier MP3 contient des balises ID3 2.0 et ID3 1.0, le
gestionnaire d’événement onID3 sera appelé deux fois, car les balises se trouvent dans des parties
différentes du fichier.Lecture dynamique des fichiers FLV externes 205
Pour obtenir une liste des balises ID3 prises en charge, consultez Sound.ID3, page 624.
Lecture dynamique des fichiers FLV externes
Plutôt que d’importer des données vidéo dans l’environnement auteur de Flash, vous pouvez
utiliser ActionScript pour lire dynamiquement les fichiers FLV externes dans Flash Player. Vous
pouvez lire les fichiers FLV à partir d’une adresse HTTP ou du système de fichiers local. Pour lire
les fichiers FLV, utilisez les classes NetConnection et NetStream, ainsi que la méthode
attachVideo() de la classe Video. ( Pour obtenir des informations complètes, consultez les
entrées Classe NetConnection, Classe NetStream et Video.attachVideo() dans
le Chapitre 12, Dictionnaire ActionScript Présentation, page 211.)   
Vous pouvez créer des fichiers FLV en important la vidéo dans l’outil de programmation Flash et
en l’exportant sous la forme d’un fichier FLV. (Consultez « Vidéo Macromedia Flash » dans le
guide Utilisation de Flash de l’aide. Si vous possédez Flash Professionnel, vous pouvez utiliser le
module d’exportation de FLV pour exporter les fichiers FLV à partir d’applications d’édition
vidéo prises en charge. (Consultez Exportation des fichiers FLV à partir des applications d’édition
vidéo (Flash Professionnel uniquement) dans le guide Utilisation de Flash de l’aide.
L’utilisation des fichiers FLV externes offre certaines fonctionnalités qui ne sont pas disponibles
avec l’utilisation de la vidéo importée :
• Vous pouvez utiliser des clips vidéo plus longs dans vos documents Flash sans ralentir la lecture
de l’animation. Les fichiers FLV externes sont lus à l’aide de la mémoire cache. Cela signifie que
les fichiers volumineux sont stockés en petites parties et sont accessibles dynamiquement, et
qu’ils ne nécessitent pas autant de mémoire que les fichiers vidéo intégrés.
• Un fichier FLV externe peut avoir une cadence différente de celle du document Flash dans
lequel il est lu. Par exemple, vous pouvez définir la cadence du document Flash à 30 ips et celle
de l’image vidéo à 21 ips. Cela vous octroie un meilleur contrôle et garantit la fluidité du flux
vidéo.
• Avec les fichiers FLV externes, la lecture du document Flash n’a pas besoin d’être interrompue
pendant le chargement du fichier vidéo. Les fichiers vidéo importés peuvent parfois
interrompre la lecture du document pour exécuter certaines fonctions, par exemple, accéder à
un lecteur de CD-ROM. Les fichiers FLV peuvent exécuter les fonctions indépendamment du
document Flash et ainsi ne pas interrompre la lecture.
• Le sous-titrage du contenu vidéo est plus facile avec les fichiers FLV externes, parce que vous
utilisez les gestionnaires d’événements pour accéder aux métadonnées de la vidéo.
La procédure suivante illustre comment lire un fichier nommé videoFile.flv stocké au même
emplacement que votre fichier SWF.
Pour lire un fichier FLV externe dans un document Flash :
1 Si le document est ouvert dans l’outil de programmation Flash, dans le panneau Bibliothèque
(Fenêtre > Bibliothèque), sélectionnez Nouvelle vidéo dans le menu d’options de la
bibliothèque pour créer un objet vidéo.
2 Faites glisser un objet vidéo depuis le panneau Bibliothèque sur la scène. Une occurrence de
l’objet vidéo est créée.
3 Lorsque l’objet vidéo est sélectionné sur la scène, dans l’inspecteur des propriétés (Fenêtre >
Propriétés), entrez ma_video dans le champ de texte Nom de l’occurrence.
4 Ouvrez le panneau Composants (Fenêtre > Panneaux de développement > Composants) et
faites glisser un composant TextArea sur la scène.206 Chapitre 11 :  Utilisation de médias externes
5 Lorsque l’objet TextArea est sélectionné sur la scène, entrez status dans le champ de texte Nom
de l’occurrence, dans l’inspecteur des propriétés.
6 Sélectionnez l’image 1 dans le scénario et ouvrez le panneau Actions (Fenêtre > Panneaux de
développement > Actions).
7 Ajoutez le code suivant au panneau Actions
// Créer un objet NetConnection :
var netConn:NetConnection = new NetConnection();
// Créer une connexion locale en flux continu :
netConn.connect(null);
// Créer un objet NetStream et définir une fonction onStatus() :
var netStream:NetStream = new NetStream(netConn);
netStream.onStatus = function(infoObject) {
status.text += "Status (NetStream)" + newline;
status.text += "Level: "+infoObject.level + newline;
status.text += "Code: "+infoObject.code + newline;
};
// Associer la vidéo NetStream à l’objet Video :
ma_video.attachVideo(netStream);
// Définir la durée du tampon :
netStream.setBufferTime(5);
// Lire le fichier FLV :
netStream.play("videoFile.flv");