mx.core
接口public interface IUIComponent extends IFlexDisplayObject , IBitmapDrawable , IEventDispatcher
实现器 UIComponent

IUIComponent 接口定义基本 API 集,必须实现这些 API 才能创建 Flex 容器或列表的子项。



公共属性
 属性定义方
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
IFlexDisplayObject
 Inheritedalpha : Number
指示指定对象的 Alpha 透明度值。
IFlexDisplayObject
  baselinePosition : Number
[只读 (read-only)] 组件第一行文本的基线的 y 坐标。
IUIComponent
 InheritedblendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
IFlexDisplayObject
 InheritedcacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。
IFlexDisplayObject
  document : Object
对与此组件关联的文档对象的引用。
IUIComponent
  enabled : Boolean
组件是否可以接受用户交互。
IUIComponent
  explicitHeight : Number
在组件坐标中显式指定的组件高度(以像素为单位)。
IUIComponent
  explicitMaxHeight : Number
[只读 (read-only)] 在组件坐标中指定组件最大高度的数字(以像素为单位)。
IUIComponent
  explicitMaxWidth : Number
[只读 (read-only)] 在组件坐标中指定组件最大宽度的数字(以像素为单位)。
IUIComponent
  explicitMinHeight : Number
[只读 (read-only)] 在组件坐标中指定组件最小高度的数字(以像素为单位)。
IUIComponent
  explicitMinWidth : Number
[只读 (read-only)] 在组件坐标中指定组件最小宽度的数字(以像素为单位)。
IUIComponent
  explicitWidth : Number
在组件坐标中显式指定的组件宽度(以像素为单位)。
IUIComponent
 Inheritedfilters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
IFlexDisplayObject
  focusPane : Sprite
在组件中共享并用作绘图焦点叠加层的单个 Sprite 对象。
IUIComponent
 Inheritedheight : Number
指示显示对象的高度,以像素为单位。
IFlexDisplayObject
  includeInLayout : Boolean
指定此组件是否包含在父容器的布局中。
IUIComponent
  isPopUp : Boolean
PopUpManager 将其设置为 true 以指示已弹出该组件。
IUIComponent
 InheritedloaderInfo : LoaderInfo
[只读 (read-only)] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
IFlexDisplayObject
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
IFlexDisplayObject
  maxHeight : Number
[只读 (read-only)] 在组件坐标中指定组件最大高度的数字(以像素为单位)。
IUIComponent
  maxWidth : Number
[只读 (read-only)] 在组件坐标中指定组件最大宽度的数字(以像素为单位)。
IUIComponent
 InheritedmeasuredHeight : Number
[只读 (read-only)] 此对象的测量高度。
IFlexDisplayObject
  measuredMinHeight : Number
组件的默认最小高度(以像素为单位)。
IUIComponent
  measuredMinWidth : Number
组件的默认最小宽度(以像素为单位)。
IUIComponent
 InheritedmeasuredWidth : Number
[只读 (read-only)] 此对象的测量宽度。
IFlexDisplayObject
  minHeight : Number
[只读 (read-only)] 在组件坐标中指定组件最小高度的数字(以像素为单位)。
IUIComponent
  minWidth : Number
[只读 (read-only)] 在组件坐标中指定组件最小宽度的数字(以像素为单位)。
IUIComponent
 InheritedmouseX : Number
[只读 (read-only)] 指示鼠标位置的 x 坐标,以像素为单位。
IFlexDisplayObject
 InheritedmouseY : Number
[只读 (read-only)] 指示鼠标位置的 y 坐标,以像素为单位。
IFlexDisplayObject
 Inheritedname : String
指示 DisplayObject 的实例名称。
IFlexDisplayObject
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
IFlexDisplayObject
  owner : DisplayObjectContainer
通常为此组件的父容器。
IUIComponent
 Inheritedparent : DisplayObjectContainer
[只读 (read-only)] 指示包含此显示对象的 DisplayObjectContainer 对象。
IFlexDisplayObject
  percentHeight : Number
以组件父项大小百分比的方式指定组件高度的数字。
IUIComponent
  percentWidth : Number
以组件父项大小百分比形式指定其宽度的数字。
IUIComponent
 Inheritedroot : DisplayObject
[只读 (read-only)] 此处介绍的几种方法通常只位于 IDisplayObject 中,但为了具有向后兼容性,在 IFlexDisplayObject 中还必须直接包含它们,因此这些方法存在于此独立的包含文件中。
IFlexDisplayObject
 Inheritedrotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。
IFlexDisplayObject
 Inheritedscale9Grid : Rectangle
当前有效的缩放网格。
IFlexDisplayObject
 InheritedscaleX : Number
指示从注册点开始应用的对象的水平缩放比例(百分比)。
IFlexDisplayObject
 InheritedscaleY : Number
指示从对象注册点开始应用的对象的垂直缩放比例(百分比)。
IFlexDisplayObject
 InheritedscrollRect : Rectangle
显示对象的滚动矩形范围。
IFlexDisplayObject
 Inheritedstage : Stage
[只读 (read-only)] 显示对象的舞台。
IFlexDisplayObject
  systemManager : ISystemManager
对此组件的 SystemManager 对象的引用。
IUIComponent
 Inheritedtransform : Transform
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
IFlexDisplayObject
  tweeningProperties : Array
由 EffectManager 使用。
IUIComponent
 Inheritedvisible : Boolean
显示对象是否可见。
IFlexDisplayObject
 Inheritedwidth : Number
指示显示对象的宽度,以像素为单位。
IFlexDisplayObject
 Inheritedx : Number
指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。
IFlexDisplayObject
 Inheritedy : Number
指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。
IFlexDisplayObject
公共方法
 方法定义方
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
IEventDispatcher
 Inherited
将事件调度到事件流中。
IEventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
IFlexDisplayObject
  
确定是使用显式高度还是测量高度的一种简便方法
IUIComponent
  
确定是使用显式宽度还是测量宽度的一种简便方法
IUIComponent
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。
IFlexDisplayObject
 Inherited
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。
IFlexDisplayObject
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
IEventDispatcher
 Inherited
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。
IFlexDisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。
IFlexDisplayObject
  
初始化对象。
IUIComponent
 Inherited
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。
IFlexDisplayObject
 Inherited
将此对象移动到指定的 x 和 y 坐标。
IFlexDisplayObject
  
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。
IUIComponent
  
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。
IUIComponent
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
IEventDispatcher
 Inherited
setActualSize(newWidth:Number, newHeight:Number):void
设置此对象的实际大小。
IFlexDisplayObject
  
setVisible(value:Boolean, noEvent:Boolean = false):void
当 visible 属性发生更改时调用。
IUIComponent
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
IEventDispatcher
属性详细信息
baselinePosition属性
baselinePosition:Number  [只读 (read-only)]

组件第一行文本的基线的 y 坐标。

此属性用于实现 baseline 约束样式,还可用于将 FormItem 的标签与 FormItem 中的控件对齐。



实现
    public function get baselinePosition():Number
document属性 
document:Object  [读写]

对与此组件关联的文档对象的引用。文档对象是位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构顶层的 Object。



实现
    public function get document():Object
    public function set document(value:Object):void
enabled属性 
enabled:Boolean  [读写]

组件是否可以接受用户交互。将 enabled 属性设置为 false 后,某些组件仍会响应鼠标交互,如 mouseOver。因此,要完全禁用 UIComponent,您应该将 mouseEnabled 属性的值也设置为 false。如果将容器的 enabled 属性设置为 false,则 Flex 会使该容器及其所有子项的颜色变暗,并阻止用户向容器及其所有子项输入内容。



实现
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
explicitHeight属性 
explicitHeight:Number  [读写]

在组件坐标中显式指定的组件高度(以像素为单位)。如果没有显式指定的高度,则值为 NaN



实现
    public function get explicitHeight():Number
    public function set explicitHeight(value:Number):void

另请参见

explicitMaxHeight属性 
explicitMaxHeight:Number  [只读 (read-only)]

在组件坐标中指定组件最大高度的数字(以像素为单位)。



实现
    public function get explicitMaxHeight():Number

另请参见

explicitMaxWidth属性 
explicitMaxWidth:Number  [只读 (read-only)]

在组件坐标中指定组件最大宽度的数字(以像素为单位)。



实现
    public function get explicitMaxWidth():Number

另请参见

explicitMinHeight属性 
explicitMinHeight:Number  [只读 (read-only)]

在组件坐标中指定组件最小高度的数字(以像素为单位)。



实现
    public function get explicitMinHeight():Number

另请参见

explicitMinWidth属性 
explicitMinWidth:Number  [只读 (read-only)]

在组件坐标中指定组件最小宽度的数字(以像素为单位)。



实现
    public function get explicitMinWidth():Number

另请参见

explicitWidth属性 
explicitWidth:Number  [读写]

在组件坐标中显式指定的组件宽度(以像素为单位)。如果没有显式指定的宽度,则值为 NaN



实现
    public function get explicitWidth():Number
    public function set explicitWidth(value:Number):void

另请参见

focusPane属性 
focusPane:Sprite  [读写]

在组件中共享并用作绘图焦点叠加层的单个 Sprite 对象。如果组件的父项具有焦点,则这些组件共享此对象;如果该组件实现了 IFocusManagerComponent 接口,则不共享此对象。



实现
    public function get focusPane():Sprite
    public function set focusPane(value:Sprite):void

另请参见

includeInLayout属性 
includeInLayout:Boolean  [读写]

指定此组件是否包含在父容器的布局中。如果为 true,则该对象包含在其父容器的布局中。如果为 false,则由其父容器按布局规则定位该对象,但计算下一子项的位置时将忽略该对象。



实现
    public function get includeInLayout():Boolean
    public function set includeInLayout(value:Boolean):void
isPopUp属性 
isPopUp:Boolean  [读写]

PopUpManager 将其设置为 true 以指示已弹出该组件。



实现
    public function get isPopUp():Boolean
    public function set isPopUp(value:Boolean):void
maxHeight属性 
maxHeight:Number  [只读 (read-only)]

在组件坐标中指定组件最大高度的数字(以像素为单位)。



实现
    public function get maxHeight():Number

另请参见

maxWidth属性 
maxWidth:Number  [只读 (read-only)]

在组件坐标中指定组件最大宽度的数字(以像素为单位)。



实现
    public function get maxWidth():Number

另请参见

measuredMinHeight属性 
measuredMinHeight:Number  [读写]

组件的默认最小高度(以像素为单位)。此值由 measure() 方法设置。



实现
    public function get measuredMinHeight():Number
    public function set measuredMinHeight(value:Number):void
measuredMinWidth属性 
measuredMinWidth:Number  [读写]

组件的默认最小宽度(以像素为单位)。此值由 measure() 方法设置。



实现
    public function get measuredMinWidth():Number
    public function set measuredMinWidth(value:Number):void
minHeight属性 
minHeight:Number  [只读 (read-only)]

在组件坐标中指定组件最小高度的数字(以像素为单位)。



实现
    public function get minHeight():Number

另请参见

minWidth属性 
minWidth:Number  [只读 (read-only)]

在组件坐标中指定组件最小宽度的数字(以像素为单位)。



实现
    public function get minWidth():Number

另请参见

owner属性 
owner:DisplayObjectContainer  [读写]

通常为此组件的父容器。但是,如果这是一个弹出组件,则所有者为弹出该组件的组件。例如,ComboBox 控件下拉列表的所有者是 ComboBox 控件本身。此属性并非由 Flex 管理,而由各个组件管理。因此,如果弹出一个组件,则应对此属性进行相应的设置。



实现
    public function get owner():DisplayObjectContainer
    public function set owner(value:DisplayObjectContainer):void
percentHeight属性 
percentHeight:Number  [读写]

以组件父项大小百分比的方式指定组件高度的数字。允许的值为从 0 到 100。



实现
    public function get percentHeight():Number
    public function set percentHeight(value:Number):void
percentWidth属性 
percentWidth:Number  [读写]

以组件父项大小百分比形式指定其宽度的数字。允许的值为从 0 到 100。



实现
    public function get percentWidth():Number
    public function set percentWidth(value:Number):void
systemManager属性 
systemManager:ISystemManager  [读写]

对此组件的 SystemManager 对象的引用。



实现
    public function get systemManager():ISystemManager
    public function set systemManager(value:ISystemManager):void
tweeningProperties属性 
tweeningProperties:Array  [读写]

由 EffectManager 使用。如果组件不使用 EffectManager 执行 Tween,则返回非空值。



实现
    public function get tweeningProperties():Array
    public function set tweeningProperties(value:Array):void
方法详细信息
getExplicitOrMeasuredHeight()方法
public function getExplicitOrMeasuredHeight():Number

确定是使用显式高度还是测量高度的一种简便方法

返回
Number — 一个 Number,在已定义的情况下是 explicitHeight,在未定义的情况下是 measuredHeight.
getExplicitOrMeasuredWidth()方法 
public function getExplicitOrMeasuredWidth():Number

确定是使用显式宽度还是测量宽度的一种简便方法

返回
Number — 一个 Number,在已定义的情况下是 explicitWidth,在未定义的情况下是 measuredWidth。
initialize()方法 
public function initialize():void

初始化对象。

另请参见

owns()方法 
public function owns(child:DisplayObject):Boolean

如果 owner 属性链从 child 指向此 UIComponent,则返回 true

参数

child:DisplayObject — 一个 UIComponent。

返回
Boolean — 如果子项以此 UIComponent 为父项或归其所有,则为 true
parentChanged()方法 
public function parentChanged(p:DisplayObjectContainer):void

当在父项中添加或删除 UIComponent 对象时由 Flex 调用。开发人员通常无需调用此方法。

参数

p:DisplayObjectContainer — 此 UIComponent 对象的父项。

setVisible()方法 
public function setVisible(value:Boolean, noEvent:Boolean = false):void

visible 属性发生更改时调用。您应设置 visible 属性来显示或隐藏组件,而不是直接调用此方法。

参数

value:Booleanvisible 属性的新值。指定 true 可显示组件,指定 false 可隐藏组件。
 
noEvent:Boolean (default = false) — 如果为 true,则不调度事件。如果为 false,则当组件变为可见时调度 show 事件,当组件变为不可见时调度 hide 事件。