IStyleClient - Adobe ActionScript® 3 (AS3 Flex) API 参考

包	mx.styles
接口	public interface IStyleClient extends ISimpleStyleClient
实现器	AdvancedDataGridItemRenderer, DataGridItemRenderer, DefaultGridItemRenderer, FTEAdvancedDataGridItemRenderer, FTEDataGridItemRenderer, HaloFocusRect, UITextFieldGridItemRenderer

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

该接口描述了对象要完全参与样式子系统所必须实现的属性和方法。该接口由 UIComponent 实现。

如果对象不需要在本地存储样式值，则该对象可改为实现 ISimpleStyleClient 接口。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		className : String [只读] 组件类的名称。	IStyleClient
		inheritingStyles : Object 包含此组件的可继承样式的对象。	IStyleClient
		nonInheritingStyles : Object 包含此组件的不可继承样式的对象。	IStyleClient
		styleDeclaration : CSSStyleDeclaration 具有此对象声明的内嵌样式的样式声明。	IStyleClient
		styleName : Object 该对象的样式值的源。	ISimpleStyleClient

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		clearStyle(styleProp:String):void 删除此组件实例的样式属性。	IStyleClient
		getClassStyleDeclarations():Array 为应用于该组件的类型选择器返回 CSSStyleDeclaration 对象数组，如果不存在则返回 null。	IStyleClient
		getStyle(styleProp:String):* 获取已在此组件的样式查找链中的某个位置设置过的样式属性。	IStyleClient
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void 向该组件的子项传送样式更改。	IStyleClient
		regenerateStyleCache(recursive:Boolean):void 设置内部样式缓存值，以便 getStyle() 方法可以起作用。	IStyleClient
		registerEffects(effects:Array):void 将 EffectManager 注册为每个效果事件的事件侦听器之一。	IStyleClient
		setStyle(styleProp:String, newValue:*):void 对此组件实例设置样式属性。	IStyleClient
		styleChanged(styleProp:String):void 当样式属性的值发生更改时调用。	ISimpleStyleClient

属性详细信息

className

属性

className:String [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件类的名称。

实现
public function get className():String

inheritingStyles

属性

inheritingStyles:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

包含此组件的可继承样式的对象。

实现
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void

nonInheritingStyles

属性

nonInheritingStyles:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

包含此组件的不可继承样式的对象。

实现
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void

styleDeclaration

属性

styleDeclaration:CSSStyleDeclaration

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

具有此对象声明的内嵌样式的样式声明。

实现
public function get styleDeclaration():CSSStyleDeclaration
public function set styleDeclaration(value:CSSStyleDeclaration):void

clearStyle

()

方法

public function clearStyle(styleProp:String):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

删除此组件实例的样式属性。

此操作不一定会使 getStyle() 方法返回 undefined。

参数

styleProp:String — 样式属性的名称。

getClassStyleDeclarations

()

方法

public function getClassStyleDeclarations():Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

为应用于该组件的类型选择器返回 CSSStyleDeclaration 对象数组，如果不存在则返回 null。

例如，假定组件 MyButton 扩展了 Button。该方法首先查找 MyButton 选择器；然后查找 Button 类型选择器；最后查找 UIComponent 类型选择器。

Array — CSSStyleDeclaration 对象数组。

getStyle

()

方法

public function getStyle(styleProp:String):*

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

获取已在此组件的样式查找链中的某个位置设置过的样式属性。

因为此方法同样可用于获取任何类型的样式属性，所以返回值可能是 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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

向该组件的子项传送样式更改。

参数

	`styleProp:String` — 样式属性的名称。

	`recursive:Boolean` — 是否将样式更改传播到子项的子项。

regenerateStyleCache

()

方法

public function regenerateStyleCache(recursive:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置内部样式缓存值，以便 getStyle() 方法可以起作用。如果该对象已有子项，则重新初始化子项的样式缓存。

参数

recursive:Boolean — 重新生成子项的原始链。

registerEffects

()

方法

public function registerEffects(effects:Array):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将 EffectManager 注册为每个效果事件的事件侦听器之一。

参数

effects:Array — 效果名称的字符串 Array。

setStyle

()

方法

public function setStyle(styleProp:String, newValue:*):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对此组件实例设置样式属性。

这可能会覆盖以全局方式设置的样式。

调用 setStyle() 方法会降低性能。仅在必要时才使用它。

参数

	`styleProp:String` — 样式属性的名称。

	`newValue:*` — 样式的新值。

法律声明 | 在线隐私策略

IStyleClient - AS3 Flex

类 x

className

inheritingStyles

nonInheritingStyles

styleDeclaration

clearStyle

getClassStyleDeclarations

getStyle

notifyStyleChangeInChildren

regenerateStyleCache

registerEffects

setStyle