mx.styles.StyleManager (Flex 3.2)

	属性	定义方
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		selectors : Array [静态] [只读 (read-only)] 返回所有在 StyleManager 中注册的 CSS 选择器的数组。	StyleManager

	方法	定义方
		clearStyleDeclaration(selector:String, update:Boolean):void [静态] 清除存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。	StyleManager
		getColorName(colorName:Object):uint [静态] 返回对应于指定颜色字符串的数字 RGB 颜色值。	StyleManager
		getColorNames(colors:Array):void [静态] 将颜色数组中的每个元素从颜色名转换为数字 RGB 颜色值。	StyleManager
		getStyleDeclaration(selector:String):CSSStyleDeclaration [静态] 获取存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。	StyleManager
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isColorName(colorName:String):Boolean [静态] 测试以查看给定的字符串是否为颜色值的别名。	StyleManager
		isInheritingStyle(styleName:String):Boolean [静态] 测试以查看样式是否为继承。	StyleManager
		isInheritingTextFormatStyle(styleName:String):Boolean [静态] 测试以查看 TextFormat 样式是否为继承。	StyleManager
		isParentDisplayListInvalidatingStyle(styleName:String):Boolean [静态] 测试以查看该样式是否影响组件的父容器，如当该样式更改时要求父容器重绘自身。	StyleManager
		isParentSizeInvalidatingStyle(styleName:String):Boolean [静态] 测试以查看样式是否更改组件父容器的大小。	StyleManager
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		isSizeInvalidatingStyle(styleName:String):Boolean [静态] 测试以查看样式是否更改组件的大小。	StyleManager
		isValidStyleValue(value:*):Boolean [静态] 确定指定的参数是否为有效的样式属性。	StyleManager
		loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher [静态] 加载样式 SWF。	StyleManager
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		registerColorName(colorName:String, colorValue:uint):void [静态] 将颜色名添加到颜色别名列表。	StyleManager
		registerInheritingStyle(styleName:String):void [静态] 添加到可从其父级中继承值的样式列表。	StyleManager
		registerParentDisplayListInvalidatingStyle(styleName:String):void [静态] 添加到可能影响组件父容器的外观或布局的样式列表。	StyleManager
		registerParentSizeInvalidatingStyle(styleName:String):void [静态] 添加到可能影响组件父容器的测量大小的样式列表。	StyleManager
		registerSizeInvalidatingStyle(styleName:String):void [静态] 添加到可能影响组件的测量大小的样式列表。	StyleManager
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void [静态] 设置存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。	StyleManager
		toString():String 返回指定对象的字符串表示形式。	Object
		unloadStyleDeclarations(url:String, update:Boolean = true):void [静态] 卸载样式 SWF。	StyleManager
		valueOf():Object 返回指定对象的原始值。	Object

	常量	定义方
		NOT_A_COLOR : uint = 0xFFFFFFFF [静态] 如果传入的字符串不是合法的颜色名，getColorName() 方法将返回该值。	StyleManager

属性详细信息

selectors

属性

selectors:Array [只读 (read-only)]

返回所有在 StyleManager 中注册的 CSS 选择器的数组。可将该数组中的项传递给 getStyleDeclaration() 方法，以获取相应的 CSSStyleDeclaration 对象。类选择器以英文句号开头。

实现
public static function get selectors():Array

方法详细信息

clearStyleDeclaration

()

方法

public static function clearStyleDeclaration(selector:String, update:Boolean):void

清除存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。

如果指定的选择器是一个类选择器（例如，“.bigMargins”或“.myStyle”），则必须确保 selector 属性以英文句号 (.) 开头。

如果指定的选择器是一个类型选择器（例如，“Button”），则不要让 selector 属性以英文句号开头。

global 选择器和类型选择器相似，不以英文句号开头。

参数

	`selector:String` — 要清除的 CSS 选择器的名称。

	`update:Boolean` — 设置为 `true` 以强制立即更新样式。设置为 `false` 以避免立即更新应用程序中的样式。有关该方法的详细信息，请参阅 `setStyleDeclaration()` 方法中的说明。

另请参见

setStyleDeclaration()

getColorName

()

方法

public static function getColorName(colorName:Object):uint

返回对应于指定颜色字符串的数字 RGB 颜色值。颜色字符串可以是不区分大小写的颜色名（如 "red"、"Blue" 或 "haloGreen"）、十六进制值（如 0xFF0000）或 #-十六进制值字符串（如 "#FF0000"）。

该方法返回一个表示颜色的 uint，如 4521830。通过将基数（此例中为 16 ）传递给 uint 类的 toString() 方法，可将该 uint 转换为一个十六进制值，如下例所示：

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

参数

colorName:Object — 颜色名。

uint — 返回一个表示颜色值的 uint；如果 colorName 属性的值不是颜色的别名，则返回 NOT_A_COLOR。

getColorNames

()

方法

public static function getColorNames(colors:Array):void

将颜色数组中的每个元素从颜色名转换为数字 RGB 颜色值。每个颜色字符串可以是不区分大小写的颜色名称（如 "red"、"Blue" 或 "haloGreen"）、十六进制值（如 0xFF0000）或 #-十六进制值字符串（如 "#FF0000"）。

参数

colors:Array — 颜色名数组。

getStyleDeclaration

()

方法

public static function getStyleDeclaration(selector:String):CSSStyleDeclaration

获取存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。

如果 selector 参数以英文句号 (.) 开头，则返回的 CSSStyleDeclaration 是一个类选择器，只适用于那些其 styleName 属性指定了该选择器（不包括英文句号）的实例。例如，类选择器 ".bigMargins" 适用于任何 styleName 为 "bigMargins" 的 UIComponent。

如果 selector 参数不以英文句号开头，则返回的 CSSStyleDeclaration 是一个类型选择器，适用于该类型的所有实例。例如，类型选择器 "Button" 适用于 Button 及其子类的所有实例。

global 选择器和类型选择器相似，不以英文句号开头。

参数

selector:String — CSS 选择器的名称。

CSSStyleDeclaration — 其名称和 selector 属性匹配的样式声明。

isColorName

()

方法

public static function isColorName(colorName:String):Boolean

测试以查看给定的字符串是否为颜色值的别名。例如，默认情况下，字符串“blue”是 0x0000FF 的别名。

参数

colorName:String — 要测试的颜色名。该参数不区分大小写。

Boolean — 如果 colorName 为颜色的别名，则返回 true。

isInheritingStyle

()

方法

public static function isInheritingStyle(styleName:String):Boolean

测试以查看样式是否为继承。

参数

styleName:String — 测试以查看其是否为继承的样式的名称。

Boolean — 如果指定的样式为继承，则返回 true。

isInheritingTextFormatStyle

()

方法

public static function isInheritingTextFormatStyle(styleName:String):Boolean

测试以查看 TextFormat 样式是否为继承。

参数

styleName:String — 测试以查看其是否为继承的样式的名称。

Boolean — 如果指定的 TextFormat 样式为继承，则返回 true。

isParentDisplayListInvalidatingStyle

()

方法

public static function isParentDisplayListInvalidatingStyle(styleName:String):Boolean

测试以查看该样式是否影响组件的父容器，如当该样式更改时要求父容器重绘自身。

当使用 setStyle() 设置这些样式之一时，将对该组件的父容器自动调用 invalidateDisplayList() 方法，以使其重绘和/或重新布局其子项。

参数

styleName:String — 要测试的样式的名称。

Boolean — 如果指定的样式可能影响组件父容器的外观或布局，则返回 true。

isParentSizeInvalidatingStyle

()

方法

public static function isParentSizeInvalidatingStyle(styleName:String):Boolean

测试以查看样式是否更改组件父容器的大小。

当使用 setStyle() 设置这些样式之一时，将对该组件的父容器自动调用 invalidateSize() 方法，以便在以后重新计算其测量大小。

参数

styleName:String — 要测试的样式的名称。

Boolean — 如果指定的样式可能影响组件父容器的测量大小，则返回 true。

isSizeInvalidatingStyle

()

方法

public static function isSizeInvalidatingStyle(styleName:String):Boolean

测试以查看样式是否更改组件的大小。

当使用 setStyle() 方法设置这些样式之一时，将对该组件自动调用 invalidateSize() 方法，以便在以后重新计算其测量大小。

参数

styleName:String — 要测试的样式的名称。

Boolean — 如果指定的样式可能影响组件的测量大小，则返回 true。

isValidStyleValue

()

方法

public static function isValidStyleValue(value:*):Boolean

确定指定的参数是否为有效的样式属性。例如：

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

这将非常有用，因为某些样式的值可以设置为如 0、NaN、空字符串 ("") 或 null 之类的值，这会导致 if (value) 测试失败。

参数

value:* — 要测试的样式属性。

Boolean — 如果将由 getStyle() 方法调用返回的值传递给该方法，则若设置了样式，将返回 true，若未设置样式，将返回 false。

loadStyleDeclarations

()

方法

 public static function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher

加载样式 SWF。

参数

	`url:String` — 样式 SWF 的位置。

	`update:Boolean` (default = `true`) — 设置为 `true` 以强制立即更新样式。设置为 `false` 以避免立即更新应用程序中的样式。此参数可选并且默认值为 `true`。有关此参数的详细信息，请参阅 `setStyleDeclaration()` 方法中的说明。

	`trustContent:Boolean` (default = `false`) — 废除，不再使用。该参数可选，默认值为 `false`。

	`applicationDomain:ApplicationDomain` (default = `null`) — 传递给加载样式 SWF 的·IModuleInfo 的 `load()` 方法的 ApplicationDomain。该参数可选，默认值为 `null`。

	`securityDomain:SecurityDomain` (default = `null`) — 传递给加载样式 SWF 的·IModuleInfo 的 `load()` 方法的 SecurityDomain。该参数可选，默认值为 `null`。

IEventDispatcher — 支持 StyleEvent.PROGRESS、StyleEvent.COMPLETE 和 StyleEvent.ERROR 的 IEventDispatcher 实现。

另请参见

setStyleDeclaration()

registerColorName

()

方法

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

将颜色名添加到颜色别名列表。

参数

	`colorName:String` — 要添加到列表的颜色的名称，如“blue”。如果以后访问该颜色名，该值不区分大小写。

	`colorValue:uint` — 颜色值，例如 0x0000FF。

registerInheritingStyle

()

方法

public static function registerInheritingStyle(styleName:String):void

添加到可从其父级中继承值的样式列表。

注意：请确保避免使用重复的样式名称，因为如果已使用的样式变为继承，命名冲突将导致性能降低。

参数

styleName:String — 添加到可继承值的样式列表中的样式名称。

registerParentDisplayListInvalidatingStyle

()

方法

public static function registerParentDisplayListInvalidatingStyle(styleName:String):void

添加到可能影响组件父容器的外观或布局的样式列表。当使用 setStyle() 设置这些样式之一时，将对该组件的父容器自动调用 invalidateDisplayList() 方法，以使其重绘和/或重新布局其子项。

参数

styleName:String — 要注册的样式的名称。

registerParentSizeInvalidatingStyle

()

方法

public static function registerParentSizeInvalidatingStyle(styleName:String):void

添加到可能影响组件父容器的测量大小的样式列表。

当使用 setStyle() 设置这些样式之一时，将对该组件的父容器自动调用 invalidateSize() 方法，以便在以后重新计算其测量大小。

参数

styleName:String — 要注册的样式的名称。

registerSizeInvalidatingStyle

()

方法

public static function registerSizeInvalidatingStyle(styleName:String):void

添加到可能影响组件的测量大小的样式列表。当使用 setStyle() 设置这些样式之一时，将对该组件自动调用 invalidateSize() 方法，以便在以后重新计算其测量大小。

参数

styleName:String — 添加到列表的样式的名称。

setStyleDeclaration

()

方法

public static function setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void

设置存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。

如果 selector 参数以英文句号 (.) 开头，则指定的选择器是一个“类选择器”，只适用于那些其 styleName 属性指定了该选择器（不包括英文句号）的实例。例如，类选择器 ".bigMargins" 适用于任何 styleName 为 "bigMargins" 的 UIComponent。

如果 selector 参数不以英文句号开头，则指定的选择器是一个“类型选择器”，适用于该类型的所有实例。例如，类型选择器 "Button" 适用于 Button 及其子类的所有实例。

global 选择器和类型选择器相似，不以英文句号开头。

参数

	`selector:String` — CSS 选择器的名称。

	`styleDeclaration:CSSStyleDeclaration` — 新样式声明。

	`update:Boolean` — 设置为 `true` 以强制立即更新样式；在内部，Flex 调用 UIComponent 的 `styleChanged()` 方法。设置为 `false` 以避免立即更新应用程序中的样式。样式将在下一次调用以下方法之一并且 `update` 属性设置为 `true` 时更新。 `clearStyleDeclaration()` `loadStyleDeclarations()` `setStyleDeclaration()` `unloadStyleDeclarations()` 通常，如果多次调用这些方法中的一种，只需在最后一次调用时将该属性设置为 `true`，以便 Flex 不会多次调用 `styleChanged()` 方法。如果调用 `getStyle()` 方法，Flex 将返回通过调用 `styleChanged()` 方法最后一次应用到 UIComponent 中的样式值。组件的外观可能不反映由 `getStyle()` 方法返回的值。这是因为这些样式声明方法中的一种可能未在 `update` 属性设置为 `true` 时被调用。

unloadStyleDeclarations

()

方法

public static function unloadStyleDeclarations(url:String, update:Boolean = true):void

卸载样式 SWF。

参数

	`url:String` — 样式 SWF 的位置。

	`update:Boolean` (default = `true`) — 设置为 `true` 以强制立即更新样式。设置为 `false` 以避免立即更新应用程序中的样式。有关该方法的详细信息，请参阅 `setStyleDeclaration()` 方法中的说明。

另请参见

setStyleDeclaration()

常量详细信息

NOT_A_COLOR

常量

public static const NOT_A_COLOR:uint = 0xFFFFFFFF

如果传入的字符串不是合法的颜色名，getColorName() 方法将返回该值。

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
StyleManager	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例

包	mx.styles
类	public class StyleManager
继承	StyleManager Object