Forums d'entraide informatique - Astuces - Conseils

Description
Fonction : convertit une chaîne en entier. Si la chaîne spécifiée dans les paramètres ne peut pas
être convertie en un nombre, la fonction renvoie NaN. Les chaînes commençant par 0x sont
interprétées comme des nombres hexadécimaux. Les entiers commençant par 0 ou spécifiant une
base de 8 sont interprétés comme des nombres octaux. Les espaces précédant les entiers valides
sont ignorés, tout comme les caractères non numériques à droite.
Exemple
Les exemples suivants utilisent la fonction parseInt pour évaluer différents types de nombres.
parseInt("3.5")
// renvoie 3
parseInt("chose")
// renvoie NaN
parseInt("4foo")
// renvoie 4
Les exemples suivants illustrent les conversions hexadécimales :
parseInt("0x3F8")
// renvoie 1016
parseInt("3E8", 16)
// renvoie 1000
L’exemple suivant présente une conversion binaire :
parseInt("1010", 2)
// renvoie 10 (la représentation décimale du binaire 1010)
Les exemples suivants présentent une analyse de nombres octaux :
parseInt("0777")
parseInt("777", 8)
// renvoie 511 (la représentation décimale de l’octal 777)584 Chapitre 12 : Dictionnaire ActionScript Présentation
play()
Disponibilité
Flash 2.
Usage
play()
Paramètres
Aucun.
Renvoie
Rien.
Description
Fonction : fait avancer la tête de lecture dans le scénario.
Exemple
Le code suivant utilise une instruction if pour vérifier la valeur d’un nom entré par l’utilisateur.
Si l’utilisateur entre Steve, l’action play() est appelée et la tête de lecture avance dans le scénario.
Si l’utilisateur entre autre chose que Steve, le fichier SWF n’est pas lu et un champ de texte
contenant le nom de variable alert est affiché.
stop();
if (nom == "Steve") {
play();
} else {
alert="Vous n’êtes pas Steve !";
}
prevFrame()
Disponibilité
Flash 2.
Usage
prevFrame()
Paramètres
Aucun.
Renvoie
Rien.
Description
Fonction : envoie la tête de lecture vers l’image précédente et l’arrête. Si l’image actuelle est
l’image 1, la tête de lecture ne bouge pas.print() 585
Exemple
Lorsque l’utilisateur clique sur un bouton auquel le gestionnaire suivant est affecté, la tête de
lecture est envoyée à l’image précédente.
on(release) {
prevFrame();
}
Consultez également
MovieClip.prevFrame()
prevScene()
Disponibilité
Flash 2.
Usage
prevScene()
Paramètres
Aucun.
Renvoie
Rien.
Description
Fonction : envoie la tête de lecture vers l’image 1 de la séquence précédente et l’arrête.
Consultez également
nextScene()
print()
Disponibilité
Flash Player 4.20.
Remarque : Si vous utilisez Flash Player7 ou ultérieur, vous pouvez créer un objet PrintJob, qui vous
permet (ainsi que l’utilisateur) de mieux contrôler le processus d’impression. Pour plus d’informations,
consultez l’entrée Classe PrintJob.
Usage
print("cible", "régionDimpression")
Paramètres
cible Le nom d’occurrence d’un clip à imprimer. Par défaut, toutes les images de l’occurrence
cible sont imprimées. Affectez une étiquette #p aux images que vous souhaitez imprimer dans ce
clip.
régionDimpression Un modificateur qui définit la zone d’impression du clip. Mettez ce
paramètre entre guillemets et spécifiez l’une des valeurs suivantes :586 Chapitre 12 : Dictionnaire ActionScript Présentation
• bmovie Désigne le cadre de délimitation d’une image spécifique dans une animation comme
zone d’impression de toutes les images imprimables de l’animation. Affectez une étiquette
d’image #b à l’image dont vous souhaitez utiliser le cadre de délimitation comme région
d’impression.
• bmax Désigne un composite de tous les cadres de délimitation de l’ensemble des images
imprimables comme zone d’impression. Spécifiez le paramètre bmax lorsque la taille des images
de votre animation varie.
• bframe Indique que le cadre de délimitation de chaque image imprimable est utilisé comme
zone d’impression pour cette image. Cela modifie la région d’impression pour chaque image et
modifie la taille des objets pour qu’ils correspondent à la région d’impression. Utilisez bframe
si vous avez des objets de tailles diverses dans chaque image et si vous souhaitez que chaque
objet remplisse la page imprimée.
Renvoie
Aucun.
Description
Fonction : imprime le clip cible en fonction des limites spécifiées dans le paramètre (bmovie,
bmax ou bframe). Affectez une étiquette #p aux images que vous souhaitez imprimer dans le clip
cible. Bien que print() fournisse des impressions de meilleure qualité que printAsBitmap(),
elle ne peut pas être utilisée pour imprimer des clips utilisant les transparences alpha ou des effets
de couleur spéciaux.
Si vous utilisez bmovie pour le paramètre régionDimpression, mais que vous n’affectez pas
d’étiquette #b à une image, la zone d’impression est déterminée par la taille de scène de la vidéo
chargée. L’animation n’hérite pas de la taille de scène de l’animation principale.
Tous les éléments imprimables d’une animation doivent être complètement chargés avant de
commencer l’impression.
La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
Exemple
L’exemple suivant imprime toutes les images imprimables du clip mon_mc selon la zone
d’impression définie par le cadre de délimitation de l’image portant l’étiquette d’image #b :
print(mon_mc,"bmovie");
L’exemple suivant imprime toutes les images imprimables de mon_mc avec une zone d’impression
définie par le cadre de délimitation de chaque image :
print(mon_mc,"bframe");
Consultez également
printAsBitmap(), printAsBitmapNum, Classe PrintJob, printNum()
printAsBitmap()
Disponibilité
Flash Player 4.20.printAsBitmap() 587
Remarque : Si vous utilisez Flash Player7 ou ultérieur, vous pouvez créer un objet PrintJob, qui vous
permet (ainsi que l’utilisateur) de mieux contrôler le processus d’impression. Pour plus d’informations,
consultez l’entrée Classe PrintJob.
Usage
printAsBitmap(cible, "régionDimpression")
Paramètres
cible Le nom d’occurrence d’un clip à imprimer. Par défaut, toutes les images de l’animation
sont imprimées. Affectez une étiquette #p aux images que vous souhaitez imprimer dans cette
animation.
régionDimpression Un modificateur qui définit la zone d’impression de l’animation. Mettez
ce paramètre entre guillemets et spécifiez l’une des valeurs suivantes :
• bmovie Désigne le cadre de délimitation d’une image spécifique dans une animation comme
zone d’impression de toutes les images imprimables de l’animation. Affectez une étiquette
d’image #b à l’image dont vous souhaitez utiliser le cadre de délimitation comme région
d’impression.
• bmax Désigne un composite de tous les cadres de délimitation de l’ensemble des images
imprimables comme zone d’impression. Spécifiez le paramètre bmax lorsque la taille des images
de votre animation varie.
• bframe Indique que le cadre de délimitation de chaque image imprimable est utilisé comme
zone d’impression pour cette image. Cela modifie la région d’impression pour chaque image et
modifie la taille des objets pour qu’ils correspondent à la région d’impression. Utilisez bframe
si vous avez des objets de tailles diverses dans chaque image et si vous souhaitez que chaque
objet remplisse la page imprimée.
Renvoie
Rien.
Description
Fonction : imprime le clip cible en tant que bitmap, en fonction des contours spécifiés dans le
paramètre (bmovie, bmax, ou bframe). Utilisez printAsBitmap() pour imprimer des animations
contenant des images avec des objets qui utilisent des transparences ou des effets de couleur.
L’action printAsBitmap() imprime avec la résolution la plus élevée possible sur l’imprimante
pour conserver la définition et la qualité les plus élevées possibles.
Si votre animation ne contient aucune transparence alpha ou effet de couleur, Macromedia vous
recommande d’utiliser print() pour obtenir des résultats de meilleure qualité.
Si vous utilisez bmovie pour le paramètre régionDimpression, mais que vous n’affectez pas
d’étiquette #b à une image, la zone d’impression est déterminée par la taille de scène de la vidéo
chargée. L’animation n’hérite pas de la taille de scène de l’animation principale.
Tous les éléments imprimables d’une animation doivent être complètement chargés avant de
commencer l’impression.
La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
Consultez également
print(), printAsBitmapNum, Classe PrintJob, printNum()588 Chapitre 12 : Dictionnaire ActionScript Présentation
printAsBitmapNum
Disponibilité
Flash Player 5.
Remarque : Si vous utilisez Flash Player7 ou ultérieur, vous pouvez créer un objet PrintJob, qui vous
permet (ainsi que l’utilisateur) de mieux contrôler le processus d’impression. Pour plus d’informations,
consultez l’entrée Classe PrintJob.
Usage
printAsBitmapNum(niveau, "régionDimpression")
Paramètres
niveau Le niveau de Flash Player à imprimer. Par défaut, toutes les images du niveau sont
imprimées. Affectez une étiquette #p aux images que vous souhaitez imprimer dans ce niveau.
régionDimpression Un modificateur qui définit la zone d’impression de l’animation. Mettez
ce paramètre entre guillemets et spécifiez l’une des valeurs suivantes :
• bmovie Désigne le cadre de délimitation d’une image spécifique dans une animation comme
zone d’impression de toutes les images imprimables de l’animation. Affectez une étiquette
d’image #b à l’image dont vous souhaitez utiliser le cadre de délimitation comme région
d’impression.
• bmax Désigne un composite de tous les cadres de délimitation de l’ensemble des images
imprimables comme zone d’impression. Spécifiez le paramètre bmax lorsque la taille des images
de votre animation varie.
• bframe Indique que le cadre de délimitation de chaque image imprimable est utilisé comme
zone d’impression pour cette image. Cela modifie la région d’impression pour chaque image et
modifie la taille des objets pour qu’ils correspondent à la région d’impression. Utilisez bframe
si vous avez des objets de tailles diverses dans chaque image et si vous souhaitez que chaque
objet remplisse la page imprimée.
Renvoie
Aucun.
Description
Fonction : imprime un niveau dans Flash Player en tant que bitmap, en fonction des contours
spécifiés dans le paramètre (bmovie, bmax, ou bframe). Utilisez printAsBitmapNum() pour
imprimer des animations contenant des images avec des objets qui utilisent des effets de
transparence ou de couleur. L’action printAsBitmapNum() imprime dans la résolution la plus
élevée sur l’imprimante pour préserver autant de définition et de qualité que possible. Pour
calculer la taille de fichier imprimable d’une image à imprimer en bitmap, multipliez la largeur en
pixels par la hauteur en pixels par la résolution de l’imprimante.
Si votre animation ne contient pas de transparences alpha ou d’effets de couleur, il est
recommandé d’utiliser printNum() pour un résultat de meilleure qualité.
Si vous utilisez bmovie pour le paramètre régionDimpression, mais que vous n’affectez pas
d’étiquette #b à une image, la zone d’impression est déterminée par la taille de scène de la vidéo
chargée. L’animation n’hérite pas de la taille de scène de l’animation principale.Classe PrintJob 589
Tous les éléments imprimables d’une animation doivent être complètement chargés avant de
commencer l’impression.
La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
Consultez également
print(), printAsBitmap(), Classe PrintJob, printNum()
Classe PrintJob
Disponibilité
Flash Player 7.
Description
La classe PrintJob vous permet de créer un contenu et de l’imprimer sur une ou plusieurs pages.
Cette classe, en plus d’offrir des fonctions d’impression améliorées disponibles avec la méthode
print(), permet de rendre le contenu dynamique hors écran, d’inviter les utilisateurs à l’aide
d’une seule boîte de dialogue d’impression et d’imprimer un document non mis à l’échelle dans
des proportions qui correspondent aux proportions du contenu. Cette fonctionnalité est
particulièrement utile pour rendre et imprimer un contenu dynamique externe, comme le
contenu et le texte dynamique d’une base de données.
En outre, grâce aux propriétés renseignées par PrintJob.start(), votre document peut accéder
aux paramètres de l’imprimante utilisateur, tels que la hauteur, la largeur et l’orientation de la
page, et vous pouvez configurer le document pour qu’il formate dynamiquement le contenu Flash
adapté aux paramètres de l’imprimante.
Résumé des méthodes de la classe PrintJob
Vous devez utiliser les méthodes de la classe PrintJob dans l’ordre spécifié dans le tableau suivant.
Constructeur pour la classe PrintJob
Disponibilité
Flash Player 7.
Usage
ma_pj = new PrintJob()
Paramètres
Aucun.
Méthode Description
PrintJob.start() Affiche les boîtes de dialogue d’impression du système d’exploitation et
démarre la mise en attente.
PrintJob.addPage() Ajoute une page au spouleur d’impression.
PrintJob.send() Envoie les pages mises en attente vers l’imprimante.590 Chapitre 12 : Dictionnaire ActionScript Présentation
Renvoie
Rien.
Description
Constructeur : crée un objet PrintJob que vous pouvez utiliser pour imprimer une ou plusieurs
pages.
Pour implémenter une tâche d’impression, utilisez ces méthodes dans la séquence indiquée :
// créer un objet PrintJob
ma_pj = new PrintJob();                        // instantier l’objet
// afficher la boîte de dialogue d’impression
ma_pj.start();                                 // initialiser la tâche
d’impression
// ajouter la zone spécifiée à la tâche d’impression
// répéter une fois pour chaque page à imprimer
ma_pj.addPage([params]);                       // envoyer la(les) page(s) au
spouleur
ma_pj.addPage([params]);   
ma_pj.addPage([params]);   
ma_pj.addPage([params]);   
// envoyer des pages du spouleur vers l’imprimante
ma_pj.send();                                   // imprimer page(s)
// nettoyer
delete ma_pj;                                    // supprimer l’objet
Dans votre propre implémentation des objets PrintJob, vérifiez les valeurs renvoyées par
PrintJob.start() et PrintJob.addPage() avant de poursuivre l’impression. Consultez les
exemples pour PrintJob.addPage().
Vous ne pouvez pas créer d’objet PrintJob tant que tous les objets PrintJob déjà créés n’ont pas été
désactivés (à savoir, qu’ils ont réussi ou échoué). Si vous tentez de créer un second objet PrintJob
(en appelant new PrintJob()) tandis que le premier objet PrintJob est encore actif, le second
objet PrintJob n’est pas créé.
Exemple
Pour plus d’informations, consultez PrintJob.addPage().
Consultez également
PrintJob.addPage(), PrintJob.send(), PrintJob.start()
PrintJob.addPage()
Disponibilité
Flash Player 7.
Usage
ma_pj.addPage(target [, printArea] [, options ] [, frameNumber])PrintJob.addPage() 591
Paramètres
target Le niveau ou le nom de l’occurrence du clip à imprimer. Définissez un nombre pour
spécifier un niveau (par exemple, 0 est l’animation _root) ou une chaîne (entre guillemets) pour
spécifier le nom de l’occurrence d’un clip.
printArea  Un objet facultatif qui spécifie la zone à imprimer, au format suivant :
{xMin:topLeft, xMax:topRight, yMin:bottomLeft, yMax:bottomRight}
Les coordonnées que vous spécifiez pour printArea représentent les pixels d’écran par rapport au
point d’alignement de l’animation _root (si target=0) ou du niveau ou clip spécifié par target.
Vous devez fournir les quatre coordonnées. Les valeurs de largeur (xMax-xMin) et de hauteur
(yMax-yMin) doivent chacune être supérieure à 0.
Les points sont des unités de mesure d’impression, et les pixels sont des unités de mesure d’écrans.
Un point équivaut à un pixel en termes de taille. Vous pouvez utiliser les équivalences suivantes
pour convertir les pouces ou les centimètres en twips, en pixels ou en points (un twip équivaut à
1/20 de pixel) :
• 1 pixel = 1 point = 1/72 pouce = 20 twips
• 1 pouce = 72 pixels = 72 points = 1 440 twips
• 1 cm = 567 twips
Remarque : Si vous avez précédemment utilisé print(), printAsBitmap(), printAsBitmapNum ou
printNum() pour imprimer depuis Flash, vous avez utilisé une étiquette d’image #b pour spécifier la
zone à imprimer. Lorsque vous utilisez la méthode addPage(), vous devez utiliser le paramètre
printArea pour spécifier la zone d’impression ; les étiquettes d’image #b sont ignorées.
Si vous omettez le paramètre printArea ou s’il n’est pas correctement défini, la totalité de la zone
target est imprimée. Si vous ne souhaitez pas spécifier une valeur pour printArea mais voulez
en spécifier une pour options ou frameNumber, définissez null pour printArea.
options Un paramètre facultatif qui indique si l’impression est effectuée au format vectoriel ou
bitmap, de la manière suivante :
{printAsBitmap:Boolean}
Par défaut, les pages sont imprimées au format vectoriel. Pour imprimer target au format
bitmap, définissez true pour printAsBitmap. La valeur par défaut est false, ce qui représente
une demande d’impression vectorielle. Tenez compte des suggestions suivantes lors de la
détermination de la valeur à utiliser :
• Si le contenu en cours d’impression comprend une image bitmap, utilisez
{printAsBitmap:true} pour inclure les transparences et les effets de couleur.
• Si le contenu ne comprend pas d’image bitmap, omettez ce paramètre ou utilisez
{printAsBitmap:false} pour imprimer le contenu sous forme de graphiques vectoriels afin
de bénéficier d’une qualité d’image élevée.
Si options est omis ou défini de manière incorrecte, l’impression vectorielle est implémentée. Si
vous ne souhaitez pas spécifier une valeur pour options mais souhaitez en spécifier une pour
frameNumber, définissez null pour options.
frameNumber Un nombre optionnel qui vous permet de spécifier l’image à imprimer ; notez
qu’aucun paramètre ActionScript défini sur l’image n’est appelé. Si vous omettez ce paramètre,
l’image actuelle de target est imprimée.592 Chapitre 12 : Dictionnaire ActionScript Présentation
Remarque : Si vous avez précédemment utilisé print(), printAsBitmap(), printAsBitmapNum ou
printNum() pour imprimer depuis Flash, vous avez peut-être utilisé une étiquette d’image #p sur
plusieurs images pour spécifier les images à imprimer. Pour utiliser PrintJob.addPage() afin
d’imprimer plusieurs images, vous devez émettre une commande PrintJob.addPage() pour chaque
image ; les étiquettes d’image #p sont ignorées. Pour savoir comment programmer cette opération,
consultez l’exemple figurant plus bas dans cette entrée.
Renvoie
Une valeur booléenne true si la page a été envoyée avec succès vers le spouleur d’impression,
false dans les autres cas.
Description
Méthode : envoie le niveau ou le clip spécifié sous la forme d’une page unique au spouleur. Avant
d’utiliser cette méthode, vous devez utiliser PrintJob.start() ; après avoir appelé
PrintJob.addPage() une ou plusieurs fois pour une tâche d’impression, vous devez utiliser
PrintJob.send() pour envoyer les pages mises en attente vers l’imprimante.
Si cette méthode renvoie false (par exemple, si vous n’avez pas appelé PrintJob.start() ou si
l’utilisateur a annulé la tâche d’impression), les appels ultérieurs de PrintJob.addPage()
échoueront. Toutefois, si les appels antérieurs à PrintJob.addPage() ont réussi, la commande
PrintJob.send() finale envoie les pages traitées par le spouleur à l’imprimante.
Si vous avez défini une valeur pour printArea, les coordonnées xMin et yMin correspondent à
l’angle supérieur gauche (coordonnées 0,0) de la zone imprimable de la page ; cette zone est
déterminée par les propriétés pageHeight et pageWidth définies par PrintJob.start(). La
sortie d’imprimante s’alignant avec l’angle supérieur gauche de la zone imprimable de la page, elle
est attachée à droite et/ou en bas si la zone définie dans printArea est plus grande que la zone
imprimable de la page. Si vous n’avez pas transmis de valeur pour printArea et que la scène est
plus grande que la zone imprimable, le même type de découpage est effectué.
Si vous souhaitez mettre à l’échelle un clip avant de l’imprimer, définissez ses propriétés
MovieClip._xscale et MovieClip._yscale avant d’appeler cette méthode, puis redéfinissez-les
sur leurs valeurs d’origine après l’appel. L’échelle d’un clip n’a aucun rapport avec printArea. En
d’autres termes, si vous spécifiez que vous imprimez une zone de dimensions 50 x 50 pixels, 2 500
pixels sont imprimés. Si vous avez mis le clip à l’échelle, ces mêmes 2 500 pixels sont imprimés,
mais aux nouvelles dimensions.
La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
Les imprimantes non PostScript convertissent les vecteurs en bitmaps.
Exemple
L’exemple suivant permet d’émettre la commande addPage() de différentes manières :
mon_btn.onRelease = function ()
{
var pageCount = 0;
var ma_pj = new PrintJob();
if (ma_pj.start())
{
// Imprimer la totalité de l’image actuelle de l’animation _root au format
vectoriel
if (ma_pj.addPage(0))
{PrintJob.addPage() 593
pageCount++;
// En démarrant à 0,0, imprimer une zone de 400 pixels de large et
500 pixels de haut
// de l’image actuelle de l’animation _root au format vectoriel
if (ma_pj.addPage(0, {xMin:0,xMax:400,yMin:0,yMax:500}))
{
pageCount++;
// En démarrant à 0,0, imprimer une zone de 400 pixels de large et
500 pixels de haut
// de l’image 1 de l’animation _root au format bitmap
if (ma_pj.addPage(0, {xMin:0,xMax:400,yMin:0,yMax:500},
{printAsBitmap:true}, 1));
{
pageCount++;
// En démarrant avec 50 pixels à droite de 0,0 et 70 pixels en bas,
// imprimer une zone de 500 pixels de large et 600 pixels de haut
// de l’image 4 du niveau 5 au format vectoriel
if (ma_pj.addPage(5, {xMin:50,xMax:550,yMin:70,yMax:670},null, 4))
{
pageCount++;
// En commençant à 0,0, imprimer une zone de 400 pixels de
largeur
// et 400 pixels de hauteur de la page 3 du clip "danse_mc"
// au format bitmap
if (ma_pj.addPage("danse_mc",
{xMin:0,xMax:400,yMin:0,yMax:400},{printAsBitmap:true}, 3))
{
pageCount++;
// En commençant à 0,0, imprimer une zone de 400 pixels de
largeur
// et 600 pixels de hauteur de la page 3 du clip "danse_mc"
// au format vectoriel, à 50 % de sa taille réelle
var x = Danse_mc._xscale;
var y = clipDeDanse._yscale;
Danse_mc._xscale = 50;
Danse_mc._yscale = 50;
if (ma_pj.addPage("danse_mc",
{xMin:0,xMax:400,yMin:0,yMax:600},null, 3))
{
pageCount++;
}
Danse_mc._xscale = x;
Danse_mc._yscale = y;
}
}
}
}
}
}
if (pageCount)
{
ma_pj.send();
}594 Chapitre 12 : Dictionnaire ActionScript Présentation
delete ma_pj;
}
Consultez également
PrintJob.send(), PrintJob.start()
PrintJob.send()
Disponibilité
Flash Player 7.
Usage
ma_pj.send()
Paramètres
Aucun.
Renvoie
Rien.
Description
Méthode : est utilisée après PrintJob.start() et PrintJob.addPage() pour envoyer des pages
mises en attente vers l’imprimante.
Exemple
Pour plus d’informations, consultez PrintJob.addPage().
Consultez également
PrintJob.addPage(), PrintJob.start()
PrintJob.start()
Disponibilité
Flash Player 7.
Usage
ma_pj.start()
Paramètres
Aucun.
Renvoie
Une valeur booléenne true si l’utilisateur clique sur OK à l’affichage des boîte de dialogue
d’impression ou false si l’utilisateur clique sur Annuler ou si une erreur se produit.PrintJob.start() 595
Description
Méthode : affiche les boîtes de dialogue d’impression du système d’exploitation et démarre la mise
en attente. Les boîtes de dialogue d’impression permettent à l’utilisateur de modifier les
paramètres d’impression, puis de charger les propriétés en lecture seule suivantes (notez que 1
point équivaut à 1 pixel) :
Une fois que l’utilisateur a cliqué sur OK dans la boîte de dialogue d’impression, le lecteur
commence à mettre en attente une tâche d’impression dans le système d’exploitation. Vous devez
activer toutes les commandes ActionScript qui affectent l’impression, avant de commencer à
utiliser les commandes PrintJob.addPage() pour démarrer l’envoi des pages au spouleur. Si
vous le souhaitez, vous pouvez utiliser les propriétés de largeur, de hauteur et d’orientation
renvoyées par cette méthode pour déterminer le formatage de l’impression.
Etant donné que l’utilisateur reçoit des informations telles que « Impression de la page 1 »
immédiatement après avoir cliqué sur OK, vous devez appeler les commandes
PrintJob.addPage() et PrintJob.send() dès que possible.
Si cette méthode renvoie false (par exemple, si l’utilisateur clique sur Annuler au lieu de OK),
les appels ultérieurs à PrintJob.addPage() et PrintJob.send() échouent. Cependant, si vous
testez cette valeur renvoyée et n’envoyez pas les commandes PrintJob.addPage(), vous devrez
encore supprimer l’objet PrintJob pour vous assurer que le spouleur d’impression est nettoyé,
comme dans l’exemple ci-dessous.
var ma_pj = new PrintJob();
var myResult = ma_pj.start();
if(monRésultat){
// instructions addPage() et send() ici
}
delete ma_pj;
Exemple
Pour plus d’informations, consultez PrintJob.addPage().
Consultez également
PrintJob.addPage(), PrintJob.send()
Propriété Caractères Unités Remarques
PrintJob.paperHeight  Number Points Hauteur générale du papier
PrintJob.paperWidth  Number Points Largeur générale du papier
PrintJob.pageHeight  Number Points  Hauteur de la zone imprimable réelle sur
la page ; toutes les marges définies par
l’utilisateur sont ignorées
PrintJob.pageWidth  Number Points  Largeur de la zone imprimable réelle sur
la page ; toutes les marges définies par
l’utilisateur sont ignorées
PrintJob.orientation String  sans objet « Portrait » ou « Paysage »596 Chapitre 12 : Dictionnaire ActionScript Présentation
printNum()
Disponibilité
Flash Player 5.
Remarque : Si vous utilisez Flash Player7 ou ultérieur, vous pouvez créer un objet PrintJob, qui vous
permet (ainsi que l’utilisateur) de mieux contrôler le processus d’impression. Pour plus d’informations,
consultez l’entrée Classe PrintJob.
Usage
printNum (niveau, "régionDimpression")
Paramètres
niveau Le niveau de Flash Player à imprimer. Par défaut, toutes les images du niveau sont
imprimées. Affectez une étiquette #p aux images que vous souhaitez imprimer dans ce niveau.
régionDimpression Un modificateur qui définit la zone d’impression de l’animation. Mettez
ce paramètre entre guillemets et spécifiez l’une des valeurs suivantes :
• bmovie Désigne le cadre de délimitation d’une image spécifique dans une animation comme
zone d’impression de toutes les images imprimables de l’animation. Affectez une étiquette
d’image #b à l’image dont vous souhaitez utiliser le cadre de délimitation comme région
d’impression.
• bmax Désigne un composite de tous les cadres de délimitation de l’ensemble des images
imprimables comme zone d’impression. Spécifiez le paramètre bmax lorsque la taille des images
de votre animation varie.
• bframe Indique que le cadre de délimitation de chaque image imprimable est utilisé comme
zone d’impression pour cette image. Cela modifie la région d’impression pour chaque image et
modifie la taille des objets pour qu’ils correspondent à la région d’impression. Utilisez bframe
si vous avez des objets de tailles diverses dans chaque image et si vous souhaitez que chaque
objet remplisse la page imprimée.
Renvoie
Rien.
Description
Fonction : imprime le niveau de Flash Player en fonction des limites spécifiées dans le paramètre
regionDimpression ("bmovie", "bmax", "bframe"). Affectez une étiquette #p aux images que
vous souhaitez imprimer dans le clip cible. Bien que l’utilisation de printNum() offre des
impressions de meilleure qualité que l’utilisation de printAsBitmapNum(), vous ne pouvez pas
utiliser printNum() pour imprimer des animations contenant des transparences alpha ou des
effets de couleur spéciaux.
Si vous utilisez bmovie pour le paramètre régionDimpression, mais que vous n’affectez pas
d’étiquette #b à une image, la zone d’impression est déterminée par la taille de scène de la vidéo
chargée. L’animation n’hérite pas de la taille de scène de l’animation principale.
Tous les éléments imprimables d’une animation doivent être complètement chargés avant de
commencer l’impression.
La fonction d’impression de Flash Player supporte les imprimantes PostScript et non PostScript.
Les imprimantes non PostScript convertissent les vecteurs en bitmaps.public 597
Consultez également
print(), printAsBitmap(), printAsBitmapNum, Classe PrintJob
private
Disponibilité
Flash Player 6.
Usage
class nomClasse{
private var nom;
private function nom() {
// vos instructions
}
}
Remarque : Pour utiliser ce mot-clé, vous devez définir ActionScript 2.0 et Flash Player 6 ou version
ultérieure dans l’onglet Flash de la boîte de dialogue Paramètres de publication de votre fichier FLA.
Ce mot-clé n’est supporté que lorsqu’il est utilisé dans des fichiers de scripts externes et non dans
des scripts écrits dans le panneau Actions.
Paramètres
nom Le nom de la variable ou de la fonction à spécifier en tant que variable ou fonction privée.
Description
Mot-clé : spécifie qu’une variable ou une fonction est disponible uniquement pour la classe qui la
déclare ou la définit, ou pour les sous-classes de cette dernière. Par défaut, une variable ou une
fonction est disponible pour toutes les classes qui l’appellent. Utilisez ce mot-clé pour restreindre
l’accès à une variable ou une fonction. Pour plus d’informations, consultez Contrôle de l’accès des
membres, page 170.
Vous pouvez uniquement utiliser ce mot-clé dans les définitions de classes, et non dans les
définitions d’interfaces.
Consultez également
public, static
public
Flash Player6
Usage
class NomClasse{
public var nom;
public function nom() {
// vos instructions
}
}
Remarque : Pour utiliser ce mot-clé, vous devez définir ActionScript 2.0 et Flash Player 6 ou version
ultérieure dans l’onglet Flash de la boîte de dialogue Paramètres de publication de votre fichier FLA.
Ce mot-clé n’est supporté que lorsqu’il est utilisé dans des fichiers de scripts externes et non dans
des scripts écrits dans le panneau Actions.598 Chapitre 12 : Dictionnaire ActionScript Présentation
Paramètres
nom Le nom de la variable ou de la fonction à spécifier en tant que variable ou fonction privée.
Description
Mot-clé : spécifie qu’une variable ou une fonction est disponible pour toutes les classes qui
l’appellent. Les variables et les fonctions étant publiques par défaut, ce mot-clé est utilisé
principalement pour des raisons stylistiques. Par exemple, vous pouvez utiliser ce mot-clé dans un
but d’homogénéisation dans un bloc de code qui contient également des variables privées ou
statiques.
Exemple
Les deux blocs de code suivants sont fonctionnellement identiques.
private var age:Number;
public var nom:String;
static var naissance:Date;
private var age:Number;
var nom:String;
static var naissance:Date;
Pour plus d’informations, consultez Contrôle de l’accès des membres, page 170.
Consultez également
private, static
_quality
Disponibilité
Flash Player 5.
Usage
_quality
Description
Propriété (globale) : définit ou récupère la qualité de rendu utilisée pour une animation. Les
polices de périphérique sont toujours aliasées et ne sont donc pas affectées par la propriété
_quality.
La propriété _quality peut être définie avec les valeurs suivantes :
• « LOW » Qualité de rendu minimum.  Les graphiques ne sont pas anti-aliasés et les bitmaps ne
sont pas lissés.
• « MEDIUM » Qualité de rendu moyenne. Les graphiques sont anti-aliasés avec une grille 2x2, en
pixels, mais les bitmaps ne sont pas lissés. Convient aux animations ne contenant pas de texte.
• « HIGH » Qualité de rendu élevée. Les graphiques sont anti-aliasés avec une grille 4x4, en
pixels, et les bitmaps sont lissés si l’animation est statique. Il s’agit du paramètre de qualité de
rendu par défaut utilisé par Flash.
• "BEST" Qualité de rendu très élevée. Les graphiques sont anti-aliasés avec une grille 4x4, en
pixels, et les bitmaps sont toujours lissés.removeMovieClip() 599
Exemple
L’exemple suivant définit la qualité de rendu sur LOW
_quality = "LOW";
Consultez également
_highquality, toggleHighQuality()
random
Disponibilité
Flash Player 4. Cette fonction est déconseillée dans Flash 5 ; utilisez plutôt Math.random().
Usage
random(valeur)
Paramètres
valeur Un entier.
Renvoie
Un entier.
Description
Fonction : renvoie un entier aléatoire entre 0 et un de moins que l’entier spécifié dans le
paramètre valeur.
Exemple
L’utilisation suivante de random() renvoie une valeur 0, 1, 2, 3 ou 4 :
random(5);
Consultez également
Math.random()
removeMovieClip()
Disponibilité
Flash Player 4.
Usage
removeMovieClip(cible)
Paramètres
cible Le chemin cible d’une occurrence de clip créé avec duplicateMovieClip() ou le nom
d’occurrence d’un clip créé avec MovieClip.attachMovie() ou
MovieClip.duplicateMovieClip.
Renvoie
Aucun.600 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Fonction : supprime le clip spécifié.
Consultez également
duplicateMovieClip(), MovieClip.duplicateMovieClip, MovieClip.attachMovie(),
MovieClip.removeMovieClip()
return
Disponibilité
Flash Player 5.
Usage
return[expression]
Paramètres
expression Une chaîne, un nombre, un tableau ou un objet à évaluer et à renvoyer comme
valeur de la fonction. Ce paramètre est facultatif.
Renvoie
Le paramètre expression évalué, si fourni.
Description
Instruction : spécifie la valeur renvoyée par une fonction. L’action return évalue expression et
renvoie le résultat en tant que valeur de la fonction dans laquelle elle est exécutée. L’action return
entraîne l’arrêt de la fonction et son remplacement par la valeur renvoyée. Si l’instruction return
est utilisée seule, elle renvoie null.
Vous ne pouvez pas renvoyer plusieurs valeurs. Si vous tentez de le faire, seule la dernière valeur est
renvoyée. Dans l’exemple suivant, c est renvoyé :
renvoyer a, b, c ;
Exemple
L’exemple suivant utilise l’action return à l’intérieur du corps de la fonction somme() pour
renvoyer la valeur de la somme des trois paramètres. La ligne de code suivante appelle la fonction
somme() et affecte la valeur renvoyée à la variable nouvelleValeur :
function somme(a, b, c){
return a + b + c;
}
nouvelleValeur = somme(4, 32, 78);
trace(nouvelleValeur);
// envoie 114 dans le panneau de sortie
Consultez également
functionscroll 601
_root
Disponibilité
Flash Player 5.
Usage
_root.clip
_root.action
_root.propriété
Paramètres
clip Le nom d’occurrence d’un clip.
action Une action ou une méthode.
propriété Une propriété de l’objet MovieClip.
Description
Propriété : spécifie ou renvoie une référence au scénario de l’animation principale. Si une
animation possède plusieurs niveaux, le scénario principal de l’animation se situe dans le niveau
contenant le script en cours d’exécution. Par exemple, si un script de niveau 1 est évalué comme
_root, _level1 est renvoyé.
La spécification de _root est identique à l’utilisation de la notation à barre oblique (/) pour
spécifier un chemin absolu au sein du niveau courant.
Remarque : Si une animation contenant _root est chargée dans une autre animation, _root fait
référence au scénario de l’animation en cours de chargement et non au scénario contenant _root. Si
vous souhaitez vérifier que _root fait référence au scénario de l’animation chargée même si elle est
chargée dans une autre animation, utilisez MovieClip._lockroot.
Exemple
L’exemple suivant arrête le scénario du niveau contenant le script en cours d’exécution :
_root.stop();
L’exemple suivant envoie le scénario dans le niveau actuel à l’image 3 :
_root.gotoAndStop(3);
Consultez également
MovieClip._lockroot, _parent, targetPath
scroll
Disponibilité
Flash Player 4.
Usage
nomDeVariableDeChampDeTexte.scroll = x602 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Propriété : une propriété maintenant déconseillée qui contrôle l’affichage des informations d’un
champ de texte associé à une variable. La propriété scroll définit l’endroit où le champ de texte
commence à afficher le contenu ; après l’avoir définie, le Flash Player la met à jour au fur et à
mesure que l’utilisateur fait défiler le champ de texte. La propriété scroll est utile pour diriger les
utilisateurs vers un paragraphe spécifique dans un long passage, ou pour créer des champs de texte
défilants. Cette propriété peut être récupérée et modifiée.
Exemple
Le code suivant est associé à un bouton Haut qui fait défiler le champ de texte monTexte :
on (release) {
monTexte.scroll = monTexte.scroll + 1;
}
Consultez également
TextField.maxscroll, TextField.scroll
Classe Selection
Disponibilité
Flash Player 5.
Description
La classe Selection vous permet de définir et de contrôler le champ de texte dans lequel est situé le
point d’insertion, c’est-à-dire, le champ qui a le focus. Les index de la plage de sélection sont basés
sur zéro (par exemple, la première position est 0, la deuxième est 1, et ainsi de suite).
Il n’existe aucune fonction du constructeur pour la classe Selection, car il ne peut y avoir qu’un
seul champ de texte avec focus à la fois.
Résumé des méthodes de la classe Selection
Méthode Description
Selection.addListener Enregistre un objet pour la réception de la notification lorsque
onSetFocus est invoqué.
Selection.getBeginIndex() Renvoie l’index au début de la plage de sélection. Renvoie -1 s’il n’y a
pas d’index ou de champ sélectionné courant.
Selection.getCaretIndex() Renvoie la position courante du point d’insertion dans la plage de
sélection avec focus. Renvoie -1 s’il n’y a pas de position de point
d’insertion ou de plage de sélection avec focus.
Selection.getEndIndex() Renvoie l’index de la fin de la plage de sélection. Renvoie -1 s’il n’y a
pas d’index ou de champ sélectionné courant.
Selection.getFocus() Renvoie le nom de la variable pour le champ de texte avec focus.
Renvoie null s’il n’existe aucun champ de texte avec focus.
Selection.removeListener Supprime un objet enregistré avec addListener().Selection.getBeginIndex() 603
Résumé des écouteurs de la classe Selection
Selection.addListener
Disponibilité
Flash Player 6.
Usage
Selection.addListener(nouvelEcouteur)
Paramètres
nouvelEcouteur Un objet avec une méthode onSetFocus.
Renvoie
Aucun.
Description
Méthode : enregistre un objet pour la réception de notifications de changement de focus clavier.
Lorsque le focus change (par exemple, lorsque Selection.setFocus() est invoqué), la méthode
onSetFocus de tous les objets à l’écoute enregistrés avec addListener() est invoquée. Plusieurs
objets peuvent attendre des notifications de changement de focus. Si l’écouteur nouvelEcouteur
est déjà enregistré, aucun changement n’a lieu.
Selection.getBeginIndex()
Disponibilité
Flash Player 5.
Usage
Selection.getBeginIndex()
Paramètres
Aucun.
Renvoie
Un entier.
Selection.setFocus() Règle le champ de texte associé à la variable spécifiée.
Selection.setSelection() Définit les index de début et de fin de la plage de sélection.
Ecouteur Description
Selection.onSetFocus Notifié lorsque le focus de saisie change.
Méthode Description604 Chapitre 12 : Dictionnaire ActionScript Présentation
Description
Méthode : renvoie l’index du début de la plage de sélection. Si aucun index n’existe ou si aucun
champ de texte courant n’a le focus, la méthode renvoie -1. Les index de la plage de sélection sont
basés sur zéro (par exemple, la première position est 0, la deuxième est 1, et ainsi de suite).
Selection.getCaretIndex()
Disponibilité
Flash Player 5.
Usage
Selection.getCaretIndex()
Paramètres
Aucun.
Renvoie
Un entier.
Description
Méthode : renvoie l’index de la position du point d’insertion clignotant (caret). Si aucun point
d’insertion clignotant n’est affiché, la méthode renvoie -1. Les index de la plage de sélection sont
basés sur zéro (par exemple, la première position est 0, la deuxième est 1, etc.).
Selection.getEndIndex()
Disponibilité
Flash Player 5.
Usage
Selection.getEndIndex()
Paramètres
Aucun.
Renvoie
Un entier.
Description
Méthode : renvoie l’index de fin de la zone de sélection avec le focus courant. Si aucun index
n’existe ou s’il n’y a aucune plage de sélection avec le focus, la méthode renvoie -1. Les index de la
plage de sélection sont basés sur zéro (par exemple, la première position est 0, la deuxième est 1, et
ainsi de suite).Selection.onSetFocus 605
Selection.getFocus()
Disponibilité
Flash Player 5. Les noms d’occurrence des boutons et des champs de texte fonctionnent dans
Flash Player 6 et ultérieur.
Usage
Selection.getFocus()
Paramètres
Aucun.
Renvoie
Une chaîne ou null.
Description
Méthode : renvoie le nom de variable du champ de texte ayant le focus. Si aucun champ de texte
n’a le focus, la méthode renvoie null. Si le focus actuel est un bouton et que le bouton est un
objet Button, getFocus() renvoie le chemin cible sous forme de chaîne. Si le focus actuel est un
champ de texte et que le champ de texte est un objet TextField, getFocus() renvoie le chemin
cible sous forme de chaîne.
Si un clip de bouton est le bouton où se trouve actuellement le focus, Selection.getFocus()
renvoie le chemin cible du clip de bouton. Si un champ de texte avec un nom d’occurrence a
actuellement le focus, Selection.getFocus() renvoie le chemin cible de l’objet TextField.
Sinon, il renvoie le nom de variable du champ de texte.
Selection.onSetFocus
Disponibilité
Flash Player 6.
Usage
unEcouteur.onSetFocus = function(ancienFocus, nouveauFocus){
instructions;
}
Description
Ecouteur : notifié lorsque le focus de saisie change. Pour utiliser onSetFocus, vous devez créer un
objet d’écoute. Vous pouvez alors définir une fonction pour onSetFocus et utiliser la méthode
addListener pour enregistrer l’écouteur avec l’objet Selection, comme dans l’exemple suivant :
unEcouteur = new Object();
unEcouteur.onSetFocus = function () { ... };
Selection.addListener(unEcouteur);
Les écouteurs permettent à différents morceaux de code de coopérer étant donné que plusieurs
écouteurs peuvent recevoir une notification concernant un seul événement.
Consultez également
Selection.addListener606 Chapitre 12 : Dictionnaire ActionScript Présentation
Selection.removeListener
Disponibilité
Flash Player 6.
Usage
Selection.removeListener(écouteur)
Paramètres
écouteur L’objet qui ne reçoit plus de notification de focus.
Renvoie
Si l’écouteur a été correctement retiré de la méthode renvoie true. Si l’écouteur n’a pas été
correctement retiré, par exemple si l’écouteur n’apparaissait pas dans la liste des écouteurs de
l’objet Selection, la méthode renvoie false.
Description
Méthode : supprime un objet précédemment enregistré avec addListener().
Selection.setFocus()
Disponibilité
Flash Player 5. Les noms d’occurrence des boutons et des clips ne fonctionnent que dans Flash
Player 6 et ses versions ultérieures.
Usage
Selection.setFocus("nomDoccurrence")
Paramètres
nomDoccurrence Chaîne spécifiant le chemin vers le nom d’occurrence d’un bouton, d’un clip
ou d’un champ de texte.
Renvoie
Un événement.
Description
Méthode : donne le focus au champ de texte, bouton ou clip sélectionnable (modifiable) spécifié
par nomDoccurrence. Le paramètre instanceName doit être une chaîne littérale du chemin de
cette occurrence. Vous pouvez utiliser la notation à point ou la notation à barre oblique pour
spécifier le chemin. Vous pouvez également utiliser un chemin relatif ou absolu. Si vous utilisez
ActionScript 2.0, vous devez utiliser la notation en points.
Si null est transmis, le focus actuel est retiré.
Exemple
L’exemple suivant donne le focus à un champ de texte associé à maVar, sur le scénario principal.
Etant donné que le paramètre nomDoccurrence est un chemin absolu, vous pouvez appeler
l’action à partir de tout scénario.
Selection.setFocus("_root.maVar");set 607
Dans l’exemple suivant, le champ de texte associé à maVar est dans un clip appelé monClip dans le
scénario principal. Vous pouvez utiliser l’un ou l’autre des deux chemins suivants pour définir le
focus, le premier étant relatif, le deuxième absolu.
Selection.setFocus("monClip.maVar");
Selection.setFocus("_root.monClip.maVar");
Selection.setSelection()
Disponibilité
Flash Player 5.
Usage
Selection.setSelection(début, fin)
Paramètres
début L’index de début de la plage de sélection.
fin L’index de fin de la plage de sélection.
Renvoie
Rien.
Description
Méthode : définit la plage de sélection du champ de texte avec focus. La nouvelle plage de
sélection commencera à l’index spécifié dans le paramètre début et finira à l’index spécifié dans le
paramètre fin. Les index de la plage de sélection sont basés sur zéro (par exemple, la première
position est 0, la deuxième est 1, et ainsi de suite). Cette méthode n’a aucun effet si aucun champ
de texte n’a le focus.
set
Disponibilité
Flash Player 6.
Usage
function set propriete(nomVar) {
// vos instructions
}
Remarque : Pour utiliser ce mot-clé, vous devez définir ActionScript 2.0 et Flash Player 6 ou version
ultérieure dans l’onglet Flash de la boîte de dialogue Paramètres de publication de votre fichier FLA.
Ce mot-clé n’est supporté que lorsqu’il est utilisé dans des fichiers de scripts externes et non dans
des scripts écrits dans le panneau Actions.
Paramètres
propriete Mot utilisé en référence à la propriété à laquelle la commande set accède ; cette
valeur doit être identique à celle utilisée dans la commande get correspondante.
nomVar La variable locale qui définit la valeur en cours d’affectation.608 Chapitre 12 : Dictionnaire ActionScript Présentation
Renvoie
Rien.
Description
Mot-clé : permet une "définition" implicite des propriétés associées aux objets, en fonction des
classes définies dans les fichiers de classes externes. L’utilisation de méthodes de définition
implicites vous permet d’accéder aux propriétés des objets, sans accéder directement à ces objets.
Les méthodes get/set implicites sont des abréviations syntaxiques de la méthode
Object.addProperty() dans ActionScript 1.
Pour plus d’informations, consultez Méthodes get/set implicites, page 179.
Consultez également
get, Object.addProperty()
Variable set
Disponibilité
Flash Player 4.
Usage
set(variable, expression)
Paramètres
variable Un identifiant devant contenir la valeur du paramètre de l’expression.
expression Une valeur affectée à la variable.
Renvoie
Rien.
Description
Instruction : affecte une valeur à une variable. Une variable est un conteneur d’informations. Le
conteneur reste toujours le même, c’est le contenu qui peut varier. La modification de la valeur
d’une variable pendant la lecture du fichier SWF permet d’enregistrer les informations relatives
aux actions de l’utilisateur, d’enregistrer les valeurs modifiées pendant la lecture du fichier SWF
ou d’évaluer si une condition est true ou false.
Les variables peuvent contenir n’importe quel type de données (par exemple, Chaîne, Nombre,
Booléen, Objet ou Clip). Le scénario de chaque fichier SWF et clip possède son propre jeu de
variables et chaque variable possède sa propre valeur indépendante des variables des autres
scénarios.
La saisie stricte des données n’est pas autorisée au sein d’une instruction set. Si vous utilisez cette
instruction pour définir une variable sur une valeur dont le type de données est différent du type
associé à la variable d’un fichier de classe, aucune erreur de compilation n’est renvoyée.
Exemple
Cet exemple définit une variable appelée orig_x_pos qui stocke la position originale de l’axe x du
clip vaisseau afin de pouvoir le réinitialiser à sa position de début ultérieurement dans le fichier
SWF.setInterval() 609
on(release) {
set("pos_x_orig", getProperty ("vaisseau", _x ));
}
Le code précédent donne le même résultat que le suivant :
on(release) {
pos_x_orig = vaisseau._x;
}
Consultez également
var, call()
setInterval()
Disponibilité
Flash Player 6.
Usage
setInterval(NomDeFonction, intervalle [, param1, param2, ..., paramN])
Paramètres
NomDeFonction Un nom de fonction ou une référence à une fonction anonyme.
intervalle Le temps en millisecondes qui s’écoule entre les appels du paramètre
nomDeFonction.
param1, param2, ..., paramN Paramètres facultatifs transmis à la fonction ou au paramètre
NomDeMéthode.
Renvoie
Un identifiant d’intervalle que vous pouvez transmettre à clearInterval pour annuler
l’intervalle.

Description
La classe String est une enveloppe pour le type de données primitives de la chaîne et contient les
méthodes et les propriétés permettant de manipuler les types de valeurs de chaîne primitives. Vous
pouvez convertir la valeur de n’importe quel objet en chaîne avec la fonction String().
Toutes les méthodes de la classe String, à l’exception de concat(), fromCharCode(), slice() et
substr(), sont génériques. Cela signifie que les méthodes appellent elles-mêmes
this.toString() avant d’effectuer leurs opérations et que vous pouvez utiliser ces méthodes
avec des objets autres que String.
Tous les index de chaîne étant basés sur zéro, l’index du dernier caractère de toute chaîne x est
x.length - 1.Classe String 643
Vous pouvez appeler n’importe quelle méthode de la classe String en utilisant la méthode
constructeur new String ou en utilisant une valeur de chaîne littérale. Si vous spécifiez une
chaîne littérale, l’interprète d’ActionScript la convertit automatiquement en objet String
temporaire, appelle la méthode puis supprime l’objet String temporaire. Vous pouvez également
utiliser la propriété String.length avec une chaîne littérale.
Ne confondez pas une chaîne littérale avec un objet String. Dans l’exemple suivant, la première
ligne de code crée la chaîne littérale s1 et la seconde ligne de code crée une occurrence de l’objet
String s2.
s1 = "machin"
s2 = new String("machin")
Utilisez des chaînes littérales, à moins que vous n’ayez spécifiquement besoin d’utiliser un objet
String.
Résumé des méthodes de la classe String
Résumé des propriétés de la classe String
Méthode Description
String.charAt Renvoie le caractère situé à un endroit spécifique dans une chaîne.
String.charCodeAt Renvoie la valeur du caractère situé à l’index donné sous la forme d’un
entier à 16 bits compris entre 0 et 65535.
String.concat() Combine le texte de deux chaînes et renvoie une nouvelle chaîne.
String.fromCharCode() Renvoie une chaîne constituée des caractères spécifiés dans les
paramètres.
String.indexOf Renvoie la position de la première occurrence d’une sous-chaîne spécifiée.
String.lastIndexOf Renvoie la position de la dernière occurrence d’une sous-chaîne spécifiée.
String.slice Extrait une section d’une chaîne et renvoie une nouvelle chaîne.
String.split Scinde un objet String en tableau de chaînes en séparant la chaîne en
sous-chaînes.
String.substr Renvoie un nombre spécifique de caractères dans une chaîne en
commençant à un endroit donné.
String.substring Renvoie les caractères entre deux index dans une chaîne.
String.toLowerCase Convertit la chaîne en minuscules et renvoie le résultat ; ne change pas le
contenu de l’objet d’origine.
String.toUpperCase Convertit la chaîne en majuscules et renvoie le résultat ; ne change pas le
contenu de l’objet d’origine.
Propriété Description
String.length Un entier différent de zéro indique le nombre de caractères dans l’objet
String spécifié.644 Chapitre 12 : Dictionnaire ActionScript Présentation
Constructeur pour la classe String
Disponibilité
Flash Player 5.
Usage
new String(valeur)
Paramètres
valeur La valeur initiale du nouvel objet String.
Renvoie
Rien.
Description
Constructeur : crée un nouvel objet String.
Consultez également
String, " " (délimiteur de chaîne)
String.charAt
Disponibilité
Flash Player 5.
Usage
ma_str.charAt(index)
Paramètres
index Un entier spécifiant la position d’un caractère dans la chaîne. Le premier caractère est
indiqué par 0 et le dernier caractère est indiqué par ma_str.length-1.
Renvoie
Un caractère.
Description
Méthode : renvoie le caractère à la position spécifiée par le paramètre index. Si index n’est pas un
nombre compris entre 0 et ma_str.length - 1, une chaîne vide est renvoyée.
Cette méthode est semblable à String.charCodeAt sauf que la valeur renvoyée est un caractère et
non un code de caractère entier à 16 bits.
Exemple
Dans l’exemple suivant, cette méthode est appelée sur la première lettre de la chaîne "Chris".
ma_str = new String("Chris");
i = ma_str.charCodeAt(0); // i = "C"String.concat() 645
String.charCodeAt
Disponibilité
Flash Player 5.
Usage
ma_str.charCodeAt(index)
Paramètres
index Un entier spécifiant la position d’un caractère dans la chaîne. Le premier caractère est
indiqué par 0 et le dernier caractère est indiqué par ma_str.length-1.
Renvoie
Un entier.
Description
Méthode : renvoie un entier de 16 bits, compris entre 0 et 65535, qui représente le caractère
spécifié par index. Si index n’est pas un nombre compris entre 0 et string.length - 1, NaN est
renvoyé.
Cette méthode est semblable à String.charAt sauf que la valeur renvoyée est un code de
caractère entier à 16 bits, pas un caractère.
Exemple
Dans l’exemple suivant, cette méthode est appelée sur la première lettre de la chaîne "Chris".
ma_str = new String("Chris");
i = ma_str.charCodeAt(0); // i = 67
String.concat()
Disponibilité
Flash Player 5.
Usage
ma_str.concat(valeur1,...valeurN)
Paramètres
valeur1,...valeurN Zéro ou plusieurs valeurs à concaténer.
Renvoie
Une chaîne.
Description
Méthode : combine la valeur de l’objet String aux paramètres et renvoie la nouvelle chaîne, la
valeur d’origine (ma_str) restant inchangée.646 Chapitre 12 : Dictionnaire ActionScript Présentation
String.fromCharCode()
Disponibilité
Flash Player 5.
Usage
String.fromCharCode(c1,c2,...cN)
Paramètres
c1,c2,...cN Entiers décimaux qui représentent des valeurs ASCII.
Renvoie
Une chaîne.
Description
Méthode : renvoie une chaîne constituée des caractères représentés par les valeurs ASCII des
paramètres.
Exemple
Cet exemple utilise la méthode fromCharCode() pour insérer un caractère « @ » dans l’adresse
électronique.
adresse = "chien" + String.fromCharCode(64) + "niche.net";
trace(adresse); // chien@niche.net
String.indexOf
Disponibilité
Flash Player 5.
Usage
ma_str.indexOf(sousChaîne, [indexDébut])
Paramètres
sousChaîne Un entier ou une chaîne spécifiant la sous-chaîne à rechercher dans ma_str.
indexDébut Un entier facultatif spécifiant le point de début dans ma_str à partir duquel
effectuer la recherche de la sous-chaîne.
Renvoie
La position de la première occurrence de la sous-chaîne spécifiée ou -1.
Description
Méthode : recherche la chaîne et renvoie la position de la première occurrence de sousChaîne
trouvée au niveau de ou après indexDébut dans la chaîne appelante. Si sousChaîne n’est pas
trouvée, la méthode renvoie -1.
Consultez également
String.lastIndexOfString.slice 647
String.lastIndexOf
Disponibilité
Flash Player 5.
Usage
ma_str.lastIndexOf(sousChaîne, [indexDébut])
Paramètres
sousChaîne Un entier ou une chaîne spécifiant la chaîne à rechercher.
indexDébut Un entier facultatif spécifiant le point de départ de la recherche de la sousChaîne.
Renvoie
La position de la dernière occurrence de la sous-chaîne spécifiée ou -1.
Description
Méthode : recherche la chaîne, de droite à gauche, et renvoie l’index de la dernière occurrence de
sousChaîne trouvée avant indexDébut dans la chaîne appelante. Si sousChaîne n’est pas
trouvée, la méthode renvoie -1.
Consultez également
String.indexOf
String.length
Disponibilité
Flash Player 5.
Usage
ma_str.length
Description
Propriété : un entier différent de zéro indiquant le nombre de caractères dans l’objet String
spécifié.
Tous les index de chaîne étant basés sur zéro, l’index du dernier caractère de toute chaîne x est
x.length - 1.
String.slice
Disponibilité
Flash Player 5.
Usage
ma_str.slice(début, [fin])
Paramètres
debut Un nombre spécifiant l’index du point de début de la section. Si début est un nombre
négatif, le point de début est déterminé à partir de la fin de la chaîne, -1 étant le dernier caractère.648 Chapitre 12 : Dictionnaire ActionScript Présentation
fin Un entier qui est égal à 1+ l’index du point de fin de la section. Le caractère indexé par le
paramètre fin n’est pas inclus dans la chaîne extraite. Si ce paramètre est omis, string.length
est utilisé. Si fin est un nombre négatif, le point de fin est déterminé en décomptant depuis la fin
de la chaîne, -1 étant le dernier caractère.
Renvoie
Une sous-chaîne de la chaîne spécifiée.
Description
Méthode : renvoie une chaîne qui inclut le caractère début et tous les caractères jusqu’au caractère
fin (qui est exclus). L’objet String d’origine n’est pas modifié. Si le paramètre fin n’est pas
spécifié, la fin de la sous-chaîne est la fin de la chaîne. Si la valeur de début est supérieure ou égale
à la valeur de fin, la méthode renvoie une chaîne vide.
Exemple
L’exemple suivant définit une variable, texte, crée une occurrence de l’objet String, ma_str et lui
transmet la variable texte. La méthode slice() extrait une section de la chaîne contenue dans la
variable et trace() l’envoie vers la fenêtre Sortie. L’exemple suivant illustre l’utilisation d’une
valeur positive et négative pour le paramètre fin.
texte = "Lexington";
ma_str = new String( texte );
trace(ma_str.slice( 1, 3 )); // "ex"
trace(ma_str.slice( 1, -6 )); // "ex"
Consultez également
String.substr, String.substring
String.split
Disponibilité
Flash Player 5.
Usage
ma_str.split("délimiteur", [limite])
Paramètres
délimiteur Le caractère ou la chaîne au niveau duquel ma_str est scindée.
limite Le nombre d’éléments à placer dans le tableau. Ce paramètre est facultatif.
Renvoie
Un tableau contenant les sous-chaînes de ma_str.
Description
Méthode : scinde un objet String en sous-chaînes à l’endroit où se trouve le paramètre
délimiteur et renvoie les sous-chaînes dans un tableau. Si vous utilisez une chaîne vide ("")
comme délimiteur, chaque caractère de la chaîne est placé en tant qu’élément dans le tableau,
comme dans le code suivant.
ma_str = "Joe";String.substring 649
i = ma_str.split("");
trace (i);
La fenêtre Sortie affiche le contenu suivant :
J, o, e
Si le paramètre delimiter est undefined, la chaîne tout entière est placée dans le premier
élément du tableau renvoyé.
Exemple
L’exemple suivant renvoie un tableau avec cinq éléments.
ma_str = "P, A, T, S, Y";
ma_str.split(",");
Cet exemple renvoie un tableau avec deux éléments, "P" et "A".
ma_str.split(",", 2);
String.substr
Disponibilité
Flash Player 5.
Usage
ma_str.substr(début, [longueur])
Paramètres
début Un entier indiquant la position du premier caractère de ma_str à utiliser lors de la
création de la sous-chaîne. Si début est un nombre négatif, la position de début est déterminée
depuis la fin de la chaîne, -1 étant le dernier caractère.
longueur Le nombre de caractères dans la sous-chaîne créée. Si longueur n’est pas spécifié, la
sous-chaîne inclut tous les caractères du début jusqu’à la fin de la chaîne.
Renvoie
Une sous-chaîne de la chaîne spécifiée.
Description
Méthode : renvoie les caractères d’une chaîne depuis l’index spécifié par le paramètre début
jusqu’au nombre de caractères spécifié dans le paramètre longueur. La méthode substr ne
modifie pas la chaîne spécifiée par ma_str ; elle renvoie une nouvelle chaîne.
String.substring
Disponibilité
Flash Player 5.
Usage
ma_str.substring(début, [fin])650 Chapitre 12 : Dictionnaire ActionScript Présentation
Paramètres
début Un entier indiquant la position du premier caractère de ma_str utilisé pour créer la sous-
chaîne. Les valeurs valides pour début sont comprises entre 0 et String.length - 1. Si début est
une valeur négative, 0 est utilisé.
fin Un entier étant égal à 1+ l’index du dernier caractère de ma_str devant être extrait. Les
valeurs valides pour fin sont comprises entre 1 et string.length. Le caractère indexé par le
paramètre fin n’est pas inclus dans la chaîne extraite. Si ce paramètre est omis, string.length
est utilisé. Si ce paramètre est une valeur négative, 0 est utilisé.
Renvoie
Une chaîne.
Description
Méthode : renvoie une chaîne constituée des caractères contenus entre les points spécifiés par les
paramètres début et fin. Si le paramètre fin n’est pas spécifié, la fin de la sous-chaîne est la fin de
la chaîne. Si la valeur de début est égale à la valeur de fin, la méthode renvoie une chaîne vide. Si
la valeur de début est supérieure à la valeur de fin, les paramètres sont automatiquement
permutés avant l’exécution de la fonction et la valeur d’origine reste inchangée.
String.toLowerCase
Disponibilité
Flash Player 5.
Usage
ma_str.toLowerCase()
Paramètres
Aucun.
Renvoie
Une chaîne.
Description
Méthode : renvoie une copie de l’objet String, les caractères majuscules étant convertis en
minuscules. La valeur d’origine reste inchangée.
String.toUpperCase
Disponibilité
Flash Player 5.
Usage
ma_str.toUpperCase()
Paramètres
Aucun.String 651
Renvoie
Une chaîne.
Description
Méthode : renvoie une copie de l’objet String, les caractères minuscules étant convertis en
majuscules. La valeur d’origine reste inchangée.
String
Disponibilité
Flash Player 4 ; comportement modifié dans Flash Player 7.
Usage
String(expression)
Paramètres
expression Une expression à convertir en chaîne.
Renvoie
Une chaîne.
Description
Fonction : renvoie une représentation chaîne du paramètre spécifié, comme suit :
Si expression est un nombre, la chaîne renvoyée est une représentation texte du nombre.
Si expression est une chaîne, la chaîne renvoyée est expression.
Si expression est un objet, la valeur renvoyée est la représentation sous forme de chaîne de
l’objet, générée par l’appel de la propriété String de l’objet ou par l’appel de Object.toString()
si une telle propriété n’existe pas.
Si expression est undefined, les valeurs renvoyées sont les suivantes :
• Dans les fichiers publiés pour Flash Player 6 ou une version antérieure, le résultat est une
chaîne vide ("").
• Dans les fichiers publiés pour Flash Player 7 ou une version ultérieure, le résultat est
undefined.
Si expression est une valeur booléenne, la chaîne renvoyée "true" ou "false".
Si expression est un clip, la valeur renvoyée est le chemin cible du clip en notation à barre
oblique (/).
Remarque : La notation à barre oblique n’est pas supportée par ActionScript 2.0.
Consultez également
Number.toString(), Object.toString(), Classe String, " " (délimiteur de chaîne)652 Chapitre 12 : Dictionnaire ActionScript Présentation
substring
Disponibilité
Flash Player 4. Cette fonction est abandonnée et remplacée par String.substr.
Usage
substring("chaîne", index, nombre)
Paramètres
chaîne La chaîne à partir de laquelle s’effectue l’extraction de la nouvelle chaîne.
index Le numéro du premier caractère à extraire.
nombre Le nombre de caractères à inclure dans la chaîne extraite, en excluant le caractère
d’index.
Renvoie
Rien.
Description
Fonction de chaîne : extrait une portion d’une chaîne. Cette fonction est basée sur un, tandis que
les méthodes de l’objet String sont basées sur zéro.
Consultez également
String.substr
super
Disponibilité
Flash Player 6.
Usage
super.méthode([param1, ..., paramN])
super([param1, ..., paramN])
Paramètres
méthode  La méthode à invoquer dans la superclasse.
param1 Paramètres facultatifs transmis à la version superclasse de la méthode (syntaxe 1) ou à la
fonction constructeur de la superclasse (syntaxe 2).
Renvoie
Les deux formes invoquent une fonction. La fonction peut renvoyer n’importe quelle valeur.
Description
Opérateur : le premier style de syntaxe peut être utilisé dans le corps d’une méthode d’objet pour
invoquer la version superclasse d’une méthode, et peut en option transmettre des paramètres
(param1 ... paramN) à la méthode de superclasse. Ceci est utile pour créer des méthodes de sous-
classe qui ajoutent un comportement supplémentaire aux méthodes superclasse, mais qui
invoquent également les méthodes superclasse pour remplir leur comportement d’origine.switch 653
Le deuxième style de syntaxe peut être utilisé dans le corps d’une fonction constructeur pour
invoquer la version superclasse de la fonction constructeur, et peut en option lui transmettre des
paramètres. Ceci est utile pour créer une sous-classe qui effectue une initialisation supplémentaire,
mais qui invoque également le constructeur de superclasse pour effectuer une initialisation de
superclasse.
switch
Disponibilité
Flash Player 4.
Usage
switch (expression){
clauseDeCas:
[clauseParDéfaut:]
}
Paramètres
expression Toute expression.
clauseDeCas Un mot-clé case, suivi d’une expression, de deux points et d’un groupe
d’instructions à exécuter si l’expression correspond au paramètre expression avec une égalité
stricte (==.
clauseParDéfaut Un mot-clé default, suivi d’instructions à exécuter si aucune des
expressions de cas ne correspond au paramètre expression par égalité stricte (==.
Renvoie
Rien.
Description
Instruction : crée une structure de branchement pour des instructions ActionScript. Comme
l’action if, l’action switch teste une condition et exécute des instructions si la condition renvoie
une valeur de true.
Exemple
Dans l’exemple suivant, si le paramètre nombre est 1, l’action trace() qui suit case 1 est
exécutée ; si le paramètre nombre est 2, l’action trace() qui suit case 2 est exécutée, et ainsi de
suite. Si aucune expression case ne correspond au paramètre nombre, l’action trace() qui suit le
mot-clé default est exécutée.
switch (nombre) {
case 1:
trace ("case 1 est true");
break
case 2:
trace ("case 2 est true");
break
case 3:
trace ("case 3 est true");
break
default
trace ("aucun cas n’est true")
}654 Chapitre 12 : Dictionnaire ActionScript Présentation
Dans l’exemple suivant, il n’y a aucune rupture dans le premier groupe de cas ; donc, si le nombre
est 1, A et B sont tous deux envoyés à la fenêtre Sortie.
switch (nombre) {
case 1:
trace ("A");
case 2:
trace ("B");
break
default
trace ("D")
}
Consultez également
=== (égalité stricte), break, case, default,
Classe System
Disponibilité
Flash Player 6.
Description
Il s’agit d’une classe de haut niveau qui contient l’objet capabilities (consultez Objet
System.capabilities), l’objet de sécurité (consultez Objet System.security), ainsi que les méthodes,
propriétés et gestionnaires d’événement répertoriés ci-dessous.
Résumé des méthodes de la classe System
Résumé des propriétés de la classe System
Résumé des gestionnaires d’événement de la classe System
Méthode Description
System.setClipboard() Remplace le contenu du presse-papiers du système par une chaîne de
texte.
System.showSettings() Affiche un panneau Paramètres Flash Player.
Méthode Description
System.exactSettings Spécifie l’utilisation des règles de correspondance de superdomaines ou
de domaines exacts lors de l’accès aux paramètres locaux.
System.useCodepage Indique à Flash Player s’il doit utiliser Unicode ou la page de code
classique du système d’exploitation exécutant le lecteur pour interpréter
des fichiers texte externes.
Méthode Description
System.onStatus Fournit un super gestionnaire d’événement pour un certain nombre
d’objetsSystem.exactSettings 655
System.exactSettings
Disponibilité
Programmation : Flash MX 2004.
Lecture : De fichiers SWF publiés pour Flash Player 6 ou ultérieur, lus dans Flash Player 7 ou
ultérieur.
Usage
System.exactSettings
Description
Propriété : spécifie l’utilisation des règles de correspondance de superdomaines ou de domaines
exacts lors de l’accès aux paramètres locaux (par exemple, les autorisations d’accès aux caméras ou
aux microphones) ou aux données persistantes localement (objets partagés). La valeur par défaut
est true pour les fichiers publiés pour Flash Player 7 ou une version ultérieure et false pour les
fichiers publiés pour Flash Player 6.
Si cette valeur est définie sur true, les paramètres et les données d’un fichier SWF hébergé sur
ici.xyz.com sont stockés sur ici.xyz.com, les paramètres et les données d’un fichier SWF hébergé
sur la.xyz.com sont stockés sur la.xyz.com et ainsi de suite. Si cette valeur est définie sur false, les
paramètres et les données des fichiers SWF hébergés sur ici.xyz.com, la.xyz.com et xyz.com sont
partagés et sont tous stockés sur xyz.com.
Si une partie de vos fichiers définit cette propriété sur false et d’autres sur true, les fichiers SWF
dans différents sous-domaines peuvent partager des paramètres et des données. Par exemple, si
cette propriété est false dans un fichier SWF hébergé sur ici.xyz.com et true dans un fichier
SWF hébergé sur xyz.com, les deux fichiers utilisent les mêmes paramètres et données - c’est-à-
dire, ceux situés sur xyz.com. Si ce n’est pas le comportement que vous souhaitez, vérifiez que
vous définissez cette propriété dans chaque fichier pour représenter correctement l’emplacement
où les paramètres et les données doivent être stockés.
Si vous souhaitez modifier cette propriété à partir de sa valeur par défaut, émettez la commande
System.exactSettings = false dans la première image de votre document. Il est impossible
de changer la propriété après une activité nécessitant un accès aux paramètres locaux, par exemple
System.ShowSettings() ou SharedObject.getLocal().
Si vous utilisez loadMovie(), MovieClip.loadMovie ou MovieClipLoader.loadClip() pour
charger un fichier SWF dans un autre, tous les fichiers publiés pour Flash Player 7 partagent une
valeur unique pour System.exactSettings et tous les fichiers publiés pour Flash Player 6
partagent une valeur unique pour System.exactSettings. Par conséquent, si vous spécifiez une
valeur pour cette propriété dans un fichier publié pour une version particulière de Flash Player,
vous devez le faire dans tous les fichiers que vous envisagez de charger. Si vous chargez plusieurs
fichiers, le paramètre spécifié dans le dernier fichier chargé supplante tout paramètre
précédemment spécifié.
Pour plus d’informations sur l’implémentation de la correspondance des domaines dans Flash,
consultez Fonctions de sécurité de Flash Player, page 196.
Consultez également
SharedObject.getLocal(), System.showSettings()656 Chapitre 12 : Dictionnaire ActionScript Présentation
System.onStatus
Disponibilité
Flash Player 6.
Description
Gestionnaire d’événement : fournit un « super » gestionnaire d’événement pour un certain
nombre d’objets.
Les objets LocalConnection, NetStream et SharedObject fournissent un gestionnaire d’événement
onStatus qui utilise un objet d’information pour délivrer des informations, un état ou des
messages d’erreur. Pour répondre à ce gestionnaire d’événement, vous devez créer une fonction
pour traiter l’objet d’information et vous devez connaître le format et le contenu de l’objet
d’information renvoyé.
Outre les méthodes onStatus spécifiques fournies pour les objets répertoriés ci-dessus, Flash
propose également une « super » fonction appelée System.onStatus. Si onStatus est invoqué
pour un objet particulier avec une propriété level de "erreur" et qu’aucune fonction n’est
affectée pour lui répondre, Flash traite une fonction affectée à System.onStatus s’il en existe
une.
Remarque : Les classes Camera et Microphone ont aussi des gestionnaires onStatus, mais ne
transmettent pas des objets d’information avec une propriété level de "erreur". Par conséquent,
System.onStatus n’est pas appelé si vous ne spécifiez pas de fonction pour ces gestionnaires.
L’exemple suivant illustre la manière de créer des fonctions génériques et spécifiques pour traiter
les objets d’information envoyés par la méthode onStatus.
// Créez une fonction générique
System.onStatus = function(genericError)
{
// Votre script a plus de sens dans ce cas
trace("Une erreur s’est produite. Veuillez essayer de nouveau.");
}
// Créez une fonction pour l’objet NetStream
// Si l’objet NetStream renvoie un objet d’information différent
// de celui répertorié ci-dessous, avec une propriété level de "erreur",
// System.onStatus sera invoqué
videoStream_ns.onStatus = function(objetInfo) {
si (objetInfo.code == "NetStream.Play.StreamNotFound") {
trace("Fichier vidéo introuvable.");
}
}
Consultez également
Camera.onStatus, LocalConnection.onStatus, Microphone.onStatus,
NetStream.onStatus, SharedObject.onStatus
System.setClipboard()
Disponibilité
Programmation : Flash MX 2004.System.showSettings() 657
Lecture : De fichiers SWF publiés pour Flash Player 6 ou ultérieur, lus dans Flash Player 7 ou
ultérieur.
Usage
System.setClipboard(chaîne)
Paramètres
chaîne Une chaîne de caractères de texte ordinaire à placer sur le presse-papiers du système,
remplaçant son contenu actuel (s’il y en a un). Si vous affectez une chaîne littérale, par opposition
à une variable de type chaîne, mettez cette chaîne littérale entre guillemets.
Renvoie
Une valeur booléenne : true si le texte a été placé avec succès dans le presse-papiers, false dans
les autres cas.
Description
Méthode : remplace le contenu du presse-papiers du système par une chaîne de texte spécifique.
System.showSettings()
Disponibilité
Flash Player 6.
Usage
System.showSettings([panneau])
Paramètres
panneau Un nombre facultatif spécifiant le panneau Paramètres Flash Player à afficher,
conformément au tableau suivant :
Renvoie
Rien.
Description
Méthode : affiche le panneau Paramètres Flash Player spécifié permettant aux utilisateurs de
procéder aux actions suivantes :
• Autoriser ou refuser l’accès à la caméra et au microphone
Valeur transmise pour
panneau
Panneau de paramètres affiché
Aucun (paramètre omis) ou
valeur non supportée
N’importe quel panneau ouvert la dernière fois que l’utilisateur a
fermé le panneau Paramètres Flash Player
0Confidentialité
1 Stockage local
2Microphone
3Camera658 Chapitre 12 : Dictionnaire ActionScript Présentation
• Spécifier l’espace disponible sur le disque local pour les objets partagés
• Sélectionner une caméra et un microphone par défaut
• Spécifier les paramètres du microphone et de la fonction de suppression de l’écho
Par exemple, si votre application nécessite l’utilisation d’une caméra, vous pouvez dire à
l’utilisateur de sélectionner Autoriser dans le panneau Paramètres de confidentialité, pour ensuite
donner la commande System.showSettings(0). (Assurez-vous que la scène mesure au moins
215 x 138 pixels ; il s’agit de la taille minimale requise pour que Flash puisse afficher le panneau.)
Consultez également
Camera.get(), Microphone.get(), SharedObject.getLocal()
System.useCodepage
Disponibilité
Flash Player 6.
Usage
System.useCodepage