[static]
Tests to see if this style affects the component's parent container in
such a way as to require that the parent container redraws itself when this style changes.
Returns an Array of all the CSS selectors that are registered with the StyleManager.
You can pass items in this Array to the getStyleDeclaration() method to get the corresponding CSSStyleDeclaration object.
Class selectors are prepended with a period.
Implementation public static function get selectors():Array
Method Detail
clearStyleDeclaration
()
method
public static function clearStyleDeclaration(selector:String, update:Boolean):void
Clears the CSSStyleDeclaration object that stores the rules
for the specified CSS selector.
If the specified selector is a class selector (for example, ".bigMargins" or ".myStyle"),
you must be sure to start the
selector property with a period (.).
If the specified selector is a type selector (for example, "Button"), do not start the
selector property with a period.
The global selector is similar to a type selector
and does not start with a period.
Parameters
selector:String — The name of the CSS selector to clear.
update:Boolean — Set to true to force an immediate update of the styles.
Set to false to avoid an immediate update of the styles in the application.
For more information about this method, see the description in the setStyleDeclaration()
method.
Returns the numeric RGB color value that corresponds to the
specified color string.
The color string can be either a case-insensitive color name
such as "red", "Blue", or
"haloGreen", a hexadecimal value such as 0xFF0000, or a #-hexadecimal String
such as "#FF0000".
This method returns a uint, such as 4521830, that represents a color. You can convert
this uint to a hexadecimal value by passing the numeric base (in this case, 16), to
the uint class's toString() method, as the following example shows:
import mx.styles.StyleManager;
private function getNewColorName():void {
StyleManager.registerColorName("soylentGreen",0x44FF66);
trace(StyleManager.getColorName("soylentGreen").toString(16));
}
Parameters
colorName:Object — The color name.
Returns
uint — Returns a uint that represents the color value or NOT_A_COLOR
if the value of the colorName property is not an alias for a color.
getColorNames
()
method
public static function getColorNames(colors:Array):void
Converts each element of the colors Array from a color name
to a numeric RGB color value.
Each color String can be either a case-insensitive color name
such as "red", "Blue", or
"haloGreen", a hexadecimal value such as 0xFF0000, or a #-hexadecimal String
such as "#FF0000"..
Parameters
colors:Array — An Array of color names.
getStyleDeclaration
()
method
public static function getStyleDeclaration(selector:String):CSSStyleDeclaration
Gets the CSSStyleDeclaration object that stores the rules
for the specified CSS selector.
If the selector parameter starts with a period (.),
the returned CSSStyleDeclaration is a class selector and applies only to those instances
whose styleName property specifies that selector
(not including the period).
For example, the class selector ".bigMargins"
applies to any UIComponent whose styleName
is "bigMargins".
If the selector parameter does not start with a period,
the returned CSSStyleDeclaration is a type selector and applies to all instances
of that type.
For example, the type selector "Button"
applies to all instances of Button and its subclasses.
The global selector is similar to a type selector
and does not start with a period.
Parameters
selector:String — The name of the CSS selector.
Returns
CSSStyleDeclaration — The style declaration whose name matches the selector property.
Tests to see if this style affects the component's parent container in
such a way as to require that the parent container redraws itself when this style changes.
When one of these styles is set with setStyle(),
the invalidateDisplayList() method is auomatically called on the component's
parent container to make it redraw and/or relayout its children.
Parameters
styleName:String — The name of the style to test.
Returns
Boolean — Returns true if the specified style is one
which may affect the appearance or layout of the component's
parent container.
isParentSizeInvalidatingStyle
()
method
public static function isParentSizeInvalidatingStyle(styleName:String):Boolean
Tests to see if the style changes the size of the component's parent container.
When one of these styles is set with setStyle(),
the invalidateSize() method is automatically called on the component's
parent container to make its measured size get recalculated
later.
Parameters
styleName:String — The name of the style to test.
Returns
Boolean — Returns true if the specified style is one
which may affect the measured size of the component's
parent container.
isSizeInvalidatingStyle
()
method
public static function isSizeInvalidatingStyle(styleName:String):Boolean
Tests to see if a style changes the size of a component.
When one of these styles is set with the setStyle() method,
the invalidateSize() method is automatically called on the component
to make its measured size get recalculated later.
Parameters
styleName:String — The name of the style to test.
Returns
Boolean — Returns true if the specified style is one
which may affect the measured size of the component.
isValidStyleValue
()
method
public static function isValidStyleValue(value:*):Boolean
This can be useful because some styles can be set to values
such as 0, NaN,
the empty String (""), or null, which can
cause an if (value) test to fail.
Parameters
value:* — The style property to test.
Returns
Boolean — If you pass the value returned by a getStyle() method call
to this method, it returns true if the style
was set and false if it was not set.
loadStyleDeclarations
()
method
public static function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
update:Boolean (default = true) — Set to true to force
an immediate update of the styles.
Set to false to avoid an immediate update
of the styles in the application.
This parameter is optional and defaults to true
For more information about this parameter, see the description
in the setStyleDeclaration() method.
trustContent:Boolean (default = false) — Obsolete, no longer used.
This parameter is optional and defaults to false.
applicationDomain:ApplicationDomain (default = null) — The ApplicationDomain passed to the
load() method of the IModuleInfo that loads the style SWF.
This parameter is optional and defaults to null.
securityDomain:SecurityDomain (default = null) — The SecurityDomain passed to the
load() method of the IModuleInfo that loads the style SWF.
This parameter is optional and defaults to null.
Returns
IEventDispatcher — An IEventDispatcher implementation that supports
StyleEvent.PROGRESS, StyleEvent.COMPLETE, and
StyleEvent.ERROR.
Adds a color name to the list of aliases for colors.
Parameters
colorName:String — The name of the color to add to the list; for example, "blue".
If you later access this color name, the value is not case-sensitive.
colorValue:uint — Color value, for example, 0x0000FF.
registerInheritingStyle
()
method
public static function registerInheritingStyle(styleName:String):void
Adds to the list of styles that can inherit values
from their parents.
Note: Ensure that you avoid using duplicate style names, as name
collisions can result in decreased performance if a style that is
already used becomes inheriting.
Parameters
styleName:String — The name of the style that is added to the list of styles that can inherit values.
registerParentDisplayListInvalidatingStyle
()
method
public static function registerParentDisplayListInvalidatingStyle(styleName:String):void
Adds to the list of styles which may affect the appearance
or layout of the component's parent container.
When one of these styles is set with setStyle(),
the invalidateDisplayList() method is auomatically called on the component's
parent container to make it redraw and/or relayout its children.
Parameters
styleName:String — The name of the style to register.
registerParentSizeInvalidatingStyle
()
method
public static function registerParentSizeInvalidatingStyle(styleName:String):void
Adds to the list of styles which may affect the measured size
of the component's parent container.
When one of these styles is set with setStyle(),
the invalidateSize() method is automatically called on the component's
parent container to make its measured size get recalculated
later.
Parameters
styleName:String — The name of the style to register.
registerSizeInvalidatingStyle
()
method
public static function registerSizeInvalidatingStyle(styleName:String):void
Adds to the list of styles which may affect the measured size
of the component.
When one of these styles is set with setStyle(),
the invalidateSize() method is automatically called on the component
to make its measured size get recalculated later.
Parameters
styleName:String — The name of the style that you add to the list.
setStyleDeclaration
()
method
public static function setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void
Sets the CSSStyleDeclaration object that stores the rules
for the specified CSS selector.
If the selector parameter starts with a period (.),
the specified selector is a "class selector" and applies only to those instances
whose styleName property specifies that selector
(not including the period).
For example, the class selector ".bigMargins"
applies to any UIComponent whose styleName
is "bigMargins".
If the selector parameter does not start with a period,
the specified selector is a "type selector" and applies to all instances
of that type.
For example, the type selector "Button"
applies to all instances of Button and its subclasses.
The global selector is similar to a type selector
and does not start with a period.
update:Boolean — Set to true to force an immediate update of the styles; internally, Flex
calls the styleChanged() method of UIComponent.
Set to false to avoid an immediate update of the styles in the application.
The styles will be updated the next time one of the following methods is called with
the update property set to true:
clearStyleDeclaration()
loadStyleDeclarations()
setStyleDeclaration()
unloadStyleDeclarations()
Typically, if you call the one of these methods multiple times,
you set this property to true only on the last call,
so that Flex does not call the styleChanged() method multiple times.
If you call the getStyle() method, Flex returns the style value
that was last applied to the UIComponent through a call to the styleChanged() method.
The component's appearance might not reflect the value returned by the getStyle() method. This occurs
because one of these style declaration methods might not yet have been called with the
update property set to true.
unloadStyleDeclarations
()
method
public static function unloadStyleDeclarations(url:String, update:Boolean = true):void
update:Boolean (default = true) — Set to true to force an immediate update of the styles.
Set to false to avoid an immediate update of the styles in the application.
For more information about this method, see the description in the setStyleDeclaration()
method.
Object