CSSStyleDeclaration

套件	mx.styles
類別	public class CSSStyleDeclaration
繼承	CSSStyleDeclaration EventDispatcher Object
子類別	AdvancedDataGridColumn, DataGridColumn

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The CSSStyleDeclaration class represents a set of CSS style rules. The MXML compiler automatically generates one CSSStyleDeclaration object for each selector in the CSS files associated with a Flex application.

A CSS rule such as

      Button { color: #FF0000 }

affects every instance of the Button class; a selector like Button is called a type selector and must not start with a dot.

A CSS rule such as

      .redButton { color: #FF0000 }

affects only components whose styleName property is set to "redButton"; a selector like .redButton is called a class selector and must start with a dot.

You can access the autogenerated CSSStyleDeclaration objects using the StyleManager.getStyleDeclaration() method, passing it either a type selector

  var buttonDeclaration:CSSStyleDeclaration =
      StyleManager.getStyleDeclaration("Button");

or a class selector

  var redButtonStyleDeclaration:CSSStyleDeclaration =
      StyleManager.getStyleDeclaration(".redButton");

You can use the getStyle(), setStyle(), and clearStyle() methods to get, set, and clear style properties on a CSSStyleDeclaration.

You can also create and install a CSSStyleDeclaration at run time using the StyleManager.setStyleDeclaration() method:

  var newStyleDeclaration:CSSStyleDeclaration = new CSSStyleDeclaration(".bigMargins");
  newStyleDeclaration.defaultFactory = function():void
  {
      leftMargin = 50;
      rightMargin = 50;
  }
  StyleManager.setStyleDeclaration(".bigMargins", newStyleDeclaration, true);

更多範例

Using the StyleManager class

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		defaultFactory : Function This function, if it isn't null, is usually autogenerated by the MXML compiler.	CSSStyleDeclaration
		factory : Function This function, if it isn't null, is usually autogenerated by the MXML compiler.	CSSStyleDeclaration
		overrides : Object If the setStyle() method is called on a UIComponent or CSSStyleDeclaration at run time, this object stores the name/value pairs that were set; they override the name/value pairs in the objects produced by the methods specified by the defaultFactory and factory properties.	CSSStyleDeclaration
		selector : CSSSelector This property is the base selector of a potential chain of selectors and conditions that are used to match CSS style declarations to components.	CSSStyleDeclaration
		selectorIndex : int = 0 The order this CSSStyleDeclaration was added to its StyleManager.	CSSStyleDeclaration
		specificity : int [唯讀] Determines the order of precedence when applying multiple style declarations to a component.	CSSStyleDeclaration
		subject : String [唯讀] The subject describes the name of a component that may be a potential match for this style declaration.	CSSStyleDeclaration

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		CSSStyleDeclaration(selector:Object = null, styleManager:IStyleManager2 = null, autoRegisterWithStyleManager:Boolean = true) Constructor.	CSSStyleDeclaration
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		clearStyle(styleProp:String):void Clears a style property on this CSSStyleDeclaration.	CSSStyleDeclaration
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		getStyle(styleProp:String):* Gets the value for a specified style property, as determined solely by this CSSStyleDeclaration.	CSSStyleDeclaration
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		matchesStyleClient(object:IAdvancedStyleClient):Boolean Determines whether this style declaration applies to the given component based on a match of the selector chain.	CSSStyleDeclaration
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		setStyle(styleProp:String, newValue:*):void Sets a style property on this CSSStyleDeclaration.	CSSStyleDeclaration
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	事件		摘要	定義自
		activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
		deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher

屬性詳細資訊

defaultFactory

屬性

defaultFactory:Function

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

This function, if it isn't null, is usually autogenerated by the MXML compiler. It produce copies of a plain Object, such as { leftMargin: 10, rightMargin: 10 }, containing name/value pairs for style properties; the object is used to build a node of the prototype chain for looking up style properties.

If this CSSStyleDeclaration is owned by a UIComponent written in MXML, this function encodes the style attributes that were specified on the root tag of the component definition.

If the UIComponent was written in ActionScript, this property is null.

實作
public function get defaultFactory():Function
public function set defaultFactory(value:Function):void

factory

屬性

factory:Function

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

If this CSSStyleDeclaration is owned by a UIComponent, this function encodes the style attributes that were specified in MXML for an instance of that component.

實作
public function get factory():Function
public function set factory(value:Function):void

overrides

屬性

overrides:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

If the setStyle() method is called on a UIComponent or CSSStyleDeclaration at run time, this object stores the name/value pairs that were set; they override the name/value pairs in the objects produced by the methods specified by the defaultFactory and factory properties.

實作
public function get overrides():Object
public function set overrides(value:Object):void

selector

屬性

selector:CSSSelector

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

This property is the base selector of a potential chain of selectors and conditions that are used to match CSS style declarations to components.

實作
public function get selector():CSSSelector
public function set selector(value:CSSSelector):void

selectorIndex

屬性

public var selectorIndex:int = 0

The order this CSSStyleDeclaration was added to its StyleManager. MatchStyleDeclarations has to return the declarations in the order they were declared

specificity

屬性

specificity:int [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Determines the order of precedence when applying multiple style declarations to a component. If style declarations are of equal precedence, the last one wins.

實作
public function get specificity():int

subject

屬性

subject:String [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The subject describes the name of a component that may be a potential match for this style declaration. The subject is determined as right most simple type selector in a potential chain of selectors.

實作
public function get subject():String

建構函式詳細資料

()

建構函式

public function CSSStyleDeclaration(selector:Object = null, styleManager:IStyleManager2 = null, autoRegisterWithStyleManager:Boolean = true)

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Constructor.

參數

	`selector:Object` (default = `null`) — - If the selector is a CSSSelector then advanced CSS selectors are supported. If a String is used for the selector then only simple CSS selectors are supported. If the String starts with a dot it is interpreted as a universal class selector, otherwise it must represent a simple type selector. If not null, this CSSStyleDeclaration will be registered with StyleManager.

	`styleManager:IStyleManager2` (default = `null`) — - The style manager to set this declaration into. If the styleManager is null the top-level style manager will be used.

	`autoRegisterWithStyleManager:Boolean` (default = `true`) — - If true set the selector in the styleManager. The selector will only be set if both `selector` and `styleManager` are both non-null.

方法詳細資訊

clearStyle

()

方法

public function clearStyle(styleProp:String):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Clears a style property on this CSSStyleDeclaration. This is the same as setting the style value to undefined.

參數

styleProp:String — The name of the style property.

getStyle

()

方法

public function getStyle(styleProp:String):*

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Gets the value for a specified style property, as determined solely by this CSSStyleDeclaration.

The returned value may be of any type.

The values null, "", false, NaN, and 0 are all valid style values, but the value undefined is not; it indicates that the specified style is not set on this CSSStyleDeclaration. You can use the method StyleManager.isValidStyleValue() to test the value that is returned.

參數

styleProp:String — The name of the style property.

傳回值

* — The value of the specified style property if set, or undefined if not.

matchesStyleClient

()

方法

public function matchesStyleClient(object:IAdvancedStyleClient):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Determines whether this style declaration applies to the given component based on a match of the selector chain.

參數

object:IAdvancedStyleClient — The component to match the style declaration against.

傳回值

Boolean — true if this style declaration applies to the component, otherwise false.

setStyle

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Sets a style property on this CSSStyleDeclaration.

參數

	`styleProp:String` — The name of the style property.

	`newValue:*` — The value of the style property. The value may be of any type. The values `null`, `""`, `false`, `NaN`, and `0` are all valid style values, but the value `undefined` is not. Setting a style property to the value `undefined` is the same as calling the `clearStyle()` method.

法律聲明 | 線上隱私權政策

CSSStyleDeclaration - AS3 Flex

類別 x

defaultFactory

factory

overrides

selector

selectorIndex

specificity

subject