| 套件 | mx.styles |
| 類別 | public class StyleManager |
| 繼承 | StyleManager  Object |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
- Which CSS style properties the class inherits
- Which style properties are colors, and therefore get special handling
- A list of strings that are aliases for color values
更多範例
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| selectors : Array 從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.selectors on a style manager instance [靜態] [唯讀]
Returns an Array of all the CSS selectors that are registered with the StyleManager. | StyleManager | ||
| 方法 | 定義自 | ||
|---|---|---|---|
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.clearStyleDeclaration on a style manager instance [靜態]
Clears the CSSStyleDeclaration object that stores the rules
for the specified CSS selector. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.getColorName on a style manager instance [靜態]
Returns the numeric RGB color value that corresponds to the
specified color string. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.getColorNames on a style manager instance [靜態]
Converts each element of the colors Array from a color name
to a numeric RGB color value. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.getStyleDeclaration on a style manager instance [靜態]
Gets the CSSStyleDeclaration object that stores the rules
for the specified CSS selector. | StyleManager | ||
[靜態]
Returns the style manager for an object. | StyleManager | ||
|
指出物件是否有已定義的指定屬性。 | Object | |
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.isColorName on a style manager instance [靜態]
Tests to see if the given String is an alias for a color value. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.isInheritingStyle on a style manager instance [靜態]
Tests to see if a style is inheriting. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.isInheritingTextFormatStyle on a style manager instance [靜態]
Test to see if a TextFormat style is inheriting. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.isParentDisplayListInvalidatingStyle on a style manager instance [靜態]
Tests to see if this style affects the component's parent container in
such a way as to require that the parent container redraws itself when this style changes. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.isParentSizeInvalidatingStyle on a style manager instance [靜態]
Tests to see if the style changes the size of the component's parent container. | StyleManager | ||
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.isSizeInvalidatingStyle on a style manager instance [靜態]
Tests to see if a style changes the size of a component. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.isValidStyleValue on a style manager instance [靜態]
Determines if a specified parameter is a valid style property. | 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 [靜態]
Loads a style SWF. | StyleManager | ||
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.registerColorName on a style manager instance [靜態]
Adds a color name to the list of aliases for colors. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.registerInheritingStyle on a style manager instance [靜態]
Adds to the list of styles that can inherit values
from their parents. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.registerParentDisplayListInvalidatingStyle on a style manager instance [靜態]
Adds to the list of styles which may affect the appearance
or layout of the component's parent container. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.registerParentSizeInvalidatingStyle on a style manager instance [靜態]
Adds to the list of styles which may affect the measured size
of the component's parent container. | StyleManager | ||
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.registerSizeInvalidatingStyle on a style manager instance [靜態]
Adds to the list of styles which may affect the measured size
of the component. | StyleManager | ||
|
為迴圈作業設定動態屬性的可用性。 | Object | |
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.setStyleDeclaration on a style manager instance [靜態]
Sets the CSSStyleDeclaration object that stores the rules
for the specified CSS selector. | StyleManager | ||
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
從下列版本以後不建議使用： 4.0: 請使用 IStyleManager2.unloadStyleDeclarations on a style manager instance [靜態]
Unloads a style SWF. | StyleManager | ||
|
會傳回指定之物件的基本值。 | Object | |
| 常數 | 定義自 | ||
|---|---|---|---|
| NOT_A_COLOR : uint = 0xFFFFFFFF [靜態]
The getColorName() method returns this value if the passed-in
String is not a legitimate color name. | StyleManager | ||
selectors | 屬性 |
selectors:Array [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns an Array of all the CSS selectors that are registered with the StyleManager.
You can pass items in this Array to the getStyleDeclaration() method to get the corresponding CSSStyleDeclaration object.
Class selectors are prepended with a period.
實作
public static function get selectors():ArrayclearStyleDeclaration | () | 方法 |
public static function clearStyleDeclaration(selector:String, update:Boolean):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Clears the CSSStyleDeclaration object that stores the rules for the specified CSS selector.
If the specified selector is a class selector (for example, ".bigMargins" or ".myStyle"),
you must be sure to start the
selector property with a period (.).
If the specified selector is a type selector (for example, "Button"), do not start the
selector property with a period.
The global selector is similar to a type selector
and does not start with a period.
參數
selector:String — The name of the CSS selector to clear.
| |
update:Boolean — Set to true to force an immediate update of the styles.
Set to false to avoid an immediate update of the styles in the application.
For more information about this method, see the description in the setStyleDeclaration()
method.
|
相關 API 元素
getColorName | () | 方法 |
public static function getColorName(colorName:Object):uint| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns the numeric RGB color value that corresponds to the
specified color string.
The color string can be either a case-insensitive color name
such as "red", "Blue", or
"haloGreen", a hexadecimal value such as 0xFF0000, or a #-hexadecimal String
such as "#FF0000".
This method returns a uint, such as 4521830, that represents a color. You can convert
this uint to a hexadecimal value by passing the numeric base (in this case, 16), to
the uint class's toString() method, as the following example shows:
import mx.styles.StyleManager;
private function getNewColorName():void {
StyleManager.registerColorName("soylentGreen",0x44FF66);
trace(StyleManager.getColorName("soylentGreen").toString(16));
}
參數
colorName:Object — The color name.
|
uint — Returns a uint that represents the color value or NOT_A_COLOR
if the value of the colorName property is not an alias for a color.
|
getColorNames | () | 方法 |
public static function getColorNames(colors:Array):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Converts each element of the colors Array from a color name
to a numeric RGB color value.
Each color String can be either a case-insensitive color name
such as "red", "Blue", or
"haloGreen", a hexadecimal value such as 0xFF0000, or a #-hexadecimal String
such as "#FF0000"..
參數
colors:Array — An Array of color names.
|
getStyleDeclaration | () | 方法 |
public static function getStyleDeclaration(selector:String):CSSStyleDeclaration| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Gets the CSSStyleDeclaration object that stores the rules for the specified CSS selector.
If the selector parameter starts with a period (.),
the returned CSSStyleDeclaration is a class selector and applies only to those instances
whose styleName property specifies that selector
(not including the period).
For example, the class selector ".bigMargins"
applies to any UIComponent whose styleName
is "bigMargins".
If the selector parameter does not start with a period,
the returned CSSStyleDeclaration is a type selector and applies to all instances
of that type.
For example, the type selector "Button"
applies to all instances of Button and its subclasses.
The global selector is similar to a type selector
and does not start with a period.
參數
selector:String — The name of the CSS selector.
|
CSSStyleDeclaration — The style declaration whose name matches the selector property.
|
getStyleManager | () | 方法 |
public static function getStyleManager(moduleFactory:IFlexModuleFactory):IStyleManager2| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Returns the style manager for an object.
參數
moduleFactory:IFlexModuleFactory — The module factory of an object you want the
style manager for. If null, the top-level style manager is returned.
|
IStyleManager2 — the style manager for the given module factory.
|
isColorName | () | 方法 |
public static function isColorName(colorName:String):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Tests to see if the given String is an alias for a color value. For example, by default, the String "blue" is an alias for 0x0000FF.
參數
colorName:String — The color name to test. This parameter is not case-sensitive.
|
Boolean — Returns true if colorName is an alias
for a color.
|
isInheritingStyle | () | 方法 |
public static function isInheritingStyle(styleName:String):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Tests to see if a style is inheriting.
參數
styleName:String — The name of the style that you test to see if it is inheriting.
|
Boolean — Returns true if the specified style is inheriting.
|
isInheritingTextFormatStyle | () | 方法 |
public static function isInheritingTextFormatStyle(styleName:String):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Test to see if a TextFormat style is inheriting.
參數
styleName:String — The name of the style that you test to see if it is inheriting.
|
Boolean — Returns true if the specified TextFormat style
is inheriting.
|
isParentDisplayListInvalidatingStyle | () | 方法 |
public static function isParentDisplayListInvalidatingStyle(styleName:String):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Tests to see if this style affects the component's parent container in such a way as to require that the parent container redraws itself when this style changes.
When one of these styles is set with setStyle(),
the invalidateDisplayList() method is auomatically called on the component's
parent container to make it redraw and/or relayout its children.
參數
styleName:String — The name of the style to test.
|
Boolean — Returns true if the specified style is one
which may affect the appearance or layout of the component's
parent container.
|
isParentSizeInvalidatingStyle | () | 方法 |
public static function isParentSizeInvalidatingStyle(styleName:String):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Tests to see if the style changes the size of the component's parent container.
When one of these styles is set with setStyle(),
the invalidateSize() method is automatically called on the component's
parent container to make its measured size get recalculated
later.
參數
styleName:String — The name of the style to test.
|
Boolean — Returns true if the specified style is one
which may affect the measured size of the component's
parent container.
|
isSizeInvalidatingStyle | () | 方法 |
public static function isSizeInvalidatingStyle(styleName:String):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Tests to see if a style changes the size of a component.
When one of these styles is set with the setStyle() method,
the invalidateSize() method is automatically called on the component
to make its measured size get recalculated later.
參數
styleName:String — The name of the style to test.
|
Boolean — Returns true if the specified style is one
which may affect the measured size of the component.
|
isValidStyleValue | () | 方法 |
public static function isValidStyleValue(value:*):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Determines if a specified parameter is a valid style property. For example:
trace(StyleManager.isValidStyleValue(myButton.getStyle("color")).toString());
This can be useful because some styles can be set to values
such as 0, NaN,
the empty String (""), or null, which can
cause an if (value) test to fail.
參數
value:* — The style property to test.
|
Boolean — If you pass the value returned by a getStyle() method call
to this method, it returns true if the style
was set and false if it was not set.
|
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 |
Loads a style SWF.
參數
url:String — Location of the style SWF.
| |
update:Boolean (default = true)true to force
an immediate update of the styles.
Set to false to avoid an immediate update
of the styles in the application.
This parameter is optional and defaults to true
For more information about this parameter, see the description
in the setStyleDeclaration() method.
| |
trustContent:Boolean (default = false)false.
| |
applicationDomain:ApplicationDomain (default = null)load() method of the IModuleInfo that loads the style SWF.
This parameter is optional and defaults to null.
| |
securityDomain:SecurityDomain (default = null)load() method of the IModuleInfo that loads the style SWF.
This parameter is optional and defaults to null.
|
IEventDispatcher — An IEventDispatcher implementation that supports
StyleEvent.PROGRESS, StyleEvent.COMPLETE, and
StyleEvent.ERROR.
|
相關 API 元素
registerColorName | () | 方法 |
public static function registerColorName(colorName:String, colorValue:uint):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Adds a color name to the list of aliases for colors.
參數
colorName:String — The name of the color to add to the list; for example, "blue".
If you later access this color name, the value is not case-sensitive.
| |
colorValue:uint — Color value, for example, 0x0000FF.
|
registerInheritingStyle | () | 方法 |
public static function registerInheritingStyle(styleName:String):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Adds to the list of styles that can inherit values from their parents.
Note: Ensure that you avoid using duplicate style names, as name collisions can result in decreased performance if a style that is already used becomes inheriting.
參數
styleName:String — The name of the style that is added to the list of styles that can inherit values.
|
registerParentDisplayListInvalidatingStyle | () | 方法 |
public static function registerParentDisplayListInvalidatingStyle(styleName:String):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Adds to the list of styles which may affect the appearance
or layout of the component's parent container.
When one of these styles is set with setStyle(),
the invalidateDisplayList() method is auomatically called on the component's
parent container to make it redraw and/or relayout its children.
參數
styleName:String — The name of the style to register.
|
registerParentSizeInvalidatingStyle | () | 方法 |
public static function registerParentSizeInvalidatingStyle(styleName:String):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Adds to the list of styles which may affect the measured size of the component's parent container.
When one of these styles is set with setStyle(),
the invalidateSize() method is automatically called on the component's
parent container to make its measured size get recalculated
later.
參數
styleName:String — The name of the style to register.
|
registerSizeInvalidatingStyle | () | 方法 |
public static function registerSizeInvalidatingStyle(styleName:String):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Adds to the list of styles which may affect the measured size
of the component.
When one of these styles is set with setStyle(),
the invalidateSize() method is automatically called on the component
to make its measured size get recalculated later.
參數
styleName:String — The name of the style that you add to the list.
|
setStyleDeclaration | () | 方法 |
public static function setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Sets the CSSStyleDeclaration object that stores the rules for the specified CSS selector.
If the selector parameter starts with a period (.),
the specified selector is a "class selector" and applies only to those instances
whose styleName property specifies that selector
(not including the period).
For example, the class selector ".bigMargins"
applies to any UIComponent whose styleName
is "bigMargins".
If the selector parameter does not start with a period,
the specified selector is a "type selector" and applies to all instances
of that type.
For example, the type selector "Button"
applies to all instances of Button and its subclasses.
The global selector is similar to a type selector
and does not start with a period.
參數
selector:String — The name of the CSS selector.
| |
styleDeclaration:CSSStyleDeclaration — The new style declaration.
| |
update:Boolean — Set to true to force an immediate update of the styles; internally, Flex
calls the styleChanged() method of UIComponent.
Set to false to avoid an immediate update of the styles in the application.
The styles will be updated the next time one of the following methods is called with
the
Typically, if you call the one of these methods multiple times,
you set this property to If you call the |
unloadStyleDeclarations | () | 方法 |
public static function unloadStyleDeclarations(url:String, update:Boolean = true):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Unloads a style SWF.
參數
url:String — Location of the style SWF.
| |
update:Boolean (default = true)true to force an immediate update of the styles.
Set to false to avoid an immediate update of the styles in the application.
For more information about this method, see the description in the setStyleDeclaration()
method.
|
相關 API 元素
NOT_A_COLOR | 常數 |
public static const NOT_A_COLOR:uint = 0xFFFFFFFF| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The getColorName() method returns this value if the passed-in
String is not a legitimate color name.
Tue Jun 12 2018, 03:47 PM Z