包 | mx.styles |
类 | public class StyleManager |
继承 | StyleManager Object |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
- 该类继承哪些 CSS 样式属性
- 哪些样式属性是颜色,因此获得特殊处理
- 一组用作颜色值别名的字符串
相关 API 元素
属性 | 由以下参数定义 | ||
---|---|---|---|
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
selectors : Array 自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.selectors on a style manager instance [静态] [只读]
返回所有在 StyleManager 中注册的 CSS 选择器的数组。 | StyleManager |
方法 | 由以下参数定义 | ||
---|---|---|---|
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.clearStyleDeclaration on a style manager instance [静态]
清除存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.getColorName on a style manager instance [静态]
返回对应于指定颜色字符串的数字 RGB 颜色值。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.getColorNames on a style manager instance [静态]
将颜色数组中的每个元素从颜色名转换为数字 RGB 颜色值。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.getStyleDeclaration on a style manager instance [静态]
获取存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。 | StyleManager | ||
[静态]
返回对象的样式管理器。 | StyleManager | ||
表示对象是否已经定义了指定的属性。 | Object | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.isColorName on a style manager instance [静态]
测试以查看给定的字符串是否为颜色值的别名。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.isInheritingStyle on a style manager instance [静态]
测试以查看样式是否为继承。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.isInheritingTextFormatStyle on a style manager instance [静态]
测试以查看 TextFormat 样式是否为继承。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.isParentDisplayListInvalidatingStyle on a style manager instance [静态]
测试以查看该样式是否影响组件的父容器,如当该样式更改时要求父容器重绘自身。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.isParentSizeInvalidatingStyle on a style manager instance [静态]
测试以查看样式是否更改组件父容器的大小。 | StyleManager | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.isSizeInvalidatingStyle on a style manager instance [静态]
测试以查看样式是否更改组件的大小。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.isValidStyleValue on a style manager instance [静态]
确定指定的参数是否为有效的样式属性。 | StyleManager | ||
loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher 自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.loadStyleDeclarations on a style manager instance [静态]
加载样式 SWF。 | StyleManager | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.registerColorName on a style manager instance [静态]
将颜色名添加到颜色别名列表。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.registerInheritingStyle on a style manager instance [静态]
添加到可从其父级中继承值的样式列表。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.registerParentDisplayListInvalidatingStyle on a style manager instance [静态]
添加到可能影响组件父容器的外观或布局的样式列表。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.registerParentSizeInvalidatingStyle on a style manager instance [静态]
添加到可能影响组件父容器的测量大小的样式列表。 | StyleManager | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.registerSizeInvalidatingStyle on a style manager instance [静态]
添加到可能影响组件的测量大小的样式列表。 | StyleManager | ||
设置循环操作动态属性的可用性。 | Object | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.setStyleDeclaration on a style manager instance [静态]
设置存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。 | StyleManager | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
自以下版本起不推荐使用: 4.0: 请使用 IStyleManager2.unloadStyleDeclarations on a style manager instance [静态]
卸载样式 SWF。 | StyleManager | ||
返回指定对象的原始值。 | Object |
常量 | 由以下参数定义 | ||
---|---|---|---|
NOT_A_COLOR : uint = 0xFFFFFFFF [静态]
如果传入的字符串不是合法的颜色名,getColorName() 方法将返回该值。 | StyleManager |
selectors | 属性 |
selectors:Array
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
返回所有在 StyleManager 中注册的 CSS 选择器的数组。可将该数组中的项传递给 getStyleDeclaration()
方法,以获取相应的 CSSStyleDeclaration 对象。类选择器以英文句号开头。
实现
public static function get selectors():Array
clearStyleDeclaration | () | 方法 |
public static function clearStyleDeclaration(selector:String, update:Boolean):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
清除存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。
如果指定的选择器是一个类选择器(例如,“.bigMargins”或“.myStyle”),则必须确保 selector
属性以英文句号 (.) 开头。
如果指定的选择器是一个类型选择器(例如,“Button”),则不要让 selector
属性以英文句号开头。
global
选择器和类型选择器相似,不以英文句号开头。
参数
selector:String — 要清除的 CSS 选择器的名称。
| |
update:Boolean — 设置为 true 以强制立即更新样式。设置为 false 以避免立即更新应用程序中的样式。有关该方法的详细信息,请参阅 setStyleDeclaration() 方法中的说明。
|
相关 API 元素
getColorName | () | 方法 |
public static function getColorName(colorName:Object):uint
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
返回对应于指定颜色字符串的数字 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
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将颜色数组中的每个元素从颜色名转换为数字 RGB 颜色值。每个颜色字符串可以是不区分大小写的颜色名称(如 "red"
、"Blue"
或 "haloGreen"
)、十六进制值(如 0xFF0000)或 #-十六进制值字符串(如 "#FF0000"
)。
参数
colors:Array — 颜色名数组。
|
getStyleDeclaration | () | 方法 |
public static function getStyleDeclaration(selector:String):CSSStyleDeclaration
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
获取存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。
如果 selector
参数以英文句号 (.) 开头,则返回的 CSSStyleDeclaration 是一个类选择器,只适用于那些其 styleName
属性指定了该选择器(不包括英文句号)的实例。例如,类选择器 ".bigMargins"
适用于任何 styleName
为 "bigMargins"
的 UIComponent。
如果 selector
参数不以英文句号开头,则返回的 CSSStyleDeclaration 是一个类型选择器,适用于该类型的所有实例。例如,类型选择器 "Button"
适用于 Button 及其子类的所有实例。
global
选择器和类型选择器相似,不以英文句号开头。
参数
selector:String — CSS 选择器的名称。
|
CSSStyleDeclaration — 其名称和 selector 属性匹配的样式声明。
|
getStyleManager | () | 方法 |
public static function getStyleManager(moduleFactory:IFlexModuleFactory):IStyleManager2
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回对象的样式管理器。
参数
moduleFactory:IFlexModuleFactory — 您希望为其管理样式的对象的模块工厂。若为 null,将返回顶级样式管理器。
|
IStyleManager2 — 给定模块工厂的样式管理器。
|
isColorName | () | 方法 |
public static function isColorName(colorName:String):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
测试以查看给定的字符串是否为颜色值的别名。例如,默认情况下,字符串“blue”是 0x0000FF 的别名。
参数
colorName:String — 要测试的颜色名。该参数不区分大小写。
|
Boolean — 如果 colorName 为颜色的别名,则返回 true 。
|
isInheritingStyle | () | 方法 |
public static function isInheritingStyle(styleName:String):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
测试以查看样式是否为继承。
参数
styleName:String — 测试以查看其是否为继承的样式的名称。
|
Boolean — 如果指定的样式为继承,则返回 true 。
|
isInheritingTextFormatStyle | () | 方法 |
public static function isInheritingTextFormatStyle(styleName:String):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
测试以查看 TextFormat 样式是否为继承。
参数
styleName:String — 测试以查看其是否为继承的样式的名称。
|
Boolean — 如果指定的 TextFormat 样式为继承,则返回 true 。
|
isParentDisplayListInvalidatingStyle | () | 方法 |
public static function isParentDisplayListInvalidatingStyle(styleName:String):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
测试以查看该样式是否影响组件的父容器,如当该样式更改时要求父容器重绘自身。
当使用 setStyle()
设置这些样式之一时,将对该组件的父容器自动调用 invalidateDisplayList()
方法,以使其重绘和/或重新布局其子项。
参数
styleName:String — 要测试的样式的名称。
|
Boolean — 如果指定的样式可能影响组件父容器的外观或布局,则返回 true 。
|
isParentSizeInvalidatingStyle | () | 方法 |
public static function isParentSizeInvalidatingStyle(styleName:String):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
测试以查看样式是否更改组件父容器的大小。
当使用 setStyle()
设置这些样式之一时,将对该组件的父容器自动调用 invalidateSize()
方法,以便在以后重新计算其测量大小。
参数
styleName:String — 要测试的样式的名称。
|
Boolean — 如果指定的样式可能影响组件父容器的测量大小,则返回 true 。
|
isSizeInvalidatingStyle | () | 方法 |
public static function isSizeInvalidatingStyle(styleName:String):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
测试以查看样式是否更改组件的大小。
当使用 setStyle()
方法设置这些样式之一时,将对该组件自动调用 invalidateSize()
方法,以便在以后重新计算其测量大小。
参数
styleName:String — 要测试的样式的名称。
|
Boolean — 如果指定的样式可能影响组件的测量大小,则返回 true 。
|
isValidStyleValue | () | 方法 |
public static function isValidStyleValue(value:*):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
确定指定的参数是否为有效的样式属性。例如:
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
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
加载样式 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 实现。
|
相关 API 元素
registerColorName | () | 方法 |
public static function registerColorName(colorName:String, colorValue:uint):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将颜色名添加到颜色别名列表。
参数
colorName:String — 要添加到列表的颜色的名称,如“blue”。如果以后访问该颜色名,该值不区分大小写。
| |
colorValue:uint — 颜色值,例如 0x0000FF。
|
registerInheritingStyle | () | 方法 |
public static function registerInheritingStyle(styleName:String):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
添加到可从其父级中继承值的样式列表。
注意:请确保避免使用重复的样式名称,因为如果已使用的样式变为继承,命名冲突将导致性能降低。
参数
styleName:String — 添加到可继承值的样式列表中的样式名称。
|
registerParentDisplayListInvalidatingStyle | () | 方法 |
public static function registerParentDisplayListInvalidatingStyle(styleName:String):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
添加到可能影响组件父容器的外观或布局的样式列表。当使用 setStyle()
设置这些样式之一时,将对该组件的父容器自动调用 invalidateDisplayList()
方法,以使其重绘和/或重新布局其子项。
参数
styleName:String — 要注册的样式的名称。
|
registerParentSizeInvalidatingStyle | () | 方法 |
public static function registerParentSizeInvalidatingStyle(styleName:String):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
添加到可能影响组件父容器的测量大小的样式列表。
当使用 setStyle()
设置这些样式之一时,将对该组件的父容器自动调用 invalidateSize()
方法,以便在以后重新计算其测量大小。
参数
styleName:String — 要注册的样式的名称。
|
registerSizeInvalidatingStyle | () | 方法 |
public static function registerSizeInvalidatingStyle(styleName:String):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
添加到可能影响组件的测量大小的样式列表。当使用 setStyle()
设置这些样式之一时,将对该组件自动调用 invalidateSize()
方法,以便在以后重新计算其测量大小。
参数
styleName:String — 添加到列表的样式的名称。
|
setStyleDeclaration | () | 方法 |
public static function setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
设置存储指定 CSS 选择器规则的 CSSStyleDeclaration 对象。
如果 selector
参数以英文句号 (.) 开头,则指定的选择器是一个“类选择器”,只适用于那些其 styleName
属性指定了该选择器(不包括英文句号)的实例。例如,类选择器 ".bigMargins"
适用于任何 styleName
为 "bigMargins"
的 UIComponent。
如果 selector
参数不以英文句号开头,则指定的选择器是一个“类型选择器”,适用于该类型的所有实例。例如,类型选择器 "Button"
适用于 Button 及其子类的所有实例。
global
选择器和类型选择器相似,不以英文句号开头。
参数
selector:String — CSS 选择器的名称。
| |
styleDeclaration:CSSStyleDeclaration — 新样式声明。
| |
update:Boolean — 设置为 true 以强制立即更新样式;在内部,Flex 调用 UIComponent 的 styleChanged() 方法。设置为 false 以避免立即更新应用程序中的样式。
样式将在下一次调用以下方法之一并且
通常,如果多次调用这些方法中的一种,只需在最后一次调用时将该属性设置为 如果调用 |
unloadStyleDeclarations | () | 方法 |
public static function unloadStyleDeclarations(url:String, update:Boolean = true):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
卸载样式 SWF。
参数
url:String — 样式 SWF 的位置。
| |
update:Boolean (default = true ) — 设置为 true 以强制立即更新样式。设置为 false 以避免立即更新应用程序中的样式。有关该方法的详细信息,请参阅 setStyleDeclaration() 方法中的说明。
|
相关 API 元素
NOT_A_COLOR | 常量 |
public static const NOT_A_COLOR:uint = 0xFFFFFFFF
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
如果传入的字符串不是合法的颜色名,getColorName()
方法将返回该值。
Tue Jun 12 2018, 11:04 AM Z