Package | mx.styles |
Classe | public class CSSStyleDeclaration |
Héritage | CSSStyleDeclaration EventDispatcher Object |
Sous-classes | AdvancedDataGridColumn, DataGridColumn |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Une règle CSS telle que
Button { color: #FF0000 }affecte toutes les instances de la classe Button ; un sélecteur comme
Button
, également dénommé sélecteur de type, ne doit pas commencer par un point.
Une règle CSS telle que
.redButton { color: #FF0000 }affecte uniquement les composants dont la propriété
styleName
est définie sur "redButton"
; un sélecteur comme .redButton
, dénommé sélecteur de classe, doit commencer par un point.
Vous pouvez accéder aux objets CSSStyleDeclaration autogénérés à l’aide de la méthode StyleManager.getStyleDeclaration()
, en transmettant un sélecteur de type
var buttonDeclaration:CSSStyleDeclaration = StyleManager.getStyleDeclaration("Button");ou un sélecteur de classe
var redButtonStyleDeclaration:CSSStyleDeclaration = StyleManager.getStyleDeclaration(".redButton");
Vous pouvez utiliser la méthode getStyle()
, setStyle()
et clearStyle
pour obtenir, définir et effacer les propriétés de style d’un objet CSSStyleDeclaration.
Vous pouvez également créer et installer un objet CSSStyleDeclaration lors de l’exécution à l’aide de la méthode StyleManager.setStyleDeclaration()
:
var newStyleDeclaration:CSSStyleDeclaration = new CSSStyleDeclaration(".bigMargins"); newStyleDeclaration.defaultFactory = function():void { leftMargin = 50; rightMargin = 50; } StyleManager.setStyleDeclaration(".bigMargins", newStyleDeclaration, true);
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
defaultFactory : Function
Cette fonction, si elle n’est pas null, est généralement générée automatiquement par le compilateur MXML. | CSSStyleDeclaration | ||
factory : Function
Cette fonction, si elle n’est pas null, est généralement générée automatiquement par le compilateur MXML. | CSSStyleDeclaration | ||
overrides : Object
Si la méthode setStyle() est appelée sur un composant UIComponent ou CSSStyleDeclaration lors de l’exécution, cet objet stocke les paires nom/valeur qui ont été définies ; elles remplacent les paires nom/valeur des objets produits par les méthodes spécifiées par les propriétés defaultFactory et factory. | CSSStyleDeclaration | ||
selector : CSSSelector
Cette propriété correspond au sélecteur de base d’une chaîne potentielle de sélecteurs et de conditions utilisés pour faire correspondre une déclaration de style CSS à des composants. | CSSStyleDeclaration | ||
selectorIndex : int = 0
L’ordre dans lequel cet objet CSSStyleDeclaration a été ajouté à son gestionnaire StyleManager. | CSSStyleDeclaration | ||
specificity : int [lecture seule]
Détermine l’ordre de priorité lors de l’application de plusieurs déclarations de style à un composant. | CSSStyleDeclaration | ||
subject : String [lecture seule]
Le sujet décrit le nom d’un composant pouvant être une correspondance potentielle pour cette déclaration de style. | CSSStyleDeclaration |
Méthode | Défini par | ||
---|---|---|---|
CSSStyleDeclaration(selector:Object = null, styleManager:IStyleManager2 = null, autoRegisterWithStyleManager:Boolean = true)
Constructeur. | CSSStyleDeclaration | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Supprime une propriété de style pour cet objet CSSStyleDeclaration. | CSSStyleDeclaration | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Récupère la valeur d’une propriété de style spécifiée, telle que déterminée uniquement par cet objet CSSStyleDeclaration. | CSSStyleDeclaration | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
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 | ||
Détermine si cette déclaration de style s’applique au composant donné en fonction d’une correspondance de la chaîne de sélecteur. | CSSStyleDeclaration | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Définit une propriété de style pour cet objet CSSStyleDeclaration. | CSSStyleDeclaration | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
defaultFactory | propriété |
defaultFactory:Function
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Cette fonction, si elle n’est pas null
, est généralement générée automatiquement par le compilateur MXML. Elle produit des copies d’un objet ordinaire, tel que { leftMargin: 10, rightMargin: 10 }
, contenant des paires nom/valeur pour les propriétés de style. L’objet est utilisé pour construire un nœud de la chaîne de prototype à des fins de recherche des propriétés de style.
Si cette déclaration CSSStyleDeclaration est administrée par un composant UIComponent écrit en MXML, cette fonction code les attributs de style qui ont été spécifiés dans la balise racine de la définition du composant.
Si le composant UIComponent a été écrit en code ActionScript, cette propriété est null
.
Implémentation
public function get defaultFactory():Function
public function set defaultFactory(value:Function):void
factory | propriété |
factory:Function
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Cette fonction, si elle n’est pas null
, est généralement générée automatiquement par le compilateur MXML. Elle produit des copies d’un objet ordinaire, tel que { leftMargin: 10, rightMargin: 10 }
, contenant des paires nom/valeur pour les propriétés de style. L’objet est utilisé pour construire un nœud de la chaîne de prototype à des fins de recherche des propriétés de style.
Si cette déclaration CSSStyleDeclaration est administrée par un composant UIComponent, cette fonction code les attributs de style qui ont été spécifiés en MXML pour une instance de ce composant.
Implémentation
public function get factory():Function
public function set factory(value:Function):void
overrides | propriété |
overrides:Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Si la méthode setStyle()
est appelée sur un composant UIComponent ou CSSStyleDeclaration lors de l’exécution, cet objet stocke les paires nom/valeur qui ont été définies ; elles remplacent les paires nom/valeur des objets produits par les méthodes spécifiées par les propriétés defaultFactory
et factory
.
Implémentation
public function get overrides():Object
public function set overrides(value:Object):void
selector | propriété |
selector:CSSSelector
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Cette propriété correspond au sélecteur de base d’une chaîne potentielle de sélecteurs et de conditions utilisés pour faire correspondre une déclaration de style CSS à des composants.
Implémentation
public function get selector():CSSSelector
public function set selector(value:CSSSelector):void
selectorIndex | propriété |
public var selectorIndex:int = 0
L’ordre dans lequel cet objet CSSStyleDeclaration a été ajouté à son gestionnaire StyleManager. MatchStyleDeclarations doit renvoyer les déclarations dans l’ordre dans lequel elles ont été effectuées.
specificity | propriété |
specificity:int
[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 |
Détermine l’ordre de priorité lors de l’application de plusieurs déclarations de style à un composant. Si les déclarations de style ont une priorité identique, la dernière est prioritaire.
Implémentation
public function get specificity():int
subject | propriété |
subject: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 |
Le sujet décrit le nom d’un composant pouvant être une correspondance potentielle pour cette déclaration de style. Le sujet est déterminé comme le sélecteur de type simple le plus à droite dans une chaîne de sélecteurs potentielle.
Implémentation
public function get subject():String
CSSStyleDeclaration | () | Constructeur |
public function CSSStyleDeclaration(selector:Object = null, styleManager:IStyleManager2 = null, autoRegisterWithStyleManager:Boolean = true)
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ètresselector:Object (default = null ) — - Si le sélecteur est de type CSSSelector, les sélecteurs CSS avancés sont pris en charge. Si une chaîne est utilisée pour le sélecteur, seuls sélecteurs CSS simples sont pris en charge. Si la chaîne commence par un point, elle est interprétée comme un sélecteur de classe universel. Dans le cas contraire, elle doit représenter un sélecteur de type simple. Si la valeur n’est pas null, cet objet CSSStyleDeclaration sera enregistré avec le gestionnaire StyleManager.
| |
styleManager:IStyleManager2 (default = null ) — - Le gestionnaire de style dans lequel définir cette déclaration. Si styleManager est null, le gestionnaire de style de niveau supérieur sera utilisé.
| |
autoRegisterWithStyleManager:Boolean (default = true ) — - Si la valeur est true, définissez le sélecteur dans styleManager. Le sélecteur est défini uniquement si selector et styleManager ne sont pas null.
|
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 pour cet objet CSSStyleDeclaration. Cette opération est identique à la définition de la valeur du style sur undefined
.
Paramètres
styleProp:String — Nom de la propriété de style.
|
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 |
Récupère la valeur d’une propriété de style spécifiée, telle que déterminée uniquement par cet objet CSSStyleDeclaration.
La valeur renvoyée peut être de n’importe quel type.
Les valeurs null
, ""
, false
, NaN
et 0
sont toutes des valeurs de style valides, mais la valeur undefined
ne l’est pas ; elle indique que le style spécifié n’est pas défini sur cette déclaration CSSStyleDeclaration. Vous pouvez utiliser la méthode StyleManager.isValidStyleValue()
pour tester la valeur renvoyée.
Paramètres
styleProp:String — Nom de la propriété de style.
|
* — Valeur de la propriété de style si cette dernière est définie ou undefined dans le cas contraire.
|
matchesStyleClient | () | méthode |
public function matchesStyleClient(object:IAdvancedStyleClient):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 cette déclaration de style s’applique au composant donné en fonction d’une correspondance de la chaîne de sélecteur.
Paramètres
object:IAdvancedStyleClient — Composant devant correspondre à la déclaration de style.
|
Boolean — La valeur est true si cette déclaration de style s’applique au composant, false dans le cas contraire.
|
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 cet objet CSSStyleDeclaration.
Paramètres
styleProp:String — Nom de la propriété de style.
| |
newValue:* — Valeur de la propriété de style. La valeur renvoyée peut être de n’importe quel type. Les valeurs null , "" , false , NaN et 0 sont toutes des valeurs de style valides, ce qui n’est pas le cas de la valeur undefined . La définition d’une propriété de style sur la valeur undefined est identique à l’appel de la méthode clearStyle() .
|
Tue Jun 12 2018, 09:30 AM Z