Disponibilité

Flash Player 6 (6.0.79.0).

Edition

Flash MX 2004.

Utilisation

createLabel(name, depth, text) 

Paramètres

name Chaîne du nom de l'occurrence.

depth Nombre indiquant la profondeur de la nouvelle occurrence.

text Texte de l'étiquette.

Valeur renvoyée

Un objet TextField.

Description

Méthode : crée un sous-objet TextField. Utilisée par la plupart des composants pour obtenir un objet de texte léger dans le composant tout en héritant des méthodes et des propriétés de dimension et de style du composant. Cette méthode est utilisée pour créer des composants.
Le TextField créé est identique à l'objet TextField créé en appelant la méthode MovieClip.createTextField(),, mais il possède en outre les propriétés et les méthodes héritées de l'objet UIObject parent.

Un objet TextField qui utilise UIObject.createLabel() pour exécuter une création dans un composant peut tirer parti des méthodes UIObject suivantes héritées pour définir le dimensionnement et les styles dans le contexte de l'objet UIObject parent :

• TextField.getPreferredHeight() : nombre
• TextField.getPreferredWidth() : nombre
• TextField.setStyle( styleName : valeur de type chaîne)
• TextField.setSize( width : nombre, height : nombre)
• TextField.setValue( texte : chaîne) :

  REMARQUE

  L'objet TextFields créé avec UIObject.createLabel() possède une propriété initiale TextField._visible définie sur false. Cette propriété permet d'éviter l'oscillation qui peut survenir lorsque le composant parent appelle la méthode UIObject.setSize(). La propriété TextField._visible est définie sur true lorsque la méthode UIObject.draw()est appelée après le redimensionnement des objets enfant du composant parent.

Pour plus d'informations, reportez-vous à Exemple simple de CellRenderer pour consulter l'exemple de fichier MultilineCell.as.

Exemple

L'exemple suivant crée une occurrence TextField appelée multiLineLabel dans la méthode UIComponent.createChildren() d'un composant :

public function createChildren():Void {
    var myTextField_txt:TextField = this.createLabel("multiLineLabel", 900, "Hello World");
    // Définition de l'attribut de style fontSize de l'objet TextField.
    myTextField_txt.setStyle("fontSize", 18);
    // Définition de la dimension initiale de l'objet TextField.
    myTextField_txt.setSize(myTextField_txt.getPreferredWidth(), myTextField_txt.getPreferredHeight());
    // Définition de l'emplacement initial de l'objet TextField au centre 
// de la scène.
    myTextField_txt._x = (Stage.width/2) - (myTextField_txt._width/2);
    myTextField_txt._y = (Stage.height/2) - (myTextField_txt._height/2);
}