交互式组件可以参与 Tab 切换和其它几种键盘焦点处理,接受低级事件(如键盘和鼠标输入),还可以被禁用,以便该组件不能收到键盘和鼠标输入。这与非交互式组件(如 Label 和 ProgressBar)相反,非交互式组件只显示内容且不能由用户操作。
UIComponent 类不作为 MXML 标签使用,而作为其它类的基类使用。
MXML 语法隐藏 MXML 语法All user interface components in Flex extend the UIComponent class. Flex components inherit the following properties from the UIComponent class:
<mx:tagname Properties automationName="null" cachePolicy="auto|on|off" currentState="null" doubleClickEnabled="false|true" enabled="true|false" explicitHeight="NaN" explicitMaxHeight="NaN" explicitMaxWidth="NaN" explicitMinHeight="NaN" explicitMinWidth="NaN" explicitWidth="NaN" focusEnabled="true|false" height="0" id="" includeInLayout="true|false" maxHeight="10000" maxWidth="10000" measuredHeight= measuredMinHeight= measuredMinWidth= measuredWidth= minHeight="0" minWidth="0" mouseFocusEnabled="true|false" percentHeight="NaN" percentWidth="NaN" scaleX="1.0" scaleY="1.0" states="null" styleName="undefined" toolTip="null" transitions="" validationSubField width="0" x="0" y="0" Styles bottom="undefined" errorColor="0xFF0000" focusBlendMode="normal" focusSkin="HaloFocusRect"" focusThickness="2" horizontalCenter="undefined" left="undefined" right="undefined" themeColor="haloGreen" top="undefined" verticalCenter="undefined" Effects addedEffect="No default" creationCompleteEffect="No default" focusInEffect="No default" focusOutEffect="No default" hideEffect="No default" mouseDownEffect="No default" mouseUpEffect="No default" moveEffect="No default" removedEffect="No default" resizeEffect="No default" rollOutEffect="No default" rollOverEffect="No default" showEffect="No default" Events add="No default" creationComplete="No default" currentStateChange="No default" currentStateChanging="No default" dragComplete="No default" dragDrop="No default" dragEnter="No default" dragExit="No default" dragOver="No default" effectEnd="No default" effectStart="No default" enterState="No default" exitState="No default" hide="No default" initialize="No default" invalid="No default" mouseDownOutside="No default" mouseWheelOutside="No default" move="No default" preinitialize="No default" record="No default" remove="No default" resize="No default" show="No default" toolTipCreate="No default" toolTipEnd="No default" toolTipHide="No default" toolTipShow="No default" toolTipShown="No default" toolTipStart="No default" updateComplete="No default" valid="No default" valueCommit="No default" >
另请参见
属性 | 定义方 | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。 | DisplayObject | ||
activeEffects : Array [只读 (read-only)] 组件上当前播放的效果列表,如 EffectInstance 实例的 Array。 | UIComponent | ||
alpha : Number 指示指定对象的 Alpha 透明度值。 | DisplayObject | ||
automationDelegate : Object 处理自动化相关功能的委托对象。 | UIComponent | ||
automationName : String 可用作此对象的标识符的名称。 | UIComponent | ||
automationTabularData : Object [只读 (read-only)] IAutomationTabularData 接口的实现,可用于检索数据。 | UIComponent | ||
automationValue : Array [只读 (read-only)] 此值通常对应于对象的经渲染的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。 | UIComponent | ||
baselinePosition : Number [只读 (read-only)] 组件第一行文本的基线的 y 坐标。 | UIComponent | ||
blendMode : String BlendMode 类中的一个值,用于指定要使用的混合模式。 | DisplayObject | ||
blendShader : Shader [只写] 设置用于混合前景和背景的着色器。 | DisplayObject | ||
buttonMode : Boolean 指定此 sprite 的按钮模式。 | Sprite | ||
cacheAsBitmap : Boolean 如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。 | DisplayObject | ||
cacheHeuristic : Boolean [只写] 供 Flex 使用,表示建议为对象实施位图缓存。 | UIComponent | ||
cachePolicy : String 指定此对象的位图缓存策略。 | UIComponent | ||
className : String [只读 (read-only)] 此实例的类的名称,如“Button”。 | UIComponent | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
contentMouseX : Number [只读 (read-only)] 返回鼠标在内容坐标系中的 x 位置。 | UIComponent | ||
contentMouseY : Number [只读 (read-only)] 返回内容坐标系中鼠标的 y 位置。 | UIComponent | ||
contextMenu : NativeMenu 指定与此对象相关联的上下文菜单。 | InteractiveObject | ||
currentState : String 组件的当前视图状态。 | UIComponent | ||
cursorManager : ICursorManager [只读 (read-only)] 获取控制此组件及其同级组件的光标的 CursorManager。 | UIComponent | ||
descriptor : UIComponentDescriptor 引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | UIComponent | ||
document : Object 引用与此 UIComponent 相关联的文档对象。 | UIComponent | ||
doubleClickEnabled : Boolean 指定 UIComponent 对象是否接收 doubleClick 事件。 | UIComponent | ||
dropTarget : DisplayObject [只读 (read-only)] 指定拖动 sprite 时经过的显示对象,或放置 sprite 的显示对象。 | Sprite | ||
enabled : Boolean 组件是否可以接受用户交互。 | UIComponent | ||
errorString : String 当验证程序监视组件并且验证失败时,组件的错误提示中将显示的文本。 | UIComponent | ||
explicitHeight : Number 指定该组件在组件坐标中显式高度(以像素为单位)的数字。 | UIComponent | ||
explicitMaxHeight : Number 布局过程中父级要考虑的组件最大建议高度。 | UIComponent | ||
explicitMaxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | ||
explicitMinHeight : Number 布局过程中父级要考虑的组件最小建议高度。 | UIComponent | ||
explicitMinWidth : Number 布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | ||
explicitWidth : Number 指定该组件在组件坐标中显式宽度(以像素为单位)的数字。 | UIComponent | ||
filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。 | DisplayObject | ||
flexContextMenu : IFlexContextMenu 此 UIComponent 的上下文菜单。 | UIComponent | ||
focusEnabled : Boolean 指示切换到此组件时,是否可以接收焦点。 | UIComponent | ||
focusManager : IFocusManager 获取控制此组件及其同级组件的焦点的 FocusManager。 | UIComponent | ||
focusPane : Sprite 与此对象相关联的焦点窗格。 | UIComponent | ||
focusRect : Object 指定此对象是否显示焦点矩形。 | InteractiveObject | ||
graphics : Graphics [只读 (read-only)] 指定属于此 sprite 的 Graphics 对象,在此 sprite 中可执行矢量绘画命令。 | Sprite | ||
height : Number 指定组件在父坐标中的高度的数字(以像素为单位)。 | UIComponent | ||
hitArea : Sprite 指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | ||
id : String 组件 ID。 | UIComponent | ||
includeInLayout : Boolean 指定此组件是否包含在父容器的布局中。 | UIComponent | ||
inheritingStyles : Object 此组件的继承样式链的开头内容。 | UIComponent | ||
initialized : Boolean 一个标志,用于确定某个对象是否已通过布局的所有三个阶段:提交、测量和布局(假设每个阶段都是必需的)。 | UIComponent | ||
instanceIndex : int [只读 (read-only)] 重复组件的索引。 | UIComponent | ||
instanceIndices : Array 一个 Array,包含从此 UIComponent 对象的父文档引用该对象所需的索引。 | UIComponent | ||
isDocument : Boolean [只读 (read-only)] 确定此 UIComponent 实例是否为文档对象,也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。 | UIComponent | ||
isPopUp : Boolean PopUpManager 将其设置为 true 以指示已弹出该组件。 | UIComponent | ||
loaderInfo : LoaderInfo [只读 (read-only)] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | ||
mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | ||
maxHeight : Number 布局过程中父级要考虑的组件最大建议高度。 | UIComponent | ||
maxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | ||
measuredHeight : Number 组件的默认高度(以像素为单位)。 | UIComponent | ||
measuredMinHeight : Number 组件的默认最小高度(以像素为单位)。 | UIComponent | ||
measuredMinWidth : Number 组件的默认最小宽度(以像素为单位)。 | UIComponent | ||
measuredWidth : Number 组件的默认宽度(以像素为单位)。 | UIComponent | ||
minHeight : Number 布局过程中父级要考虑的组件最小建议高度。 | UIComponent | ||
minWidth : Number 布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | ||
moduleFactory : IFlexModuleFactory 用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。 | UIComponent | ||
mouseChildren : Boolean 确定对象的子项是否支持鼠标。 | DisplayObjectContainer | ||
mouseEnabled : Boolean 指定此对象是否接收鼠标消息。 | InteractiveObject | ||
mouseFocusEnabled : Boolean 单击时是否可接收焦点。 | UIComponent | ||
mouseX : Number [只读 (read-only)] 指示鼠标位置的 x 坐标,以像素为单位。 | DisplayObject | ||
mouseY : Number [只读 (read-only)] 指示鼠标位置的 y 坐标,以像素为单位。 | DisplayObject | ||
name : String 指示 DisplayObject 的实例名称。 | DisplayObject | ||
nestLevel : int 此对象在所属关系层次结构中的深度。 | UIComponent | ||
nonInheritingStyles : Object 此组件的非继承样式链的开头内容。 | UIComponent | ||
numAutomationChildren : int [只读 (read-only)] 此容器包含的自动化子项数。 | UIComponent | ||
numChildren : int [只读 (read-only)] 返回此对象的子项数目。 | DisplayObjectContainer | ||
opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | ||
owner : DisplayObjectContainer 此 UIComponent 的所有者。 | UIComponent | ||
parent : DisplayObjectContainer [只读 (read-only)] 此组件的父容器或组件。 | UIComponent | ||
parentApplication : Object [只读 (read-only)] 引用包含此 UIComponent 实例的 Application 对象。 | UIComponent | ||
parentDocument : Object [只读 (read-only)] 引用此 UIComponent 的父文档对象。 | UIComponent | ||
percentHeight : Number 以组件父项大小百分比的方式指定组件高度的数字。 | UIComponent | ||
percentWidth : Number 以组件父项大小百分比形式指定其宽度的数字。 | UIComponent | ||
processedDescriptors : Boolean 临时或延迟子项创建操作后设置为 true,具体取决于发生对象。 | UIComponent | ||
prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | ||
repeater : IRepeater [只读 (read-only)] 对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | ||
repeaterIndex : int [只读 (read-only)] 项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。 | UIComponent | ||
repeaterIndices : Array 一个 Array,包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。 | UIComponent | ||
repeaters : Array 一个 Array,包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | ||
root : DisplayObject [只读 (read-only)] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | ||
rotation : Number 指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。 | DisplayObject | ||
rotationX : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转(以度为单位)。 | DisplayObject | ||
rotationY : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转(以度为单位)。 | DisplayObject | ||
rotationZ : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转(以度为单位)。 | DisplayObject | ||
scale9Grid : Rectangle 当前有效的缩放网格。 | DisplayObject | ||
scaleX : Number 用于指定水平缩放系数的数字。 | UIComponent | ||
scaleY : Number 用于指定垂直缩放系数的数字。 | UIComponent | ||
scaleZ : Number 指示从对象的注册点开始应用的对象的深度缩放比例(百分比)。 | DisplayObject | ||
screen : Rectangle [只读 (read-only)] 返回包含此对象的基本绘图表面大小和位置的对象。 | UIComponent | ||
scrollRect : Rectangle 显示对象的滚动矩形范围。 | DisplayObject | ||
showInAutomationHierarchy : Boolean 用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | ||
soundTransform : SoundTransform 控制此 sprite 中的声音。 | Sprite | ||
stage : Stage [只读 (read-only)] 显示对象的舞台。 | DisplayObject | ||
states : Array 为此组件定义的视图状态。 | UIComponent | ||
styleDeclaration : CSSStyleDeclaration 存储此对象的内嵌继承样式。 | UIComponent | ||
styleName : Object 此组件使用的类样式。 | UIComponent | ||
systemManager : ISystemManager 返回此组件使用的 SystemManager 对象。 | UIComponent | ||
tabChildren : Boolean 确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | ||
tabEnabled : Boolean 指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | ||
tabIndex : int 指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | ||
textSnapshot : TextSnapshot [只读 (read-only)] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | ||
toolTip : String 要在 ToolTip 中显示的文本。 | UIComponent | ||
transform : Transform 一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | DisplayObject | ||
transitions : Array 一个 Transition 对象 Array,其中的每个 Transition 对象都定义一组效果,用于在视图状态发生更改时播放。 | UIComponent | ||
tweeningProperties : Array 当前在此对象上进行补间的属性数组。 | UIComponent | ||
uid : String 对象的唯一标识符。 | UIComponent | ||
updateCompletePendingFlag : Boolean 一个标志,确定某个对象是否已通过所有三个阶段的布局验证(假设需要通过所有验证)。 | UIComponent | ||
useHandCursor : Boolean 布尔值,指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形(手形光标)。 | Sprite | ||
validationSubField : String 供验证程序用来将子字段与此组件相关联。 | UIComponent | ||
visible : Boolean 控制此 UIComponent 的可见性。 | UIComponent | ||
width : Number 指定组件在父坐标中的宽度的数字(以像素为单位)。 | UIComponent | ||
x : Number 指定组件在其父容器中的水平位置(以像素为单位)的数字。 | UIComponent | ||
y : Number 指定组件在其父容器中的垂直位置(以像素为单位)的数字。 | UIComponent | ||
z : Number 指示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | DisplayObject |
属性 | 定义方 | ||
---|---|---|---|
resourceManager : IResourceManager [只读 (read-only)] 引用管理所有应用程序本地化资源的对象。 | UIComponent | ||
unscaledHeight : Number [只读 (read-only)] 用于确定组件的未缩放高度的简便方法。 | UIComponent | ||
unscaledWidth : Number [只读 (read-only)] 用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成,还应将此宽度作为参数传递到 updateDisplayList() 中。 | UIComponent |
方法 | 定义方 | ||
---|---|---|---|
构造函数。 | UIComponent | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | ||
排队稍后调用的函数。 | UIComponent | ||
删除此组件实例中的样式属性。 | UIComponent | ||
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | ||
将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | ||
将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | ||
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | ||
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | ||
将事件调度到事件流中。 | UIComponent | ||
在此组件周围显示或隐藏焦点指示符。 | UIComponent | ||
drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | ||
停止在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
开始在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
结束组件上当前播放的所有效果。 | UIComponent | ||
将数据绑定到此 UIComponent 对象。 | UIComponent | ||
打印完成后调用。 | UIComponent | ||
在指定的索引位置提供自动化对象。 | UIComponent | ||
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | ||
返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | ||
返回具有指定名称的子显示对象。 | DisplayObjectContainer | ||
返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | ||
查找此 UIComponent 实例的类型选择器。 | UIComponent | ||
返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | ||
确定是使用显式高度还是测量高度的一种简便方法 | UIComponent | ||
确定是使用显式宽度还是测量宽度的一种简便方法 | UIComponent | ||
获取当前具有焦点的对象。 | UIComponent | ||
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | ||
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | ||
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | ||
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | ||
将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | ||
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | ||
将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
指示对象是否已经定义了指定的属性。 | Object | ||
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | ||
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | ||
返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | ||
初始化此组件的内部结构。 | UIComponent | ||
初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | ||
将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | ||
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | ||
测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标记),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | ||
测量指定的文本,假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | ||
将组件移动到其父项内的指定位置。 | UIComponent | ||
将样式更改传播到子项。 | UIComponent | ||
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | ||
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | ||
准备 IFlexDisplayObject 用于打印。 | UIComponent | ||
指示指定的属性是否存在、是否可枚举。 | Object | ||
为此组件构建或重新构建 CSS 样式缓存;如果 recursive 参数为 true,还会为此组件的所有后代执行同样的操作。 | UIComponent | ||
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | ||
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | ||
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
重放指定的事件。 | UIComponent | ||
使用提供的 ID 解析子项。 | UIComponent | ||
[静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | ||
调整对象大小。 | UIComponent | ||
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | ||
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | ||
设置当前状态。 | UIComponent | ||
设置此组件的焦点。 | UIComponent | ||
设置循环操作动态属性的可用性。 | Object | ||
对此组件实例设置样式属性。 | UIComponent | ||
当 visible 属性发生更改时调用。 | UIComponent | ||
允许用户拖动指定的 Sprite。 | Sprite | ||
结束 startDrag() 方法。 | Sprite | ||
检测对样式属性的更改。 | UIComponent | ||
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | ||
[静态] 阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | ||
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | ||
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | ||
返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | ||
验证子项的位置和大小,并绘制其它可视内容。 | UIComponent | ||
验证并更新此对象的属性和布局,如果需要的话重绘对象。 | UIComponent | ||
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | ||
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。 | UIComponent | ||
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | ||
返回指定对象的原始值。 | Object | ||
返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | ||
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher |
方法 | 定义方 | ||
---|---|---|---|
调整焦点矩形。 | UIComponent | ||
这是一个内部方法,供 Flex 框架用于支持 Dissolve 效果。 | UIComponent | ||
创建子对象后执行任何最终处理。 | UIComponent | ||
处理对组件设置的属性。 | UIComponent | ||
创建组件的子对象。 | UIComponent | ||
根据所用的嵌入字体使用上下文创建新对象。 | UIComponent | ||
使用给定的 moduleFactory 创建对象。 | UIComponent | ||
当 UIComponent 对象获得焦点时调用的事件处理函数。 | UIComponent | ||
当 UIComponent 对象失去焦点时调用的事件处理函数。 | UIComponent | ||
完成对此组件的初始化。 | UIComponent | ||
初始化此组件的辅助功能代码。 | UIComponent | ||
通常由包含 UITextField 对象的组件覆盖,其中 UITextField 对象获取焦点。 | UIComponent | ||
为 keyDown 事件调用的事件处理函数。 | UIComponent | ||
为 keyUp 事件调用的事件处理函数。 | UIComponent | ||
计算组件的默认大小和(可选)默认最小大小。 | UIComponent | ||
构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。 | UIComponent | ||
绘制对象和/或设置其子项的大小和位置。 | UIComponent |
事件 | 摘要 | 定义方 | ||
---|---|---|---|---|
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | |||
使用 addChild() 或 addChildAt() 方法将组件作为内容子项添加到容器时调度。 | UIComponent | |||
将显示对象添加到显示列表中时调度。 | DisplayObject | |||
在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | |||
当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。 | InteractiveObject | |||
用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | |||
当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | |||
当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | |||
当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | |||
视图状态更改后调度。 | UIComponent | |||
在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | |||
当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | |||
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | |||
如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | |||
在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。 | UIComponent | |||
用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | |||
当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。 | UIComponent | |||
用户在组件外拖动但没有将数据放置到目标时,由组件调度。 | UIComponent | |||
在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。 | UIComponent | |||
启动拖动操作时,由拖动启动器调度。 | UIComponent | |||
在一个效果结束后调度。 | UIComponent | |||
在即将开始播放效果前调度。 | UIComponent | |||
[播放事件] 播放头进入新帧时调度。 | DisplayObject | |||
组件返回到根视图状态之后调度。 | UIComponent | |||
[广播事件] 播放头退出当前帧时调度。 | DisplayObject | |||
组件退出根视图状态之前调度。 | UIComponent | |||
显示对象获得焦点后调度。 | InteractiveObject | |||
显示对象失去焦点后调度。 | InteractiveObject | |||
[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | DisplayObject | |||
当对象的状态从可见变为不可见时调度。 | UIComponent | |||
当组件完成构建并设置了所有初始化属性后调度。 | UIComponent | |||
当组件由 Validator 监控且未通过验证时调度。 | UIComponent | |||
用户按下某个键时调度。 | InteractiveObject | |||
用户尝试使用键盘导航更改焦点时调度。 | InteractiveObject | |||
用户释放某个键时调度。 | InteractiveObject | |||
当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | |||
当用户在使用 PopUpManager 打开的某个组件外部单击时,从该组件调度。 | UIComponent | |||
用户尝试使用指针设备更改焦点时调度。 | InteractiveObject | |||
用户移动 InteractiveObject 上的指针设备时调度。 | InteractiveObject | |||
用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | |||
用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
当鼠标滚轮滚动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时,从该组件调度。 | UIComponent | |||
移动对象后调度。 | UIComponent | |||
当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。 | InteractiveObject | |||
在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。 | InteractiveObject | |||
当拖动动作进入其边界时由 InteractiveObject 调度。 | InteractiveObject | |||
当拖动动作离开其边界时由 InteractiveObject 调度。 | InteractiveObject | |||
当拖动动作保持在其边界内时,由 InteractiveObject 持续调度。 | InteractiveObject | |||
在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | |||
在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | |||
当用户激活特定于平台的粘贴操作的快捷键组合或从文本上下文菜单中选择“粘贴”时调度。 | InteractiveObject | |||
在组件初始化序列开始时调度。 | UIComponent | |||
使用 removeChild() 或 removeChildAt() 方法将组件作为内容子项从容器中删除时调度。 | UIComponent | |||
将要从显示列表中删除显示对象时调度。 | DisplayObject | |||
在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | |||
[广播事件] 将要更新和呈现显示列表时调度。 | DisplayObject | |||
在调整组件大小时调度。 | UIComponent | |||
当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | |||
用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。 | InteractiveObject | |||
当对象的状态从不可见变为可见时调度。 | UIComponent | |||
对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | |||
对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | |||
对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | |||
要创建 ToolTip 时由组件调度。 | UIComponent | |||
已隐藏组件的 ToolTip 并要将其放弃时由组件调度。 | UIComponent | |||
要隐藏组件的 ToolTip 时由组件调度。 | UIComponent | |||
要显示组件的 ToolTip 时由组件调度。 | UIComponent | |||
显示组件的 ToolTip 时由组件调度。 | UIComponent | |||
用户将鼠标移动到设置了 toolTip 属性的组件上方后,由该组件调度。 | UIComponent | |||
当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度(如果需要)。 | UIComponent | |||
当组件由 Validator 监控并且成功通过验证时调度。 | UIComponent | |||
当以编程方式或通过用户交互更改值时调度。 | UIComponent |
样式 | 说明 | 定义方 | ||
---|---|---|---|---|
baseline | 类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位)。如果设置此样式,则组件的基线锚定在其内容区域的上边缘;调整组件容器大小后,这两个边缘将保持它们的间距。
此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(
默认值为 | UIComponent | ||
bottom | 类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的下边缘锚定在其内容区域的下边缘;调整组件容器大小后,这两个边缘将保持它们的间距。
此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(
默认值为 | UIComponent | ||
errorColor | 类型: uint 格式: Color CSS 继承: yes 验证失败时,组件加亮部分的颜色。验证失败时,Flex 还会将组件的 borderColor 样式设置为 errorColor 。
默认值为 0xFF0000 . | UIComponent | ||
focusBlendMode | 类型: String CSS 继承: no 焦点矩形使用的混合模式。有关详细信息,请参阅 flash.display.DisplayObject 类的 blendMode 属性。
默认值为 "normal" . | UIComponent | ||
focusSkin | 类型: Class CSS 继承: no 用于绘制焦点矩形的外观。 默认值为 mx.skins.halo.HaloFocusRect . | UIComponent | ||
focusThickness | 类型: Number 格式: Length CSS 继承: no 焦点矩形轮廓的粗细,以像素为单位。 默认值为 2 . | UIComponent | ||
horizontalCenter | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整组件容器大小后,这两个中心将保持它们的水平间距。
此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(
默认值为 | UIComponent | ||
left | 类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离(以像素为单位)。如果设置此样式,则组件的左边缘锚定在其内容区域的左边缘;调整组件容器大小后,这两个边缘将保持它们的间距。
此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(
默认值为 | UIComponent | ||
right | 类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离(以像素为单位)。如果设置此样式,则组件的右边缘锚定在其内容区域的右边缘;调整组件容器大小后,这两个边缘将保持它们的间距。
此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(
默认值为 | UIComponent | ||
themeColor | 类型: uint 格式: Color CSS 继承: yes 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示,但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值,但首选值为 haloGreen 、haloBlue 、haloOrange 和 haloSilver 。
"haloBlue" . | UIComponent | ||
top | 类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的上边缘锚定在其内容区域的上边缘;调整其容器大小后,这两个边缘将保持其间距。
此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(
默认值为 | UIComponent | ||
verticalCenter | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整其容器大小后,这两个中心将保持其垂直间距。
此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(
默认值为 | UIComponent |
常量 | 定义方 | ||
---|---|---|---|
DEFAULT_MAX_HEIGHT : Number = 10000 [静态] maxHeight 属性的默认值。 | UIComponent | ||
DEFAULT_MAX_WIDTH : Number = 10000 [静态] maxWidth 属性的默认值。 | UIComponent | ||
DEFAULT_MEASURED_HEIGHT : Number = 22 [静态] measuredHeight 属性的默认值。 | UIComponent | ||
DEFAULT_MEASURED_MIN_HEIGHT : Number = 22 [静态] measuredMinHeight 属性的默认值。 | UIComponent | ||
DEFAULT_MEASURED_MIN_WIDTH : Number = 40 [静态] measuredMinWidth 属性的默认值。 | UIComponent | ||
DEFAULT_MEASURED_WIDTH : Number = 160 [静态] measuredWidth 属性的默认值。 | UIComponent |
activeEffects | 属性 |
activeEffects:Array
[只读 (read-only)] 组件上当前播放的效果列表,如 EffectInstance 实例的 Array。
public function get activeEffects():Array
automationDelegate | 属性 |
automationDelegate:Object
[读写] 处理自动化相关功能的委托对象。
public function get automationDelegate():Object
public function set automationDelegate(value:Object):void
automationName | 属性 |
automationName:String
[读写] 可用作此对象的标识符的名称。
public function get automationName():String
public function set automationName(value:String):void
automationTabularData | 属性 |
automationTabularData:Object
[只读 (read-only)]
IAutomationTabularData
接口的实现,可用于检索数据。
public function get automationTabularData():Object
automationValue | 属性 |
automationValue:Array
[只读 (read-only)] 此值通常对应于对象的经渲染的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。
public function get automationValue():Array
baselinePosition | 属性 |
baselinePosition:Number
[只读 (read-only)] 组件第一行文本的基线的 y 坐标。
此属性用于实现 baseline
约束样式,还可用于将 FormItem 的标签与 FormItem 中的控件对齐。
各组件应覆盖此属性。
public function get baselinePosition():Number
cacheHeuristic | 属性 |
cacheHeuristic:Boolean
[只写]
供 Flex 使用,表示建议为对象实施位图缓存。如果 cachePolicy
为 UIComponentCachePolicy.AUTO
,则 cacheHeuristic
用于控制对象的 cacheAsBitmap
属性。
public function set cacheHeuristic(value:Boolean):void
cachePolicy | 属性 |
cachePolicy:String
[读写]
指定此对象的位图缓存策略。在 MXML 中,可能值为 "on"
、"off"
和 "auto"
(默认值)。
在 ActionScript 中,可能值为 UIComponentCachePolicy.ON
、UIComponentCachePolicy.OFF
和 UIComponentCachePolicy.AUTO
(默认值)。
UIComponentCachePolicy.ON
,则表示对象始终作为位图缓存。
UIComponentCachePolicy.OFF
,则表示对象从不作为位图缓存。
UIComponentCachePolicy.AUTO
,则表示框架将使用试探法确定此对象是否应作为位图缓存。
默认值为 UIComponentCachePolicy.AUTO.
public function get cachePolicy():String
public function set cachePolicy(value:String):void
className | 属性 |
className:String
[只读 (read-only)]
此实例的类的名称,如 "Button"
。
此字符串不包括包名称。如果您还需要包名称,请调用 flash.utils 包中的 getQualifiedClassName()
方法。它将返回一个字符串,如 "mx.controls::Button"
。
public function get className():String
contentMouseX | 属性 |
contentMouseX:Number
[只读 (read-only)] 返回鼠标在内容坐标系中的 x 位置。内容坐标指定的像素位置随组件内容的左上角而变化,并包括组件的所有内容区域,甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。
public function get contentMouseX():Number
contentMouseY | 属性 |
contentMouseY:Number
[只读 (read-only)] 返回内容坐标系中鼠标的 y 位置。内容坐标指定的像素位置随组件内容的左上角而变化,并包括组件的所有内容区域,甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。
public function get contentMouseY():Number
currentState | 属性 |
currentState:String
[读写]
组件的当前视图状态。将其设置为 ""
或 null
可将组件重置回其基本状态。
当您使用此属性设置组件的状态时,Flex 将应用您定义的转移。您还可以使用 setCurrentState()
方法设置当前状态,此方法可以有选择性地更改状态,而无需应用转移。
此属性可用作数据绑定的源。修改此属性后,将调度 currentStateChange
事件。
public function get currentState():String
public function set currentState(value:String):void
另请参见
cursorManager | 属性 |
cursorManager:ICursorManager
[只读 (read-only)] 获取控制此组件及其同级组件的光标的 CursorManager。每个顶级窗口都包含自己的 CursorManager 实例;为确保使用的实例正确,请使用此方法。
public function get cursorManager():ICursorManager
descriptor | 属性 |
descriptor:UIComponentDescriptor
[读写]
引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor()
方法使用它来创建此 UIComponent 实例。如果此 UIComponent 实例并非基于描述符创建,则此属性为 null。
public function get descriptor():UIComponentDescriptor
public function set descriptor(value:UIComponentDescriptor):void
另请参见
document | 属性 |
document:Object
[读写] 引用与此 UIComponent 相关联的文档对象。文档对象是位于 Flex 应用程序、MXML 组件或 AS 组件层次结构顶层的 Object。
public function get document():Object
public function set document(value:Object):void
doubleClickEnabled | 属性 |
doubleClickEnabled:Boolean
[读写]
指定 UIComponent 对象是否接收 doubleClick
事件。默认值为 false
,即 UIComponent 对象不接收 doubleClick
事件。
还必须将 mouseEnabled
属性设置为 true
(默认值),这样对象才能接收 doubleClick
事件。
默认值为 false.
public function get doubleClickEnabled():Boolean
public function set doubleClickEnabled(value:Boolean):void
enabled | 属性 |
enabled:Boolean
[读写]
组件是否可以接受用户交互。将 enabled
属性设置为 false
后,某些组件仍会响应鼠标交互,如 mouseOver。因此,要完全禁用 UIComponent,您应该将 mouseEnabled
属性的值也设置为 false
。如果将容器的 enabled
属性设置为 false
,则 Flex 会使该容器及其所有子项的颜色变暗,并阻止用户向容器及其所有子项输入内容。
此属性可用作数据绑定的源。修改此属性后,将调度 enabledChanged
事件。
public function get enabled():Boolean
public function set enabled(value:Boolean):void
errorString | 属性 |
errorString:String
[读写] 当验证程序监视组件并且验证失败时,组件的错误提示中将显示的文本。
您可以使用 errorString
属性显示组件的验证错误,而无需实际使用 validator 类。当您将 String 值写入 errorString
属性时,Flex 将在组件周围绘制红色边框以指示验证错误,并且当您将鼠标指针移至组件上方时,该 String 将作为验证错误消息显示在工具提示中,就像验证程序检测到验证错误一样。
若要清除验证错误,请为 errorString
属性写入一个空 String ""。
请注意,为 errorString
属性写入值不会触发 valid 或 invalid 事件,只会更改边框颜色和显示验证错误消息。
此属性可用作数据绑定的源。修改此属性后,将调度 errorStringChanged
事件。
public function get errorString():String
public function set errorString(value:String):void
explicitHeight | 属性 |
explicitHeight:Number
[读写] 指定该组件在组件坐标中显式高度(以像素为单位)的数字。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于该值是组件坐标值,因此针对其父项的真正 explicitHeight
受 scaleY
属性影响。
设置 height
属性,同时也会将此属性设置为指定的高度值。
此属性可用作数据绑定的源。修改此属性后,将调度 explicitHeightChanged
事件。
public function get explicitHeight():Number
public function set explicitHeight(value:Number):void
explicitMaxHeight | 属性 |
explicitMaxHeight:Number
[读写] 布局过程中父级要考虑的组件最大建议高度。此值采用组件坐标(以像素为单位)。
应用程序开发人员一般不设置 explicitMaxHeight 属性。而是设置 maxHeight 属性的值,该值设置 explicitMaxHeight 属性。不会更改 maxHeight 的值。
在布局过程中,如果应用程序开发人员明确设置了 maxHeight,则使用 explicitMaxHeight 的值。否则,使用 maxHeight 的默认值。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 maxHeight
受 scaleY
属性影响。有些组件从理论上没有高度限制。在这些情况下,可将其 maxHeight
设置为 UIComponent.DEFAULT_MAX_HEIGHT
。
默认值为 NaN.
此属性可用作数据绑定的源。修改此属性后,将调度 explicitMaxHeightChanged
事件。
public function get explicitMaxHeight():Number
public function set explicitMaxHeight(value:Number):void
explicitMaxWidth | 属性 |
explicitMaxWidth:Number
[读写] 布局过程中父级要考虑的组件最大建议宽度。此值采用组件坐标(以像素为单位)。
应用程序开发人员一般不设置 explicitMaxWidth 属性。而是设置 maxWidth 属性的值,该值设置 explicitMaxWidth 属性。不会更改 maxWidth 的值。
在布局过程中,如果应用程序开发人员明确设置了 maxWidth,则使用 explicitMaxWidth 的值。否则,使用 maxWidth 的默认值。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 maxWidth
受 scaleX
属性影响。有些组件从理论上没有宽度限制。在这些情况下,可将其 maxWidth
设置为 UIComponent.DEFAULT_MAX_WIDTH
。
默认值为 NaN.
此属性可用作数据绑定的源。修改此属性后,将调度 explicitMaxWidthChanged
事件。
public function get explicitMaxWidth():Number
public function set explicitMaxWidth(value:Number):void
explicitMinHeight | 属性 |
explicitMinHeight:Number
[读写] 布局过程中父级要考虑的组件最小建议高度。此值采用组件坐标(以像素为单位)。
应用程序开发人员一般不设置 explicitMinHeight 属性。而是设置 minHeight 属性的值,该值设置 explicitMinHeight 属性。不会更改 minHeight 的值。
在布局过程中,如果应用程序开发人员明确设置了 minHeight,则使用 explicitMinHeight 的值。否则,使用 measuredMinHeight 的值。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 minHeight
受 scaleY
属性影响。
默认值为 NaN.
此属性可用作数据绑定的源。修改此属性后,将调度 explictMinHeightChanged
事件。
public function get explicitMinHeight():Number
public function set explicitMinHeight(value:Number):void
explicitMinWidth | 属性 |
explicitMinWidth:Number
[读写] 布局过程中父级要考虑的组件最小建议宽度。此值采用组件坐标(以像素为单位)。
应用程序开发人员一般不设置 explicitMinWidth 属性。而是设置 minWidth 属性的值,该值设置 explicitMinWidth 属性。不会更改 minWidth 的值。
在布局过程中,如果应用程序开发人员明确设置了 minWidth,则使用 explicitMinWidth 的值。否则,使用 measuredMinWidth 的值。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 minWidth
受 scaleX
属性影响。
默认值为 NaN.
此属性可用作数据绑定的源。修改此属性后,将调度 explicitMinWidthChanged
事件。
public function get explicitMinWidth():Number
public function set explicitMinWidth(value:Number):void
explicitWidth | 属性 |
explicitWidth:Number
[读写] 指定该组件在组件坐标中显式宽度(以像素为单位)的数字。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于该值是组件坐标值,因此针对其父项的真正 explicitWidth
受 scaleX
属性影响。
设置 width
属性,同时也会将此属性设置为指定的宽度值。
此属性可用作数据绑定的源。修改此属性后,将调度 explicitWidthChanged
事件。
public function get explicitWidth():Number
public function set explicitWidth(value:Number):void
flexContextMenu | 属性 |
flexContextMenu:IFlexContextMenu
[读写] 此 UIComponent 的上下文菜单。
默认值为 null.
public function get flexContextMenu():IFlexContextMenu
public function set flexContextMenu(value:IFlexContextMenu):void
focusEnabled | 属性 |
focusEnabled:Boolean
[读写]
指示切换到此组件时,是否可以接收焦点。当 UIComponent 用作另一组件的子组件时,可以将 focusEnabled
设置为 false
,以便外部组件成为可获得焦点的实体。如果此属性是 false
,则焦点将转换到已将 focusEnable
设置为 true
的第一个父项。
默认值为 true.
public function get focusEnabled():Boolean
public function set focusEnabled(value:Boolean):void
focusManager | 属性 |
focusManager:IFocusManager
[读写] 获取控制此组件及其同级组件的焦点的 FocusManager。每个弹出框都有自己的焦点循环,因此也有自己的 FocusManager 实例。为确保使用的实例正确,请使用此方法。
public function get focusManager():IFocusManager
public function set focusManager(value:IFocusManager):void
focusPane | 属性 |
focusPane:Sprite
[读写] 与此对象相关联的焦点窗格。如果对象的任一子项包含焦点,该对象将具有焦点窗格。
public function get focusPane():Sprite
public function set focusPane(value:Sprite):void
height | 属性 |
height:Number
[读写] 指定组件在父坐标中的高度的数字(以像素为单位)。默认值为 0,但当 Flex 在应用程序中设置完组件的大小后,此属性将包含实际的组件高度。
请注意:您可以在 MXMLheight
属性中指定一个百分比值(如 height="100%"
),但无法在 ActionScript 的 height
属性中使用百分比值;可改用 percentHeight
属性。
设置此属性将导致 resize
事件被调度。有关何时调度此事件的详细信息,请参阅 resize
事件。如果组件的 scaleY
属性不是 100,则组件在其内部坐标中的高度将不匹配。因此,如果 100 个像素高的组件将 scaleY
设为 200,则会在父级中占用 100 个像素,但其内部高度被认为是 50 个像素。
此属性可用作数据绑定的源。修改此属性后,将调度 heightChanged
事件。
public function get height():Number
public function set height(value:Number):void
id | 属性 |
id:String
[读写] 组件 ID。此值将作为对象的实例名称,因此不应包含任何空格或特殊字符。应用程序中的每个组件都应具有唯一的 ID。
如果将使用第三方工具对您的应用程序进行测试,请为每个组件赋予一个有意义的 ID。测试工具使用 ID 代表其脚本中的控件,因此使用有意义的名称可使脚本更具可读性。例如,将某个按钮的值设置为 submit_button 而不是 b1 或 button1。
public function get id():String
public function set id(value:String):void
includeInLayout | 属性 |
includeInLayout:Boolean
[读写]
指定此组件是否包含在父容器的布局中。如果为 true
,则该对象包含在其父容器的布局中。如果为 false
,则由其父容器按布局规则定位该对象,但计算下一子项的位置时将忽略该对象。
默认值为 true.
此属性可用作数据绑定的源。修改此属性后,将调度 includeInLayoutChanged
事件。
public function get includeInLayout():Boolean
public function set includeInLayout(value:Boolean):void
inheritingStyles | 属性 |
inheritingStyles:Object
[读写]
此组件的继承样式链的开头内容。getStyle()
方法只需访问 inheritingStyles[styleName]
,即可搜索整个与原型链接的链。此对象由 initProtoChain()
设置。开发人员通常不需要直接访问此属性。
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
initialized | 属性 |
initialized:Boolean
[读写] 一个标志,用于确定某个对象是否已通过布局的所有三个阶段:提交、测量和布局(假设每个阶段都是必需的)。
public function get initialized():Boolean
public function set initialized(value:Boolean):void
instanceIndex | 属性 |
instanceIndex:int
[只读 (read-only)] 重复组件的索引。如果组件不在 Repeater 中,则值为 -1。
public function get instanceIndex():int
instanceIndices | 属性 |
instanceIndices:Array
[读写] 一个 Array,包含从此 UIComponent 对象的父文档引用该对象所需的索引。除非 UIComponent 对象位于一个或多个 Repeater 中,否则该 Array 为空。第一个元素与最外面的 Repeater 对应。例如,如果 id 为“b”并且 instanceIndices 为 [2,4],则在父文档中将以 b[2][4] 的形式对其引用。
public function get instanceIndices():Array
public function set instanceIndices(value:Array):void
isDocument | 属性 |
isDocument:Boolean
[只读 (read-only)] 确定此 UIComponent 实例是否为文档对象,也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。
public function get isDocument():Boolean
isPopUp | 属性 |
isPopUp:Boolean
[读写]
PopUpManager 将其设置为 true
以指示已弹出该组件。
public function get isPopUp():Boolean
public function set isPopUp(value:Boolean):void
maxHeight | 属性 |
maxHeight:Number
[读写] 布局过程中父级要考虑的组件最大建议高度。此值采用组件坐标(以像素为单位)。此属性的默认值由组件开发人员设置。
组件开发人员使用此属性设置组件高度的上限。
如果应用程序开发人员覆盖 maxHeight 的默认值,则将在 explicitMaxHeight 中存储新值。不会更改 maxHeight 的默认值。因此,在布局过程中,如果应用程序开发人员明确设置了 maxHeight,则对组件最大建议高度使用 explicitMaxHeight 的值。如果用户未明确设置 maxHeight,则使用默认值。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 maxHeight
受 scaleY
属性影响。有些组件从理论上没有高度限制。在这些情况下,可将其 maxHeight
设置为 UIComponent.DEFAULT_MAX_HEIGHT
。
默认值为 10000.
此属性可用作数据绑定的源。修改此属性后,将调度 explicitMaxHeightChanged
事件。
public function get maxHeight():Number
public function set maxHeight(value:Number):void
maxWidth | 属性 |
maxWidth:Number
[读写] 布局过程中父级要考虑的组件最大建议宽度。此值采用组件坐标(以像素为单位)。此属性的默认值由组件开发人员设置。
组件开发人员使用此属性设置组件宽度的上限。
如果应用程序开发人员覆盖 maxWidth 的默认值,则将在 explicitMaxWidth 中存储新值。不会更改 maxWidth 的默认值。因此,在布局过程中,如果应用程序开发人员明确设置了 maxWidth,则对组件最大建议宽度使用 explicitMaxWidth 的值。如果用户未明确设置 maxWidth,则使用默认值。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 maxWidth
受 scaleX
属性影响。有些组件从理论上没有宽度限制。在这些情况下,可将其 maxWidth
设置为 UIComponent.DEFAULT_MAX_WIDTH
。
默认值为 10000.
此属性可用作数据绑定的源。修改此属性后,将调度 explicitMaxWidthChanged
事件。
public function get maxWidth():Number
public function set maxWidth(value:Number):void
measuredHeight | 属性 |
measuredHeight:Number
[读写]
组件的默认高度(以像素为单位)。此值由 measure()
方法设置。
public function get measuredHeight():Number
public function set measuredHeight(value:Number):void
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
measuredWidth | 属性 |
measuredWidth:Number
[读写]
组件的默认宽度(以像素为单位)。此值由 measure()
方法设置。
public function get measuredWidth():Number
public function set measuredWidth(value:Number):void
minHeight | 属性 |
minHeight:Number
[读写] 布局过程中父级要考虑的组件最小建议高度。此值采用组件坐标(以像素为单位)。默认值取决于组件的实现方式。
如果应用程序开发人员设置 minHeight 的值,则将在 explicitMinHeight 中存储新值。不会更改 minHeight 的默认值。因此,在布局过程中,如果应用程序开发人员明确设置了 minHeight,则对组件最小建议高度使用 explicitMinHeight 的值。如果应用程序开发人员未明确设置 minHeight,则使用 measuredMinHeight 的值。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 minHeight
受 scaleY
属性影响。
此属性可用作数据绑定的源。修改此属性后,将调度 explicitMinHeightChanged
事件。
public function get minHeight():Number
public function set minHeight(value:Number):void
minWidth | 属性 |
minWidth:Number
[读写] 布局过程中父级要考虑的组件最小建议宽度。此值采用组件坐标(以像素为单位)。默认值取决于组件的实现方式。
如果应用程序开发人员设置 minWidth 的值,则将在 explicitMinWidth 中存储新值。不会更改 minWidth 的默认值。因此,在布局过程中,如果应用程序开发人员明确设置了 minWidth,则对组件最小建议宽度使用 explicitMinWidth 的值。如果应用程序开发人员未明确设置 minWidth,则使用 measuredMinWidth 的值。
容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 minWidth
受 scaleX
属性影响。
此属性可用作数据绑定的源。修改此属性后,将调度 explicitMinWidthChanged
事件。
public function get minWidth():Number
public function set minWidth(value:Number):void
moduleFactory | 属性 |
moduleFactory:IFlexModuleFactory
[读写] 用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。这是嵌入字体起作用而必需的项目。
public function get moduleFactory():IFlexModuleFactory
public function set moduleFactory(value:IFlexModuleFactory):void
mouseFocusEnabled | 属性 |
mouseFocusEnabled:Boolean
[读写]
单击时是否可接收焦点。如果值为 false
,则焦点将转换到已将 mouseFocusEnable
设置为 true
的第一个父项。例如,您可以将某个 Button 控件的此属性设置为 false
,这样可使用 Tab 键将焦点移动到该控件,但在单击该控件时不会使其获得焦点。
默认值为 true.
public function get mouseFocusEnabled():Boolean
public function set mouseFocusEnabled(value:Boolean):void
nestLevel | 属性 |
nestLevel:int
[读写] 此对象在所属关系层次结构中的深度。测量和布局代码都使用此编号。如果 DisplayList 中没有此组件,则值为 0。
public function get nestLevel():int
public function set nestLevel(value:int):void
nonInheritingStyles | 属性 |
nonInheritingStyles:Object
[读写]
此组件的非继承样式链的开头内容。getStyle()
方法只需访问 nonInheritingStyles[styleName]
,即可搜索整个与原型链接的链。此对象由 initProtoChain()
设置。开发人员通常不需要直接访问此属性。
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
numAutomationChildren | 属性 |
numAutomationChildren:int
[只读 (read-only)] 此容器包含的自动化子项数。此和不应包含任何复合子项,尽管它在自动化层次中确实包含这些不重要的子项。
public function get numAutomationChildren():int
owner | 属性 |
owner:DisplayObjectContainer
[读写] 此 UIComponent 的所有者。默认情况下,它是此 UIComponent 的父项。不过,如果此 UIComponent 对象是由其父项弹出的一个子组件(如 ComboBox 控件的下拉列表),则所有者是弹出此 UIComponent 对象的组件。
此属性并非由 Flex 管理,而由各个组件管理。因此,如果使用 PopUpManger.createPopUp()
或 PopUpManger.addPopUp()
方法弹出一个子组件,则应该将该子组件的 owner
属性设置为弹出它的组件。
默认值为 parent
属性的值。
public function get owner():DisplayObjectContainer
public function set owner(value:DisplayObjectContainer):void
parent | 属性 |
parent:DisplayObjectContainer
[只读 (read-only)]
此组件的父容器或组件。只有 UIComponent 对象应该具有父属性。非 UIComponent 对象应该使用其它属性引用其所属对象。一般而言,非 UIComponent 对象使用 owner
属性引用其所属对象。
public function get parent():DisplayObjectContainer
parentApplication | 属性 |
parentApplication:Object
[只读 (read-only)]
引用包含此 UIComponent 实例的 Application 对象。此 Application 对象可能存在于另一应用程序的 SWFLoader 控件中,依此类推,从而形成可使用 parentApplication 遍历的 Application 对象链。Application 的 parentApplication
属性永远不会是其本身;它通常是加载该对象的 Application 或为空(对于顶级 Application)。使用 parentApplication
属性遍历应用程序链与使用 parentDocument
属性遍历文档链类似。您可以使用 Application 类的 application
属性访问顶级应用程序。
此属性可用作数据绑定的源。修改此属性后,将调度 initialize
事件。
public function get parentApplication():Object
parentDocument | 属性 |
parentDocument:Object
[只读 (read-only)]
引用此 UIComponent 的父文档对象。文档对象是位于 Flex 应用程序、MXML 组件或 AS 组件层次结构顶层的 UIComponent。对于此类 Application 对象,parentDocument
属性为空。此属性在 MXML 脚本中非常有用,可以使文档对象链提升一个层次。它有助于使用 parentDocument.parentDocument
遍历此链等。它的类型为 Object,以便创作者可以访问始祖文档对象上的属性和方法而无需进行转换。
此属性可用作数据绑定的源。修改此属性后,将调度 initialize
事件。
public function get parentDocument():Object
percentHeight | 属性 |
percentHeight:Number
[读写]
以组件父项大小百分比的方式指定组件高度的数字。允许的值为 0-100。默认值为 NaN。设置 height
或 explicitHeight
属性会将此属性重置为 NaN。
仅当先前已设置此属性时,此属性才会返回数值;它不会以百分比形式反映组件的确切大小。
对于 UITextField 控件,此属性始终设置为 NaN。
此属性可用作数据绑定的源。修改此属性后,将调度 resize
事件。
public function get percentHeight():Number
public function set percentHeight(value:Number):void
percentWidth | 属性 |
percentWidth:Number
&n