Packagemx.core
Interfacepublic interface IUIComponent extends IFlexDisplayObject, flash.display.IBitmapDrawable, flash.events.IEventDispatcher
SubinterfacesIButton, IContainer, IDeferredInstantiationUIComponent, IListItemRenderer, IToolTip, IUITextField
ImplementorsUIComponent

The IUIComponent interface defines the basic set of APIs that you must implement to create a child of a Flex container or list.



Public Properties
 PropertyDefined by
 InheritedaccessibilityProperties : AccessibilityProperties
IFlexDisplayObject
 Inheritedalpha : Number
IFlexDisplayObject
  baselinePosition : Number
[read-only] The y-coordinate of the baseline of the first line of text of the component.
IUIComponent
 InheritedblendMode : String
IFlexDisplayObject
 InheritedcacheAsBitmap : Boolean
IFlexDisplayObject
  document : Object
A reference to the document object associated with this component.
IUIComponent
  enabled : Boolean
Whether the component can accept user interaction.
IUIComponent
  explicitHeight : Number
The explicitly specified height for the component, in pixels, as the component's coordinates.
IUIComponent
  explicitMaxHeight : Number
[read-only] Number that specifies the maximum height of the component, in pixels, as the component's coordinates.
IUIComponent
  explicitMaxWidth : Number
[read-only] Number that specifies the maximum width of the component, in pixels, as the component's coordinates.
IUIComponent
  explicitMinHeight : Number
[read-only] Number that specifies the minimum height of the component, in pixels, as the component's coordinates.
IUIComponent
  explicitMinWidth : Number
[read-only] Number that specifies the minimum width of the component, in pixels, as the component's coordinates.
IUIComponent
  explicitWidth : Number
The explicitly specified width for the component, in pixels, as the component's coordinates.
IUIComponent
 Inheritedfilters : Array
IFlexDisplayObject
  focusPane : Sprite
A single Sprite object that is shared among components and used as an overlay for drawing focus.
IUIComponent
 Inheritedheight : Number
IFlexDisplayObject
  includeInLayout : Boolean
Specifies whether this component is included in the layout of the parent container.
IUIComponent
  isPopUp : Boolean
Set to true by the PopUpManager to indicate that component has been popped up.
IUIComponent
 InheritedloaderInfo : LoaderInfo
IFlexDisplayObject
 Inheritedmask : DisplayObject
IFlexDisplayObject
  maxHeight : Number
[read-only] Number that specifies the maximum height of the component, in pixels, as the component's coordinates.
IUIComponent
  maxWidth : Number
[read-only] 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
  measuredMinHeight : Number
The default minimum height of the component, in pixels.
IUIComponent
  measuredMinWidth : Number
The default minimum width of the component, in pixels.
IUIComponent
 InheritedmeasuredWidth : Number
The measured width of this object.
IFlexDisplayObject
  minHeight : Number
[read-only] Number that specifies the minimum height of the component, in pixels, as the component's coordinates.
IUIComponent
  minWidth : Number
[read-only] 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
  owner : DisplayObjectContainer
Typically the parent container of this component.
IUIComponent
 Inheritedparent : DisplayObjectContainer
IFlexDisplayObject
  percentHeight : Number
Number that specifies the height of a component as a percentage of its parent's size.
IUIComponent
  percentWidth : 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
  systemManager : ISystemManager
A reference to the SystemManager object for this component.
IUIComponent
 Inheritedtransform : Transform
IFlexDisplayObject
  tweeningProperties : Array
Used by EffectManager.
IUIComponent
 Inheritedvisible : Boolean
IFlexDisplayObject
 Inheritedwidth : Number
IFlexDisplayObject
 Inheritedx : Number
IFlexDisplayObject
 Inheritedy : Number
IFlexDisplayObject
Public Methods
 MethodDefined by
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
IFlexDisplayObject
  
A convenience method for determining whether to use the explicit or measured height
IUIComponent
  
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
  
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
  
owns(child:DisplayObject):Boolean
Returns true if the chain of owner properties points from child to this UIComponent.
IUIComponent
  
Called by Flex when a UIComponent object is added to or removed from a parent.
IUIComponent
 Inherited
setActualSize(newWidth:Number, newHeight:Number):void
Sets the actual size of this object.
IFlexDisplayObject
  
setVisible(value:Boolean, noEvent:Boolean = false):void
Called when the visible property changes.
IUIComponent
Property detail
baselinePositionproperty
baselinePosition:Number  [read-only]

The y-coordinate of the baseline of the first line of text of the component.

This property is used to implement the baseline constraint style. It is also used to align the label of a FormItem with the controls in the FormItem.

Implementation
    public function get baselinePosition():Number
documentproperty 
document:Object  [read-write]

A reference to the document object associated with this component. A document object is an Object at the top of the hierarchy of a Flex application, MXML component, or ActionScript component.

Implementation
    public function get document():Object
    public function set document(value:Object):void
enabledproperty 
enabled:Boolean  [read-write]

Whether the component can accept user interaction. After setting the enabled property to false, some components still respond to mouse interactions such as mouseOver. As a result, to fully disable UIComponents, you should also set the value of the mouseEnabled property to false. If you set the enabled property to false for a container, Flex dims the color of the container and of all of its children, and blocks user input to the container and to all of its children.

Implementation
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
explicitHeightproperty 
explicitHeight:Number  [read-write]

The explicitly specified height for the component, in pixels, as the component's coordinates. If no height is explicitly specified, the value is NaN.

Implementation
    public function get explicitHeight():Number
    public function set explicitHeight(value:Number):void

See also

explicitMaxHeightproperty 
explicitMaxHeight:Number  [read-only]

Number that specifies the maximum height of the component, in pixels, as the component's coordinates.

Implementation
    public function get explicitMaxHeight():Number

See also

explicitMaxWidthproperty 
explicitMaxWidth:Number  [read-only]

Number that specifies the maximum width of the component, in pixels, as the component's coordinates.

Implementation
    public function get explicitMaxWidth():Number

See also

explicitMinHeightproperty 
explicitMinHeight:Number  [read-only]

Number that specifies the minimum height of the component, in pixels, as the component's coordinates.

Implementation
    public function get explicitMinHeight():Number

See also

explicitMinWidthproperty 
explicitMinWidth:Number  [read-only]

Number that specifies the minimum width of the component, in pixels, as the component's coordinates.

Implementation
    public function get explicitMinWidth():Number

See also

explicitWidthproperty 
explicitWidth:Number  [read-write]

The explicitly specified width for the component, in pixels, as the component's coordinates. If no width is explicitly specified, the value is NaN.

Implementation
    public function get explicitWidth():Number
    public function set explicitWidth(value:Number):void

See also

focusPaneproperty 
focusPane:Sprite  [read-write]

A single Sprite object that is shared among components and used as an overlay for drawing focus. Components share this object if their parent is a focused component, not if the component implements the IFocusManagerComponent interface.

Implementation
    public function get focusPane():Sprite
    public function set focusPane(value:Sprite):void

See also

includeInLayoutproperty 
includeInLayout:Boolean  [read-write]

Specifies whether this component is included in the layout of the parent container. If true, the object is included in its parent container's layout. If false, the object is positioned by its parent container as per its layout rules, but it is ignored for the purpose of computing the position of the next child.

Implementation
    public function get includeInLayout():Boolean
    public function set includeInLayout(value:Boolean):void
isPopUpproperty 
isPopUp:Boolean  [read-write]

Set to true by the PopUpManager to indicate that component has been popped up.

Implementation
    public function get isPopUp():Boolean
    public function set isPopUp(value:Boolean):void
maxHeightproperty 
maxHeight:Number  [read-only]

Number that specifies the maximum height of the component, in pixels, as the component's coordinates.

Implementation
    public function get maxHeight():Number

See also

maxWidthproperty 
maxWidth:Number  [read-only]

Number that specifies the maximum width of the component, in pixels, as the component's coordinates.

Implementation
    public function get maxWidth():Number

See also

measuredMinHeightproperty 
measuredMinHeight:Number  [read-write]

The default minimum height of the component, in pixels. This value is set by the measure() method.

Implementation
    public function get measuredMinHeight():Number
    public function set measuredMinHeight(value:Number):void
measuredMinWidthproperty 
measuredMinWidth:Number  [read-write]

The default minimum width of the component, in pixels. This value is set by the measure() method.

Implementation
    public function get measuredMinWidth():Number
    public function set measuredMinWidth(value:Number):void
minHeightproperty 
minHeight:Number  [read-only]

Number that specifies the minimum height of the component, in pixels, as the component's coordinates.

Implementation
    public function get minHeight():Number

See also

minWidthproperty 
minWidth:Number  [read-only]

Number that specifies the minimum width of the component, in pixels, as the component's coordinates.

Implementation
    public function get minWidth():Number

See also

ownerproperty 
owner:DisplayObjectContainer  [read-write]

Typically the parent container of this component. However, if this is a popup component, the owner is the component that popped it up. For example, the owner of a dropdown list of a ComboBox control is the ComboBox control itself. This property is not managed by Flex, but by each component. Therefore, if you popup a component, you should set this property accordingly.

Implementation
    public function get owner():DisplayObjectContainer
    public function set owner(value:DisplayObjectContainer):void
percentHeightproperty 
percentHeight:Number  [read-write]

Number that specifies the height of a component as a percentage of its parent's size. Allowed values are 0 to 100.

Implementation
    public function get percentHeight():Number
    public function set percentHeight(value:Number):void
percentWidthproperty 
percentWidth:Number  [read-write]

Number that specifies the width of a component as a percentage of its parent's size. Allowed values are 0 to 100.

Implementation
    public function get percentWidth():Number
    public function set percentWidth(value:Number):void
systemManagerproperty 
systemManager:ISystemManager  [read-write]

A reference to the SystemManager object for this component.

Implementation
    public function get systemManager():ISystemManager
    public function set systemManager(value:ISystemManager):void
tweeningPropertiesproperty 
tweeningProperties:Array  [read-write]

Used by EffectManager. Returns non-null if a component is not using the EffectManager to execute a Tween.

Implementation
    public function get tweeningProperties():Array
    public function set tweeningProperties(value:Array):void
Method detail
getExplicitOrMeasuredHeight()method
public function getExplicitOrMeasuredHeight():Number

A convenience method for determining whether to use the explicit or measured height

Returns
Number — A Number which is explicitHeight if defined or measuredHeight if not.
getExplicitOrMeasuredWidth()method 
public function getExplicitOrMeasuredWidth():Number

A convenience method for determining whether to use the explicit or measured width

Returns
Number — A Number which is explicitWidth if defined or measuredWidth if not.
initialize()method 
public function initialize():void

Initialize the object.

See also

owns()method 
public function owns(child:DisplayObject):Boolean

Returns true if the chain of owner properties points from child to this UIComponent.

Parameters
child:DisplayObject — A UIComponent.

Returns
Booleantrue if the child is parented or owned by this UIComponent.
parentChanged()method 
public function parentChanged(p:DisplayObjectContainer):void

Called by Flex when a UIComponent object is added to or removed from a parent. Developers typically never need to call this method.

Parameters
p:DisplayObjectContainer — The parent of this UIComponent object.
setVisible()method 
public function setVisible(value:Boolean, noEvent:Boolean = false):void

Called when the visible property changes. You should set the visible property to show or hide a component instead of calling this method directly.

Parameters
value:Boolean — The new value of the visible property. Specify true to show the component, and false to hide it.
 
noEvent:Boolean (default = false) — If true, do not dispatch an event. If false, dispatch a show event when the component becomes visible, and a hide event when the component becomes invisible.