public createTextField(instanceName:String, depth:Number, x:Number, y:Number, width:Number, height:Number) : TextField

Crée un nouveau champ de texte vide en tant qu’enfant du clip pour lequel vous avez appelé cette méthode. Vous pouvez utiliser la méthode createTextField() pour créer des champs de texte lors de la lecture d’un fichier SWF. Le paramètre depth détermine le niveau de profondeur (la position de l’ordre z) du nouveau champ de texte dans le clip. Chaque niveau de profondeur peut contenir uniquement un objet. Si vous créez un nouveau champ de texte sur une profondeur disposant déjà d’un champ de texte, le nouveau champ de texte remplace le champ de texte existant. Pour éviter d’écraser des champs de texte existants, utilisez la méthode MovieClip.getInstanceAtDepth() afin de déterminer si une profondeur spécifique est déjà occupée, ou la méthode MovieClip.getNextHighestDepth() afin de déterminer la profondeur inoccupée la plus élevée. Le champ de texte est positionné aux coordonnées (x, y) en adoptant les dimensions définies par les paramètres width x height. Les paramètres x et y sont calculés par rapport au conteneur du clip ; ces paramètres correspondent aux propriétés _x et _y du champ de texte. Les paramètres width et height correspondent aux propriétés _width et _height du champ de texte.

Les propriétés par défaut d’un champ de texte sont les suivantes :

type = "dynamic"
border = false
background = false
password = false
multiline = false
html = false
embedFonts = false
selectable = true
wordWrap = false
mouseWheelEnabled = true
condenseWhite = false
restrict = null
variable = null
maxChars = null
styleSheet = undefined
tabInded = undefined

Un champ de texte créé avec createTextField() reçoit les paramètres d’objet TextFormat par défaut suivants :

font = "Times New Roman" // "Times" on Mac OS
size = 12
color = 0x000000
bold = false
italic = false
underline = false
url = ""
target = ""
align = "left"
leftMargin = 0
rightMargin = 0
indent = 0
leading = 0
blockIndent = 0
bullet = false
display = block
tabStops = [] // (empty array)

Vous pouvez étendre les méthodes et les gestionnaires d’événements de la classe MovieClip en créant une sous-classe.

Disponibilité : ActionScript 1.0 ; Flash Player 6

instanceName:String - Chaîne qui identifie le nom d’occurrence du nouveau champ de texte.

depth:Number - Entier positif qui spécifie la profondeur du nouveau champ de texte.

x:Number - Entier qui spécifie la coordonnée x du nouveau champ de texte.

y:Number - Entier qui spécifie la coordonnée y du nouveau champ de texte.

width:Number - Entier positif qui spécifie la largeur du nouveau champ de texte.

height:Number - Entier positif qui spécifie la hauteur du nouveau champ de texte.

TextField - Flash Player 8 renvoie une référence à l’objet TextField créé. Les versions antérieures à Flash Player 8 renvoient void.

L’exemple suivant crée un champ de texte d’une largeur de 300, d’une hauteur de 100, une coordonnée x de 100, une coordonnée y de 100, pas de bordure, texte en rouge et souligné :

this.createTextField("my_txt", 1, 100, 100, 300, 100);
my_txt.multiline = true;
my_txt.wordWrap = true;
var my_fmt:TextFormat = new TextFormat();
my_fmt.color = 0xFF0000;
my_fmt.underline = true;
my_txt.text = "This is my first test field object text.";
my_txt.setTextFormat(my_fmt);

Vous trouverez également un exemple dans le fichier animation.fla du dossier Samples\ActionScriptAnimation. La liste suivante présente les chemins type vers ce dossier :

• Windows : \Program Files\Macromedia\Flash 8\Samples et Tutorials\Samples\
• Macintosh : HD/Applications/Macromedia Flash 8/Samples et Tutorials/Samples/

getInstanceAtDepth (méthode MovieClip.getInstanceAtDepth), getNextHighestDepth (méthode MovieClip.getNextHighestDepth), TextFormat