Pacotemx.styles
Classepublic class StyleManager
HerançaStyleManager Inheritance Object

The StyleManager class manages the following:

Veja também

mx.styles.CSSStyleDeclaration


Propriedades Públicas
 PropriedadeDefinido por
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  selectors : Array
[static] [read-only] Returns an Array of all the CSS selectors that are registered with the StyleManager.
StyleManager
Métodos Públicos
 MétodoDefinido por
  
[static] Clears the CSSStyleDeclaration object that stores the rules for the specified CSS selector.
StyleManager
  
getColorName(colorName:Object):uint
[static] Returns the numeric RGB color value that corresponds to the specified color string.
StyleManager
  
[static] Converts each element of the colors Array from a color name to a numeric RGB color value.
StyleManager
  
[static] Gets the CSSStyleDeclaration object that stores the rules for the specified CSS selector.
StyleManager
 Inherited
Indicates whether an object has a specified property defined.
Object
  
[static] Tests to see if the given String is an alias for a color value.
StyleManager
  
[static] Tests to see if a style is inheriting.
StyleManager
  
[static] Test to see if a TextFormat style is inheriting.
StyleManager
  
[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.
StyleManager
  
[static] Tests to see if the style changes the size of the component's parent container.
StyleManager
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
  
[static] Tests to see if a style changes the size of a component.
StyleManager
  
[static] Determines if a specified parameter is a valid style property.
StyleManager
  
loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
[static] Loads a style SWF.
StyleManager
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
  
registerColorName(colorName:String, colorValue:uint):void
[static] Adds a color name to the list of aliases for colors.
StyleManager
  
[static] Adds to the list of styles that can inherit values from their parents.
StyleManager
  
[static] Adds to the list of styles which may affect the appearance or layout of the component's parent container.
StyleManager
  
[static] Adds to the list of styles which may affect the measured size of the component's parent container.
StyleManager
  
[static] Adds to the list of styles which may affect the measured size of the component.
StyleManager
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
  
setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void
[static] Sets the CSSStyleDeclaration object that stores the rules for the specified CSS selector.
StyleManager
 Inherited
Returns the string representation of the specified object.
Object
  
[static] Unloads a style SWF.
StyleManager
 Inherited
Returns the primitive value of the specified object.
Object
Constantes públicas
 ConstanteDefinido por
  NOT_A_COLOR : uint = 0xFFFFFFFF
[static] The getColorName() method returns this value if the passed-in String is not a legitimate color name.
StyleManager
Detalhes da propriedade
selectorspropriedade
selectors:Array  [read-only]

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. Classe selectors are prepended with a period.


Implementação
    public static function get selectors():Array
Detalhes do método
clearStyleDeclaration()método
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 exemplo, ".bigMargins" or ".myStyle"), you must be sure to start the selector property with a period (.).

If the specified selector is a type selector (for exemplo, "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.

Parâmetros

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.

Veja também

getColorName()método 
public static function getColorName(colorName:Object):uint

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 exemplo shows:

      import mx.styles.StyleManager;
      private function getNewColorName():void {
          StyleManager.registerColorName("soylentGreen",0x44FF66);
          trace(StyleManager.getColorName("soylentGreen").toString(16));
      }
      

Parâmetros

colorName:Object — The color name.

Retorna
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()método 
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"..

Parâmetros

colors:Array — An Array of color names.

getStyleDeclaration()método 
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 exemplo, 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 exemplo, 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.

Parâmetros

selector:String — The name of the CSS selector.

Retorna
CSSStyleDeclaration — The style declaration whose name matches the selector property.
isColorName()método 
public static function isColorName(colorName:String):Boolean

Tests to see if the given String is an alias for a color value. For exemplo, by default, the String "blue" is an alias for 0x0000FF.

Parâmetros

colorName:String — The color name to test. This parameter is not case-sensitive.

Retorna
Boolean — Returns true if colorName is an alias for a color.
isInheritingStyle()método 
public static function isInheritingStyle(styleName:String):Boolean

Tests to see if a style is inheriting.

Parâmetros

styleName:String — The name of the style that you test to see if it is inheriting.

Retorna
Boolean — Returns true if the specified style is inheriting.
isInheritingTextFormatStyle()método 
public static function isInheritingTextFormatStyle(styleName:String):Boolean

Test to see if a TextFormat style is inheriting.

Parâmetros

styleName:String — The name of the style that you test to see if it is inheriting.

Retorna
Boolean — Returns true if the specified TextFormat style is inheriting.
isParentDisplayListInvalidatingStyle()método 
public static function isParentDisplayListInvalidatingStyle(styleName:String):Boolean

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.

Parâmetros

styleName:String — The name of the style to test.

Retorna
Boolean — Returns true if the specified style is one which may affect the appearance or layout of the component's parent container.
isParentSizeInvalidatingStyle()método 
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.

Parâmetros

styleName:String — The name of the style to test.

Retorna
Boolean — Returns true if the specified style is one which may affect the measured size of the component's parent container.
isSizeInvalidatingStyle()método 
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.

Parâmetros

styleName:String — The name of the style to test.

Retorna
Boolean — Returns true if the specified style is one which may affect the measured size of the component.
isValidStyleValue()método 
public static function isValidStyleValue(value:*):Boolean

Determines if a specified parameter is a valid style property. For exemplo:

      trace(StyleManager.isValidStyleValue(myButton.getStyle("color")).toString());
      

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.

Parâmetros

value:* — The style property to test.

Retorna
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()método 
public static function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher

Loads a style SWF.

Parâmetros

url:String — Location of the style SWF.
 
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.

Retorna
IEventDispatcher — An IEventDispatcher implementation that supports StyleEvent.PROGRESS, StyleEvent.COMPLETE, and StyleEvent.ERROR.

Veja também

registerColorName()método 
public static function registerColorName(colorName:String, colorValue:uint):void

Adds a color name to the list of aliases for colors.

Parâmetros

colorName:String — The name of the color to add to the list; for exemplo, "blue". If you later access this color name, the value is not case-sensitive.
 
colorValue:uint — Color value, for exemplo, 0x0000FF.

registerInheritingStyle()método 
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.

Parâmetros

styleName:String — The name of the style that is added to the list of styles that can inherit values.

registerParentDisplayListInvalidatingStyle()método 
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.

Parâmetros

styleName:String — The name of the style to register.

registerParentSizeInvalidatingStyle()método 
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.

Parâmetros

styleName:String — The name of the style to register.

registerSizeInvalidatingStyle()método 
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.

Parâmetros

styleName:String — The name of the style that you add to the list.

setStyleDeclaration()método 
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 exemplo, 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 exemplo, 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.

Parâmetros

selector:String — The name of the CSS selector.
 
styleDeclaration:CSSStyleDeclaration — The new style declaration.
 
update:Boolean — Set to true to force an immediate update of the styles; internally, Flash Player 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 Flash Player does not call the styleChanged() method multiple times.

If you call the getStyle() method, Flash Player 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()método 
public static function unloadStyleDeclarations(url:String, update:Boolean = true):void

Unloads a style SWF.

Parâmetros

url:String — Location of the style SWF.
 
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.

Veja também

Detalhes da constante
NOT_A_COLORConstante
public static const NOT_A_COLOR:uint = 0xFFFFFFFF

The getColorName() method returns this value if the passed-in String is not a legitimate color name.