Disponibilité

Flash Player 6 (6.0.79.0).

Edition

Flash MX 2004.

Utilisation

componentInstance.setStyle(propertyName, value)

Paramètres

propertyName Chaîne indiquant le nom de la propriété de style. Les styles pris en charge dépendent du composant. Chaque composant possède un ensemble de styles différent que vous pouvez définir. Par exemple, Personnalisation du composant TextArea affiche un tableau de styles, notamment fontWeight. Par conséquent, pour un composant TextArea, vous pouvez utiliser fontWeight comme paramètre propertyName.

value Valeur de la propriété. Si la valeur est une chaîne, elle doit être mise entre guillemets.

Valeur renvoyée

Aucune.

Description

Méthode : définit la propriété de style sur l'objet ou la déclaration de style. Si la propriété de style est un style d'héritage, les enfants de l'objet sont informés de la nouvelle valeur.

Pour obtenir la liste des styles pris en charge par chacun des composants, consultez leurs entrées respectives. Par exemple, les styles de composant Button sont répertoriés dans Utilisation de styles avec le composant Button.

Pour améliorer les performances, vous pouvez modifier les styles avant de les charger, de les calculer et de les appliquer aux objets du fichier SWF. Si vous modifiez les styles avant de les charger et de les calculer, l'appel à setStyle devient superflu.

Adobe vous conseille de définir des propriétés sur chaque objet, car les objets sont instanciés pour améliorer les performances lorsque vous utilisez des styles. Lorsque vous liez de façon dynamique des occurrences à la scène, définissez des propriétés dans le paramètre initObj dans l'appel que vous effectuez vers UIObject.createClassObject(), comme dans le code ActionScript suivant :

createClassObject(ComponentClass, "myInstance", 0, {styleName:"myStyle", color:0x99CCFF});

Exemple

Le code suivant définit la propriété de style fontWeight de l'occurrence de la case à cocher cb sur bold :

cb.setStyle("fontWeight", "bold");