Packagemx.styles
Classpublic class StyleProxy
InheritanceStyleProxy Inheritance Object
Implements IAdvancedStyleClient

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Wraps an object that implements the IAdvancedStyleClient interface. This interface supports a filterMap property that contains style-source/style-destination pairs.

See also

mx.styles.IAdvancedStyleClient


Public Properties
 PropertyDefined By
  className : String
[read-only] The name of the component class.
StyleProxy
  filterMap : Object
A set of string pairs.
StyleProxy
  id : String
[read-only] The identity of the component.
StyleProxy
  inheritingStyles : Object
An object containing the inheritable styles for this component.
StyleProxy
  nonInheritingStyles : Object
An object containing the noninheritable styles for this component.
StyleProxy
  source : IStyleClient
The object that implements the IStyleClient interface.
StyleProxy
  styleDeclaration : CSSStyleDeclaration
The style declaration that holds the inline styles declared by this object.
StyleProxy
  styleName : Object
The source of this object's style values.
StyleProxy
  styleParent : IAdvancedStyleClient
The parent of this IAdvancedStyleClient..
StyleProxy
Public Methods
 MethodDefined By
  
StyleProxy(source:IStyleClient, filterMap:Object)
Constructor.
StyleProxy
  
clearStyle(styleProp:String):void
Deletes a style property from this component instance.
StyleProxy
  
Returns an Array of CSSStyleDeclaration objects for the type selector that applies to this component, or null if none exist.
StyleProxy
  
getStyle(styleProp:String):*
Gets a style property that has been set anywhere in this component's style lookup chain.
StyleProxy
  
hasCSSState():Boolean
Returns true if currentCSSState is not null.
StyleProxy
  
matchesCSSState(cssState:String):Boolean
Returns true if cssState matches currentCSSState.
StyleProxy
  
matchesCSSType(cssType:String):Boolean
Determines whether this instance is the same as, or is a subclass of, the given type.
StyleProxy
  
notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void
Propagates style changes to the children of this component.
StyleProxy
  
regenerateStyleCache(recursive:Boolean):void
Sets up the internal style cache values so that the getStyle() method functions.
StyleProxy
  
registerEffects(effects:Array):void
Registers the EffectManager as one of the event listeners for each effect event.
StyleProxy
  
setStyle(styleProp:String, newValue:*):void
Sets a style property on this component instance.
StyleProxy
  
styleChanged(styleProp:String):void
Called when the value of a style property is changed.
StyleProxy
  
Flex calls the stylesInitialized() method when the styles for a component are first initialized.
StyleProxy
Property Detail
classNameproperty
className:String  [read-only]

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The name of the component class.


Implementation
    public function get className():String
filterMapproperty 
filterMap:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

A set of string pairs. The first item of the string pair is the name of the style in the source component. The second item of the String pair is the name of the style in the subcomponent. With this object, you can map a particular style in the parent component to a different style in the subcomponent. This is useful if both the parent component and the subcomponent share the same style, but you want to be able to control the values seperately.


Implementation
    public function get filterMap():Object
    public function set filterMap(value:Object):void
idproperty 
id:String  [read-only]

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The identity of the component.


Implementation
    public function get id():String
inheritingStylesproperty 
inheritingStyles:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

An object containing the inheritable styles for this component.


Implementation
    public function get inheritingStyles():Object
    public function set inheritingStyles(value:Object):void
nonInheritingStylesproperty 
nonInheritingStyles:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

An object containing the noninheritable styles for this component.


Implementation
    public function get nonInheritingStyles():Object
    public function set nonInheritingStyles(value:Object):void
sourceproperty 
source:IStyleClient

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The object that implements the IStyleClient interface. This is the object that is being proxied.


Implementation
    public function get source():IStyleClient
    public function set source(value:IStyleClient):void
styleDeclarationproperty 
styleDeclaration:CSSStyleDeclaration

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The style declaration that holds the inline styles declared by this object.


Implementation
    public function get styleDeclaration():CSSStyleDeclaration
    public function set styleDeclaration(value:CSSStyleDeclaration):void
styleNameproperty 
styleName:Object

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The source of this object's style values. The value of the styleName property can be one of three possible types:


Implementation
    public function get styleName():Object
    public function set styleName(value:Object):void
styleParentproperty 
styleParent:IAdvancedStyleClient

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The parent of this IAdvancedStyleClient.. Typically, you do not assign this property directly. It is set by the addChild, addChildAt, removeChild, and removeChildAt methods of the flash.display.DisplayObjectContainer and the mx.core.UIComponent.addStyleClient() and the mx.core.UIComponent.removeStyleClient() methods. If it is assigned a value directly, without calling one of the above mentioned methods the instance of the class that implements this interface will not inherit styles from the UIComponent or DisplayObject. Also if assigned a value directly without, first removing the object from the current parent with the remove methods listed above, a memory leak could occur.


Implementation
    public function get styleParent():IAdvancedStyleClient
    public function set styleParent(value:IAdvancedStyleClient):void
Constructor Detail
StyleProxy()Constructor
public function StyleProxy(source:IStyleClient, filterMap:Object)

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Constructor.

Parameters
source:IStyleClient — The object that implements the IStyleClient interface.
 
filterMap:Object — The set of styles to pass from the source to the subcomponent.
Method Detail
clearStyle()method
public function clearStyle(styleProp:String):void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Deletes a style property from this component instance.

This does not necessarily cause the getStyle() method to return undefined.

Parameters

styleProp:String — Name of the style property.

getClassStyleDeclarations()method 
public function getClassStyleDeclarations():Array

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Returns an Array of CSSStyleDeclaration objects for the type selector that applies to this component, or null if none exist.

For example, suppose that component MyButton extends Button. This method first looks for a MyButton selector; then, it looks for a Button type selector; finally, it looks for a UIComponent type selector.

Returns
Array — Array of CSSStyleDeclaration objects.
getStyle()method 
public function getStyle(styleProp:String):*

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Gets a style property that has been set anywhere in this component's style lookup chain.

This same method is used to get any kind of style property, so the value returned may be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is specified as *.

If you are getting a particular style property, you will know its type and will often want to store the result in a variable of that type. You can use either the as operator or coercion to do this. For example:

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

If the style property has not been set anywhere in the style lookup chain, the value returned by the getStyle() method is undefined. Note that undefined is a special value that is not the same as false, the empty String (""), NaN, 0, or null. No valid style value is ever undefined. You can use the static method StyleManager.isValidStyleValue() to test whether the value was set.

Parameters

styleProp:String — Name of the style property.

Returns
* — Style value.
hasCSSState()method 
public function hasCSSState():Boolean

Language Version : ActionScript 3.0
Product Version : Flex 4.6
Runtime Versions : Flash Player 10, AIR 2.5

Returns true if currentCSSState is not null. Typically, you do not call this method directly. It is called by the mx.styles.CSSCondition.matchesStyleClient() method.

Note Spark components use their skin state as the pseudo state. Halo components use the currentState property.

Returns
Booleantrue if currentCSSState is not null. By default, currentCSSState is the same as currentState. If no state exists, return false.
matchesCSSState()method 
public function matchesCSSState(cssState:String):Boolean

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Returns true if cssState matches currentCSSState. Typically, you do not call this method directly. It is called by the mx.styles.CSSCondition.matchesStyleClient() method.

Note Spark components use their skin state as the pseudo state. Halo components use the currentState property.

Parameters

cssState:String — A possible value of CSSCondition.value. It represents the current state of this component used to match CSS pseudo-selectors.

Returns
Booleantrue if cssState matches currentCSSState. By default, currentCSSState is the same as currentState. If no state exists, return null.
matchesCSSType()method 
public function matchesCSSType(cssType:String):Boolean

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Determines whether this instance is the same as, or is a subclass of, the given type. Typically, you do not call this method directly. It is called by the mx.styles.CSSCondition.matchesStyleClient() method.

Parameters

cssType:String — A CSSSelector object.

Returns
Booleantrue if cssType is in the hierarchy of qualified type selectors.
notifyStyleChangeInChildren()method 
public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Propagates style changes to the children of this component.

Parameters

styleProp:String — Name of the style property.
 
recursive:Boolean — Whether to propagate the style changes to the children's children.

regenerateStyleCache()method 
public function regenerateStyleCache(recursive:Boolean):void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Sets up the internal style cache values so that the getStyle() method functions. If this object already has children, then reinitialize the children's style caches.

Parameters

recursive:Boolean — Regenerate the proto chains of the children.

registerEffects()method 
public function registerEffects(effects:Array):void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Registers the EffectManager as one of the event listeners for each effect event.

Parameters

effects:Array — An Array of Strings of effect names.

setStyle()method 
public function setStyle(styleProp:String, newValue:*):void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Sets a style property on this component instance.

This may override a style that was set globally.

Calling the setStyle() method can result in decreased performance. Use it only when necessary.

Parameters

styleProp:String — Name of the style property.
 
newValue:* — New value for the style.

styleChanged()method 
public function styleChanged(styleProp:String):void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Called when the value of a style property is changed.

Parameters

styleProp:String — The name of the style property that changed.

stylesInitialized()method 
public function stylesInitialized():void

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Flex calls the stylesInitialized() method when the styles for a component are first initialized.