Apache Adobe Flex TutorialTutoriaux Adobe Flex & AIR en Français

Flex UIComponent – Instances et Propriétés génériques des UIComponent

Création d'instance de composant visuel

Vous pouvez créer des instances de composants visuels soir en MXML, soit en ActionScript. Si vous utilisez du MXML, vous devrez utiliser le tag qui a le même nom que le composant.
Par exemple, le code suivant créer une instance de Button:

<mx:Button />

Si vous voulez utiliser de l'ActionScript, vous devrez utiliser le constructeur du composant grâce à une instruction new. Le code suivant crée une instance de Button en ActionScript:

var button:Button = new Button();

Si vous créez un composant en utilisant de l'ActionScript, il ne sera pas automatiquement ajouté à la liste d'affichage (contrairement au MXML). Si vous voulez ajouter le composant à la liste d'affichage pour qu'il soit visible, vous devez utiliser la méthode addChild() d'un conteneur:

addChild(button);

Propriétés communes des composants visuels UI

Quand vous travaillez avec des composants visuels, vous pouvez être sur que certaines propriétés seront implémentées. Ces propriétés sont les suivantes:

• x (lecture/écriture): la coordonnée x d'un composant, relative à la position de son conteneur parent. Vous pouvez modifier cette propriété pour le déplacer
• y (lecture/écriture): la coordonnée y d'un composant, relative à la position de son conteneur parent. Vous pouvez modifier cette propriété pour le déplacer
• width (lecture/écriture): Largeur du composant

• height (lecture/écriture): Hauteur du composant

• scaleX (lecture/écriture): Mise à l'échelle du composant dans la direction horizontale, relative à sa largeur originale. Les propriétés scaleX et width sont liées. Quand vous modifiez scaleX, la largeur change aussi, mais pas l'inverse.
• scaleY (lecture/écriture): Mise à l'échelle du composant dans la direction verticale, relative à sa hauteur originale. Les propriétés scaleY et height sont liées. Quand vous modifiez scaleY, la hauteur change aussi, mais pas l'inverse.
• rotation (lecture/écriture): La rotation du composant en degré, relative à son orientation originale. La rotation de fait toujours dans le sens horaire, et est toujours relative au point d'origine du composant en interne. Dans la plupart des cas, l'origine d'un composant se trouve dans le coin haut gauche.
• alpha (lecture/écriture): L'opacité d'un composant. La valeur par défaut est 1, ce qui signifie que le composant est opaque. L'intervalle pour alpha va de 0 (transparent) à 1 (opaque).
• visible (lecture/écriture): La visibilité d'un composant. La valeur par défaut est true, ce qui veut dire que le composant est visible. Passez la propriété visible à false pour le cacher.
• enabled (lecture/écriture): L'interactivité d'un composant. Par exemple, si un bouton est enabled, il peut accepter les clics. La valeur par défaut est true. Une valeur false désactive le composant
• parent (lecture seulement): Une référence vers le conteneur parent du composant. Si vous voulez changer le parent d'un composant, vous devez utiliser la méthode removeChild() du container parent pour supprimer le composant ou utiliser addChild() pour ajouter le composant à un nouveau conteneur

Vous pouvez modifier ces propriétés à la fois en MXML et en ActionScript (sauf quand une valeur est en lecture seule, vous devrez alors utiliser de l'AS).
L'exemple suivant fixe plusieurs propriétés d'une instance de Button en utilisant du MXML:

<mx:Button id="button" label="Exemple" width="200" height="50" enabled="false"/>

Et voici l'équivalent en ActionScript:

var button:Button = new Button();
button.label = "Exemple";
button.width = 200;
button.height = 50;
button.enabled = false;
addChild(button);