Adobe Flex 2 Language Reference - collected by Jimbob | Back to MY RESOURCES


Packagemx.core
Interfacepublic interface IUIComponent extends IFlexDisplayObject, IBitmapDrawable, IEventDispatcher
SubinterfacesIAxisRenderer, IDeferredInstantiationUIComponent, IListItemRenderer, IMenuBarItemRenderer, IToolTip
ImplementorsUIComponent, UITextField

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
 Inheritedalpha : Number
The transparency of this object.
IFlexDisplayObject
  baselinePosition : Number
[read-only] Determines the baseline y-coordinate of the first line of text of the component.
IUIComponent
  cacheAsBitmap : Boolean
If set to true, Flash Player caches an internal bitmap representation of the object.
IUIComponent
  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
  focusPane : Sprite
A single Sprite object that is shared among components and used as an overlay for drawing focus.
IUIComponent
 Inheritedheight : Number
The height of this object, in pixels.
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
 Inheritedmask : DisplayObject
The DisplayObject used to mask this object so that only part of it is actually drawn.
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
 Inheritedname : String
The instance name of this object.
IFlexDisplayObject
  opaqueBackground : Object
Specifies whether the display object is opaque with a certain background color.
IUIComponent
  owner : DisplayObjectContainer
Your owner is usually your parent, however If you are a popup subcomponent, your owner will be the component that popped you up.
IUIComponent
 Inheritedparent : DisplayObjectContainer
The parent of this object.
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
 InheritedscaleX : Number
The horizontal scaling factor for this object.
IFlexDisplayObject
 InheritedscaleY : Number
The vertical scaling factor for this object.
IFlexDisplayObject
  scrollRect : Rectangle
The scroll rectangle bounds of the surface of the component.
IUIComponent
  systemManager : ISystemManager
A reference to the SystemManager object for this component.
IUIComponent
  tweeningProperties : Array
Used by EffectManager.
IUIComponent
 Inheritedvisible : Boolean
A flag that indicates whether this object is visible.
IFlexDisplayObject
 Inheritedwidth : Number
The width of this object, in pixels.
IFlexDisplayObject
 Inheritedx : Number
The horizontal position of this object relative to its parent, in pixel coordinates.
IFlexDisplayObject
 Inheritedy : Number
The vertical position of this object relative to its parent, in pixel coordinates.
IFlexDisplayObject
Public Methods
 MethodDefined by
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
IEventDispatcher
 Inherited
Dispatches an event into the event flow.
IEventDispatcher
  
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
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
IEventDispatcher
  
initialize():void
Initialize the object.
IUIComponent
 Inherited
move(x:Number, y:Number):void
Moves this object to the specified x and y coordinates.
IFlexDisplayObject
  
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
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
IEventDispatcher
 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
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
IEventDispatcher
Property detail
baselinePositionproperty
baselinePosition:Number  [read-only]

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

Implementation
    public function get baselinePosition():Number
cacheAsBitmapproperty 
cacheAsBitmap:Boolean  [read-write]

If set to true, Flash Player caches an internal bitmap representation of the object. This can increase performance for display objects that contain complex vector content.

Implementation
    public function get cacheAsBitmap():Boolean
    public function set cacheAsBitmap(value:Boolean):void

See also

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. 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

opaqueBackgroundproperty 
opaqueBackground:Object  [read-write]

Specifies whether the display object is opaque with a certain background color. A transparent bitmap contains alpha channel data and is drawn transparently. An opaque bitmap has no alpha channel (and renders faster than a transparent bitmap). If the bitmap is opaque, you specify its own background color to use.

Implementation
    public function get opaqueBackground():Object
    public function set opaqueBackground(value:Object):void

See also

ownerproperty 
owner:DisplayObjectContainer  [read-write]

Your owner is usually your parent, however If you are a popup subcomponent, your owner will be the component that popped you up. For example, a combobox dropdown's owner is the combobox. This property is not managed by the framework, but rather, by each component so if you popup sub-components you should set this property on them

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
scrollRectproperty 
scrollRect:Rectangle  [read-write]

The scroll rectangle bounds of the surface of the component.

Implementation
    public function get scrollRect():Rectangle
    public function set scrollRect(value:Rectangle):void

See also

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.





collected by Jimbob 2007.05