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 

StyleProxy  - AS3 Flex

Packagemx.styles
Classepublic class StyleProxy
HéritageStyleProxy Inheritance Object
Implémente IAdvancedStyleClient

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

Enveloppe un objet qui implémente l’interface IAdvancedStyleClient. Cette interface prend en charge une propriété filterMap qui contient les paires style-source/style- destination.

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
  className : String
[lecture seule] Nom de la classe du composant.
StyleProxy
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  filterMap : Object
Jeu de paires de chaînes.
StyleProxy
  id : String
[lecture seule] Identité du composant.
StyleProxy
  inheritingStyles : Object
Objet contenant les styles héritables pour ce composant.
StyleProxy
  nonInheritingStyles : Object
Objet contenant les styles non héritables pour ce composant.
StyleProxy
  source : IStyleClient
Objet qui implémente l’interface IStyleClient.
StyleProxy
  styleDeclaration : CSSStyleDeclaration
Déclaration de style contenant les styles en ligne déclarés par cet objet.
StyleProxy
  styleName : Object
Source des valeurs de style de cet objet.
StyleProxy
  styleParent : IAdvancedStyleClient
Le parent de cette interface IAdvancedStyleClient.
StyleProxy
Méthodes publiques
 MéthodeDéfini par
  
StyleProxy(source:IStyleClient, filterMap:Object)
Constructeur.
StyleProxy
  
Supprime une propriété de style de cette instance de composant.
StyleProxy
  
Renvoie un tableau d’objets CSSStyleDeclaration pour le sélecteur de type qui s’applique à ce composant. Renvoie la valeur null si aucun n’existe.
StyleProxy
  
getStyle(styleProp:String):*
Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant.
StyleProxy
  
Renvoie true si la valeur currentCSSState n’est pas nulle.
StyleProxy
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
  
Renvoie la valeur true si cssState correspond à currentCSSState.
StyleProxy
  
Détermine si l’instance est identique au, ou est une sous-classe du, type donné.
StyleProxy
  
Propage les changements de style aux enfants de ce composant.
StyleProxy
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
Configure les valeurs de cache du style interne afin que la méthode getStyle() fonctionne.
StyleProxy
  
Enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement pour chaque événement d’effet.
StyleProxy
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
setStyle(styleProp:String, newValue:*):void
Définit une propriété de style pour cette instance de composant.
StyleProxy
  
Appelé lorsque la valeur d’une propriété de style change.
StyleProxy
  
Flex() appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisés.
StyleProxy
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la propriété

className

propriété
className:String  [lecture seule]

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

Nom de la classe du composant.



Implémentation
    public function get className():String

filterMap

propriété 
filterMap:Object

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

Jeu de paires de chaînes. Le premier élément de la paire de chaînes est le nom du style du composant source. Le deuxième élément de la paire de chaînes est le nom du style du sous-composant. Cet objet vous permet de mapper un style particulier du composant parent à un autre style du sous-composant. Cette fonction est utile si le composant parent et le sous-composant partagent le même style, mais que vous souhaitez contrôler leurs valeurs séparément.



Implémentation
    public function get filterMap():Object
    public function set filterMap(value:Object):void

id

propriété 
id:String  [lecture seule]

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

Identité du composant.



Implémentation
    public function get id():String

inheritingStyles

propriété 
inheritingStyles:Object

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

Objet contenant les styles héritables pour ce composant.



Implémentation
    public function get inheritingStyles():Object
    public function set inheritingStyles(value:Object):void

nonInheritingStyles

propriété 
nonInheritingStyles:Object

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

Objet contenant les styles non héritables pour ce composant.



Implémentation
    public function get nonInheritingStyles():Object
    public function set nonInheritingStyles(value:Object):void

source

propriété 
source:IStyleClient

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

Objet qui implémente l’interface IStyleClient. Il s’agit de l’objet dont la mise en proxy est en cours.



Implémentation
    public function get source():IStyleClient
    public function set source(value:IStyleClient):void

styleDeclaration

propriété 
styleDeclaration:CSSStyleDeclaration

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

Déclaration de style contenant les styles en ligne déclarée par cet objet.



Implémentation
    public function get styleDeclaration():CSSStyleDeclaration
    public function set styleDeclaration(value:CSSStyleDeclaration):void

styleName

propriété 
styleName:Object

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

Source des valeurs de style de cet objet. La valeur de la propriété styleName peut être de l’un des trois types suivants :

  • Objet String, tel que « headerStyle ». L’objet String nomme un sélecteur de classe défini dans une feuille de style CSS.
  • Objet CSSStyleDeclaration, tel que StyleManager.getStyleDeclaration(".headerStyle").
  • UIComponent. L’objet qui implémente cette interface hérite de toutes les valeurs de style du composant UIComponent référencé.



Implémentation
    public function get styleName():Object
    public function set styleName(value:Object):void

styleParent

propriété 
styleParent:IAdvancedStyleClient

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

Le parent de cette interface IAdvancedStyleClient. Vous ne devez généralement pas attribuer cette propriété directement. Elle est définie par les méthodes addChild, addChildAt, removeChild et removeChildAt de la classe flash.display.DisplayObjectContainer et les méthodes mx.core.UIComponent.addStyleClient() et mx.core.UIComponent.removeStyleClient(). Si elle se voit attribuer une valeur directement, sans appeler l’une des méthodes mentionnées ci-dessus, l’instance de la classe qui implémente cette interface n’héritera pas les styles à partir de l’objet UIComponent ou DisplayObject. De plus, si elle se voit attribuer une valeur directement sans supprimer auparavant l’objet du parent actuel avec les méthodes de suppression répertoriées ci-dessus, une fuite de mémoire peut se produire.



Implémentation
    public function get styleParent():IAdvancedStyleClient
    public function set styleParent(value:IAdvancedStyleClient):void
Détails du constructeur

StyleProxy

()Constructeur
public function StyleProxy(source:IStyleClient, filterMap:Object)

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

Constructeur.

Paramètres
source:IStyleClient — Objet qui implémente l’interface IStyleClient.
 
filterMap:Object — Jeu de styles à transmettre de la source au sous-composant.
Détails de la méthode

clearStyle

()méthode
public function clearStyle(styleProp: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

Supprime une propriété de style de cette instance de composant.

La méthode getStyle() ne renvoie pas nécessairement la valeur undefined.

Paramètres

styleProp:String — Nom de la propriété de style.

getClassStyleDeclarations

()méthode 
public function getClassStyleDeclarations():Array

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

Renvoie un tableau d’objets CSSStyleDeclaration pour le sélecteur de type qui s’applique à ce composant. Renvoie la valeur null si aucun n’existe.

Par exemple, supposons que le composant MyButton étende le contrôle Button. Cette méthode recherche d’abord un sélecteur MyButton. Ensuite, elle recherche un sélecteur de type Button. Enfin, elle recherche un sélecteur de type UIComponent.

Valeur renvoyée
Array — Tableau d’objets CSSStyleDeclaration.

getStyle

()méthode 
public function getStyle(styleProp:String):*

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

Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant.

Cette méthode est utilisée pour obtenir tout type de propriété de style et la valeur renvoyée peut être une valeur booléenne, String, Number, int, uint (pour une couleur RVB), classe (pour un habillage) ou tout type d’objet. Par conséquent, le type renvoyé est spécifié sous la forme *.

Si vous obtenez une propriété de style particulière, vous connaitrez son type et souhaiterez souvent stocker le résultat dans une variable de ce type. Pour ce faire, vous pouvez utiliser l’opérateur as ou la coercition. Par exemple :

      var backgroundColor:uint = getStyle("backgroundColor") as int;
      
      or
      
      var backgroundColor:uint = int(getStyle("backgroundColor"));
      

Si la propriété de style n’a pas été définie dans la chaîne de recherche de style, la valeur renvoyée par la méthode getStyle() est undefined Notez que undefined est une valeur spéciale qui ne correspond pas à false, l’objet String vide (""), NaN, 0 ou null. Aucune valeur de style valide n’est jamais undefined. Vous pouvez utiliser la méthode statique StyleManager.isValidStyleValue() pour vérifier si la valeur a été définie.

Paramètres

styleProp:String — Nom de la propriété de style.

Valeur renvoyée
* — Valeur du style.

hasCSSState

()méthode 
public function hasCSSState():Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 4.6
Versions du moteur d’exécution: Flash Player 10, AIR 2.5

Renvoie true si la valeur currentCSSState n’est pas égale à null. Vous ne devez généralement pas appeler cette méthode directement. Elle est appelée par la méthode mx.styles.CSSCondition.matchesStyleClient().

Notez que les composants Spark utilisent leur état d’habillage comme pseudo état. Les composants Halo utilisent la propriété currentState.

Valeur renvoyée
Boolean — Renvoie true si la valeur currentCSSState n’est pas égale à null. Par défaut, currentCSSState est identique à currentState. En l’absence d’état, elle renvoie la valeur false.

matchesCSSState

()méthode 
public function matchesCSSState(cssState:String):Boolean

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

Renvoie true si cssState correspond à currentCSSState. Vous ne devez généralement pas appeler cette méthode directement. Elle est appelée par la méthode mx.styles.CSSCondition.matchesStyleClient().

Notez que les composants Spark utilisent leur état d’habillage comme pseudo état. Les composants Halo utilisent la propriété currentState.

Paramètres

cssState:String — Une valeur possible de CSSCondition.value. Elle représente l’état actuel de ce composant utilisé pour faire correspondre les pseudo-sélecteurs CSS.

Valeur renvoyée
Booleantrue si cssState correspond à currentCSSState. Par défaut, currentCSSState est identique à currentState. En l’absence d’état, elle renvoie la valeur null.

matchesCSSType

()méthode 
public function matchesCSSType(cssType:String):Boolean

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

Détermine si l’instance est identique au, ou est une sous-classe du, type donné. Vous ne devez généralement pas appeler cette méthode directement. Elle est appelée par la méthode mx.styles.CSSCondition.matchesStyleClient().

Paramètres

cssType:String — Objet CSSSelector.

Valeur renvoyée
Booleantrue si cssType est dans la hiérarchie des sélecteurs de types qualifiés.

notifyStyleChangeInChildren

()méthode 
public function notifyStyleChangeInChildren(styleProp:String, recursive: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

Propage les changements de style aux enfants de ce composant.

Paramètres

styleProp:String — Nom de la propriété de style.
 
recursive:Boolean — Indique si les changements de style doivent être propagés aux enfants des enfants.

regenerateStyleCache

()méthode 
public function regenerateStyleCache(recursive: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

Configure les valeurs de cache du style interne afin que la méthode getStyle() fonctionne. Si cet objet possède déjà des enfants, réinitialisez les caches de style des enfants.

Paramètres

recursive:Boolean — Régénère les chaînes proto des enfants.

registerEffects

()méthode 
public function registerEffects(effects: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

Enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement pour chaque événement d’effet.

Paramètres

effects:Array — Tableau de chaînes de noms d’effets.

setStyle

()méthode 
public function setStyle(styleProp:String, newValue:*):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 une propriété de style pour cette instance de composant.

Ce peut remplacer un style défini globalement.

L’appel de la méthode setStyle() peut entraîner une baisse des performances. Utilisez-la uniquement lorsque cela est nécessaire.

Paramètres

styleProp:String — Nom de la propriété de style.
 
newValue:* — Nouvelle valeur du style.

styleChanged

()méthode 
public function styleChanged(styleProp: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

Appelé lorsque la valeur d’une propriété de style change.

Paramètres

styleProp:String — Nom de la propriété de style qui a changé.

stylesInitialized

()méthode 
public function stylesInitialized():void

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

Flex appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisé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.