Utilisation du composant Label

Le composant Label affiche une ligne unique de texte, généralement destinée à identifier un autre élément ou activité sur une page Web. Vous pouvez spécifier qu’une étiquette soit mise au format HTML pour pouvoir tirer parti de ses balises de formatage de texte. Vous pouvez également contrôler son alignement et sa taille. Les composants Label n’ont pas de bordures, ne peuvent pas recevoir le focus et ne diffusent pas d’événements.

L’aperçu en direct des occurrences de Label reflète les modifications apportées aux paramètres dans l’Inspecteur des propriétés ou de composants pendant la programmation. Le composant Label n’ayant pas de bordures, la définition de son paramètre de texte constitue le seul moyen de visualiser son aperçu en direct.

Interaction de l’utilisateur avec le composant Label

Un composant Label s’utilise pour créer une étiquette de texte pour un autre composant d’un formulaire, par exemple une étiquette « Nom » à gauche d’une zone TextInput destinée à contenir le nom d’un utilisateur. Il est préférable d’utiliser un composant Label au lieu d’une zone de texte ordinaire, car vous pouvez vous servir des styles pour maintenir une cohésion au niveau de la présentation.

Si vous voulez faire pivoter un composant Label, vous devez incorporer les polices, faute de quoi elles ne s’afficheront pas lors du test de l’animation.

Paramètres du composant Label

Dans l’Inspecteur des propriétés ou l’Inspecteur des composants, vous pouvez définir les paramètres de création suivants pour chaque occurrence du composant Label : autoSize , condenseWhite , selectable , text et wordWrap . A chacun de ces paramètres correspond une propriété ActionScript du même nom. Pour plus d’informations sur les valeurs gérées de ces paramètres, voir la classe Label dans le Guide de référence d’ActionScript 3.0 pour Flash Professional .

Création d’une application avec le composant Label

La procédure suivante décrit l’ajout d’un composant Label à une application au cours de la programmation. Dans cet exemple, l’étiquette affiche simplement le texte « Expiration Date ».

  1. Créez un document de fichier Flash (ActionScript 3.0).

  2. Faites glisser un composant Label du panneau Composants vers la scène et spécifiez les valeurs suivantes pour celui-ci dans l’Inspecteur des propriétés :

    • Entrez le nom d’occurrence aLabel .

    • Tapez 80 pour la valeur W.

    • Tapez 100 pour la valeur X.

    • Tapez 100 pour la valeur Y.

    • Entrez Expiration Date pour le paramètre text .

  3. Faites glisser un composant TextArea sur la scène et spécifiez les valeurs suivantes pour celui-ci dans l’Inspecteur des propriétés :

    • Entrez le nom d’occurrence aTa .

    • Tapez 22 pour la valeur H.

    • Tapez 200 pour la valeur X.

    • Tapez 100 pour la valeur Y.

  4. Ouvrez le panneau Actions, sélectionnez l’image 1 dans le scénario principal et entrez le code ActionScript suivant :

    var today:Date = new Date(); 
    var expDate:Date = addDays(today, 14); 
    aTa.text = expDate.toDateString(); 
     
    function addDays(date:Date, days:Number):Date { 
    return addHours(date, days*24); 
    } 
     
    function addHours(date:Date, hrs:Number):Date { 
    return addMinutes(date, hrs*60); 
    } 
     
    function addMinutes(date:Date, mins:Number):Date { 
    return addSeconds(date, mins*60); 
    } 
     
    function addSeconds(date:Date, secs:Number):Date { 
    var mSecs:Number = secs * 1000; 
    var sum:Number = mSecs + date.getTime(); 
    return new Date(sum); 
    }
  5. Choisissez Contrôle > Tester l’animation.

Création d’une occurrence du composant Label à l’aide d’ActionScript

L’exemple suivant crée un paramètre Label à l’aide d’ActionScript. Il emploie un composant Label pour identifier la fonction d’un composant ColorPicker, et utilise la propriété htmlText pour appliquer une mise en forme au texte du composant Label.

  1. Créez un document de fichier Flash (ActionScript 3.0).

  2. Faites glisser le composant Label du panneau Composants vers le panneau Bibliothèque du document en cours.

  3. Faites glisser le composant ColorPicker du panneau Composants vers le panneau Bibliothèque du document en cours.

  4. Ouvrez le panneau Actions, sélectionnez l’image 1 dans le scénario principal et entrez le code ActionScript suivant :

    import fl.controls.Label; 
    import fl.controls.ColorPicker; 
     
    var aLabel:Label = new Label(); 
    var aCp:ColorPicker = new ColorPicker(); 
     
    addChild(aLabel); 
    addChild(aCp); 
     
    aLabel.htmlText = '<font face="Arial" color="#FF0000" size="14">Fill:</font>'; 
    aLabel.x = 200; 
    aLabel.y = 150; 
    aLabel.width = 25; 
    aLabel.height = 22; 
     
    aCp.x = 230; 
    aCp.y = 150;
  5. Choisissez Contrôle > Tester l’animation.