| 套件 | mx.core |
| 類別 | public class UIComponentDescriptor |
| 繼承 | UIComponentDescriptor  ComponentDescriptor Object |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Most of the tags in an MXML file describe a tree of UIComponent objects.
For example, the <mx:Application> tag represents a
UIComponent object, and its child containers and controls are all
UIComponent objects.
The MXML compiler compiles each of these MXML tags into a UIComponentDescriptor instance. To be precise, the MXML compiler autogenerates an ActionScript data structure which is a tree of UIComponentDescriptor objects.
At runtime, the createComponentsFromDescriptors() method
of the Container class uses the information in the UIComponentDescriptor
objects in the container's childDescriptors array to create
the actual UIComponent objects that are the container's children,
plus deeper descendants as well.
Depending on the value of the container's creationPolicy,
property, the descendants might be created at application startup,
when some part of the component is about to become visible,
or when the application developer manually calls
the createComponentsFromDescriptors() method.
You do not typically create UIComponentDescriptor instances yourself;
you can access the ones that the MXML compiler autogenerates via the
childDescriptors array of the Container class.
相關 API 元素
mx.core.Container.creationPolicy
mx.core.Container.createComponentsFromDescriptors()
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| document : Object
A reference to the document Object in which the component
is to be created. | ComponentDescriptor | |
| effects : Array
An Array containing the effects for the component, as specified in MXML. | UIComponentDescriptor | ||
| events : Object
An Object containing name/value pairs for the component's
event handlers, as specified in MXML. | ComponentDescriptor | |
| id : String
The identifier for the component, as specified in MXML. | ComponentDescriptor | |
| properties : Object [唯讀]
An Object containing name/value pairs for the component's properties,
as specified in MXML. | ComponentDescriptor | |
| propertiesFactory : Function
A Function that returns an Object containing name/value pairs
for the component's properties, as specified in MXML. | ComponentDescriptor | |
| stylesFactory : Function
A Function that constructs an Object containing name/value pairs
for the instance styles for the component, as specified in MXML. | UIComponentDescriptor | ||
| type : Class
The Class of the component, as specified in MXML. | ComponentDescriptor | |
| 方法 | 定義自 | ||
|---|---|---|---|
UIComponentDescriptor(descriptorProperties:Object)
Constructor. | UIComponentDescriptor | ||
|
指出物件是否有已定義的指定屬性。 | Object | |
|
Invalidates the cached properties property. | ComponentDescriptor | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
Returns the string "ComponentDescriptor_" plus the value of the
id property. | ComponentDescriptor | |
|
會傳回指定之物件的基本值。 | Object | |
effects | 屬性 |
public var effects:Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
An Array containing the effects for the component, as specified in MXML.
For example, if you write the following code:
<mx:TextInput showEffect="Fade" hideEffect="Fade"/>
The descriptor's effects property is the Array
[ "showEffect", "hideEffect" ].
The effectsproperty is null
if no MXML effects were specified for the component.
Note that the values of the effect attributes are not specified
in this property.
Instead, effects are treated like styles and therefore are include
in the stylesFactory property.
The effect Array simply keeps track of which styles
in the stylesFactory are actually effects.
This property is used by the Container method
createComponentsFromDescriptors()
to register the effects with the EffectManager.
stylesFactory | 屬性 |
public var stylesFactory:Function| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
A Function that constructs an Object containing name/value pairs for the instance styles for the component, as specified in MXML.
For example, if you write the following code:
<mx:TextInput borderColor="0x888888" color="0xDDDDDD"/>
Then the descriptors' stylesFactory property
is the Function:
function():void { this.borderColor = 0x888888; this.color = 0xDDDDDD };
The stylesFactory property is null
if no MXML styles were specified for the component instance.
UIComponentDescriptor | () | 建構函式 |
public function UIComponentDescriptor(descriptorProperties:Object)| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Constructor.
參數descriptorProperties:Object — An Object containing name/value pairs
for the properties of the UIComponentDescriptor object, such as its
type, id, propertiesFactory,
events, stylesFactory,
and effects.
|
Tue Jun 12 2018, 03:47 PM Z