| 套件 | mx.styles |
| 類別 | public class AdvancedStyleClient |
| 繼承 | AdvancedStyleClient  EventDispatcher Object |
| 實作 | IAdvancedStyleClient, IFlexModule, IMXMLObject |
| 子類別 | GlobalizationBase, Sort, SortField |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
IAdvancedStyleClient interface. The base class supplies
implementations of the methods and properties required for an object
to participate in the style subsystem.
In addition to the IAdvancedStyleClient interface,
this object also implements the IFlexModule and
IMXMLObject interfaces. The IMXMLObject
interface contains an initialized method that is called
when the class is instantiated using an MXML declaration.
The implementation of the initialized method provided
by this base class will add the class instance to the document object
that contains the MXML declaration. For more details, see the description
of the initilized method.
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| className : String [唯讀]
The name of the component class. | AdvancedStyleClient | ||
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| id : String
The identity of the component. | AdvancedStyleClient | ||
| inheritingStyles : Object
An object containing the inheritable styles for this non-visual
style client instance. | AdvancedStyleClient | ||
| moduleFactory : IFlexModuleFactory
A module factory is used as context for
finding the style manager that controls the styles for this
non-visual style client instance. | AdvancedStyleClient | ||
| nonInheritingStyles : Object
The beginning of this component's chain of non-inheriting styles. | AdvancedStyleClient | ||
| styleDeclaration : CSSStyleDeclaration
The style declaration that holds the inline styles declared by this
object. | AdvancedStyleClient | ||
| styleManager : IStyleManager2 [唯讀]
Returns the StyleManager instance used by this component. | AdvancedStyleClient | ||
| styleName : Object
The source of this object's style values. | AdvancedStyleClient | ||
| styleParent : IAdvancedStyleClient
A component's parent is used to evaluate descendant selectors. | AdvancedStyleClient | ||
| 方法 | 定義自 | ||
|---|---|---|---|
Constructor. | AdvancedStyleClient | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
Deletes a style property from this component instance. | AdvancedStyleClient | ||
|
會將事件傳送到事件流程。 | EventDispatcher | |
Returns an Array of CSSStyleDeclaration objects for the type selector
that applies to this component, or null if none exist. | AdvancedStyleClient | ||
Gets a style property that has been set anywhere in this
component's style lookup chain. | AdvancedStyleClient | ||
Returns true if currentCSSState is not null. | AdvancedStyleClient | ||
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
The initialized method is called when this class or a class that
extends this class is used in an MXML declaration. | AdvancedStyleClient | ||
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
Returns true if cssState matches currentCSSState. | AdvancedStyleClient | ||
Determines whether this instance is the same as, or is a subclass of,
the given type. | AdvancedStyleClient | ||
Propagates style changes to the children of this style client
instance. | AdvancedStyleClient | ||
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
Sets up the internal style cache values so that the
getStyle()
method functions. | AdvancedStyleClient | ||
Registers the EffectManager as one of the event listeners
for each effect event. | AdvancedStyleClient | ||
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
Sets a style property on this component instance. | AdvancedStyleClient | ||
Detects changes to style properties. | AdvancedStyleClient | ||
Flex calls the stylesInitialized() method when
the styles for a component are first initialized. | AdvancedStyleClient | ||
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
className | 屬性 |
id | 屬性 |
inheritingStyles | 屬性 |
moduleFactory | 屬性 |
moduleFactory:IFlexModuleFactory| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
A module factory is used as context for finding the style manager that controls the styles for this non-visual style client instance.
實作
public function get moduleFactory():IFlexModuleFactory public function set moduleFactory(value:IFlexModuleFactory):voidnonInheritingStyles | 屬性 |
nonInheritingStyles:Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
The beginning of this component's chain of non-inheriting styles.
The getStyle() method simply accesses
nonInheritingStyles[styleName] to search the entire
prototype-linked chain.
This object is set up by initProtoChain().
Developers typically never need to access this property directly.
實作
public function get nonInheritingStyles():Object public function set nonInheritingStyles(value:Object):voidstyleDeclaration | 屬性 |
styleDeclaration:CSSStyleDeclaration| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
The style declaration that holds the inline styles declared by this object.
實作
public function get styleDeclaration():CSSStyleDeclaration public function set styleDeclaration(value:CSSStyleDeclaration):void相關 API 元素
styleManager | 屬性 |
styleManager:IStyleManager2 [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Returns the StyleManager instance used by this component.
實作
public function get styleManager():IStyleManager2styleName | 屬性 |
styleName:Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
The source of this object's style values.
The value of the styleName property can be one of three possible types:
- String, such as "headerStyle". The String names a class selector that is defined in a CSS style sheet.
- CSSStyleDeclaration, such as
StyleManager.getStyleDeclaration(".headerStyle"). - UIComponent. The object that implements this interface inherits all the style values from the referenced UIComponent.
實作
public function get styleName():Object public function set styleName(value:Object):voidstyleParent | 屬性 |
styleParent:IAdvancedStyleClient| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
A component's parent is used to evaluate descendant selectors. A parent must also be an IAdvancedStyleClient to participate in advanced style declarations.
實作
public function get styleParent():IAdvancedStyleClient public function set styleParent(value:IAdvancedStyleClient):voidAdvancedStyleClient | () | 建構函式 |
public function AdvancedStyleClient()| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Constructor.
clearStyle | () | 方法 |
getClassStyleDeclarations | () | 方法 |
public function getClassStyleDeclarations():Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Returns an Array of CSSStyleDeclaration objects for the type selector
that applies to this component, or null if none exist.
For example, suppose that component MyButton extends Button. This method first looks for a MyButton selector; then, it looks for a Button type selector; finally, it looks for a UIComponent type selector.
傳回值Array — Array of CSSStyleDeclaration objects.
|
getStyle | () | 方法 |
public function getStyle(styleProp:String):*| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Gets a style property that has been set anywhere in this component's style lookup chain.
This same method is used to get any kind of style property, so the value returned may be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is specified as *.
If you are getting a particular style property, you will
know its type and will often want to store the result in a
variable of that type. You can use either the as
operator or coercion to do this. For example:
var backgroundColor:uint = getStyle("backgroundColor") as int;
or
var backgroundColor:uint = int(getStyle("backgroundColor"));
If the style property has not been set anywhere in the
style lookup chain, the value returned by the getStyle() method
is undefined.
Note that undefined is a special value that is
not the same as false, the empty String (""),
NaN, 0, or null.
No valid style value is ever undefined.
You can use the static method
StyleManager.isValidStyleValue()
to test whether the value was set.
參數
styleProp:String — Name of the style property.
|
* — Style value.
|
hasCSSState | () | 方法 |
public function hasCSSState():Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.6 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Returns true if currentCSSState is not null.
Typically, you do not call this method directly.
It is called by the mx.styles.CSSCondition.matchesStyleClient() method.
Note Spark components use their skin state as the pseudo state.
Halo components use the currentState property.
Boolean — true if currentCSSState is not null.
By default, currentCSSState is the same as currentState.
If no state exists, return false.
|
initialized | () | 方法 |
public function initialized(document:Object, id:String):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
The initialized method is called when this class or a class that extends this class is used in an MXML declaration. It is called after the implementing object has been created and all component properties specified on the MXML tag have been initialized.
If the document that created this object is a UIComponent,
(e.g. Application, Module, etc.) then the UIComponent's
addStyleClient method will be called to add this object to the
UIComponent's list of non-visual style clients. This allows the
object to inherit styles from the document.
參數
document:Object — The MXML document that created this object.
| |
id:String — The identifier used by the document object to refer to
this object.
|
matchesCSSState | () | 方法 |
public function matchesCSSState(cssState:String):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Returns true if cssState matches currentCSSState.
Typically, you do not call this method directly.
It is called by the mx.styles.CSSCondition.matchesStyleClient() method.
Note Spark components use their skin state as the pseudo state.
Halo components use the currentState property.
參數
cssState:String — A possible value of CSSCondition.value.
It represents the current state of this component used to match CSS pseudo-selectors.
|
Boolean — true if cssState matches currentCSSState.
By default, currentCSSState is the same as currentState.
If no state exists, return null.
|
matchesCSSType | () | 方法 |
public function matchesCSSType(cssType:String):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Determines whether this instance is the same as, or is a subclass of,
the given type.
Typically, you do not call this method directly.
It is called by the mx.styles.CSSCondition.matchesStyleClient() method.
參數
cssType:String — A CSSSelector object.
|
Boolean — true if cssType is in the hierarchy of qualified type selectors.
|
notifyStyleChangeInChildren | () | 方法 |
public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Propagates style changes to the children of this style client instance. A non-visual style client (i.e. a style client that is not a DisplayObject) does not have children, therefore this method does not do anything for non-visual style clients.
參數
styleProp:String — Name of the style property.
| |
recursive:Boolean — Whether to propagate the style changes to the
children's children.
|
regenerateStyleCache | () | 方法 |
registerEffects | () | 方法 |
setStyle | () | 方法 |
public function setStyle(styleProp:String, newValue:*):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Sets a style property on this component instance.
This may override a style that was set globally.
Calling the setStyle() method can result in decreased performance.
Use it only when necessary.
參數
styleProp:String — Name of the style property.
| |
newValue:* — New value for the style.
|
styleChanged | () | 方法 |
public function styleChanged(styleProp:String):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Detects changes to style properties. When any style property is set,
Flex calls the styleChanged() method,
passing to it the name of the style being set.
This is an advanced method that you might override
when creating a subclass of AdvancedStyleClient.
When you create a custom class,
you can override the styleChanged() method
to check the style name passed to it, and handle the change
accordingly.
This lets you override the default behavior of an existing style,
or add your own custom style properties.
參數
styleProp:String — The name of the style property, or null if all
styles for this
style client have changed.
|
stylesInitialized | () | 方法 |
public function stylesInitialized():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4.5 |
| 執行階段版本: | Flash Player 10, AIR 2.5 |
Flex calls the stylesInitialized() method when
the styles for a component are first initialized.
Tue Jun 12 2018, 03:47 PM Z