包 | mx.styles |
类 | public class StyleProxy |
继承 | StyleProxy Object |
实现 | IStyleClient |
filterMap
属性,该属性包含样式源/样式目标对。
另请参见
属性 | 定义方 | ||
---|---|---|---|
className : String [只读 (read-only)] 组件类的名称。 | StyleProxy | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
filterMap : Object 一组字符串对。 | StyleProxy | ||
inheritingStyles : Object 包含此组件的可继承样式的对象。 | StyleProxy | ||
nonInheritingStyles : Object 包含此组件的不可继承样式的对象。 | StyleProxy | ||
prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | ||
source : IStyleClient 实现 IStyleClient 接口的对象。 | StyleProxy | ||
styleDeclaration : CSSStyleDeclaration 该对象使用的样式声明。 | StyleProxy | ||
styleName : Object 该对象的样式值的源。 | StyleProxy |
方法 | 定义方 | ||
---|---|---|---|
构造函数。 | StyleProxy | ||
删除此组件实例中的样式属性。 | StyleProxy | ||
为应用于该组件的类型选择器返回 CSSStyleDeclaration 对象数组,如果不存在则返回 null。 | StyleProxy | ||
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | StyleProxy | ||
指示对象是否已经定义了指定的属性。 | Object | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
向该组件的子项传送样式更改。 | StyleProxy | ||
指示指定的属性是否存在、是否可枚举。 | Object | ||
设置内部样式缓存值,以便 getStyle() 方法可以起作用。 | StyleProxy | ||
将 EffectManager 注册为每个效果事件的事件侦听器之一。 | StyleProxy | ||
设置循环操作动态属性的可用性。 | Object | ||
对此组件实例设置样式属性。 | StyleProxy | ||
当样式属性的值发生更改时调用。 | StyleProxy | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object |
className | 属性 |
filterMap | 属性 |
filterMap:Object
[读写] 一组字符串对。字符串对的第一项是源组件中样式的名称。字符串对的第二项是子组件中样式的名称。使用该对象,可以将父组件中的特定样式映射到子组件中的不同样式。如果父组件和子组件共享同一个样式,这将非常有用。但是,您可能希望单独控制这些值。
public function get filterMap():Object
public function set filterMap(value:Object):void
inheritingStyles | 属性 |
inheritingStyles:Object
[读写] 包含此组件的可继承样式的对象。
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
nonInheritingStyles | 属性 |
nonInheritingStyles:Object
[读写] 包含此组件的不可继承样式的对象。
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
source | 属性 |
source:IStyleClient
[读写] 实现 IStyleClient 接口的对象。这是被代理的对象。
public function get source():IStyleClient
public function set source(value:IStyleClient):void
styleDeclaration | 属性 |
styleDeclaration:CSSStyleDeclaration
[读写] 该对象使用的样式声明。
public function get styleDeclaration():CSSStyleDeclaration
public function set styleDeclaration(value:CSSStyleDeclaration):void
styleName | 属性 |
styleName:Object
[读写]
该对象的样式值的源。styleName
属性的值可以是以下三种可能类型之一:
StyleManager.getStyleDeclaration(".headerStyle")
。
public function get styleName():Object
public function set styleName(value:Object):void
StyleProxy | () | 构造函数 |
public function StyleProxy(source:IStyleClient, filterMap:Object)
构造函数。
参数source:IStyleClient — 实现 IStyleClient 接口的对象。 | |
filterMap:Object — 从源传递到子组件的一组样式。 |
clearStyle | () | 方法 |
public function clearStyle(styleProp:String):void
删除此组件实例中的样式属性。
此操作不一定会使 getStyle()
方法返回 undefined
。
参数
styleProp:String — 样式属性的名称。 |
getClassStyleDeclarations | () | 方法 |
public function getClassStyleDeclarations():Array
为应用于该组件的类型选择器返回 CSSStyleDeclaration 对象数组,如果不存在则返回 null
。
例如,假定组件 MyButton 扩展了 Button。该方法首先查找 MyButton 选择器;然后查找 Button 类型选择器;最后查找 UIComponent 类型选择器。
返回Array — CSSStyleDeclaration 对象数组。 |
getStyle | () | 方法 |
public function getStyle(styleProp:String):*
获取已在此组件的样式查找链中的某个位置设置过的样式属性。
因为此方法同样可用于获取任何类型的样式属性,所以返回值可能是 Boolean、String、Number、int、uint(用于 RGB 颜色)、Class(用于外观)或任何类型的对象。因此,返回类型被指定为 *。
如果要获取特定的样式属性,您需要了解其类型,而且通常希望将结果存储在该类型的某个变量中。可以使用 as
运算符或强制来完成。例如:
var backgroundColor:uint = getStyle("backgroundColor") as int; or var backgroundColor:uint = int(getStyle("backgroundColor"));
如果在样式查找链中的任何位置都未设置样式属性,则 getStyle()
方法的返回值为 undefined
。请注意,undefined
是一个特殊值,它与 false
、空字符串 (""
)、NaN
、0 或 null
不同。如果没有有效的样式值,则总是 undefined
。可以使用静态方法 StyleManager.isValidStyleValue()
来测试是否设置了值。
参数
styleProp:String — 样式属性的名称。 |
* — 样式值。 |
notifyStyleChangeInChildren | () | 方法 |
public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void
向该组件的子项传送样式更改。
参数
styleProp:String — 样式属性的名称。 | |
recursive:Boolean — 是否将样式更改传播到子项的子项。 |
regenerateStyleCache | () | 方法 |
public function regenerateStyleCache(recursive:Boolean):void
设置内部样式缓存值,以便 getStyle()
方法可以起作用。如果该对象已有子项,则重新初始化子项的样式缓存。
参数
recursive:Boolean — 重新生成子项的原始链。 |
registerEffects | () | 方法 |
public function registerEffects(effects:Array):void
将 EffectManager 注册为每个效果事件的事件侦听器之一。
参数
effects:Array — 效果名称的字符串 Array。 |
setStyle | () | 方法 |
public function setStyle(styleProp:String, newValue:*):void
对此组件实例设置样式属性。
这可能会覆盖以全局方式设置的样式。
调用 setStyle()
方法会降低性能。仅在必要时才使用它。
参数
styleProp:String — 样式属性的名称。 | |
newValue:* — 样式的新值。 |
styleChanged | () | 方法 |
public function styleChanged(styleProp:String):void
当样式属性的值发生更改时调用。
参数
styleProp:String — 所更改的样式属性的名称。 |