Guide de reference du langage ActionScript 2.0 - PowWeb

Voir également
setSelected (méthode TextSnapshot.setSelected)
setSelected (méthode TextSnapshot.setSelected)
public setSelected(start:Number, end:Number, select:Boolean) : Void
Spécifie une plage de caractères dans un objet TextSnapshot à sélectionner ou désélectionner.
Les caractères qui sont sélectionnés sont dessinés sur fond de rectangle coloré, correspondant
au cadre de délimitation du caractère. La couleur du cadre de délimitation est définie par
TextSnapshot.setSelectColor().
Pour sélectionner ou désélectionner tous les caractères, transmettez une valeur de 0 pour
start et TextSnapshot.getCount() (ou un grand nombre quelconque) pour end. Pour
spécifier un seul caractère, transmettez une valeur de start + 1 pour end.
Les caractères étant individuellement marqués comme sélectionnés, vous pouvez appeler cette
méthode plusieurs fois pour sélectionner plusieurs caractères ; c'est-à-dire, l'utilisation de cette
méthode ne désélectionne pas les autres caractères qui ont été définis par cette méthode.
Cette méthode fonctionne correctement uniquement avec les polices qui incluent des
informations métriques de caractères ; par défaut, Flash n'inclut pas ces informations pour les
champs de texte statique. Par conséquent, il se peut que du texte sélectionné n'apparaisse pas
pour être sélectionné à l'écran. Pour garantir que l'ensemble du texte sélectionné s'affiche
comme tel, vous pouvez forcer l'outil de programmation Flash à inclure les informations
métriques de caractères pour une police. A cet effet, 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.
Disponibilité : ActionScript 1.0 ; Flash Player 7
Paramètres
start:Number - Position du premier caractère à sélectionner. Les valeurs valides pour start
vont de 0 à TextSnapshot.getCount() - 1. Si start est une valeur négative, 0 est utilisé.
end:Number - Entier qui correspond à 1+ l'index du dernier caractère à examiner. Les valeurs
valides pour end vont de 0 à TextSnapshot.getCount(). Le caractère indexé par le
paramètre end n'est pas inclus dans la chaîne extraite. Si vous omettez ce paramètre,
TextSnapshot.getCount() est utilisé. Si la valeur de end est inférieure ou égale à la valeur
start, start + 1 est utilisé.
select:Boolean - Valeur booléenne indiquant si le texte doit être sélectionné (true) ou non
(false).
1308 Chapitre 2: Classes ActionScript