Package | mx.styles |
Classe | public class AdvancedStyleClient |
Héritage | AdvancedStyleClient EventDispatcher Object |
Implémente | IAdvancedStyleClient, IFlexModule, IMXMLObject |
Sous-classes | GlobalizationBase, Sort, SortField |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
IAdvancedStyleClient
. La classe de base fournit les implémentations des méthodes et des propriétés requises par un objet pour participer au sous-système de style.
Outre l’interface IAdvancedStyleClient
, cet objet implémente également les interfaces IFlexModule
et IMXMLObject
. L’interface IMXMLObject
contient une méthode initialized
qui est appelée lorsque la classe est instanciée à l’aide d’une déclaration MXML. L’implémentation de la méthode initialized
fournie par cette classe de base ajoutera l’instance de la classe à l’objet de document qui contient la déclaration MXML. Pour plus de détails, voir la description de la méthode initialized
.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
className : String [lecture seule]
Nom de la classe du composant. | AdvancedStyleClient | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
id : String
Identité du composant. | AdvancedStyleClient | ||
inheritingStyles : Object
Objet contenant les styles héritables de cette instance de client de style non visuel. | AdvancedStyleClient | ||
moduleFactory : IFlexModuleFactory
Une fabrique de modules est utilisée comme contexte pour la recherche du gestionnaire de style qui contrôle les styles de cette instance de client de style non visuel. | AdvancedStyleClient | ||
nonInheritingStyles : Object
Début de la chaîne de styles non hérités de ce composant. | AdvancedStyleClient | ||
styleDeclaration : CSSStyleDeclaration
Déclaration de style contenant les styles en ligne déclarés par cet objet. | AdvancedStyleClient | ||
styleManager : IStyleManager2 [lecture seule]
Renvoie l’instance SystemManager utilisée par ce composant. | AdvancedStyleClient | ||
styleName : Object
Source des valeurs de style de cet objet. | AdvancedStyleClient | ||
styleParent : IAdvancedStyleClient
Le parent d’un composant permet d’évaluer les sélecteurs descendants. | AdvancedStyleClient |
Méthode | Défini par | ||
---|---|---|---|
Constructeur. | AdvancedStyleClient | ||
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 de cette instance de composant. | AdvancedStyleClient | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
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. | AdvancedStyleClient | ||
Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant. | AdvancedStyleClient | ||
Renvoie true si la valeur currentCSSState n’est pas nulle. | AdvancedStyleClient | ||
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 | ||
La méthode initialized est appelée lorsque cette classe ou une classe qui étend cette classe est utilisée dans une déclaration MXML. | AdvancedStyleClient | ||
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. | AdvancedStyleClient | ||
Détermine si l’instance est identique au, ou est une sous-classe du, type donné. | AdvancedStyleClient | ||
Propage les changements de style aux enfants de cette instance du client de style. | AdvancedStyleClient | ||
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. | AdvancedStyleClient | ||
Enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement pour chaque événement d’effet. | AdvancedStyleClient | ||
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 cette instance de composant. | AdvancedStyleClient | ||
Détecte les modifications apportées aux propriétés de style. | AdvancedStyleClient | ||
Flex() appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisés. | AdvancedStyleClient | ||
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 |
className | propriété |
id | propriété |
inheritingStyles | propriété |
inheritingStyles:Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Objet contenant les styles héritables de cette instance de client de style non visuel.
Implémentation
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
moduleFactory | propriété |
moduleFactory:IFlexModuleFactory
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Une fabrique de modules est utilisée comme contexte pour la recherche du gestionnaire de style qui contrôle les styles de cette instance de client de style non visuel.
Implémentation
public function get moduleFactory():IFlexModuleFactory
public function set moduleFactory(value:IFlexModuleFactory):void
nonInheritingStyles | propriété |
nonInheritingStyles:Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Début de la chaîne de styles non hérités de ce composant. La méthode getStyle()
accède simplement à nonInheritingStyles[styleName]
pour parcourir la totalité de la chaîne liée au prototype. Cet objet est défini par la méthode initProtoChain()
. En règle générale, les développeurs n’ont jamais besoin d’accéder à cette propriété directement.
Implémentation
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
styleDeclaration | propriété |
styleDeclaration:CSSStyleDeclaration
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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
Eléments de l’API associés
styleManager | propriété |
styleManager:IStyleManager2
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Renvoie l’instance SystemManager utilisée par ce composant.
Implémentation
public function get styleManager():IStyleManager2
styleName | propriété |
styleName:Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Le parent d’un composant permet d’évaluer les sélecteurs descendants. Un parent doit également être une interface IAdvancedStyleClient pour participer aux déclarations de style avancées.
Implémentation
public function get styleParent():IAdvancedStyleClient
public function set styleParent(value:IAdvancedStyleClient):void
AdvancedStyleClient | () | Constructeur |
public function AdvancedStyleClient()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Constructeur.
clearStyle | () | méthode |
public function clearStyle(styleProp:String):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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éeArray — Tableau d’objets CSSStyleDeclaration.
|
getStyle | () | méthode |
public function getStyle(styleProp:String):*
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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 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
.
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.
|
initialized | () | méthode |
public function initialized(document:Object, id:String):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
La méthode initialized est appelée lorsque cette classe ou une classe qui étend cette classe est utilisée dans une déclaration MXML. Elle est appelée une fois que l’objet d’implémentation a été créé et que toutes les propriétés de composants spécifiées sur la balise MXML ont été initialisées.
Si le document qui a créé cet objet est un composant UIComponent
, (par ex., l’application, le module, etc.), la méthode addStyleClient
de l’objet UIComponent sera appelée pour ajouter cet objet à la liste des clients de style non visuels de l’objet UIComponent. Cela permet à l’objet d’hériter les styles du document.
Paramètres
document:Object — Document MXML ayant créé cet objet.
| |
id:String — L’identificateur utilisé par l’objet de document pour faire référence à cet objet.
|
matchesCSSState | () | méthode |
public function matchesCSSState(cssState:String):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.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.
|
Boolean — true 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.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.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.
|
Boolean — true 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 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Propage les changements de style aux enfants de cette instance du client de style. Un client de style non visuel (c’est-à-dire un client de style qui n’est pas une classe DisplayObject) n’a pas d’enfants, par conséquent, cette méthode ne fait rien pour les clients de style non visuels.
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 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Configure les valeurs de cache du style interne afin que la méthode getStyle()
fonctionne.
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 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Détecte les modifications apportées aux propriétés de style. Lorsqu’une propriété de style est définie, Flex appelle la méthode styleChanged()
et lui transmet le nom du style défini.
Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de l’objet AdvancedStyleClient
. Lorsque vous créez une classe personnalisée, vous pouvez remplacer la méthode styleChanged()
pour vérifier le nom de style transmis et traiter la modification en conséquence. Vous pouvez ainsi remplacer le comportement par défaut d’un style existant ou ajouter vos propres propriétés de style personnalisées.
Paramètres
styleProp:String — Le nom de la propriété de style, ou null si tous les styles de ce client de style ont changé.
|
stylesInitialized | () | méthode |
public function stylesInitialized():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Flex appelle la méthode stylesInitialized()
lorsque les styles d’un composant sont d’abord initialisés.
Tue Jun 12 2018, 09:30 AM Z