Forums Développement Multimédia

Les formations Mediabox
Les formations Mediabox

Le contrôle Spark Label

Compatible Flex 4. Cliquer pour en savoir plus sur les compatibilités.Compatible ActionScript 3. Cliquer pour en savoir plus sur les compatibilités.Par tannoy (Antony Chauviré), le 07 avril 2010

Cet article est une traduction de l'aide Adobe Flex.

Adobe a donné son accord concernant la traduction de la documentation.

Introduction

Le contrôle Label affiche du texte non éditable. Il est le plus simple des contrôles de texte. Le contrôle Label a les caractéristiques suivantes:

  • L'utilisateur ne peut pas changer le texte, mais l'application le peut.
  • Vous pouvez contrôler l'alignement et la taille.
  • L'arrière-plan du contrôle est transparent, de sorte que le fond du conteneur de l'élément est visible à travers.
  • Le contrôle n'a pas de bordures, de sorte que le label apparaît comme un texte écrit directement sur son arrière-plan.
  • Le contrôle ne peut pas avoir le focus.
  • Le contrôle peut afficher plusieurs lignes.
  • Le contrôle ne peut pas être sélectionné.

Pour une information complète sur la référence du langage, regardez ActionScript 3.0 Reference for the Adobe Flash Platform.

Pour créer des champs de texte éditables, utilisez les contrôles TextInput et TextArea. Pour plus d'informations, regardez TextInput control et TextArea control.

Création d'un contrôle Label

Vous définissez un contrôle Label en MXML en utilisant la balise <s:Label>, comme le montre l'exemple suivant. Spécifiez une valeur à la propriété id si vous souhaitez utiliser votre contrôle ailleurs dans une balise MXML ou dans un bloc ActionScript.

<?xml version="1.0"?>
<!-- sparktextcontrols/SparkLabelControl.mxml -->
<s:Application 
    xmlns:fx="http://ns.adobe.com/mxml/2009"    
    xmlns:mx="library://ns.adobe.com/flex/mx"     
    xmlns:s="library://ns.adobe.com/flex/spark"
    width="150" height="80">
 
  <s:Label text="Label1"/>
 
</s:Application>

Le fichier SWF de l'exemple ci-dessus est affiché ci-dessous :

L"extension Adobe Flash Plugin est nécessaire pour afficher ce contenu.

Dimensionnement d'un contrôle Label

Si vous ne spécifiez pas de largeur, le contrôle Label s'adapte automatiquement quand vous changez la valeur de la propriété text.

Si vous dimensionnez explicitement un contrôle Label et qu'il n'est pas assez large pour accueillir son texte, le texte est tronqué et terminé par une ellipse (…). Le texte complet est affiché comme une info-bulle quand vous déplacez le pointeur de souris au dessus du contrôle Label. Si vous définissez également une bulle d'aide en utilisant la propriété tooltip, l'info-bulle s'affiche plutôt que le texte.