AdvancedStyleClient  - AS3 Flex

The name of the component class.

The identity of the component.

An object containing the inheritable styles for this non-visual style client instance.

A module factory is used as context for finding the style manager that controls the styles for this non-visual style client instance.

The beginning of this component's chain of non-inheriting styles. The getStyle() method simply accesses nonInheritingStyles[styleName] to search the entire prototype-linked chain. This object is set up by initProtoChain(). Developers typically never need to access this property directly.

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

Related API Elements

Returns the StyleManager instance used by this component.

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

• String, such as "headerStyle". The String names a class selector that is defined in a CSS style sheet.
• CSSStyleDeclaration, such as StyleManager.getStyleDeclaration(".headerStyle").
• UIComponent. The object that implements this interface inherits all the style values from the referenced UIComponent.

A component's parent is used to evaluate descendant selectors. A parent must also be an IAdvancedStyleClient to participate in advanced style declarations.

Constructor.

Deletes a style property from this component instance.

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

Parameters

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.

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

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.

The initialized method is called when this class or a class that extends this class is used in an MXML declaration. It is called after the implementing object has been created and all component properties specified on the MXML tag have been initialized.

If the document that created this object is a UIComponent, (e.g. Application, Module, etc.) then the UIComponent's addStyleClient method will be called to add this object to the UIComponent's list of non-visual style clients. This allows the object to inherit styles from the document.

Parameters

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

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

Propagates style changes to the children of this style client instance. A non-visual style client (i.e. a style client that is not a DisplayObject) does not have children, therefore this method does not do anything for non-visual style clients.

Parameters

Sets up the internal style cache values so that the getStyle() method functions.

Parameters

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

Parameters

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

Detects changes to style properties. When any style property is set, Flex calls the styleChanged() method, passing to it the name of the style being set.

This is an advanced method that you might override when creating a subclass of AdvancedStyleClient. When you create a custom class, you can override the styleChanged() method to check the style name passed to it, and handle the change accordingly. This lets you override the default behavior of an existing style, or add your own custom style properties.

Parameters

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