Guide de reference du langage ActionScript 2.0 - PowWeb

Paramètres
start:Number - Entier qui indique la position du premier caractère à inclure dans la chaîne
renvoyée. 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 dans l'objet
TextSnapshot. 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é.
includeLineEndings:Boolean [facultatif] - Valeur booléenne qui spécifie si les caractères de
nouvelle ligne sont insérés (true) ou s'ils ne sont pas insérés (false) dans la chaîne renvoyée.
La valeur par défaut est false.
Valeur renvoyée
String - Chaîne contenant les caractères dans la plage spécifiée, ou une chaîne vide si aucun
caractère n'est détecté dans la plage spécifiée.
Exemple
L'exemple suivant illustre comment renvoyer le nombre de caractères dans un objet
TextSnapshot spécifié. Pour utiliser ce code, placez un champ de texte statique contenant le
texte « TextSnapshot Example » sur la Scène.
var my_mc:MovieClip = this;
var my_snap:TextSnapshot = my_mc.getTextSnapshot();
var count:Number = my_snap.getCount();
var theText:String = my_snap.getText(0, count, false);
trace(count); // 20
trace(theText); // TextSnapshot Example
Voir également
getCount (méthode TextSnapshot.getCount), getSelectedText (méthode
TextSnapshot.getSelectedText)
getTextRunInfo (méthode
TextSnapshot.getTextRunInfo)
public getTextRunInfo(beginIndex:Number, endIndex:Number) : Array
Renvoie un tableau d'objets contenant des informations sur un segment de texte. Chaque
objet correspond à un caractère dans la plage de caractères spécifiée par les deux paramètres de
méthode.
1302 Chapitre 2: Classes ActionScript