Classe Label
Héritage MovieClip > Classe UIObject > Label
Nom de classe ActionScript mx.controls.Label
Lors de l'exécution, les propriétés de la classe Label permettent de spécifier du texte pour l'étiquette, d'indiquer si ce texte peut être converti au format HTML et de spécifier si l'étiquette sera automatiquement ajustée au texte.
La définition d'une propriété de la classe Label avec ActionScript annule le paramètre du même nom défini dans l'inspecteur Propriétés ou des composants.
Si vous accédez aux valeurs des propriétés du composant Label, vérifiez qu'il est totalement chargé avant d'accéder à la propriété souhaitée. Considérons l'exemple suivant :
var listenerObject:Object = new Object();
listenerObject.load = function(){
trace(label.width);
};
label.addEventListener("load", listenerObject);
Toutes les classes de composants ont une propriété version qui est une propriété de classe. Les propriétés de classe ne sont disponibles que dans la classe elle-même. La propriété version renvoie une chaîne qui indique la version du composant. Pour accéder à cette propriété, utilisez le code suivant :
trace(mx.controls.Label.version);
|
REMARQUE |
|
Le code trace(myLabelInstance.version); renvoie undefined. |
Méthodes de la classe Label
La classe Label ne présente pas de méthodes exclusives.
Méthodes héritées de la classe UIObject
Le tableau suivant énumère les méthodes de la classe Label héritées de la classe UIObject.
Pour appeler ces méthodes à partir de l'objet Label, utilisez le formulaire labelInstance.methodName.
|
Méthode |
Description |
|---|---|
|
Crée un objet dans la classe spécifiée. |
|
|
Crée un sous-objet dans un objet. |
|
|
Détruit une occurrence de composant. |
|
|
Appelle une fonction lorsque les paramètres ont été définis dans les inspecteurs des propriétés et des composants. |
|
|
Obtient la propriété de style de l'objet ou de la déclaration |
|
|
Marque l'objet de sorte qu'il soit redessiné dans le prochain intervalle d'image. |
|
|
Déplace l'objet à l'emplacement demandé. |
|
|
Force la validation de l'objet pour qu'il soit dessiné dans l'image actuelle. |
|
|
Redimensionne l'objet à la taille demandée. |
|
|
Définit une enveloppe dans l'objet. |
|
|
Définit la propriété de style sur l'objet ou la déclaration |
Propriétés de la classe Label
Le tableau suivant présente les propriétés de la classe Label.
|
Propriété |
Description |
|---|---|
|
Chaîne qui indique la manière dont une étiquette doit être dimensionnée et alignée pour s'adapter à la valeur de sa propriété text. Quatre valeurs sont possibles : "none", "left", "center" et "right". La valeur par défaut est "none". |
|
|
Valeur booléenne qui indique si une étiquette peut être mise au format HTML (true) ou non (false). |
|
|
Texte de l'étiquette. |
Propriétés héritées de la classe UIObject
Le tableau suivant énumère les propriétés de la classe Label héritées de la classe UIObject. Pour accéder à ces propriétés, utilisez le formulaire labelInstance.propertyName.
|
Propriété |
Description |
|---|---|
|
Position du bord inférieur de l'objet par rapport au bord inférieur de son parent. Lecture seule. |
|
|
Hauteur de l'objet, en pixels. Lecture seule. |
|
|
Bord gauche de l'objet, en pixels. Lecture seule. |
|
|
Position du bord droit de l'objet par rapport au bord droit de son parent. Lecture seule. |
|
|
Nombre indiquant le facteur de redimensionnement dans la direction x de l'objet par rapport à son parent. |
|
|
Nombre indiquant le facteur de redimensionnement dans la direction y de l'objet par rapport à son parent. |
|
|
Position du bord supérieur de l'objet par rapport à son parent. Lecture seule. |
|
|
Valeur booléenne indiquant si l'objet est visible (true) ou non (false). |
|
|
Largeur de l'objet, en pixels. Lecture seule. |
|
|
Bord gauche de l'objet, en pixels. Lecture seule. |
|
|
Bord supérieur de l'objet, en pixels. Lecture seule. |
Evénements de la classe Label
La classe Label ne présente pas d'événement exclusif.
Evénements hérités de la classe UIObject
Le tableau suivant énumère les événements de la classe Label hérités de la classe UIObject.
|
Evénement |
Description |
|---|---|
|
Diffusé lorsqu'un objet est sur le point de dessiner ses graphiques. |
|
|
Diffusé lorsqu'un objet passe de l'état visible à l'état invisible. |
|
|
Diffusé lorsque des sous-objets sont créés. |
|
|
Diffusé lorsque l'objet a été déplacé. |
|
|
Diffusé lorsqu'un objet a été redimensionné. |
|
|
Diffusé lorsqu'un objet passe de l'état invisible à l'état visible. |
|
|
Diffusé lorsque les sous-objets sont purgés. |