包 | mx.charts |
类 | public class Legend |
继承 | Legend UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
实现 | IContainer |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
您可以将图表控件标识符绑定到 Legend 控件的 dataProvider
属性,或者定义一个 LegendItem 对象 Array,进而初始化 Legend 控件。
The <mx:Legend>
tag inherits all the properties
of its parent classes and adds the following properties:
<mx:Legend Properties autoLayout="true|false" clipContent="true|false" creationIndex="undefined" creationPolicy="auto|all|queued|none" dataProvider="No default" direction="horizontal|vertical" horizontalScrollPosition="0" legendItemClass="No default" verticalScrollPosition="0" Styles backgroundAlpha="1.0" backgroundAttachment="scroll" backgroundColor="undefined" backgroundDisabledColor="undefined" backgroundImage="undefined" backgroundSize="auto" barColor="undefined" borderColor="0xAAB3B3" borderSides="left top right bottom" borderSkin="mx.skins.halo.HaloBorder" borderStyle="inset|none|solid|outset" borderThickness="1" color="0x0B333C" cornerRadius="0" disabledColor="0xAAB3B3" disbledOverlayAlpha="undefined" dropShadowColor="0x000000" dropShadowEnabled="false" fontAntiAliasType="advanced" fontfamily="Verdana" fontGridFitType="pixel" fontSharpness="0"" fontSize="10" fontStyle="normal" fontThickness="0" fontWeight="normal" horizontalAlign="left|center|right" horizontalGap="8" labelPlacement="right|left|top|bottom" markerHeight="15" markerWidth="10" paddingBottom="0" paddingLeft="0" paddingRight="0" paddingTop="0" shadowDirection="center" shadowDistance="2" stroke="IStroke; no default" textAlign="left" textDecoration="none|underline" textIndent="0" verticalAlign="top|middle|bottom" verticalGap="6" Events childAdd="No default" childIndexChange="No default" childRemove="No default" dataChange="No default" itemClick="Event; no default" itemMouseDown="Event; no default" itemMouseOut="Event; no default" itemMouseOver="Event; no default" itemMouseUp="Event; no default" />
相关 API 元素
属性 | 由以下参数定义 | ||
---|---|---|---|
accessibilityDescription : String
一个方便的存取器,用于访问此 UIComponent 的 accessibilityProperties 对象的 description 属性。 | UIComponent | ||
accessibilityEnabled : Boolean
一个方便的存取器,用于访问此 UIComponent 的 accessibilityProperties 对象的 silent 属性。 | UIComponent | ||
accessibilityImplementation : AccessibilityImplementation
InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。 | InteractiveObject | ||
accessibilityName : String
一个方便的存取器,用于访问此 UIComponent 的 accessibilityProperties 对象的 name 属性。 | UIComponent | ||
accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。 | DisplayObject | ||
accessibilityShortcut : String
一个方便的存取器,用于访问此 UIComponent 的 accessibilityProperties 对象的 shortcut 属性。 | UIComponent | ||
activeEffects : Array [只读]
组件上当前播放的效果列表,如 EffectInstance 实例的 Array。 | UIComponent | ||
alpha : Number
表示指定对象的 Alpha 透明度值。 | DisplayObject | ||
autoLayout : Boolean
如果为 true,则在更改子项的位置或大小时完成度量和布局。 | Legend | ||
automationDelegate : Object
处理自动化相关功能的委托对象。 | UIComponent | ||
automationEnabled : Boolean [只读]
如果此组件启用了自动化,则为 true;否则为 false。 | UIComponent | ||
automationName : String
可用作此对象的标识符的名称。 | UIComponent | ||
automationOwner : DisplayObjectContainer [只读]
用于自动化目的的此组件的所有者。 | UIComponent | ||
automationParent : DisplayObjectContainer [只读]
用于自动化目的的此组件的父级。 | UIComponent | ||
automationTabularData : Object [只读]
IAutomationTabularData 接口的实现,可用于检索数据。 | UIComponent | ||
automationValue : Array [只读]
此值通常对应于对象的经呈示的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。 | UIComponent | ||
automationVisible : Boolean [只读]
如果此组件对于自动化是可见的,则为 true;否则为 false。 | UIComponent | ||
baseline : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
baselinePosition : Number [只读]
组件第一行文本的基线的 y 坐标。 | UIComponent | ||
blendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。 | DisplayObject | ||
blendShader : Shader [只写]
设置用于混合前景和背景的着色器。 | DisplayObject | ||
borderMetrics : EdgeMetrics [只读]
返回 EdgeMetrics 对象,它具有四个属性:left、top、right 和 bottom。 | Legend | ||
bottom : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
buttonMode : Boolean
指定此 sprite 的按钮模式。 | Sprite | ||
cacheAsBitmap : Boolean
如果设置为 true,则 Flash 运行时将缓存显示对象的内部位图表示形式。 | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
如果为非 null,则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。 | DisplayObject | ||
cacheHeuristic : Boolean [只写]
供 Flex 使用,表示建议为对象实施位图缓存。 | UIComponent | ||
cachePolicy : String
指定此对象的位图缓存策略。 | UIComponent | ||
childDescriptors : Array
由 MXML 编译器生成的 UIComponentDescriptor 对象的 Array。 | Legend | ||
className : String [只读]
此实例的类的名称,如“Button”。 | UIComponent | ||
clipContent : Boolean
如果此容器的子项的位置和/或大小扩展到此容器的边框之外,是否应用剪裁遮罩。 | Legend | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
contentMouseX : Number [覆盖] [只读]
返回鼠标在内容坐标系中的 x 位置。 | Legend | ||
contentMouseY : Number [覆盖] [只读]
返回内容坐标系中鼠标的 y 位置。 | Legend | ||
contextMenu : NativeMenu
指定与此对象相关联的上下文菜单。 | InteractiveObject | ||
creatingContentPane : Boolean
容器使用内部内容窗格控制滚动。 | Legend | ||
creationIndex : int 不推荐使用: 不推荐使用
指定实例化和绘制容器子项的顺序。 | Legend | ||
creationPolicy : String
此 MX Container 的子代创建策略。 | Legend | ||
currentState : String
组件的当前视图状态。 | UIComponent | ||
cursorManager : ICursorManager [只读]
获取控制此组件及其同级组件的光标的 CursorManager。 | UIComponent | ||
data : Object
当您在项呈示器或项目编辑器中使用某个组件时,可借助 data 属性向该组件传递值。 | Legend | ||
dataProvider : Object
Legend 中将使用的数据设置。 | Legend | ||
deferredContentCreated : Boolean [只读]
IDeferredContentOwner 等效于 processedDescriptors
| Legend | ||
depth : Number
确定容器内各项目的呈示顺序。 | UIComponent | ||
descriptor : UIComponentDescriptor
引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | UIComponent | ||
designLayer : DesignLayer
指定与该可视元素关联的可选 DesignLayer 实例。 | UIComponent | ||
direction : String
确定子项在容器中的放置方式。 | Legend | ||
document : Object
引用与此 UIComponent 相关联的文档对象。 | UIComponent | ||
doubleClickEnabled : Boolean [覆盖]
指定 UIComponent 对象是否接收 doubleClick 事件。 | UIComponent | ||
dropTarget : DisplayObject [只读]
指定拖动 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 [只读]
指定属于此 sprite 的 Graphics 对象,在此 sprite 中可执行矢量绘图命令。 | Sprite | ||
hasFocusableChildren : Boolean
一个标志,指示子对象是否能够获得焦点。 | UIComponent | ||
hasLayoutMatrix3D : Boolean [只读]
如果元素具有 3D 矩阵,则为 true。 | UIComponent | ||
height : Number [覆盖]
指定组件在父坐标中的高度的数字(以像素为单位)。 | UIComponent | ||
hitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | ||
horizontalCenter : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
horizontalScrollPosition : Number
水平滚动条的当前位置。 | Legend | ||
id : String
组件 ID。 | UIComponent | ||
includeInLayout : Boolean
指定此组件是否包含在父容器的布局中。 | UIComponent | ||
inheritingStyles : Object
此组件的继承样式链的开头内容。 | UIComponent | ||
initialized : Boolean
一个标志,用于确定某个对象是否已通过布局的所有三个阶段:提交、测量和布局(假设每个阶段都是必需的)。 | UIComponent | ||
instanceIndex : int [只读]
重复组件的索引。 | UIComponent | ||
instanceIndices : Array
一个 Array,包含从此 UIComponent 对象的父文档引用该对象所需的索引。 | UIComponent | ||
is3D : Boolean [只读]
当元素为 3D 时,则为 true。 | UIComponent | ||
isDocument : Boolean [只读]
如果此 UIComponent 实例为文档对象,则为 true。 | UIComponent | ||
isPopUp : Boolean
PopUpManager 将其设置为 true 以指示已弹出该组件。 | UIComponent | ||
layoutMatrix3D : Matrix3D [只写]
用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | ||
left : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
legendItemClass : Class
用于实例化 LegendItem 对象的类。 | Legend | ||
loaderInfo : LoaderInfo [只读]
返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | ||
maintainProjectionCenter : Boolean
如果为 true,则该组件将使其投影矩阵在其边框的中央保持居中。 | UIComponent | ||
mask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | ||
maxHeight : Number
布局过程中父级要考虑的组件最大建议高度。 | UIComponent | ||
maxHorizontalScrollPosition : Number [只读]
horizontalScrollPosition 属性的最大可能值。 | Legend | ||
maxVerticalScrollPosition : Number [只读]
verticalScrollPosition 属性的最大可能值。 | Legend | ||
maxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | ||
measuredHeight : Number
组件的默认高度(以像素为单位)。 | UIComponent | ||
measuredMinHeight : Number
组件的默认最小高度(以像素为单位)。 | UIComponent | ||
measuredMinWidth : Number
组件的默认最小宽度(以像素为单位)。 | UIComponent | ||
measuredWidth : Number
组件的默认宽度(以像素为单位)。 | UIComponent | ||
metaData : Object
如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的,则获取 DisplayObject 实例的元数据对象。 | DisplayObject | ||
minHeight : Number
布局过程中父级要考虑的组件最小建议高度。 | UIComponent | ||
minWidth : Number
布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | ||
moduleFactory : IFlexModuleFactory
模块工厂用作上下文,用于为此组件使用嵌入字体以及查找用于控制此组件样式的样式管理器。 | UIComponent | ||
mouseChildren : Boolean
确定对象的子级是否支持鼠标或用户输入设备。 | DisplayObjectContainer | ||
mouseEnabled : Boolean
指定此对象是否接收鼠标或其他用户输入、消息。 | InteractiveObject | ||
mouseFocusEnabled : Boolean
单击时是否可获得焦点。 | UIComponent | ||
mouseX : Number [只读]
表示此鼠标或用户输入设备位置的 x 坐标,以像素为单位。 | DisplayObject | ||
mouseY : Number [只读]
表示此鼠标或用户输入设备位置的 y 坐标,以像素为单位。 | DisplayObject | ||
name : String
表示 DisplayObject 的实例名称。 | DisplayObject | ||
needsSoftKeyboard : Boolean
指定当该 InteractiveObject 实例获得焦点时,是否显示虚拟键盘(显示在屏幕上的软键盘)。 | InteractiveObject | ||
nestLevel : int
此对象在所属关系层次结构中的深度。 | UIComponent | ||
nonInheritingStyles : Object
此组件的非继承样式链的开头内容。 | UIComponent | ||
numAutomationChildren : int [只读]
此容器包含的自动化子项数。 | UIComponent | ||
numChildren : int [覆盖] [只读]
此容器中的子组件数。 | Legend | ||
numElements : int [只读]
此容器中的可视元素的数量。 | Legend | ||
opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | ||
owner : DisplayObjectContainer
此 IVisualElement 对象的所有者。 | UIComponent | ||
parent : DisplayObjectContainer [覆盖] [只读]
此组件的父容器或组件。 | UIComponent | ||
parentApplication : Object [只读]
引用包含此 UIComponent 实例的 Application 对象。 | UIComponent | ||
parentDocument : Object [只读]
引用此 UIComponent 的父文档对象。 | UIComponent | ||
percentHeight : Number
以组件父代大小百分比的方式指定组件高度。 | UIComponent | ||
percentWidth : Number
以组件父代大小百分比的方式指定组件宽度。 | UIComponent | ||
postLayoutTransformOffsets : mx.geom:TransformOffsets
定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。 | UIComponent | ||
processedDescriptors : Boolean
临时或延迟子项创建操作后设置为 true,具体取决于发生对象。 | UIComponent | ||
rawChildren : IChildList [只读]
容器中通常包含子组件,可以使用 Container.getChildAt() 方法和 Container.numChildren 属性枚举这些子组件。 | Legend | ||
repeater : IRepeater [只读]
对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | ||
repeaterIndex : int [只读]
项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。 | UIComponent | ||
repeaterIndices : Array
一个 Array,包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。 | UIComponent | ||
repeaters : Array
一个 Array,包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | ||
right : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
root : DisplayObject [只读]
对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | ||
rotation : Number [覆盖]
表示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。 | UIComponent | ||
rotationX : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转(以度为单位)。 | UIComponent | ||
rotationY : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转(以度为单位)。 | UIComponent | ||
rotationZ : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转(以度为单位)。 | UIComponent | ||
scale9Grid : Rectangle
当前有效的缩放网格。 | DisplayObject | ||
scaleX : Number [覆盖]
用于指定水平缩放系数的数字。 | UIComponent | ||
scaleY : Number [覆盖]
用于指定垂直缩放系数的数字。 | UIComponent | ||
scaleZ : Number [覆盖]
指定沿着 z 轴的缩放因子的数值。 | UIComponent | ||
screen : Rectangle [只读]
返回包含此对象的基本绘图表面大小和位置的对象。 | UIComponent | ||
scrollRect : Rectangle
显示对象的滚动矩形范围。 | DisplayObject | ||
showInAutomationHierarchy : Boolean
用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | ||
softKeyboard : String
控制软键盘的外观。 | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
定义当显示软键盘时应在屏幕上保留的区域(在 iOS 上不支持)。 | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
控制此 sprite 中的声音。 | Sprite | ||
stage : Stage [只读]
显示对象的舞台。 | DisplayObject | ||
states : Array
为此组件定义的视图状态。 | UIComponent | ||
styleDeclaration : CSSStyleDeclaration
存储此对象的内嵌继承样式。 | UIComponent | ||
styleManager : IStyleManager2 [只读]
返回此组件使用的 StyleManager 实例。 | UIComponent | ||
styleName : Object
此组件使用的类样式。 | UIComponent | ||
styleParent : IAdvancedStyleClient
组件的父项用于评估后代选择器。 | UIComponent | ||
systemManager : ISystemManager
返回此组件使用的 SystemManager 对象。 | UIComponent | ||
tabChildren : Boolean
确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | ||
tabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | ||
tabFocusEnabled : Boolean
一个标志,指示该对象是否能够通过 Tab 键获得焦点。这与 Flash Player 使用的 tabEnabled 属性类似。对于处理键盘输入的组件该标志通常为 true,但是控件栏中的一些组件将其设置为 false,因为它们不能像编辑器一样从另外的组件窃取焦点。 | UIComponent | ||
tabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [只读]
返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | ||
toolTip : String
要在 ToolTip 中显示的文本。 | UIComponent | ||
top : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
transform : flash.geom:Transform [覆盖]
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | UIComponent | ||
transformX : Number
设置组件转换中心的 x 坐标。 | UIComponent | ||
transformY : Number
设置组件转换中心的 y 坐标。 | UIComponent | ||
transformZ : Number
设置组件转换中心的 z 坐标。 | UIComponent | ||
transitions : Array
一个 Transition 对象 Array,其中的每个 Transition 对象都定义一组效果,用于在视图状态发生更改时播放。 | UIComponent | ||
tweeningProperties : Array
当前在此对象上进行补间的属性数组。 | UIComponent | ||
uid : String
对象的唯一标识符。 | UIComponent | ||
updateCompletePendingFlag : Boolean
一个标志,确定某个对象是否已通过所有三个阶段的布局验证(假设需要通过所有验证)。 | UIComponent | ||
useHandCursor : Boolean
布尔值,表示当指针滑过 buttonMode 属性设置为 true 的 sprite 时是否显示指针手形(手形光标)。 | Sprite | ||
validationSubField : String
供验证程序用来将子字段与此组件相关联。 | UIComponent | ||
verticalCenter : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
verticalScrollPosition : Number
垂直滚动条的当前位置。 | Legend | ||
viewMetrics : EdgeMetrics [只读]
返回一个对象,该对象具有四个属性:left、top、right 和 bottom。 | Legend | ||
viewMetricsAndPadding : EdgeMetrics [只读]
返回一个对象,该对象具有四个属性:left、top、right 和 bottom。 | Legend | ||
visible : Boolean [覆盖]
显示对象是否可见。 | UIComponent | ||
width : Number [覆盖]
指定组件在父坐标中的宽度的数字(以像素为单位)。 | UIComponent | ||
x : Number [覆盖]
指定组件在其父容器中的水平位置(以像素为单位)的数字。 | UIComponent | ||
y : Number [覆盖]
指定组件在其父容器中的垂直位置(以像素为单位)的数字。 | UIComponent | ||
z : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | UIComponent |
属性 | 由以下参数定义 | ||
---|---|---|---|
actualCreationPolicy : String
此容器的创建策略。 | Legend | ||
currentCSSState : String [只读]
匹配 CSS 伪选择器时要使用的状态。 | UIComponent | ||
hasComplexLayoutMatrix : Boolean [只读]
如果 UIComponent 具有任何非平移 (x,y) 转换属性,则返回 true。 | UIComponent | ||
resourceManager : IResourceManager [只读]
对管理所有应用程序本地化资源的对象的引用。 | UIComponent | ||
unscaledHeight : Number [只读]
用于确定组件的未缩放高度的简便方法。 | UIComponent | ||
unscaledWidth : Number [只读]
用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成,还应将此宽度作为参数传递到 updateDisplayList() 中。 | UIComponent |
方法 | 由以下参数定义 | ||
---|---|---|---|
Legend()
构造函数。 | Legend | ||
[覆盖]
向此容器添加一个子 DisplayObject 子项。 | Legend | ||
[覆盖]
向此容器添加一个子 DisplayObject 子项。 | Legend | ||
将可视元素添加到此容器中。 | Legend | ||
将可视元素添加到此容器中。 | Legend | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
将非可视样式客户端添加到该组件实例。 | UIComponent | ||
表示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | ||
排队稍后调用的函数。 | UIComponent | ||
删除此组件实例的样式属性。 | UIComponent | ||
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | ||
[覆盖]
将 Point 对象由内容坐标转换为全局坐标。 | Legend | ||
[覆盖]
将 Point 对象由内容坐标转换为本地坐标。 | Legend | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
提供一个 UIComponentDescriptor,创建相应的组件并将该组件添加为此容器的子代。 | Legend | ||
循环访问 childDescriptor Array,并对每个元素调用 createComponentFromDescriptor() 方法。 | Legend | ||
为实现 IDeferredContentOwner 接口以支持延迟实例化的容器,执行调用 createComponentsFromDescriptors(true) 方法的等效操作。 | Legend | ||
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | ||
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | ||
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | ||
[覆盖]
将事件调度到事件流中。 | UIComponent | ||
在此组件周围显示或隐藏焦点指示符。 | UIComponent | ||
drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | ||
停止在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
开始在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
结束组件上当前播放的所有效果。 | UIComponent | ||
[覆盖]
执行此 Container 上的所有数据绑定。 | Legend | ||
执行到此 Container 的子 UIComponent 对象的绑定。 | Legend | ||
打印完成后调用。 | UIComponent | ||
在指定的索引位置提供自动化对象。 | UIComponent | ||
提供自动化对象列表。 | UIComponent | ||
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | ||
按指定的元素大小,返回元素边界的 x 坐标。 | UIComponent | ||
按指定的元素大小,返回元素边界的 y 坐标。 | UIComponent | ||
[覆盖]
获取第 n 个子组件对象。 | Legend | ||
[覆盖]
返回 name 属性为指定 String 的子项。 | Legend | ||
[覆盖]
获取特定子项的从零开始的索引。 | Legend | ||
返回由容器的内容子项组成的 DisplayObject 对象的 Array。 | Legend | ||
查找此 UIComponent 实例的类型选择器。 | UIComponent | ||
返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | ||
返回指定索引处的可视元素。 | Legend | ||
返回可视元素的索引位置。 | Legend | ||
确定是使用显式高度还是测量高度的一种简便方法
| UIComponent | ||
确定是使用显式宽度还是测量宽度的一种简便方法
| UIComponent | ||
获取当前具有焦点的对象。 | UIComponent | ||
返回元素的布局高度。 | UIComponent | ||
返回元素的布局宽度。 | UIComponent | ||
返回元素在屏幕上进行绘制时所用的 x 坐标。 | UIComponent | ||
返回元素在屏幕上进行绘制时所用的 y 坐标。 | UIComponent | ||
返回用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | ||
返回此元素的布局转换 Matrix3D。 | UIComponent | ||
返回元素的最大高度。 | UIComponent | ||
返回元素的最大宽度。 | UIComponent | ||
返回元素的最小高度。 | UIComponent | ||
返回元素的最小宽度。 | UIComponent | ||
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | ||
返回元素的首选高度。 | UIComponent | ||
返回元素的首选宽度。 | UIComponent | ||
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | ||
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | ||
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | ||
[覆盖]
将 Point 对象由全局坐标转换为内容坐标。 | Legend | ||
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | ||
将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | ||
如果 currentCSSState 不为 null,则返回 true。 | UIComponent | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
表示对象是否已经定义了指定的属性。 | Object | ||
确定是否已在此 UIComponent 上定义指定的状态。 | UIComponent | ||
计算显示对象的边框,以确定它是否与 obj 显示对象的边框重叠或相交。 | DisplayObject | ||
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | ||
返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | ||
初始化此组件的内部结构。 | UIComponent | ||
初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | ||
由某个组件的项目进行调用,以指示其 depth 属性已更改。 | UIComponent | ||
当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时,该元素必须调用该方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | ||
[覆盖]
将 Point 对象由本地坐标转换为内容坐标。 | Legend | ||
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | ||
如果 cssState 与 currentCSSState 匹配,则返回 true。 | UIComponent | ||
确定此实例与给定类型相同,还是属于给定类型的子类。 | UIComponent | ||
测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标签),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | ||
测量指定的文本,假定该文本使用由此 UIComponent 的样式确定的 UITextFormat 显示在单行 UITextField(或 UIFTETextField)中。 | UIComponent | ||
将组件移动到其父项内的指定位置。 | UIComponent | ||
将样式更改传播到子项。 | UIComponent | ||
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | ||
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | ||
准备 IFlexDisplayObject 用于打印。 | UIComponent | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
为此组件及其所有后代生成或重新生成 CSS 样式缓存,前提条件是递归参数为 true。 | UIComponent | ||
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | ||
在此容器的子项列表中删除所有子项。 | Legend | ||
从容器中删除所有可视元素。 | Legend | ||
[覆盖]
从此容器的子项列表中删除子 DisplayObject。 | Legend | ||
[覆盖]
从此容器的子项列表中删除指定索引位置的子 DisplayObject。 | Legend | ||
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | ||
从此容器的子列表中删除指定的可视元素。 | Legend | ||
从容器中的指定索引位置删除可视元素。 | Legend | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
从该组件实例删除非可视样式客户端。 | UIComponent | ||
重放指定的事件。 | UIComponent | ||
显示虚拟键盘。 | InteractiveObject | ||
使用提供的 ID 解析子项。 | UIComponent | ||
[静态]
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | ||
调整对象大小。 | UIComponent | ||
[覆盖]
设置特定子项的索引。 | Legend | ||
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | ||
设置当前状态。 | UIComponent | ||
在可视容器中更改现有可视元素的位置。 | Legend | ||
设置此组件的焦点。 | UIComponent | ||
设置元素在屏幕上进行绘制时所用的坐标。 | UIComponent | ||
设置元素的布局大小。 | UIComponent | ||
设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。 | UIComponent | ||
设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。 | UIComponent | ||
设置循环操作动态属性的可用性。 | Object | ||
对此组件实例设置样式属性。 | UIComponent | ||
当 visible 属性发生更改时调用。 | UIComponent | ||
允许用户拖动指定的 Sprite。 | Sprite | ||
使用户可以在启用触摸的设备上拖动指定的 Sprite。 | Sprite | ||
对源起于此对象的所有 MovieClip 递归停止时间轴执行。 | DisplayObjectContainer | ||
结束 startDrag() 方法。 | Sprite | ||
结束 startTouchDrag() 方法,用于启用触摸的设备。 | Sprite | ||
检测对样式属性的更改。 | UIComponent | ||
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | ||
[静态]
阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | ||
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | ||
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | ||
交换两个指定可视元素的索引。 | Legend | ||
交换容器中位于两个指定索引位置的可视元素。 | Legend | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
[覆盖]
返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | ||
transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
用于更新转换的旋转、缩放和平移的一种实用程序方法,同时保留某个特定点,该点是在组件自己的坐标空间中指定的,且在父项的坐标空间中是固定的。 | UIComponent | ||
一种实用程序方法,用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。 | UIComponent | ||
验证子项的位置和大小,并绘制其他可视内容。 | UIComponent | ||
验证并更新此对象的属性和布局,如果需要的话重绘对象。 | UIComponent | ||
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | ||
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。 | UIComponent | ||
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | ||
返回指定对象的原始值。 | Object | ||
返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | ||
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher |
方法 | 由以下参数定义 | ||
---|---|---|---|
调整焦点矩形。 | UIComponent | ||
提交计算的矩阵,该矩阵是基于布局矩阵以及 flash displayObject 的转换的转换偏移量而构建的。 | UIComponent | ||
[覆盖]
供溶解效果在内部用来添加叠加层到容器的镶边。 | Legend | ||
确定是否可以跳过对 measure() 方法的调用。 | UIComponent | ||
创建子对象后执行任何最终处理。 | UIComponent | ||
处理对组件设置的属性。 | UIComponent | ||
如果需要容器的边框外观,但却不存在,则创建容器的边框外观。 | Legend | ||
创建组件的子对象。 | UIComponent | ||
根据所用的嵌入字体使用上下文创建新对象。 | UIComponent | ||
使用给定的 moduleFactory 创建对象。 | UIComponent | ||
更新属性时调度 PropertyChangeEvent 的 Helper 方法。 | UIComponent | ||
当 UIComponent 对象获得焦点时调用的事件处理函数。 | UIComponent | ||
当 UIComponent 对象失去焦点时调用的事件处理函数。 | UIComponent | ||
对于组件的某些不常使用的高级布局功能,初始化其实现和存储。 | UIComponent | ||
完成对此组件的初始化。 | UIComponent | ||
初始化此组件的辅助功能代码。 | UIComponent | ||
此对象影响其布局时(includeInLayout 为 true),使父代大小和显示列表失效的 Helper 方法。 | UIComponent | ||
通常由包含 UITextField 对象的组件覆盖,其中 UITextField 对象获取焦点。 | UIComponent | ||
为 keyDown 事件调用的事件处理函数。 | UIComponent | ||
为 keyUp 事件调用的事件处理函数。 | UIComponent | ||
通过设置此容器边框的位置和大小响应大小更改。 | Legend | ||
计算组件的默认大小和(可选)默认最小大小。 | UIComponent | ||
构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。 | UIComponent | ||
基于 horizontalScrollPosition 和 verticalScrollPosition 属性,确定容器的内容区域相对于可查看区域的位置。 | Legend | ||
在水平方向和垂直方向上,指定转换拉伸因子。 | UIComponent | ||
当状态改变以检查状态特定的样式是否应用到此组件时,会调用此方法。 | UIComponent | ||
[覆盖]
通过设置此容器子项的位置和大小来响应大小更改。 | Legend |
事件 | 摘要 | 由以下参数定义 | ||
---|---|---|---|---|
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | |||
当组件通过使用 addChild()、addChildAt()、addElement() 或 addElementAt() 方法作为内容子项添加到容器后调度。 | UIComponent | |||
将显示对象添加到显示列表中时调度。 | DisplayObject | |||
在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | |||
将子项添加到图例后调度。 | Legend | |||
图例子项的索引(在图例子项中)发生更改后调度。 | Legend | |||
删除图例的子项之前调度。 | Legend | |||
当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。 | InteractiveObject | |||
用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | |||
当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | |||
在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | |||
当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | |||
视图状态更改后调度。 | UIComponent | |||
在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | |||
在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | |||
当 data 属性更改时进行调度。 | Legend | |||
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | |||
如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | |||
在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。 | UIComponent | |||
用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | |||
当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。 | UIComponent | |||
用户在组件外拖动但没有将数据放置到目标时,由组件调度。 | UIComponent | |||
在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。 | UIComponent | |||
启动拖动操作时,由拖动启动器调度。 | UIComponent | |||
在一个效果结束后调度。 | UIComponent | |||
在即将开始播放效果前调度。 | UIComponent | |||
在停止某个效果(仅当对该效果调用 stop() 时发生)之后调度。 | UIComponent | |||
[播放事件] 播放头进入新帧时调度。 | DisplayObject | |||
在组件已进入视图状态之后调度。 | UIComponent | |||
[广播事件] 播放头退出当前帧时调度。 | DisplayObject | |||
在组件即将退出视图状态之前调度。 | UIComponent | |||
[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | DisplayObject | |||
当用户使用 InteractiveObject 实例沿触摸面边缘创建接触点时调度(如在 Siri Remote for Apple TV 上沿触摸面边缘轻击)。有些设备也可能将这种接触解释为多个触摸事件的组合。 | InteractiveObject | |||
当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时(例如,在配有触摸屏的移动电话或平板电脑上的显示对象上按下和释放两个手指)调度。 | InteractiveObject | |||
当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上的显示对象上从左向右移动手指)调度。 | InteractiveObject | |||
当用户在接触点处使用 InteractiveObject 实例执行旋转手势时(例如,将两个手指放在屏幕上,然后在配有触摸屏的移动电话或平板电脑上的显示对象上旋转这两个手指)调度。 | InteractiveObject | |||
当用户在接触点处使用 InteractiveObject 实例执行滑动手势(例如,在配有触摸屏的移动电话或平板电脑上用三根手指触摸屏幕,然后在一个显示对象上平行移动这三根手指)时调度。 | InteractiveObject | |||
当用户使用 InteractiveObject 实例创建接触点,然后点击启用触屏的设备时(例如,将几个手指放在显示对象上以打开菜单,然后点击一个手指在配有触摸屏的移动电话或平板电脑上选择一个菜单项)调度。 | InteractiveObject | |||
当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时(例如,将两个手指放在屏幕上,然后在配有触摸屏的移动电话或平板电脑上的显示对象上快速分开手指)调度。 | InteractiveObject | |||
当对象的状态从可见变为不可见时调度。 | UIComponent | |||
此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序 | InteractiveObject | |||
当组件完成构建并设置了所有初始化属性后调度。 | UIComponent | |||
当组件由 Validator 监控且未通过验证时调度。 | UIComponent | |||
当用户在 Legend 控件中的 LegendItem 上单击时调度此事件。 | Legend | |||
当用户在 Legend 控件中的 LegendItem 上按下鼠标按键时调度此事件。 | Legend | |||
当用户将鼠标从 Legend 中的 LegendItem 上移走时调度此事件。 | Legend | |||
当用户将鼠标移至 Legend 控件中的 LegendItem 上时调度此事件。 | Legend | |||
当用户在 Legend 中的 LegendItem 上释放鼠标按键时调度此事件。 | Legend | |||
用户按下某个键时调度。 | 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 | |||
当用户将活动笔针放低经过屏幕的邻近检测阈值上时调度。 | InteractiveObject | |||
当用户将活动笔针抬高放在屏幕的邻近检测阈值上时调度。 | InteractiveObject | |||
当用户将活动笔针移动到屏幕上但仍保留在邻近检测阈值中时调度。 | InteractiveObject | |||
当用户直接将活动笔针从此 InteractiveObject 上移开但仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | |||
当用户直接将活动笔针移动到此 InteractiveObject 上但仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | |||
当用户从此 InteractiveObject 及其任一子项中移开而仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | |||
当用户将活动笔针从显示列表中子项的对象树中滑过此 InteractiveObject 时(而仍保留在屏幕的邻近检测阈值中)时调度。 | InteractiveObject | |||
在用户首先在 InteractiveObject 实例上按下按钮,然后将指针设备移离 InteractiveObject 实例,释放指针设备上的按钮时调度。 | InteractiveObject | |||
当组件通过使用 removeChild()、removeChildAt()、removeElement() 或 removeElementAt() 方法作为内容子项从容器中删除后调度。 | UIComponent | |||
将要从显示列表中删除显示对象时调度。 | DisplayObject | |||
在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | |||
[广播事件] 将要更新和呈现显示列表时调度。 | DisplayObject | |||
在调整组件大小时调度。 | UIComponent | |||
当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | |||
用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
在用户为全选操作激活特定于平台的加速键组合或从文本上下文菜单中选择“全选”时调度。 | InteractiveObject | |||
当对象的状态从不可见变为可见时调度。 | UIComponent | |||
在放开软键盘之后立即调度。 | InteractiveObject | |||
在放开软键盘之前立即调度。 | InteractiveObject | |||
在隐藏软键盘之后立即调度。 | InteractiveObject | |||
在组件进入新状态且切换到该状态的状态转换动画已经播放完时调度。 | UIComponent | |||
在组件中断转换到当前状态从而切换到新状态时调度。 | UIComponent | |||
对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | |||
对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | |||
对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | |||
当用户输入一个或多个文本字符时调度。 | InteractiveObject | |||
要创建 ToolTip 时由组件调度。 | UIComponent | |||
已隐藏组件的 ToolTip 并要将其放弃时由组件调度。 | UIComponent | |||
要隐藏组件的 ToolTip 时由组件调度。 | UIComponent | |||
要显示组件的 ToolTip 时由组件调度。 | UIComponent | |||
显示组件的 ToolTip 时由组件调度。 | UIComponent | |||
用户将鼠标移动到设置了 toolTip 属性的组件上方后,由该组件调度。 | UIComponent | |||
当用户第一次触摸启用触摸的设备时(例如,用手指触摸配有触摸屏的移动电话或平板)调度。 | InteractiveObject | |||
当用户移除与启用触摸的设备的接触时(例如,将手指从配有触摸屏的移动电话或平板电脑上抬起)调度。 | InteractiveObject | |||
不可撤消事件,在组件结束响应 touch 交互用户操作时由组件调度。 | UIComponent | |||
不可撤消事件,在组件开始响应 touch 交互用户操作时由组件调度。 | UIComponent | |||
可撤消事件,在组件试图响应 touch 交互用户操作时由组件调度。 | UIComponent | |||
当用户触碰设备时进行调度,而且会连续调度,直到接触点被删除。 | InteractiveObject | |||
当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从一个显示对象拖到另一个显示对象)调度。 | InteractiveObject | |||
当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从显示对象外的一点拖动到显示对象上的一点)调度。 | InteractiveObject | |||
当用户移动接触点,使其远离启用触摸的设备上的 InteractiveObject 实例时(例如,在配有触摸屏的移动电话或平板电脑上将一个手指从显示对象上的一点移动到显示对象外的一点)调度。 | InteractiveObject | |||
当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从显示对象外的一点拖动到显示对象上的一点)调度。 | InteractiveObject | |||
当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时(例如,在配有触摸屏的移动电话或平板的显示对象上的某一点处按下并释放手指)调度。 | InteractiveObject | |||
当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度(如果需要)。 | UIComponent | |||
当组件由 Validator 监控并且成功通过验证时调度。 | UIComponent | |||
当以编程方式或通过用户交互更改值时调度。 | UIComponent |
样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
backgroundAttachment | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 如果指定了背景图像,则此样式指定它是相对于视域保持固定状态 ( "fixed" ) 还是随着内容一起滚动 ("scroll" )。
默认值为 "scroll" 。 | Legend | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位). | UIComponent | |||
borderSkin | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的边框外观类。在未显式设置其自身默认值的所有组件中,Halo 主题的默认值为 mx.skins.halo.HaloBorder ,Spark 主题的默认值为 mx.skins.spark.BorderSkin 。Panel 容器的 Halo 主题默认值为 mx.skins.halo.PanelSkin ,Spark 主题默认值为 mx.skins.spark.BorderSkin 。要确定组件的默认值,请参阅 default.css 文件。
| Legend | ||
borderStyle | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 边框样式。可能值为 "none" 、"solid" 、"inset" 和 "outset" 。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 "inset" 。大多数容器的默认值为 "none" 。"inset" 和 "outset" 值只在 halo 主题中有效。
| Legend | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件底边到其父容器的内容区域底边之间的垂直距离(以像素为单位). | UIComponent | |||
color | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件中文本(包括组件标签)的颜色。 默认值为 0x0B333C 。 | Legend | ||
disabledColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用时组件中文本的颜色。 默认值为 0xAAB3B3 。 | Legend | ||
disabledOverlayAlpha | 类型: Number CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用容器时放置在容器上的叠加层的 alpha 值。 | Legend | ||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 验证失败时,组件加亮部分的颜色. | UIComponent | |||
fontAntiAliasType | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash.text.AntiAliasType.NORMAL ) 和 "advanced" (flash.text.AntiAliasType.ADVANCED )。
默认值为 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 默认值为 "advanced" 。相关 API 元素 | Legend | ||
fontFamily | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。 默认值为 "Verdana" 。 | Legend | ||
fontGridFitType | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash.text.GridFitType.NONE )、"pixel" (flash.text.GridFitType.PIXEL ) 和"subpixel" (flash.text.GridFitType.SUBPIXEL )。
仅当使用嵌入的高级消除锯齿字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 默认值为 "pixel" 。相关 API 元素 | Legend | ||
fontSharpness | 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。
仅当使用嵌入的高级消除锯齿字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 默认值为 0 。相关 API 元素 | Legend | ||
fontSize | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。 | Legend | ||
fontStyle | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用斜体。可识别的值为 "normal" 和 "italic" 。
默认值为 "normal" 。 | Legend | ||
fontThickness | 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。
仅当使用嵌入的高级消除锯齿字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 默认值为 0 。相关 API 元素 | Legend | ||
fontWeight | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用粗体。可识别的值为 "normal" 和 "bold" 。对于 Button 控件,默认值为 "bold" 。
默认值为 "normal" 。 | Legend | ||
horizontalAlign | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 水平对齐平铺单元格中的各子项。可能值包括 "left" 、"center" 和 "right" 。如果将此值设为 "left" ,则各子项的左边缘位于其单元格的左边处。如果将此值设为 "center" ,则各子项在其单元格中水平居中。如果将此值设为 "right" ,则各子项的右边缘位于其单元格的右边处。
默认值为 "left" 。 | Legend | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的水平距离(以像素为单位). | UIComponent | |||
horizontalGap | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 水平方向上各子代之间的像素数。默认值取决于组件类;如果未覆盖类的默认值,则默认值为 8。 | Legend | ||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 该组件的主要交互模式. | UIComponent | |||
kerning | 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 一个布尔值,表示是启用 ( true ) 还是禁用 (false ) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入的高级消除锯齿字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。
默认值为 false 。 | Legend | ||
labelPlacement | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定图例元素的标签位置。有效值为 "top" 、"bottom" 、"right" 和 "left" 。
| Legend | ||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.1 运行时版本: Flash10, AIR 1.5 指定组件的所需布局方向. | UIComponent | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件左边到其父容器的内容区域左边之间的水平距离(以像素为单位). | UIComponent | |||
letterSpacing | 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。 默认值为 0 。 | Legend | ||
locale | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的区域设置。 FTE 和 TLF 使用此区域设置将 Unicode 字符映射到字体字型并查找后备字体。 注意:仅当 MX 组件将 UIFTETextField 指定为其 "en" 。 | Legend | ||
markerHeight | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定图例元素的高度。 | Legend | ||
markerWidth | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定图例元素的宽度。 | Legend | ||
paddingBottom | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 图例下边框与其内容区域底部之间的像素数目。 默认值为 0 。 | Legend | ||
paddingLeft | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 控件左边框与内容区域左边缘之间的像素数目。 默认值为 2 。 | Legend | ||
paddingRight | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 控件右边框与内容区域右边缘之间的像素数目。 默认值为 0 。 | Legend | ||
paddingTop | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 图例上边框与其内容区域顶部之间的像素数目。 默认值为 0 。 | Legend | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件右边到其父容器的内容区域右边之间的水平距离(以像素为单位). | UIComponent | |||
类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 当此组件无效时,显示错误边框或外观 | UIComponent | |||
类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 如果此组件无效,当用户将鼠标移到它上方时,将显示错误提示 | UIComponent | |||
stroke | 类型: Object CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定图例元素的线条笔触。 | Legend | ||
textAlign | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器内文本的对齐方式。可能值有: "left" 、"right" 或 "center" 。
大多数控件的默认值都为 | Legend | ||
textDecoration | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否加下划线。可能值有: "none" 和 "underline" 。
默认值为 "none" 。 | Legend | ||
textFieldClass | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 实现此组件用来呈示文本的 IUITextField 的类。 它可以设置为 mx.core.UITextField 类(以使用 Flash Player 内置经典 TextField 类)或 mx.core.UIFTETextField 类(以使用 Text Layout Framework 改进文本呈示,包括双向布局)。 默认值为 mx.core.UITextField 。 | Legend | ||
textIndent | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本第一行偏离容器左侧的距离(以像素为单位)。 默认值为 0 。 | Legend | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件顶边到其父容器的内容区域顶边之间的垂直距离(以像素为单位). | UIComponent | |||
verticalAlign | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 垂直对齐平铺单元格中的各子项。可能值包括 "top" 、"middle" 和 "bottom" 。如果将此值设为 "top" ,则各子项的顶部边缘位于其单元格的顶边处。如果将此值设为 "middle" ,则各子项在其单元格中垂直居中。如果将此值设为 "bottom" ,则各子项的底部边缘位于其单元格的底边处。
默认值为 "top" 。 | Legend | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的垂直距离(以像素为单位). | UIComponent | |||
verticalGap | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 垂直方向上各子项间的像素数目。默认值取决于组件类;如果未覆盖类的默认值,则默认值为 6。 | Legend |
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
accentColor | 类型: uint 格式: Color CSS 继承: 是 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件外观使用的强调文字颜色。默认按钮外观使用此颜色对背景进行着色。使用此颜色加亮滑块轨道。 默认值为 #0099FF 。 | Legend | ||
backgroundAlpha | 类型: Number CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 backgroundColor 属性定义的颜色和 backgroundImage 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0.0 到 1.0。对于大多数控件,默认值为 1.0,但 ToolTip 控件的默认值为 0.95,而 Alert 控件的默认值为 0.9。
默认值为 1.0 。 | Legend | ||
backgroundColor | 类型: uint 格式: Color CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的背景色。您可以同时设置 backgroundColor 和 backgroundImage 。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 undefined ,即不进行设置。如果此样式和 backgroundImage 样式都为 undefined ,则控件将采用透明背景。
对于 Application 容器,此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx:Container backgroundColor="0x66CC66"/> <mx:ControlName ... fillAlphas="[1,1]"/> </mx:Container> | Legend | ||
borderAlpha | 类型: Number CSS 继承: 否 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 边框 Alpha(透明度)。 默认值为 1 。 | Legend | ||
borderColor | 类型: uint 格式: Color CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 边框颜色。默认值取决于组件类;如果没有覆盖该类的默认值,则 Halo 主题的默认值为 0xB7BABC ,Spark 主题的默认值为 0x696969 。
| Legend | ||
borderVisible | 类型: Boolean CSS 继承: 否 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 边框可视性。 默认值为 true 。 | Legend | ||
类型: uint 格式: Color CSS 继承: 是 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件的主要颜色. | UIComponent | |||
contentBackgroundAlpha | 类型: Number CSS 继承: 是 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件内容背景的 Alpha。 | Legend | ||
contentBackgroundColor | 类型: uint 格式: Color CSS 继承: 是 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件的内容区域的颜色。 默认值为 0xFFFFFF 。 | Legend | ||
cornerRadius | 类型: Number 格式: Length CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件角的半径。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0。对于 ApplicationControlBar,默认值为 5。 | Legend | ||
dropShadowVisible | 类型: Boolean CSS 继承: 否 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定组件是否具有可见投影的布尔值属性。默认值为 false 。
注意:对于显示在容器上的投影,需设置 | Legend | ||
focusColor | 类型: uint 格式: Color CSS 继承: 是 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件对焦时,对焦环的颜色。 默认值为 0x70B2EE 。 | Legend | ||
symbolColor | 类型: uint 格式: Color CSS 继承: 是 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件的任何元件的颜色。示例包括 CheckBox 的复选标记或 ScrollBar 按钮的箭头。 默认值为 0x000000 。 | Legend |
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
backgroundAlpha | 类型: Number CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 backgroundColor 属性定义的颜色和 backgroundImage 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0.0 到 1.0。对于大多数控件,默认值为 1.0,但 ToolTip 控件的默认值为 0.95,而 Alert 控件的默认值为 0.9。
默认值为 1.0 。 | Legend | ||
backgroundColor | 类型: uint 格式: Color CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的背景色。您可以同时设置 backgroundColor 和 backgroundImage 。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 undefined ,即不进行设置。如果此样式和 backgroundImage 样式都为 undefined ,则控件将采用透明背景。
对于 Application 容器,此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx:Container backgroundColor="0x66CC66"/> <mx:ControlName ... fillAlphas="[1,1]"/> </mx:Container> | Legend | ||
backgroundDisabledColor | 类型: uint 格式: Color CSS 继承: 是 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用组件时组件的背景色。全局默认值为 undefined 。List 控件的默认值为 0xDDDDDD (浅灰)。如果禁用了容器,背景将变暗,而暗淡程度由 disabledOverlayAlpha 样式控制。
| Legend | ||
backgroundImage | 类型: Object 格式: File CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的背景图像。此样式可以是绝对或相对 URL 或类。您既可以设置 backgroundColor ,也可以设置 backgroundImage 。背景图像显示在背景色上面。默认值为 undefined ,表示“未设置”。如果此样式和 backgroundColor 样式都未定义,则控件将采用透明背景。
大多数 Flex 控件的默认外观为半透明。因此,容器的背景图像将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx:Container backgroundColor="0x66CC66"/> <mx:ControlName ... fillAlphas="[1,1]"/> </mx:Container> | Legend | ||
backgroundSize | 类型: String CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 将 backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值,您必须输入百分号 (%)。Application 容器的默认值为 100% 。所有其他容器的默认值为 auto ,此值将保持图像的原始大小。
| Legend | ||
barColor | 类型: uint 格式: Color CSS 继承: 是 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定 ProgressBar 的颜色。将使用此颜色与较明亮的颜色(基于此颜色计算得出)之间的垂直渐变填充 ProgressBar。此样式对其他组件不起作用,但可对某个容器设置此样式,以控制其中所有进度栏的外观。默认值为 undefined ,即不进行设置。此时,将使用 themeColor 样式属性。
| Legend | ||
borderColor | 类型: uint 格式: Color CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 边框颜色。默认值取决于组件类;如果没有覆盖该类的默认值,则 Halo 主题的默认值为 0xB7BABC ,Spark 主题的默认值为 0x696969 。
| Legend | ||
borderSides | 类型: String CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 边框边。指定要显示的边框边的以空格分隔的字符串。此字符串可以任意顺序包含 "left" 、"top" 、"right" 和 "bottom" 。默认值为 "left top right bottom" ,此值会显示所有四条边。仅当 borderStyle 为 "solid" 时才使用此样式。
| Legend | ||
borderThickness | 类型: Number 格式: Length CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 边框厚度。仅在将 borderStyle 设置为 "solid" 时使用。
默认值为 1 。 | Legend | ||
cornerRadius | 类型: Number 格式: Length CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件角的半径。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0。对于 ApplicationControlBar,默认值为 5。 | Legend | ||
dropShadowColor | 类型: uint 格式: Color CSS 继承: 是 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 投影颜色。 默认值为 0x000000 。 | Legend | ||
dropShadowEnabled | 类型: Boolean CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定组件是否具有可见投影的布尔值属性。此样式与 borderStyle="solid" 一起使用。默认值为 false 。
注意:对于显示在容器上的投影,需设置 | Legend | ||
shadowDirection | 类型: String CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 投影方向。可能值包括 "left" 、"center" 和 "right" 。
默认值为 "center" 。 | Legend | ||
shadowDistance | 类型: Number 格式: Length CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 投影距离。如果将此属性设置为负值,此阴影将出现在组件的上方。 默认值为 2 。 | Legend | ||
类型: uint 格式: Color CSS 继承: 是 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的主题颜色. | UIComponent |
actualCreationPolicy | 属性 |
protected var actualCreationPolicy:String
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
此容器的创建策略。
autoLayout | 属性 |
autoLayout:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
如果为 true
,则在更改子项的位置或大小时完成度量和布局。如果为 false
,则仅当在容器中添加或删除子项时才能执行度量和布局。
使用 Move 效果时,正在移动的组件周围的布局不会为了适合 Move 效果动画而进行重新调整。将容器的 autoLayout
属性设置为 true
对此行为没有任何影响。
将 autoLayout
属性设置为 false
时,Zoom 效果不起作用。
autoLayout
属性不适用于 Accordion 或 ViewStack 容器。
默认值为 true。
实现
public function get autoLayout():Boolean
public function set autoLayout(value:Boolean):void
borderMetrics | 属性 |
borderMetrics:EdgeMetrics
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
返回 EdgeMetrics 对象,它具有四个属性:left
、top
、right
和 bottom
。各属性值等于边框某一侧的粗细(以像素为单位)。
与 viewMetrics
不同,此属性不会被 Container 的子类覆盖。
实现
public function get borderMetrics():EdgeMetrics
childDescriptors | 属性 |
childDescriptors:Array
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
由 MXML 编译器生成的 UIComponentDescriptor 对象的 Array。
每个 UIComponentDescriptor 对象都包含在容器的 MXML 标签的某个子 MXML 标签中指定的信息。Array 中 UIComponentDescriptor 对象的顺序与子标签的顺序相同。在初始化期间,子描述符用于创建容器的子 UIComponent 对象及其 Repeater 对象,并赋予它们在 MXML 中指定的初始属性值、事件处理程序、效果等。
实现
public function get childDescriptors():Array
public function set childDescriptors(value:Array):void
相关 API 元素
clipContent | 属性 |
clipContent:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
如果此容器的子项的位置和/或大小扩展到此容器的边框之外,是否应用剪裁遮罩。如果为 false
,则在将此容器的子项移动或调整到此容器的边框之外时,这些子项仍然可见。如果为 true
,将剪掉此容器的子项。
如果 clipContent
为 false
,则将对此容器禁用滚动并且不显示滚动条。如果 clipContent
为 true,则当容器的子项扩展到容器边框之外时通常会显示滚动条。有关控制滚动条外观的其他信息,请参阅 horizontalScrollPolicy
和 verticalScrollPolicy
。
默认值为 true。
实现
public function get clipContent():Boolean
public function set clipContent(value:Boolean):void
contentMouseX | 属性 |
contentMouseY | 属性 |
creatingContentPane | 属性 |
creationIndex | 属性 |
creationPolicy | 属性 |
creationPolicy:String
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
此 MX Container 的子代创建策略。ActionScript 值可以是 ContainerCreationPolicy.AUTO
、ContainerCreationPolicy.ALL
或 ContainerCreationPolicy.NONE
。MXML 值可以是 auto
、all
或 none
。
如果没有为容器指定 creationPolicy
,则该容器将继承其父项的 creationPolicy
。如果没有为 Application 指定 creationPolicy
,则默认为 ContainerCreationPolicy.AUTO
。
ContainerCreationPolicy.AUTO
的 creationPolicy
意味着容器将延迟创建部分或全部后代,直到需要它们时为止。此进程称为延迟实例化。此策略能使启动时间达到最佳,因为最初只创建很少的 UIComponent。但是,当用户首次导航到应用程序的其他部分时,这将引入导航延迟。导航器容器(如 Accordion、TabNavigator 和 ViewStack)通过立即创建其所有子项实现 ContainerCreationPolicy.AUTO
策略,但要等到子项成为导航器容器的所选子项时才创建该子项的更深层的后代。
ContainerCreationPolicy.ALL
的 creationPolicy
意味着导航器容器会立即创建每个子项的更深层的后代,而不必等待选择该子项。对于单一视图容器(如 VBox 容器),ContainerCreationPolicy.AUTO
和 ContainerCreationPolicy.ALL
策略没有区别。
ContainerCreationPolicy.NONE
的 creationPolicy
意味着容器不创建其子项。在这种情况下,由 MXML 作者负责通过调用 createComponentsFromDescriptors()
方法来创建子项。
默认值为 ContainerCreationPolicy.AUTO。
实现
public function get creationPolicy():String
public function set creationPolicy(value:String):void
data | 属性 |
data:Object
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当您在项呈示器或项目编辑器中使用某个组件时,可借助 data
属性向该组件传递值。您通常使用数据绑定将 data
属性的字段绑定到此组件的某个属性。
不要以 MXML 方式设置此属性。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后,将调度 dataChange
事件。
实现
public function get data():Object
public function set data(value:Object):void
相关 API 元素
dataProvider | 属性 |
deferredContentCreated | 属性 |
direction | 属性 |
direction:String
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
确定子项在容器中的放置方式。可能的 MXML 值包括 "horizontal"
和 "vertical"
。在 ActionScript 中,您可以使用 TileDirection.HORIZONTAL 或 TileDirection.VERTICAL 值设置方向。默认值是 "horizontal"
。(如果容器是作为 Tile 子类的 Legend 容器,则默认值是 "vertical"
。)
第一个子项总是放置在 Tile 容器的左上角。如果将 direction
设置为 "horizontal"
,则在最顶行中从左到右放置子项,在第二行中则从左到右进行放置,依此类推。如果将该值设置为 "vertical"
,则在最左列中从上到下放置子项,在第二列中则从上到下进行放置,依此类推。
默认值为 "horizontal"。
此属性可用作数据绑定的源。修改此属性后,将调度 directionChanged
事件。
实现
public function get direction():String
public function set direction(value:String):void
相关 API 元素
horizontalScrollPosition | 属性 |
horizontalScrollPosition:Number
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
水平滚动条的当前位置。此值等于可滚动表面的左边缘和当前可见表面最左侧的片段之间的距离(以像素为单位)。
默认值为 0。
此属性可用作数据绑定的源。修改此属性后,将调度 viewChanged
事件。
实现
public function get horizontalScrollPosition():Number
public function set horizontalScrollPosition(value:Number):void
legendItemClass | 属性 |
public var legendItemClass:Class
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
用于实例化 LegendItem 对象的类。如果图例内容是从图表或数据派生的,它将为 dataProvider
描述的每个项目实例化一个 legendItemClass
实例。如果希望自定义图例项目中的行为,您可以将 LegendItem 的一个子类分配给此属性,以使 Legend 改为创建其派生类型的实例。
maxHorizontalScrollPosition | 属性 |
maxVerticalScrollPosition | 属性 |
numChildren | 属性 |
numElements | 属性 |
rawChildren | 属性 |
rawChildren:IChildList
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
容器中通常包含子组件,可以使用 Container.getChildAt()
方法和 Container.numChildren
属性枚举这些子组件。此外,容器可以包含样式元素和外观,如边框和背景。Flash Player 和 AIR 创建的子组件和外观之间没有任何差异。二者均可以使用播放器的 getChildAt()
方法和 numChildren
属性进行访问。但是,Container 类通过覆盖 getChildAt()
方法和 numChildren
属性(以及其他多个方法)可造成容器的子项是唯一的子组件的错觉。
如果您需要访问容器的所有子项(内容子项和外观),则需使用 rawChildren
属性上的方法和属性,而不是常规 Container 方法。例如,可使用 Container.rawChildren.getChildAt())
方法。但是,如果容器为其子项创建了 ContentPane Sprite 对象,则 rawChildren
属性值将只计算 ContentPane,而不计算容器的子项。并非总能够确定容器何时包含 ContentPane。
注意:如果您调用 rawChildren
对象的 addChild
或 addChildAt
方法,则需在添加的组件上设置 tabFocusEnabled = false
。这可以防止用户跳位到所添加的仅可视组件。
实现
public function get rawChildren():IChildList
verticalScrollPosition | 属性 |
verticalScrollPosition:Number
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
垂直滚动条的当前位置。此值等于可滚动表面的顶部边缘与当前可见表面的最顶部片段之间的距离(以像素为单位)。
默认值为 0。
此属性可用作数据绑定的源。修改此属性后,将调度 viewChanged
事件。
实现
public function get verticalScrollPosition():Number
public function set verticalScrollPosition(value:Number):void
viewMetrics | 属性 |
viewMetrics:EdgeMetrics
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
返回一个对象,该对象具有四个属性:left
、top
、right
和 bottom
。每个属性的值分别等于容器边缘四周镶边(可视元素)的粗细。
镶边包括边框粗细。如果 horizontalScrollPolicy
或 verticalScrollPolicy
属性值为 ScrollPolicy.ON
,则镶边还包括相应滚动条的粗细。如果滚动策略为 ScrollPolicy.AUTO
,则即使显示滚动条,镶边度量也不包括滚动条粗细。
Container 的子类应覆盖此方法,以便在定位 Container 的子项时考虑其他镶边。例如,Panel 类的 viewMetrics
属性应返回一个对象,该对象的 top
属性包括 Panel 容器的标题栏的粗细。
实现
public function get viewMetrics():EdgeMetrics
viewMetricsAndPadding | 属性 |
viewMetricsAndPadding:EdgeMetrics
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
返回一个对象,该对象具有四个属性:left
、top
、right
和 bottom
。每个属性的值分别等于容器边缘四周镶边(可视元素)的粗细与对象边距的粗细之和。
镶边包括边框粗细。如果 horizontalScrollPolicy
或 verticalScrollPolicy
属性值为 ScrollPolicy.ON
,则镶边还包括相应滚动条的粗细。如果滚动策略为 ScrollPolicy.AUTO
,则即使显示滚动条,镶边度量也不包括滚动条粗细。
实现
public function get viewMetricsAndPadding():EdgeMetrics
Legend | () | 构造函数 |
public function Legend()
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
addChild | () | 方法 |
override public function addChild(child:DisplayObject):DisplayObject
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
向此容器添加一个子 DisplayObject 子项。一个子项添加到其他现有子项的后面,以便添加的第一个子项使用索引 0,下一个子项使用索引 1,依此类推。
注意:尽管已将方法的 child
参数指定为 DisplayObject 类型,但此参数必须实现 IUIComponent 接口才能添加为容器的子项。所有 Flex 组件都要实现此接口。
子项从后向前分层。也就是说,如果子项重叠,则索引为 0 的子项位于最后方,而索引为 numChildren - 1
的子项位于最前方。这就意味着,新添加的子项的层次将位于现有子项之前。
参数
child:DisplayObject — 要添加为此容器的子项的 DisplayObject。它必须实现 IUIComponent 接口。
|
DisplayObject — 添加的子项将作为 DisplayObject 类型的对象。您通常将返回值转换为 UIComponent 或所添加组件的类型。
|
相关 API 元素
addChildAt | () | 方法 |
override public function addChildAt(child:DisplayObject, index:int):DisplayObject
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
向此容器添加一个子 DisplayObject 子项。该子项将被添加到指定的索引位置。
注意:尽管已将方法的 child
参数指定为 DisplayObject 类型,但此参数必须实现 IUIComponent 接口才能添加为容器的子项。所有 Flex 组件都要实现此接口。
子项从后向前分层。也就是说,如果子项重叠,则索引为 0 的子项位于最后方,而索引为 numChildren - 1
的子项位于最前方。这就意味着,新添加的子项的层次将位于现有子项之前。
如果要在其中添加新子项的索引已被旧子项占用,则新子项不会替换旧子项;此旧子项及其后的子项将“滑过”此位置,且各子项的索引值将增加 1。例如,假设 Container 包含子项(A、B、C),而您在索引为 1 处添加了 D。此时容器将包含(A、D、B、C)。如果希望替换旧子项,则必须先将其删除,再添加新子项。
参数
child:DisplayObject — 要添加为此容器的子项的 DisplayObject。它必须实现 IUIComponent 接口。
| |
index:int — 要在其中添加子项的索引。
|
DisplayObject — 添加的子项将作为 DisplayObject 类型的对象。您通常将返回值转换为 UIComponent 或所添加组件的类型。
|
相关 API 元素
addElement | () | 方法 |
public function addElement(element:IVisualElement):IVisualElement
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
将可视元素添加到此容器中。该元素将在添加完所有其他元素之后添加,并出现于所有其他元素之上。要将可视元素添加到特定索引位置,请使用 addElementAt()
方法。
如果添加的可视元素已有一个不同的容器作为父项,则该元素将会从其他容器中删除。
参数
element:IVisualElement — 要添加为此容器的子项的可视元素。
|
IVisualElement — 已添加的元素。
|
addElementAt | () | 方法 |
public function addElementAt(element:IVisualElement, index:int):IVisualElement
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
将可视元素添加到此容器中。该元素将被添加到指定的索引位置。索引 0 代表显示列表中的第一个元素。
如果添加的可视元素已有一个不同的容器作为父项,则该元素将会从其他容器中删除。
参数
element:IVisualElement — 要添加为此可视容器的子项的元素。
| |
index:int — 将该元素添加到的索引位置。如果指定当前占用的索引位置,则该位置以及所有更高位置上的子对象会在子级列表中上移一个位置。
|
IVisualElement — 已添加的元素。
|
attachOverlay | () | 方法 |
override protected function attachOverlay():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
供溶解效果在内部用来添加叠加层到容器的镶边。
contentToGlobal | () | 方法 |
override public function contentToGlobal(point:Point):Point
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将 Point
对象从内容坐标转换为全局坐标。内容坐标指定的像素位置随组件内容的左上角而变化,并包括组件的所有内容区域,甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。全局坐标指定的像素位置随舞台的左上角,即应用窗口的最外侧边缘而变化。
参数
point:Point — 一个 Point 对象,用于指定内容坐标系中的 x 和 y 坐标作为属性。
|
Point — 具有相对于舞台的坐标的 Point 对象。
|
contentToLocal | () | 方法 |
override public function contentToLocal(point:Point):Point
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将 Point
对象由内容坐标转换为本地坐标。内容坐标指定的像素位置随组件内容的左上角而变化,并包括组件的所有内容区域,甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。本地坐标指定的像素位置随组件的左上角而变化。
参数
point:Point — 一个 Point 对象,用于指定内容坐标系中的 x 和 y 坐标作为属性。
|
Point — Point,具有随本地坐标系而变化的坐标的 Point 对象。
|
createBorder | () | 方法 |
protected function createBorder():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
如果需要容器的边框外观,但却不存在,则创建容器的边框外观。
createComponentFromDescriptor | () | 方法 |
public function createComponentFromDescriptor(descriptor:ComponentDescriptor, recurse:Boolean):IFlexDisplayObject
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
提供一个 UIComponentDescriptor,创建相应的组件并将该组件添加为此容器的子代。
此方法将实例化新对象,但不将其添加到显示列表,因此默认情况下,屏幕上不显示该对象。要向显示列表添加新对象,请在调用 createComponentFromDescriptor()
方法后对该容器调用 validateNow()
方法,如以下示例所示:
myVBox.createComponentFromDescriptor(myVBox.childDescriptors[0],false); myVBox.validateNow();
或者,可以对该容器调用 createComponentsFromDescriptors()
方法,以一次性创建所有组件。不需要在调用 createComponentsFromDescriptors()
方法之后调用 validateNow()
方法。
参数
descriptor:ComponentDescriptor — 要创建的组件的 UIComponentDescriptor。此参数可以是 UIComponentDescriptor 对象,也可以是容器某个子项的索引(介于 0 和 n-1 之间的一个整数,其中 n 是此容器的子项总数)。
| |
recurse:Boolean — 如果为 false ,则创建此组件但不创建其子项。如果为 true ,在创建组件后,Flex 将调用 createComponentsFromDescriptors() 方法创建该组件的所有子项或部分子项,这取决于该组件的 creationPolicy 属性值。
|
IFlexDisplayObject — 创建的组件。
|
相关 API 元素
createComponentsFromDescriptors | () | 方法 |
public function createComponentsFromDescriptors(recurse:Boolean = true):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
循环访问 childDescriptors
Array,并对每个元素调用 createComponentFromDescriptor()
方法。
如果容器的 creationPolicy
属性的值为 ContainerCreationPolicy.ALL
,则将在初始化序列期间自动调用此方法。
如果容器的 creationPolicy
值为 ContainerCreationPolicy.AUTO
,则在容器的子项将变为可见时自动调用此方法。
如果容器的 creationPolicy
属性的值为 ContainerCreationPolicy.NONE
,则当您希望创建此容器的子项时应调用此函数。
参数
recurse:Boolean (default = true ) — 如果为 true ,将递归创建组件。
|
createDeferredContent | () | 方法 |
public function createDeferredContent():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
为实现 IDeferredContentOwner 接口以支持延迟实例化的容器,执行调用 createComponentsFromDescriptors(true)
方法的等效操作。
相关 API 元素
executeBindings | () | 方法 |
override public function executeBindings(recurse:Boolean = false):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
执行此 Container 上的所有数据绑定。创建某个 Container 后,Flex 将自动调用此方法以执行其中包含目标的所有数据绑定。MXML 容器/绑定问题 (177074) 的解决方案:覆盖 Container.executeBindings(),以便在调用 BindingManager.executeBindings() 时首选 descriptor.document 而不是 parentDocument。这样,就应始终为使用描述符创建的实例提供正确行为,并将为使用程序创建的实例提供初始行为。(在后一种情况中,可能会出现错误,也可能不出现错误。)可能会针对更新程序 1 提供更完整的修补程序,以保证非 DI 方案和重设父级组件方案中的行为均正确。
参数
recurse:Boolean (default = false ) — 如果为 false ,则仅对此 Container 执行绑定。如果为 true ,则还对此容器的子级、孙级、曾孙级等执行绑定。
|
executeChildBindings | () | 方法 |
getChildAt | () | 方法 |
override public function getChildAt(index:int):DisplayObject
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
获取第 n 个子组件对象。
此方法返回的子项包括在 MXML 中声明的子项,以及使用 addChild()
或 addChildAt()
方法添加的子项。
参数
index:int — 从 0 到 (numChildren - 1) 的数字。
|
DisplayObject — 引用该子项作为 DisplayObject 类型的对象。您通常将返回值转换为 UIComponent 或特定 Flex 控件(如 ComboBox 或 TextArea)的类型。
|
getChildByName | () | 方法 |
override public function getChildByName(name:String):DisplayObject
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
返回 name
属性为指定 String 的子项。
参数
name:String — 子项的标识符。
|
DisplayObject — DisplayObject,用于将子项表示为 DisplayObject 类型的对象。您通常将返回值转换为 UIComponent 或特定 Flex 控件(如 ComboBox 或 TextArea)的类型。如果指定名称的子项不存在,则会引发运行时错误。
|
getChildIndex | () | 方法 |
override public function getChildIndex(child:DisplayObject):int
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
获取特定子项的从零开始的索引。
容器的第一个子项(即:出现在 MXML 声明中的第一个子标签)使用索引 0,第二个子项使用索引 1,依此类推。容器子项的索引确定了其布置次序。例如,在 VBox 中,索引为 0 的子项位于最上方,索引为 1 的子项位于其下,等等。
如果通过调用 addChild()
方法添加子项,则新子项的索引等于现有子项中的最大索引加 1。您可以使用 addChildAt()
方法在指定的索引位置插入子项;此时,先前位于该索引位置的子项的索引,以及高于此位置的子项的索引,都将增加 1,以使所有索引都落在 0 到 (numChildren - 1)
这一范围内。
如果通过调用 removeChild()
或 removeChildAt()
方法删除子项,将调整剩余子项的索引,以使所有索引都落在 0 到 (numChildren - 1)
这一范围内。
如果 myView.getChildIndex(myChild)
返回 5,则 myView.getChildAt(5)
返回 myChild。
通过调用 setChildIndex()
方法可以更改子项的索引。
参数
child:DisplayObject — 对要获得其索引的子项的引用。
|
int — 从 0 到 (numChildren - 1) 的数字。
|
getChildren | () | 方法 |
getElementAt | () | 方法 |
public function getElementAt(index:int):IVisualElement
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回指定索引处的可视元素。
参数
index:int — 要检索的元素的索引。
|
IVisualElement — 位于指定索引位置的元素。
|
getElementIndex | () | 方法 |
public function getElementIndex(element:IVisualElement):int
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回可视元素的索引位置。
参数
element:IVisualElement — 可视元素。
|
int — 容器中元素的索引位置。
|
globalToContent | () | 方法 |
override public function globalToContent(point:Point):Point
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将 Point
对象由全局坐标转换为内容坐标。全局坐标指定的像素位置随舞台的左上角,即应用窗口的最外侧边缘而变化。内容坐标指定的像素位置随组件内容的左上角而变化,并包括组件的所有内容区域,甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。
参数
point:Point — 一个 Point 对象,用于指定全局 (Stage) 坐标系中的 x 和 y 坐标作为属性。
|
Point — Point,具有随组件而变化的坐标的 Point 对象。
|
layoutChrome | () | 方法 |
protected function layoutChrome(unscaledWidth:Number, unscaledHeight:Number):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
通过设置此容器边框的位置和大小响应大小更改。此方法是一种高级方法,可在创建 Container 的子类时覆盖。
使用 addChild()
方法将容器添加到父容器时,以及调用容器的 invalidateDisplayList()
方法时,Flex 将调用 layoutChrome()
方法。
无论 autoLayout
属性的值是什么,都将调用 Container.layoutChrome()
方法。
Container.layoutChrome()
方法可设置 Container 容器边框的位置和大小。在 Container 的每个子类中,子类的 layoutChrome()
方法应调用 super.layoutChrome()
方法,以便适当定位边框。
参数
unscaledWidth:Number — 指定组件在组件坐标中的宽度(以像素为单位),而不考虑该组件的 scaleX 属性值。
| |
unscaledHeight:Number — 指定组件在组件坐标中的高度(以像素为单位),而不考虑该组件的 scaleY 属性值。
|
localToContent | () | 方法 |
override public function localToContent(point:Point):Point
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将 Point
对象由本地坐标转换为内容坐标。本地坐标指定的像素位置随组件的左上角而变化。内容坐标指定的像素位置随组件内容的左上角而变化,并包括组件的所有内容区域,甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。
参数
point:Point — 一个 Point 对象,用于指定本地坐标系中的 x 和 y 坐标作为属性。
|
Point — Point,具有随内容坐标系而变化的坐标的 Point 对象。
|
removeAllChildren | () | 方法 |
public function removeAllChildren():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
在此容器的子项列表中删除所有子项。
removeAllElements | () | 方法 |
public function removeAllElements():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
从容器中删除所有可视元素。
removeChild | () | 方法 |
override public function removeChild(child:DisplayObject):DisplayObject
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
从此容器的子项列表中删除子 DisplayObject。所删除子项的 parent
属性将设置为 null。除非受到显式破坏,否则,子项将一直存在。如果将其添加到另一容器,将保留其上次的已知状态。
参数
child:DisplayObject — 要删除的 DisplayObject。
|
DisplayObject — 删除的子对象是 DisplayObject 类型的对象。您通常将返回值转换为 UIComponent 或所删除组件的类型。
|
removeChildAt | () | 方法 |
override public function removeChildAt(index:int):DisplayObject
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
从此容器的子项列表中删除指定索引位置的子 DisplayObject。所删除子项的 parent
属性将设置为 null。除非受到显式破坏,否则,子项将一直存在。如果将其添加到另一容器,将保留其上次的已知状态。
参数
index:int — 要删除的 DisplayObject 的子索引。
|
DisplayObject — 删除的子对象是 DisplayObject 类型的对象。您通常将返回值转换为 UIComponent 或所删除组件的类型。
|
removeElement | () | 方法 |
public function removeElement(element:IVisualElement):IVisualElement
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
从此容器的子列表中删除指定的可视元素。在该可视容器中,位于该元素之上的所有元素的索引位置都减少 1。
参数
element:IVisualElement — 要从容器中删除的元素。
|
IVisualElement — 已删除的元素。
|
removeElementAt | () | 方法 |
public function removeElementAt(index:int):IVisualElement
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
从容器中的指定索引位置删除可视元素。在该可视容器中,位于该元素之上的所有元素的索引位置都减少 1。
参数
index:int — 要删除的元素的索引。
|
IVisualElement — 已删除的元素。
|
scrollChildren | () | 方法 |
protected function scrollChildren():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
基于 horizontalScrollPosition 和 verticalScrollPosition 属性,确定容器的内容区域相对于可查看区域的位置。可查看区域中未显示出的内容将被剪掉。此方法应由内容区域中包含滚动镶边的子类覆盖。
setChildIndex | () | 方法 |
override public function setChildIndex(child:DisplayObject, newIndex:int):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
设置特定子项的索引。请参阅 getChildIndex()
方法了解子项索引的说明。
参数
child:DisplayObject — 对要设置其索引的子项的引用。
| |
newIndex:int — 指示新索引的数字。必须是介于 0 和 (numChildren - 1) 之间的整数。
|
setElementIndex | () | 方法 |
public function setElementIndex(element:IVisualElement, index:int):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
在可视容器中更改现有可视元素的位置。
在调用 setElementIndex()
方法并指定一个已经占用的索引位置时,只有元素的先前位置和新位置之间的位置发生更改。其他位置保持不变。
如果将某个可视元素移动到低于其当前索引位置的某个索引位置,则在这两个索引之间的所有元素的索引都增加 1。如果将某个元素移动到高于其当前索引位置的某个索引位置,则在这两个索引之间的所有元素的索引都减少 1。
参数
element:IVisualElement — 要为其更改索引编号的元素。
| |
index:int — 元素的最终索引编号。
|
swapElements | () | 方法 |
public function swapElements(element1:IVisualElement, element2:IVisualElement):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
交换两个指定可视元素的索引。所有其他元素仍位于相同的索引位置。
参数
element1:IVisualElement — 第一个可视元素。
| |
element2:IVisualElement — 第二个可视元素。
|
swapElementsAt | () | 方法 |
updateDisplayList | () | 方法 |
override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
通过设置此容器子项的位置和大小来响应大小更改。
有关 updateDisplayList()
方法的更多信息,请参阅 UIComponent.updateDisplayList()
方法。
Container.updateDisplayList()
方法可设置 Container 容器边框的位置和大小。在 Container 的每个子类中,子类的 updateDisplayList()
方法应调用 super.updateDisplayList()
方法,以便适当定位边框。
参数
unscaledWidth:Number — 指定组件在组件坐标中的宽度(以像素为单位),而不考虑该组件的 scaleX 属性值。
| |
unscaledHeight:Number — 指定组件在组件坐标中的高度(以像素为单位),而不考虑该组件的 scaleY 属性值。
|
相关 API 元素
childAdd | 事件 |
mx.events.ChildExistenceChangedEvent
属性 ChildExistenceChangedEvent.type =
mx.events.ChildExistenceChangedEvent.CHILD_ADD
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将子项添加到图例后调度。
调用 addChild()
或 addChildAt()
方法时调度 childAdd 事件。首次创建容器后,会对在 MXML 文件中声明的每个子组件自动调用 addChild()
方法。每次 Repeater 对象添加或删除子对象时,都会自动调用 addChildAt()
方法。应用程序开发人员也可以手动调用这些方法来添加新的子项。
发送此事件时,即已初始化子对象,但尚未计算其宽度和高度,并且尚未在屏幕上绘制子对象。如果希望在完全初始化并呈示子对象时通知您,则注册为子对象的 creationComplete
事件的侦听器。
ChildExistenceChangedEvent.CHILD_ADD
常量可为 childAdd
事件定义事件对象的 type
属性值。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
relatedObject | 包含对创建的子对象的引用。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
childIndexChange | 事件 |
mx.events.IndexChangedEvent
属性 IndexChangedEvent.type =
mx.events.IndexChangedEvent.CHILD_INDEX_CHANGE
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
图例子项的索引(在图例子项中)发生更改后调度。仅对指定作为 setChildIndex()
方法参数的子项调度此事件;而对伴随调用 setChildIndex()
方法而发生索引更改的其他子项不会调度此事件。
调用 setChildIndex()
方法时,子项的索引将发生更改。
type
属性的值,指示容器的子项中某个组件的索引已更改。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
inputType | 指示此事件是否是由鼠标或键盘交互操作导致的。 |
newIndex | 更改后子项的从零开始的索引。 |
oldIndex | 更改前子项的从零开始的索引。 |
relatedObject | 包含对其索引已更改的子对象的引用。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
TriggerEvent | null |
类型 | IndexChangedEvent.CHILD_INDEX_CHANGE |
childRemove | 事件 |
mx.events.ChildExistenceChangedEvent
属性 ChildExistenceChangedEvent.type =
mx.events.ChildExistenceChangedEvent.CHILD_REMOVE
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
删除图例的子项之前调度。
当调用下列任一方法时传送此事件:removeChild()
、removeChildAt()
或 removeAllChildren()
。
ChildExistenceChangedEvent.CHILD_REMOVE
常量可为 childRemove
事件定义事件对象的 type
属性值。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
relatedObject | 包含对要删除的子对象的引用。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
dataChange | 事件 |
mx.events.FlexEvent
属性 FlexEvent.type =
mx.events.FlexEvent.DATA_CHANGE
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当 data
属性更改时进行调度。
当图例在 List 组件或其它组件中用作呈示器时,将使用 data
属性将要显示的数据传递给该图例。
FlexEvent.DATA_CHANGE
常量可为 dataChange
事件定义事件对象的 type
属性值。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
itemClick | 事件 |
mx.charts.events.LegendMouseEvent
属性 LegendMouseEvent.type =
mx.charts.events.LegendMouseEvent.ITEM_CLICK
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当用户在 Legend 控件中的 LegendItem 上单击时调度此事件。
事件类型常量;指示用户在图例项目上单击了鼠标按键。itemMouseDown | 事件 |
mx.charts.events.LegendMouseEvent
属性 LegendMouseEvent.type =
mx.charts.events.LegendMouseEvent.ITEM_MOUSE_DOWN
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当用户在 Legend 控件中的 LegendItem 上按下鼠标按键时调度此事件。
事件类型常量;指示用户在图例项目上单击了鼠标按键。itemMouseOut | 事件 |
mx.charts.events.LegendMouseEvent
属性 LegendMouseEvent.type =
mx.charts.events.LegendMouseEvent.ITEM_MOUSE_OUT
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当用户将鼠标从 Legend 中的 LegendItem 上移走时调度此事件。
事件类型常量;指示用户将鼠标指针滚离了某个图例项目。itemMouseOver | 事件 |
mx.charts.events.LegendMouseEvent
属性 LegendMouseEvent.type =
mx.charts.events.LegendMouseEvent.ITEM_MOUSE_OVER
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当用户将鼠标移至 Legend 控件中的 LegendItem 上时调度此事件。
事件类型常量;指示用户将鼠标指针滚到了某个图例项目上。itemMouseUp | 事件 |
mx.charts.events.LegendMouseEvent
属性 LegendMouseEvent.type =
mx.charts.events.LegendMouseEvent.ITEM_MOUSE_UP
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当用户在 Legend 中的 LegendItem 上释放鼠标按键时调度此事件。
事件类型常量;指示用户在图例项目上释放了鼠标按键。<?xml version="1.0"?> <!-- Simple example to demonstrate the PlotChart control. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx"> <fx:Script> <![CDATA[ import mx.collections.ArrayCollection; [Bindable] private var expensesAC:ArrayCollection = new ArrayCollection( [ { Month: "Jan", Profit: 2000, Expenses: 1500, Amount: 450 }, { Month: "Feb", Profit: 1000, Expenses: 200, Amount: 600 }, { Month: "Mar", Profit: 1500, Expenses: 500, Amount: 300 } ]); ]]> </fx:Script> <fx:Declarations> <!-- Define custom colors for use as plot point fills. --> <mx:SolidColor id="sc1" color="blue" alpha=".3"/> <mx:SolidColor id="sc2" color="red" alpha=".3"/> <mx:SolidColor id="sc3" color="green" alpha=".3"/> <!-- Define custom Strokes. --> <mx:SolidColorStroke id="s1" color="blue" weight="1"/> <mx:SolidColorStroke id="s2" color="red" weight="1"/> <mx:SolidColorStroke id="s3" color="green" weight="1"/> </fx:Declarations> <mx:Panel title="PlotChart Control Example" height="100%" width="100%"> <mx:PlotChart id="plot" height="100%" width="100%" paddingLeft="5" paddingRight="5" showDataTips="true" dataProvider="{expensesAC}" > <mx:series> <mx:PlotSeries xField="Expenses" yField="Profit" displayName="Plot 1" fill="{sc1}" stroke="{s1}" /> <mx:PlotSeries xField="Amount" yField="Expenses" displayName="Plot 2" fill="{sc2}" stroke="{s2}" /> <mx:PlotSeries xField="Profit" yField="Amount" displayName="Plot 3" fill="{sc3}" stroke="{s3}" /> </mx:series> </mx:PlotChart> <mx:Legend dataProvider="{plot}"/> </mx:Panel> </s:Application>
Tue Jun 12 2018, 11:04 AM Z