Packagemx.core
Interfacepublic interface IDeferredInstantiationUIComponent extends IUIComponent, IFlexDisplayObject, flash.display.IBitmapDrawable, flash.events.IEventDispatcher
ImplementorsUIComponent

The IDeferredInstantiationUIComponent interface defines the interface for a component or object that defers instantiation.



Public Properties
 PropertyDefined by
 InheritedaccessibilityProperties : AccessibilityProperties
IFlexDisplayObject
 Inheritedalpha : Number
IFlexDisplayObject
 InheritedbaselinePosition : Number
The y-coordinate of the baseline of the first line of text of the component.
IUIComponent
 InheritedblendMode : String
IFlexDisplayObject
 InheritedcacheAsBitmap : Boolean
IFlexDisplayObject
  cacheHeuristic : Boolean
[write-only] Used by Flex to suggest bitmap caching for the object.
IDeferredInstantiationUIComponent
  cachePolicy : String
[read-only] Specifies the bitmap caching policy for this object.
IDeferredInstantiationUIComponent
  descriptor : UIComponentDescriptor
Reference to the UIComponentDescriptor, if any, that was used by the createComponentFromDescriptor() method to create this UIComponent instance.
IDeferredInstantiationUIComponent
 Inheriteddocument : Object
A reference to the document object associated with this component.
IUIComponent
 Inheritedenabled : Boolean
Whether the component can accept user interaction.
IUIComponent
 InheritedexplicitHeight : Number
The explicitly specified height for the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitMaxHeight : Number
Number that specifies the maximum height of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitMaxWidth : Number
Number that specifies the maximum width of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitMinHeight : Number
Number that specifies the minimum height of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitMinWidth : Number
Number that specifies the minimum width of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitWidth : Number
The explicitly specified width for the component, in pixels, as the component's coordinates.
IUIComponent
 Inheritedfilters : Array
IFlexDisplayObject
 InheritedfocusPane : Sprite
A single Sprite object that is shared among components and used as an overlay for drawing focus.
IUIComponent
 Inheritedheight : Number
IFlexDisplayObject
  id : String
ID of the component.
IDeferredInstantiationUIComponent
 InheritedincludeInLayout : Boolean
Specifies whether this component is included in the layout of the parent container.
IUIComponent
 InheritedisPopUp : Boolean
Set to true by the PopUpManager to indicate that component has been popped up.
IUIComponent
 InheritedloaderInfo : LoaderInfo
IFlexDisplayObject
 Inheritedmask : DisplayObject
IFlexDisplayObject
 InheritedmaxHeight : Number
Number that specifies the maximum height of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedmaxWidth : Number
Number that specifies the maximum width of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedmeasuredHeight : Number
The measured height of this object.
IFlexDisplayObject
 InheritedmeasuredMinHeight : Number
The default minimum height of the component, in pixels.
IUIComponent
 InheritedmeasuredMinWidth : Number
The default minimum width of the component, in pixels.
IUIComponent
 InheritedmeasuredWidth : Number
The measured width of this object.
IFlexDisplayObject
 InheritedminHeight : Number
Number that specifies the minimum height of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedminWidth : Number
Number that specifies the minimum width of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedmouseX : Number
IFlexDisplayObject
 InheritedmouseY : Number
IFlexDisplayObject
 Inheritedname : String
IFlexDisplayObject
 InheritedopaqueBackground : Object
IFlexDisplayObject
 Inheritedowner : DisplayObjectContainer
Typically the parent container of this component.
IUIComponent
 Inheritedparent : DisplayObjectContainer
IFlexDisplayObject
 InheritedpercentHeight : Number
Number that specifies the height of a component as a percentage of its parent's size.
IUIComponent
 InheritedpercentWidth : Number
Number that specifies the width of a component as a percentage of its parent's size.
IUIComponent
 Inheritedroot : DisplayObject
The methods here would normally just be in IDisplayObject, but for backward compatibility, they have to be included directly into IFlexDisplayObject, so they are kept in this separate include file.
IFlexDisplayObject
 Inheritedrotation : Number
IFlexDisplayObject
 Inheritedscale9Grid : Rectangle
IFlexDisplayObject
 InheritedscaleX : Number
IFlexDisplayObject
 InheritedscaleY : Number
IFlexDisplayObject
 InheritedscrollRect : Rectangle
IFlexDisplayObject
 Inheritedstage : Stage
IFlexDisplayObject
 InheritedsystemManager : ISystemManager
A reference to the SystemManager object for this component.
IUIComponent
 Inheritedtransform : Transform
IFlexDisplayObject
 InheritedtweeningProperties : Array
Used by EffectManager.
IUIComponent
 Inheritedvisible : Boolean
IFlexDisplayObject
 Inheritedwidth : Number
IFlexDisplayObject
 Inheritedx : Number
IFlexDisplayObject
 Inheritedy : Number
IFlexDisplayObject
Public Methods
 MethodDefined by
  
Creates an id reference to this IUIComponent object on its parent document object.
IDeferredInstantiationUIComponent
  
Deletes the id reference to this IUIComponent object on its parent document object.
IDeferredInstantiationUIComponent
  
executeBindings(recurse:Boolean = false):void
Executes the data bindings into this UIComponent object.
IDeferredInstantiationUIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
IFlexDisplayObject
 Inherited
A convenience method for determining whether to use the explicit or measured height
IUIComponent
 Inherited
A convenience method for determining whether to use the explicit or measured width
IUIComponent
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
IFlexDisplayObject
 Inherited
globalToLocal(point:Point):Point
IFlexDisplayObject
 Inherited
hitTestObject(obj:DisplayObject):Boolean
IFlexDisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
IFlexDisplayObject
 Inherited
initialize():void
Initialize the object.
IUIComponent
 Inherited
localToGlobal(point:Point):Point
IFlexDisplayObject
 Inherited
move(x:Number, y:Number):void
Moves this object to the specified x and y coordinates.
IFlexDisplayObject
 Inherited
owns(child:DisplayObject):Boolean
Returns true if the chain of owner properties points from child to this UIComponent.
IUIComponent
 Inherited
parentChanged(p:DisplayObjectContainer):void
Called by Flex when a UIComponent object is added to or removed from a parent.
IUIComponent
  
registerEffects(effects:Array):void
For each effect event, register the EffectManager as one of the event listeners.
IDeferredInstantiationUIComponent
 Inherited
setActualSize(newWidth:Number, newHeight:Number):void
Sets the actual size of this object.
IFlexDisplayObject
 Inherited
setVisible(value:Boolean, noEvent:Boolean = false):void
Called when the visible property changes.
IUIComponent
Property detail
cacheHeuristicproperty
cacheHeuristic:Boolean  [write-only]

Used by Flex to suggest bitmap caching for the object. If cachePolicy is UIComponentCachePolicy.AUTO, then cacheHeuristic is used to control the object's cacheAsBitmap property.

Implementation
    public function set cacheHeuristic(value:Boolean):void
cachePolicyproperty 
cachePolicy:String  [read-only]

Specifies the bitmap caching policy for this object. Possible values in MXML are "on", "off" and "auto" (default).

Possible values in ActionScript are UIComponentCachePolicy.ON, UIComponentCachePolicy.OFF and UIComponentCachePolicy.AUTO (default).

Implementation
    public function get cachePolicy():String
descriptorproperty 
descriptor:UIComponentDescriptor  [read-write]

Reference to the UIComponentDescriptor, if any, that was used by the createComponentFromDescriptor() method to create this UIComponent instance. If this UIComponent instance was not created from a descriptor, this property is null.

Implementation
    public function get descriptor():UIComponentDescriptor
    public function set descriptor(value:UIComponentDescriptor):void
idproperty 
id:String  [read-write]

ID of the component. This value becomes the instance name of the object and should not contain any white space or special characters. Each component throughout an application should have a unique id.

If your application is going to be tested by third party tools, give each component a meaningful id. Testing tools use ids to represent the control in their scripts and having a meaningful name can make scripts more readable. For example, set the value of a button to submit_button rather than b1 or button1.

Implementation
    public function get id():String
    public function set id(value:String):void
Method detail
createReferenceOnParentDocument()method
public function createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void

Creates an id reference to this IUIComponent object on its parent document object. This function can create multidimensional references such as b[2][4] for objects inside one or more repeaters. If the indices are null, it creates a simple non-Array reference.

Parameters
parentDocument:IFlexDisplayObject — The parent of this IUIComponent object.
deleteReferenceOnParentDocument()method 
public function deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void

Deletes the id reference to this IUIComponent object on its parent document object. This function can delete from multidimensional references such as b[2][4] for objects inside one or more Repeaters. If the indices are null, it deletes the simple non-Array reference.

Parameters
parentDocument:IFlexDisplayObject — The parent of this IUIComponent object.
executeBindings()method 
public function executeBindings(recurse:Boolean = false):void

Executes the data bindings into this UIComponent object. Workaround for MXML container/bindings problem (177074): override Container.executeBindings() to prefer descriptor.document over parentDocument in the call to BindingManager.executeBindings(). This should always provide the correct behavior for instances created by descriptor, and will provide the original behavior for procedurally-created instances. (The bug may or may not appear in the latter case.) A more complete fix, guaranteeing correct behavior in both non-DI and reparented-component scenarios, is anticipated for updater 1.

Parameters
recurse:Boolean (default = false) — Recursively execute bindings for children of this component.
registerEffects()method 
public function registerEffects(effects:Array):void

For each effect event, register the EffectManager as one of the event listeners.

Parameters
effects:Array — An Array of strings of effect names.