createTextField (méthode MovieClip.createTextField)

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

Crée un nouveau champ 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 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 texte dans le clip. Chaque niveau de profondeur peut contenir uniquement un objet. Si vous créez un nouveau champ texte sur une profondeur disposant déjà d'un champ texte, le nouveau champ texte remplace le champ texte existant. Pour éviter d'écraser des champs texte existants, utilisez MovieClip.getInstanceAtDepth() afin de déterminer si une profondeur spécifique est déjà occupée, ou MovieClip.getNextHighestDepth() afin de déterminer la profondeur inoccupée la plus élevée. Le champ 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 texte. Les paramètres width et height correspondent aux propriétés _width et _height du champ texte.

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 texte créé avec createTextField() reçoit les paramètres d'objet TextFormat par défaut suivants :

font = "Times New Roman" // "Times" sur 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 = [] // (tableau vide)

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

Paramètres

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

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

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

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

Valeur renvoyée

Exemple

L'exemple suivant crée un champ 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 animations.fla du dossier d'exemples d'ActionScript. La liste suivante présente les chemins type vers ce dossier :

createTextField (méthode MovieClip.createTextField)

Paramètres

Valeur renvoyée

Exemple

Voir aussi