IUIComponent - Adobe ActionScript® 3 (AS3 Flex) API 参考

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。	IFlexDisplayObject
		alpha : Number 表示指定对象的 Alpha 透明度值。	IFlexDisplayObject
		baselinePosition : Number [只读] 组件第一行文本的基线的 y 坐标。	IUIComponent
		blendMode : String BlendMode 类中的一个值，用于指定要使用的混合模式。	IFlexDisplayObject
		cacheAsBitmap : Boolean 如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。	IFlexDisplayObject
		document : Object 对与此组件关联的文档对象的引用。	IUIComponent
		enabled : Boolean 组件是否可以接受用户交互。	IUIComponent
		explicitHeight : Number 在组件坐标中显式指定的组件高度（以像素为单位）。	IUIComponent
		explicitMaxHeight : Number [只读] 在组件坐标中指定组件最大高度的数字（以像素为单位）。	IUIComponent
		explicitMaxWidth : Number [只读] 在组件坐标中指定组件最大宽度的数字（以像素为单位）。	IUIComponent
		explicitMinHeight : Number [只读] 在组件坐标中指定组件最小高度的数字（以像素为单位）。	IUIComponent
		explicitMinWidth : Number [只读] 在组件坐标中指定组件最小宽度的数字（以像素为单位）。	IUIComponent
		explicitWidth : Number 在组件坐标中显式指定的组件宽度（以像素为单位）。	IUIComponent
		filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。	IFlexDisplayObject
		focusPane : Sprite 在组件中共享并用作绘制焦点指示符的叠加层的单个 Sprite 对象。	IUIComponent
		height : Number 表示显示对象的高度，以像素为单位。	IFlexDisplayObject
		includeInLayout : Boolean 指定此组件是否包含在父容器的布局中。	IUIComponent
		isPopUp : Boolean PopUpManager 将其设置为 true 以指示已弹出该组件。	IUIComponent
		loaderInfo : LoaderInfo [只读] 返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。	IFlexDisplayObject
		mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。	IFlexDisplayObject
		maxHeight : Number [只读] 在组件坐标中指定组件最大高度的数字（以像素为单位）。	IUIComponent
		maxWidth : Number [只读] 在组件坐标中指定组件最大宽度的数字（以像素为单位）。	IUIComponent
		measuredHeight : Number [只读] 此对象的测量高度。	IFlexDisplayObject
		measuredMinHeight : Number 组件的默认最小高度（以像素为单位）。	IUIComponent
		measuredMinWidth : Number 组件的默认最小宽度（以像素为单位）。	IUIComponent
		measuredWidth : Number [只读] 此对象的测量宽度。	IFlexDisplayObject
		minHeight : Number [只读] 在组件坐标中指定组件最小高度的数字（以像素为单位）。	IUIComponent
		minWidth : Number [只读] 在组件坐标中指定组件最小宽度的数字（以像素为单位）。	IUIComponent
		mouseX : Number [只读] 表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。	IFlexDisplayObject
		mouseY : Number [只读] 表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。	IFlexDisplayObject
		name : String 表示 DisplayObject 的实例名称。	IFlexDisplayObject
		opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。	IFlexDisplayObject
		owner : DisplayObjectContainer 此 IVisualElement 对象的所有者。	IUIComponent
		parent : DisplayObjectContainer [只读] 表示包含此显示对象的 DisplayObjectContainer 对象。	IFlexDisplayObject
		percentHeight : Number 以组件父项大小百分比的方式指定组件高度的数字。	IUIComponent
		percentWidth : Number 以组件父项大小百分比形式指定其宽度的数字。	IUIComponent
		root : DisplayObject [只读] 对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。	IFlexDisplayObject
		rotation : Number 表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。	IFlexDisplayObject
		scale9Grid : Rectangle 当前有效的缩放网格。	IFlexDisplayObject
		scaleX : Number 表示从注册点开始应用的对象的水平缩放比例（百分比）。	IFlexDisplayObject
		scaleY : Number 表示从对象注册点开始应用的对象的垂直缩放比例（百分比）。	IFlexDisplayObject
		scrollRect : Rectangle 显示对象的滚动矩形范围。	IFlexDisplayObject
		stage : Stage [只读] 显示对象的舞台。	IFlexDisplayObject
		systemManager : ISystemManager 对此组件的 SystemManager 对象的引用。	IUIComponent
		transform : flash.geom:Transform 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	IFlexDisplayObject
		tweeningProperties : Array 由 EffectManager 使用。	IUIComponent
		visible : Boolean 显示对象是否可见。	IFlexDisplayObject
		width : Number 表示显示对象的宽度，以像素为单位。	IFlexDisplayObject
		x : Number 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。	IFlexDisplayObject
		y : Number 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。	IFlexDisplayObject

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	IEventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	IEventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。	IFlexDisplayObject
		getExplicitOrMeasuredHeight():Number 确定是使用显式高度还是测量高度的一种简便方法	IUIComponent
		getExplicitOrMeasuredWidth():Number 确定是使用显式宽度还是测量宽度的一种简便方法	IUIComponent
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。	IFlexDisplayObject
		globalToLocal(point:Point):Point 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。	IFlexDisplayObject
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	IEventDispatcher
		hitTestObject(obj:DisplayObject):Boolean 计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。	IFlexDisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。	IFlexDisplayObject
		initialize():void 初始化对象。	IUIComponent
		localToGlobal(point:Point):Point 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。	IFlexDisplayObject
		move(x:Number, y:Number):void 将此对象移动到指定的 x 和 y 坐标。	IFlexDisplayObject
		owns(displayObject:DisplayObject):Boolean 如果 owner 属性链从 child 指向此 UIComponent，则返回 true。	IUIComponent
		parentChanged(p:DisplayObjectContainer):void 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。	IUIComponent
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	IEventDispatcher
		setActualSize(newWidth:Number, newHeight:Number):void 设置此对象的实际大小。	IFlexDisplayObject
		setVisible(value:Boolean, noEvent:Boolean = false):void 当 visible 属性发生更改时调用。	IUIComponent
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	IEventDispatcher

属性详细信息

baselinePosition

属性

baselinePosition:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

实现
public function get baselinePosition():Number

document

属性

document:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get document():Object
public function set document(value:Object):void

enabled

属性

enabled:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get enabled():Boolean
public function set enabled(value:Boolean):void

explicitHeight

属性

explicitHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

相关 API 元素

mx.core.UIComponent.explicitHeight

explicitMaxHeight

属性

explicitMaxHeight:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get explicitMaxHeight():Number

相关 API 元素

mx.core.UIComponent.explicitMaxHeight

explicitMaxWidth

属性

explicitMaxWidth:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get explicitMaxWidth():Number

相关 API 元素

mx.core.UIComponent.explicitMaxWidth

explicitMinHeight

属性

explicitMinHeight:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get explicitMinHeight():Number

相关 API 元素

mx.core.UIComponent.explicitMinHeight

explicitMinWidth

属性

explicitMinWidth:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get explicitMinWidth():Number

相关 API 元素

mx.core.UIComponent.explicitMinWidth

explicitWidth

属性

explicitWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

相关 API 元素

mx.core.UIComponent.explicitWidth

focusPane

属性

focusPane:Sprite

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

相关 API 元素

mx.core.UIComponent.focusPane

includeInLayout

属性

includeInLayout:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定此组件是否包含在父容器的布局中。如果为 true，则该对象将包含在其父容器的布局中，并由其父容器根据其布局规则调整其大小并确定其位置。如果为 false，则对象的父容器的布局不影响该对象的大小和位置。

实现
public function get includeInLayout():Boolean
public function set includeInLayout(value:Boolean):void

isPopUp

属性

isPopUp:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get isPopUp():Boolean
public function set isPopUp(value:Boolean):void

maxHeight

属性

maxHeight:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get maxHeight():Number

相关 API 元素

mx.core.UIComponent.maxHeight

maxWidth

属性

maxWidth:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get maxWidth():Number

相关 API 元素

mx.core.UIComponent.maxWidth

measuredMinHeight

属性

measuredMinHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

measuredMinWidth

属性

measuredMinWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

minHeight

属性

minHeight:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get minHeight():Number

相关 API 元素

mx.core.UIComponent.minHeight

minWidth

属性

minWidth:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get minWidth():Number

相关 API 元素

mx.core.UIComponent.minWidth

owner

属性

owner:DisplayObjectContainer

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此 IVisualElement 对象的所有者。默认情况下，它是此 IVisualElement 对象的父代。不过，如果此 IVisualElement 对象是由其父代弹出的一个子组件（如 ComboBox 控件的下拉列表），则所有者是弹出此 IVisualElement 对象的组件。

此属性并非由 Flex 管理，而由各个组件管理。因此，如果使用 PopUpManger.createPopUp() 或 PopUpManger.addPopUp() 方法弹出一个子组件，则应该将该子组件的 owner 属性设置为弹出它的组件。

默认值为 parent 属性的值。

实现
public function get owner():DisplayObjectContainer
public function set owner(value:DisplayObjectContainer):void

percentHeight

属性

percentHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

percentWidth

属性

percentWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

systemManager

属性

systemManager:ISystemManager

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get systemManager():ISystemManager
public function set systemManager(value:ISystemManager):void

tweeningProperties

属性

tweeningProperties:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get tweeningProperties():Array
public function set tweeningProperties(value:Array):void

方法详细信息

getExplicitOrMeasuredHeight

()

方法

public function getExplicitOrMeasuredHeight():Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

Number — 一个 Number，在已定义的情况下是 explicitHeight，在未定义的情况下是 measuredHeight。

getExplicitOrMeasuredWidth

()

方法

public function getExplicitOrMeasuredWidth():Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

Number — 一个 Number，在已定义的情况下是 explicitWidth，在未定义的情况下是 measuredWidth。

initialize

()

方法

public function initialize():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

初始化对象。

相关 API 元素

mx.core.UIComponent.initialize()

owns

()

方法

public function owns(displayObject:DisplayObject):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

displayObject:DisplayObject — 一个 UIComponent。

Boolean — 如果子项以此 UIComponent 为父项或归其所有，则为 true。

parentChanged

()

方法

public function parentChanged(p:DisplayObjectContainer):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

setVisible

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

	`value:Boolean` — `visible` 属性的新值。指定 `true` 可显示组件，指定 `false` 可隐藏组件。

	`noEvent:Boolean` (default = `false`) — 如果为 `true`，则不调度事件。如果为 `false`，则当组件变为可见时调度 `show` 事件，当组件变为不可见时调度 `hide` 事件。

法律声明 | 在线隐私策略

IUIComponent - AS3 Flex

类 x

baselinePosition

document

enabled

explicitHeight

explicitMaxHeight

explicitMaxWidth

explicitMinHeight

explicitMinWidth

explicitWidth

focusPane

includeInLayout

isPopUp

maxHeight

maxWidth

measuredMinHeight

measuredMinWidth

minHeight

minWidth

owner

percentHeight

percentWidth

systemManager

tweeningProperties

getExplicitOrMeasuredHeight

getExplicitOrMeasuredWidth

initialize

owns

parentChanged

setVisible