Guide de reference du langage ActionScript 2.0 - PowWeb

setSelectColor (méthode
TextSnapshot.setSelectColor)
public setSelectColor(color:Number) : Void
Spécifie la couleur à utiliser lors de la mise en surbrillance des caractères qui ont été
sélectionnés avec la méthode TextSnapshot.setSelected(). La couleur est toujours opaque
; vous ne pouvez pas spécifier de valeur de transparence.
Cette méthode fonctionne correctement uniquement pour les polices qui incluent des
informations métriques de caractères ; par défaut cependant, Macromedia Flash n'inclut pas
ces informations pour les champs de texte statique. Par conséquent, il se peut que la méthode
renvoie -1 au lieu d'une valeur d'indexation. Pour garantir qu'une valeur d'indexation est
renvoyée, vous pouvez forcer l'outil de programmation Flash à inclure les informations
métriques de caractères pour une police. Pour ce faire, ajoutez un champ de texte dynamique
qui utilise cette police, sélectionnez les options des caractères pour ce champ de texte
dynamique et spécifiez que les polices vectorielles doivent être intégrées pour au moins un
caractère. (Le choix des caractères spécifiés et la présence ou non des caractères utilisés dans les
champs de texte statique en question importent peu.)
Disponibilité : ActionScript 1.0 ; Flash Player 7
Paramètres
color:Number - Couleur du cadre entourant les caractères sélectionnés par la méthode
TextSnapshot.setSelected() exprimée au format 0xRRGGBB.
Exemple
L'exemple suivant illustre comment utiliser cette méthode. Pour utiliser ce code, placez un
champ de texte statique contenant le texte « TextSnapshot Example » sur la Scène. Incluez
dans la bibliothèque la police utilisée par le champ texte statique et dans options de Liaison
pour la police, sélectionnez Exporter pour ActionScript. Ajoutez le code ActionScript suivant
à l'image 1 du scénario :
var my_snap:TextSnapshot = this.getTextSnapshot();
var count:Number = my_snap.getCount();
my_snap.setSelectColor(0xFF0000);
my_snap.setSelected(0, 4, true);
my_snap.setSelected(1, 2, false);
var theText:String = my_snap.getSelectedText(false); // get the selected
text
trace(theText); // Text
Lorsque vous testez le fichier SWF, un rectangle de couleur entoure les caractères spécifiés.
TextSnapshot 1307