Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.styles 

IStyleManager  - AS3 Flex

Packagemx.styles
Interfacepublic interface IStyleManager

Version du langage: ActionScript 3.0
Version du produit: Flex 2.0.1
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

La classe IStyleManager gère les éléments suivants :
  • Les propriétés de style CSS dont la classe hérite
  • Les propriétés de style qui sont des couleurs et doivent donc bénéficier d’un traitement spécial
  • Une liste de chaînes qui sont les alias des valeurs de couleur
Cette interface était utilisée par Flex 2.0.1 et a été remplacée dans Flex 3 par IStyleManager2.

Eléments de l’API associés



Méthodes publiques
 MéthodeDéfini par
  
Efface l’objet CSSStyleDeclaration qui stocke les règles du sélecteur CSS spécifié.
IStyleManager
  
Renvoie la valeur de couleur RVB numérique qui correspond à la chaîne de couleurs spécifiée.
IStyleManager
  
Convertit le nom de couleur de chaque élément du tableau de couleurs en valeur colorimétrique RVB numérique.
IStyleManager
  
Récupère la déclaration CSSStyleDeclaration qui stocke les règles du sélecteur CSS spécifié.
IStyleManager
  
Vérifie si la chaîne donnée est un alias de valeur de couleur.
IStyleManager
  
Vérifie si un style hérite de valeurs.
IStyleManager
  
Vérifie si un style TextFormat hérite de valeurs.
IStyleManager
  
Vérifie si ce style affecte le conteneur parent du composant de façon à exiger que le conteneur parent se redessine lorsque ce style change.
IStyleManager
  
Vérifie si le style modifie la taille du conteneur parent du composant.
IStyleManager
  
Vérifie si un style modifie la taille d’un composant.
IStyleManager
  
Détermine si un paramètre spécifié est une propriété de style valide.
IStyleManager
  
loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
Charge un fichier SWF de style.
IStyleManager
  
registerColorName(colorName:String, colorValue:uint):void
Ajoute un nom de couleur à la liste des alias des couleurs.
IStyleManager
  
Effectue un ajout à la liste de styles qui peuvent hériter des valeurs de leurs parents.
IStyleManager
  
Effectue un ajout à la liste des styles, ce qui peut avoir une incidence sur l’aspect ou la présentation du conteneur parent du composant.
IStyleManager
  
Effectue un ajout à la liste des styles, ce qui peut avoir une incidence sur la taille mesurée du conteneur parent du composant.
IStyleManager
  
Effectue un ajout à la liste des styles, ce qui peut avoir une incidence sur la taille mesurée du composant.
IStyleManager
  
setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void
Définit l’objet CSSStyleDeclaration qui stocke les règles du sélecteur CSS spécifié.
IStyleManager
  
Décharge un fichier SWF de style.
IStyleManager
Détails de la méthode

clearStyleDeclaration

()méthode
public function clearStyleDeclaration(selector:String, update:Boolean):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Efface l’objet CSSStyleDeclaration qui stocke les règles du sélecteur CSS spécifié.

Si le sélecteur spécifié est un sélecteur de classe (par exemple, « .bigMargins » ou « .myStyle »), vous devez vérifier que la propriété selector commence par un point (.).

Si le sélecteur spécifié est un sélecteur de type (par exemple, « Button »), ne commencez pas la propriété selector par un point.

Le sélecteur global, similaire à un sélecteur de type, ne commence pas par un point.

Paramètres

selector:String — Nom du sélecteur CSS à effacer.
 
update:Boolean — Définissez la valeur sur true pour forcer une mise à jour immédiate des styles. Définissez sur false pour empêcher toute mise à jour immédiate des styles de l’application. Pour plus d’informations sur cette méthode, voir la description dans la méthode setStyleDeclaration().

Eléments de l’API associés

getColorName

()méthode 
public function getColorName(colorName:Object):uint

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Renvoie la valeur de couleur RVB numérique qui correspond à la chaîne de couleurs spécifiée. La chaîne de couleurs peut être un nom de couleur non sensible à la casse tel que "red", "Blue" ou "haloGreen", une valeur hexadécimale telle que 0xFF0000 ou une chaîne #-hexadécimale telle que "#FF0000".

Cette méthode renvoie une valeur uint, telles que 4521830, qui représente une couleur. Vous pouvez convertir cette valeur uint en valeur hexadécimale en transmettant la base numérique (dans ce cas, 16), à la méthode toString() de la classe uint, comme l’illustre l’exemple suivant :

      import mx.styles.StyleManager;
      private function getNewColorName():void {
          StyleManager.registerColorName("soylentGreen",0x44FF66);
          trace(StyleManager.getColorName("soylentGreen").toString(16));
      }
      

Paramètres

colorName:Object — Nom de la couleur.

Valeur renvoyée
uint — Renvoie une valeur uint qui représente la valeur de couleur ou NOT_A_COLOR si la valeur de la propriété colorName n’est pas un alias d’une couleur.

getColorNames

()méthode 
public function getColorNames(colors:Array):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Convertit le nom de couleur de chaque élément du tableau de couleurs en valeur colorimétrique RVB numérique. Chaque chaîne de couleurs peut être un nom de couleur non sensible à la casse tel que "red", "Blue" ou "haloGreen", une valeur hexadécimale telle que 0xFF0000 ou une chaîne #-hexadécimale telle que "#FF0000".

Paramètres

colors:Array — Tableau de noms de couleur.

getStyleDeclaration

()méthode 
public function getStyleDeclaration(selector:String):CSSStyleDeclaration

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Récupère la déclaration CSSStyleDeclaration qui stocke les règles du sélecteur CSS spécifié.

Si le paramètre selector commence par un point (.), la déclaration CSSStyleDeclaration renvoyée est un sélecteur de classe qui s’applique uniquement aux instances dont la propriété styleName spécifie ce sélecteur (qui n’inclue pas de point). Par exemple, le sélecteur de classe ".bigMargins" s’applique à tous les composants UIComponent dont le nom styleName is "bigMargins".

Si le paramètre selector ne commence pas par un point, la déclaration CSSStyleDeclaration renvoyée est un sélecteur de type qui s’applique à toutes les instances de ce type. Par exemple, le sélecteur de type "button" s’applique à toutes les instances de Button et ses sous-classes.

Le sélecteur global, similaire à un sélecteur de type, ne commence pas par un point.

Paramètres

selector:String — Nom du sélecteur CSS.

Valeur renvoyée
CSSStyleDeclaration — Déclaration de style dont le nom correspond à la propriété selector.

isColorName

()méthode 
public function isColorName(colorName:String):Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Vérifie si la chaîne est un alias de valeur de couleur. Par exemple, par défaut, la chaîne « bleu » est un alias de 0x0000FF.

Paramètres

colorName:String — Nom de la couleur à vérifier. Ce paramètre n’est pas sensible à la casse.

Valeur renvoyée
Boolean — Renvoie la valeur true si colorName est un alias de couleur.

isInheritingStyle

()méthode 
public function isInheritingStyle(styleName:String):Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Vérifie si un style hérite de valeurs.

Paramètres

styleName:String — Nom du style dont il faut vérifier l’héritage.

Valeur renvoyée
Boolean — Renvoie la valeur true si le style spécifié hérite.

isInheritingTextFormatStyle

()méthode 
public function isInheritingTextFormatStyle(styleName:String):Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Vérifie si un style TextFormat hérite de valeurs.

Paramètres

styleName:String — Nom du style dont il faut vérifier héritage.

Valeur renvoyée
Boolean — Renvoie la valeur true si le style TextFormat spécifié hérite.

isParentDisplayListInvalidatingStyle

()méthode 
public function isParentDisplayListInvalidatingStyle(styleName:String):Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Vérifie si ce style affecte le conteneur parent du composant de façon à exiger que le conteneur parent se redessine lorsque ce style est modifié.

Lorsqu’un de ces styles est défini avec setStyle(), la méthode invalidateDisplayList est appelée sur le composant de conteneur parent pour qu’il effectue à nouveau le dessin et/ou la présentation ses enfants.

Paramètres

styleName:String — Nom du style à vérifier.

Valeur renvoyée
Boolean — Renvoie true si le style spécifié est celui qui peut avoir une incidence sur l’aspect ou la présentation du composant du conteneur parent.

isParentSizeInvalidatingStyle

()méthode 
public function isParentSizeInvalidatingStyle(styleName:String):Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Vérifie si le style modifie la taille du conteneur parent du composant.

Lorsqu’un de ces styles est défini avec la méthode setStyle(), la méthode invalidateSize() est appelée automatiquement sur le conteneur parent du composant afin de recalculer ultérieurement sa taille mesurée.

Paramètres

styleName:String — Nom du style à vérifier.

Valeur renvoyée
Boolean — Renvoie la valeur true si le style spécifié est celui qui peut avoir une incidence sur la taille mesurée du composant du conteneur parent.

isSizeInvalidatingStyle

()méthode 
public function isSizeInvalidatingStyle(styleName:String):Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Vérifie si un style modifie la taille d’un composant.

Lorsqu’un de ces styles est défini avec la méthode setStyle(), la méthode invalidateSize() est appelée automatiquement sur le composant afin de recalculer ultérieurement sa taille mesurée.

Paramètres

styleName:String — Nom du style à vérifier.

Valeur renvoyée
Boolean — Renvoie la valeur true si le style spécifié est celui qui peut avoir une incidence sur la taille mesurée du composant.

isValidStyleValue

()méthode 
public function isValidStyleValue(value:*):Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Détermine si un paramètre spécifié est une propriété de style valide. Par exemple :

      trace(StyleManager.isValidStyleValue(myButton.getStyle("color")).toString());
      

Cela peut être utile car certains styles peuvent être définis sur des valeurs telles que 0, NaN, la chaîne vide ("") ou null, qui peuvent entraîner l’échec du test if (value).

Paramètres

value:* — Propriété de style à vérifier.

Valeur renvoyée
Boolean — Si vous transmettez la valeur renvoyée par un appel de la méthode getStyle() à cette méthode, elle renvoie true si le style a été défini et false dans le cas contraire.

loadStyleDeclarations

()méthode 
public function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Charge un fichier SWF de style.

Paramètres

url:String — Emplacement du fichier SWF de style.
 
update:Boolean (default = true) — Définissez la valeur sur true pour forcer une mise à jour immédiate des styles. Définissez sur false pour empêcher toute mise à jour immédiate des styles de l’application. Ce paramètre est facultatif et est défini par défaut sur true. Pour plus d’informations sur ce paramètre, voir la description dans la méthode setStyleDeclaration().
 
trustContent:Boolean (default = false) — Obsolète, n’est plus utilisé. Ce paramètre est facultatif et prend par défaut la valeur false.
 
applicationDomain:ApplicationDomain (default = null) — Classe ApplicationDomain transmise à la méthode load() de la classe IModuleInfo qui charge le fichier SWF de style. Ce paramètre est facultatif et prend par défaut la valeur null.
 
securityDomain:SecurityDomain (default = null) — Classe SecurityDomain transmise à la méthode load() de la classe IModuleInfo qui charge le fichier SWF de style. Ce paramètre est facultatif et prend par défaut la valeur null.

Valeur renvoyée
IEventDispatcher — Une implémentation IEventDispatcher qui prend en charge les événements StyleEvent.PROGRESS, StyleEvent.COMPLETE et StyleEvent.ERROR.

Eléments de l’API associés

registerColorName

()méthode 
public function registerColorName(colorName:String, colorValue:uint):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Ajoute un nom de couleur à la liste des alias des couleurs.

Paramètres

colorName:String — Nom de la couleur à ajouter à la liste ; par exemple, « blue ». Si vous accéder ultérieurement à ce nom de couleur, la valeur n’est pas sensible à la casse.
 
colorValue:uint — Valeur de la couleur, par exemple, 0x0000FF.

registerInheritingStyle

()méthode 
public function registerInheritingStyle(styleName:String):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Effectue un ajout à la liste de styles qui peuvent hériter des valeurs de leurs parents.

Remarque : veuillez éviter d’utiliser plusieurs fois les mêmes noms de style, car des conflits peuvent entraîner une baisse des performances si un style qui est déjà utilisé fait l’objet d’un héritage.

Paramètres

styleName:String — Nom du style ajouté à la liste des styles qui peuvent hériter des valeurs.

registerParentDisplayListInvalidatingStyle

()méthode 
public function registerParentDisplayListInvalidatingStyle(styleName:String):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Effectue un ajout à la liste des styles, ce qui peut avoir une incidence sur l’aspect ou la présentation du conteneur parent du composant. Lorsqu’un de ces styles est défini avec setStyle(), la méthode invalidateDisplayList est appelée sur le composant de conteneur parent pour qu’il effectue à nouveau le dessin et/ou la présentation ses enfants.

Paramètres

styleName:String — Nom du style à enregistrer.

registerParentSizeInvalidatingStyle

()méthode 
public function registerParentSizeInvalidatingStyle(styleName:String):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Effectue un ajout à la liste des styles, ce qui peut avoir une incidence sur la taille mesurée du conteneur parent du composant.

Lorsqu’un de ces styles est défini avec la méthode setStyle(), la méthode invalidateSize() est appelée automatiquement sur le conteneur parent du composant afin de recalculer ultérieurement sa taille mesurée.

Paramètres

styleName:String — Nom du style à enregistrer.

registerSizeInvalidatingStyle

()méthode 
public function registerSizeInvalidatingStyle(styleName:String):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Effectue un ajout à la liste des styles, ce qui peut avoir une incidence sur la taille mesurée du composant. Lorsqu’un de ces styles est défini avec la méthode setStyle(), la méthode invalidateSize() est appelée automatiquement sur le composant afin de recalculer ultérieurement sa taille mesurée.

Paramètres

styleName:String — Nom du style ajouté à la liste.

setStyleDeclaration

()méthode 
public function setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Définit l’objet CSSStyleDeclaration qui stocke les règles du sélecteur CSS spécifié.

Si le paramètre selector commence par un point (.), le sélecteur spécifié est un « sélecteur de classe » qui s’applique uniquement aux instances dont la propriété styleName spécifie ce sélecteur (qui n’inclue pas de point). Par exemple, le sélecteur de classe ".bigMargins" s’applique à tous les composants UIComponent dont le nom styleName is "bigMargins".

Si le paramètre selector ne commence pas par un point, le sélecteur spécifié est un « sélecteur de type » qui s’applique à toutes les instances de ce type. Par exemple, le sélecteur de type "button" s’applique à toutes les instances de Button et ses sous-classes.

Le sélecteur global, similaire à un sélecteur de type, ne commence pas par un point.

Paramètres

selector:String — Nom du sélecteur CSS.
 
styleDeclaration:CSSStyleDeclaration — Nouvelle déclaration de style.
 
update:Boolean — Définissez la valeur sur true pour forcer la mise à jour immédiate des styles ; en interne, Flex appelle la méthode styleChanged() du composant UIComponent. Définissez la valeur sur false pour empêcher toute mise à jour immédiate des styles de l’application.

Les styles sont mis à jour la prochaine fois où l’une des méthodes suivantes est appelée avec la propriété update définie sur true.

  • clearStyleDeclaration()
  • loadStyleDeclarations()
  • setStyleDeclaration()
  • unloadStyleDeclarations()

Généralement, si vous appelez l’une de ces méthodes plusieurs fois, définissez cette propriété sur true uniquement sur le dernier appel, de sorte que Flex n’appelle pas la méthode styleChanged() plusieurs fois.

Si vous appelez la méthode getStyle(), Flex renvoie la valeur de style qui a été appliquée à la classe UIComponent par un appel à la méthode styleChanged(). L’aspect du composant peut ne pas refléter la valeur renvoyée par la méthode getStyle(). Cela se produit car une de ces méthodes de déclaration de style peut ne pas avoir encore été appelée avec propriété updatedéfinie sur true.

unloadStyleDeclarations

()méthode 
public function unloadStyleDeclarations(url:String, update:Boolean = true):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Décharge un fichier SWF de style.

Paramètres

url:String — Emplacement du fichier SWF de style.
 
update:Boolean (default = true) — Définissez la valeur sur true pour forcer une mise à jour immédiate des styles. Définissez sur false pour empêcher toute mise à jour immédiate des styles de l’application. Pour plus d’informations sur cette méthode, voir la description dans la méthode setStyleDeclaration().

Eléments de l’API associés





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.