包 | mx.containers |
类 | public class FormItem |
继承 | FormItem Container UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
从 Flex 4.5 开始,Adobe 建议您使用 spark.components.FormItem 类来替代此类。 |
FormItem 容器定义一个标签以及一个或多个水平或垂直排列的子容器。子容器可以是控件,也可以是其他容器。一个 Form 容器可以容纳多个 FormItem 容器。 MXML 语法隐藏 MXML 语法
The <mx:FormItem>
tag inherits all of the tag
attributes of its superclass, except paddingLeft
,
and adds the following tag attributes:
<mx:FormItem Properties direction="vertical|horizontal" label="" required="false|true" Styles horizontalAlign="left|center|right" horizontalGap="8" indicatorGap="14" indicatorSkin="'mx.containers.FormItem.Required' symbol in Assets.swf" labelStyleName="" labelWidth="Calculated" paddingBottom="0" paddingRight="0" paddingTop="0" verticalGap="6" > ... child tags ... </mx:FormItem>
相关 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,则在更改子项的位置或大小时完成度量和布局。 | Container | ||
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。 | Container | ||
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。 | Container | ||
className : String [只读]
此实例的类的名称,如“Button”。 | UIComponent | ||
clipContent : Boolean
如果此容器的子项的位置和/或大小扩展到此容器的边框之外,是否应用剪裁遮罩。 | Container | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
contentMouseX : Number [覆盖] [只读]
返回鼠标在内容坐标系中的 x 位置。 | Container | ||
contentMouseY : Number [覆盖] [只读]
返回内容坐标系中鼠标的 y 位置。 | Container | ||
contextMenu : NativeMenu
指定与此对象相关联的上下文菜单。 | InteractiveObject | ||
creatingContentPane : Boolean
容器使用内部内容窗格控制滚动。 | Container | ||
creationIndex : int 不推荐使用: 不推荐使用
指定实例化和绘制容器子项的顺序。 | Container | ||
creationPolicy : String
此 MX Container 的子代创建策略。 | Container | ||
currentState : String
组件的当前视图状态。 | UIComponent | ||
cursorManager : ICursorManager [只读]
获取控制此组件及其同级组件的光标的 CursorManager。 | UIComponent | ||
data : Object
当您在项呈示器或项目编辑器中使用某个组件时,可借助 data 属性向该组件传递值。 | Container | ||
defaultButton : IFlexDisplayObject
指定为容器的默认按钮的 Button 控件。 | Container | ||
deferredContentCreated : Boolean [只读]
IDeferredContentOwner 等效于 processedDescriptors
| Container | ||
depth : Number
确定容器内各项目的呈示顺序。 | UIComponent | ||
descriptor : UIComponentDescriptor
引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | UIComponent | ||
designLayer : DesignLayer
指定与该可视元素关联的可选 DesignLayer 实例。 | UIComponent | ||
direction : String
FormItem 子组件的方向。 | FormItem | ||
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 | ||
horizontalLineScrollSize : Number
按下水平滚动条中的向左或向右箭头按钮时要移动的像素数目。 | Container | ||
horizontalPageScrollSize : Number
按下水平滚动条中的轨道时要移动的像素数目。 | Container | ||
horizontalScrollBar : ScrollBar
此容器中使用的水平滚动栏。 | Container | ||
horizontalScrollPolicy : String
指定水平滚动条是始终显示、始终不显示,还是在需要时自动添加。 | Container | ||
horizontalScrollPosition : Number
水平滚动条的当前位置。 | Container | ||
icon : Class
由某些导航器容器显示的图标的 Class,用于代表此 Container。 | Container | ||
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 | ||
itemLabel : Label [只读]
显示 FormItem 标签的 FormItemLabel 子组件的只读引用。 | FormItem | ||
label : String [覆盖]
FormItem 文本标签。 | FormItem | ||
layoutMatrix3D : Matrix3D [只写]
用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | ||
left : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
loaderInfo : LoaderInfo [只读]
返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | ||
maintainProjectionCenter : Boolean
如果为 true,则该组件将使其投影矩阵在其边框的中央保持居中。 | UIComponent | ||
mask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | ||
maxHeight : Number
布局过程中父级要考虑的组件最大建议高度。 | UIComponent | ||
maxHorizontalScrollPosition : Number [只读]
horizontalScrollPosition 属性的最大可能值。 | Container | ||
maxVerticalScrollPosition : Number [只读]
verticalScrollPosition 属性的最大可能值。 | Container | ||
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 [覆盖] [只读]
此容器中的子组件数。 | Container | ||
numElements : int [只读]
此容器中的可视元素的数量。 | Container | ||
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 属性枚举这些子组件。 | Container | ||
repeater : IRepeater [只读]
对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | ||
repeaterIndex : int [只读]
项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。 | UIComponent | ||
repeaterIndices : Array
一个 Array,包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。 | UIComponent | ||
repeaters : Array
一个 Array,包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | ||
required : Boolean
如果为 true,将显示一个指示符以指示 FormItem 子项要求用户进行输入。 | FormItem | ||
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 | ||
verticalLineScrollSize : Number
按下垂直滚动条中的向上或向下箭头按钮或使用鼠标滚轮滚动时,要滚动的像素数目。 | Container | ||
verticalPageScrollSize : Number
按下垂直滚动条中的轨道时要滚动的像素数目。 | Container | ||
verticalScrollBar : ScrollBar
此容器中使用的垂直滚动栏。 | Container | ||
verticalScrollPolicy : String
指定垂直滚动条是始终显示、始终不显示,还是在需要时自动添加。 | Container | ||
verticalScrollPosition : Number
垂直滚动条的当前位置。 | Container | ||
viewMetrics : EdgeMetrics [只读]
返回一个对象,该对象具有四个属性:left、top、right 和 bottom。 | Container | ||
viewMetricsAndPadding : EdgeMetrics [只读]
返回一个对象,该对象具有四个属性:left、top、right 和 bottom。 | Container | ||
visible : Boolean [覆盖]
显示对象是否可见。 | UIComponent | ||
width : Number [覆盖]
指定组件在父坐标中的宽度的数字(以像素为单位)。 | UIComponent | ||
x : Number [覆盖]
指定组件在其父容器中的水平位置(以像素为单位)的数字。 | UIComponent | ||
y : Number [覆盖]
指定组件在其父容器中的垂直位置(以像素为单位)的数字。 | UIComponent | ||
z : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | UIComponent |
方法 | 由以下参数定义 | ||
---|---|---|---|
FormItem()
构造函数。 | FormItem | ||
[覆盖]
向此容器添加一个子 DisplayObject 子项。 | Container | ||
[覆盖]
向此容器添加一个子 DisplayObject 子项。 | Container | ||
将可视元素添加到此容器中。 | Container | ||
将可视元素添加到此容器中。 | Container | ||
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 对象由内容坐标转换为全局坐标。 | Container | ||
[覆盖]
将 Point 对象由内容坐标转换为本地坐标。 | Container | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
提供一个 UIComponentDescriptor,创建相应的组件并将该组件添加为此容器的子项。 | Container | ||
循环访问 childDescriptor Array,并对每个元素调用 createComponentFromDescriptor() 方法。 | Container | ||
为实现 IDeferredContentOwner 接口以支持延迟实例化的容器,执行调用 createComponentsFromDescriptors(true) 方法的等效操作。 | Container | ||
在 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 上的所有数据绑定。 | Container | ||
执行到此 Container 的子 UIComponent 对象的绑定。 | Container | ||
打印完成后调用。 | UIComponent | ||
在指定的索引位置提供自动化对象。 | UIComponent | ||
提供自动化对象列表。 | UIComponent | ||
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | ||
按指定的元素大小,返回元素边界的 x 坐标。 | UIComponent | ||
按指定的元素大小,返回元素边界的 y 坐标。 | UIComponent | ||
[覆盖]
获取第 n 个子组件对象。 | Container | ||
[覆盖]
返回 name 属性为指定 String 的子项。 | Container | ||
[覆盖]
获取特定子项的从零开始的索引。 | Container | ||
返回由容器的内容子项组成的 DisplayObject 对象的 Array。 | Container | ||
查找此 UIComponent 实例的类型选择器。 | UIComponent | ||
返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | ||
返回指定索引处的可视元素。 | Container | ||
返回可视元素的索引位置。 | Container | ||
确定是使用显式高度还是测量高度的一种简便方法
| 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 对象由全局坐标转换为内容坐标。 | Container | ||
将 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 对象由本地坐标转换为内容坐标。 | Container | ||
将 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 | ||
在此容器的子项列表中删除所有子项。 | Container | ||
从容器中删除所有可视元素。 | Container | ||
[覆盖]
从此容器的子项列表中删除子 DisplayObject。 | Container | ||
[覆盖]
从此容器的子项列表中删除指定索引位置的子 DisplayObject。 | Container | ||
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | ||
从此容器的子列表中删除指定的可视元素。 | Container | ||
从容器中的指定索引位置删除可视元素。 | Container | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
从该组件实例删除非可视样式客户端。 | UIComponent | ||
重放指定的事件。 | UIComponent | ||
显示虚拟键盘。 | InteractiveObject | ||
使用提供的 ID 解析子项。 | UIComponent | ||
[静态]
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | ||
调整对象大小。 | UIComponent | ||
[覆盖]
设置特定子项的索引。 | Container | ||
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | ||
设置当前状态。 | UIComponent | ||
在可视容器中更改现有可视元素的位置。 | Container | ||
设置此组件的焦点。 | 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 | ||
交换两个指定可视元素的索引。 | Container | ||
交换容器中位于两个指定索引位置的可视元素。 | Container | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | 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 | ||
[覆盖]
供溶解效果在内部用来添加叠加层到容器的镶边。 | Container | ||
确定是否可以跳过对 measure() 方法的调用。 | UIComponent | ||
创建子对象后执行任何最终处理。 | UIComponent | ||
处理对组件设置的属性。 | UIComponent | ||
如果需要容器的边框外观,但却不存在,则创建容器的边框外观。 | Container | ||
创建组件的子对象。 | 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 | ||
通过设置此容器边框的位置和大小响应大小更改。 | Container | ||
[覆盖]
计算 FormItem 的首选大小、最小大小和最大大小。 | FormItem | ||
构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。 | UIComponent | ||
基于 horizontalScrollPosition 和 verticalScrollPosition 属性,确定容器的内容区域相对于可查看区域的位置。 | Container | ||
在水平方向和垂直方向上,指定转换拉伸因子。 | UIComponent | ||
当状态改变以检查状态特定的样式是否应用到此组件时,会调用此方法。 | UIComponent | ||
[覆盖]
通过设置此容器的子容器的位置和大小来响应大小更改。 | FormItem |
样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 如果指定了背景图像,则此样式指定它是相对于视域保持固定状态 ( "fixed" ) 还是随着内容一起滚动 ("scroll" ). | Container | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位). | UIComponent | |||
类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的边框外观类. | Container | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 边框样式. | Container | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件底边到其父容器的内容区域底边之间的垂直距离(以像素为单位). | UIComponent | |||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件中文本(包括组件标签)的颜色. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的方向性. | Container | |||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用时组件中文本的颜色. | Container | |||
类型: Number CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用容器时放置在容器上的叠加层的 alpha 值. | Container | |||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 验证失败时,组件加亮部分的颜色. | UIComponent | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置内部 TextField 的 antiAliasType 属性. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 使用的字体的名称. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性. | Container | |||
类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性. | Container | |||
类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本的高度,以像素为单位. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用斜体. | Container | |||
类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用粗体. | Container | |||
horizontalAlign | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 水平对齐容器中的子容器。可能值包括 "left" 、"center" 和 "right" 。
默认值为 "left" 。 | FormItem | ||
类型: 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。 | FormItem | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 水平 scrollbar 样式的名称. | Container | |||
indicatorGap | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 表单项的标签和子组件之间的像素数目。 默认值为 14 。 | FormItem | ||
indicatorSkin | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定要对所需字段指示符使用的外观。默认值为 Assets.swf 文件中的 "mx.containers.FormItem.Required" 符号。 | FormItem | ||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 该组件的主要交互模式. | UIComponent | |||
类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 一个布尔值,表示是启用 ( true ) 还是禁用 (false ) 字距调整. | Container | |||
labelStyleName | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用于 FormItem 标签样式的 CSS 样式声明的名称。默认情况下,标签使用 FormItem 的可继承样式或由 FormItemLabel 声明的样式。应使用此样式代替 FormItemLabel。 | FormItem | ||
labelWidth | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 表单标签的宽度。默认值为表单中最长标签的长度。 | FormItem | ||
类型: 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 | |||
类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 各字符之间显示的附加像素数. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的区域设置. | Container | |||
paddingBottom | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器的下边框与其内容区域的下边缘之间的像素数目。 默认值为 0 。 | FormItem | ||
类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件左边框与其内容区域左边缘之间的像素数目. | Container | |||
paddingRight | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器的右边框与其内容区域的右边缘之间的像素数目。 默认值为 0 。 | FormItem | ||
paddingTop | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器的上边框与其内容区域的上边缘之间的像素数目。 默认值为 0 。 | FormItem | ||
类型: 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 | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器内文本的对齐方式. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否加下划线. | Container | |||
类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 实现此组件用来呈示文本的 IUITextField 的类. | Container | |||
类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本第一行偏离容器左侧的距离(以像素为单位). | Container | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件顶边到其父容器的内容区域顶边之间的垂直距离(以像素为单位). | UIComponent | |||
类型: 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。 | FormItem | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 垂直 scrollbar 样式的名称. | Container |
direction | 属性 |
direction:String
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
FormItem 子组件的方向。MXML 值可以是 "vertical"
,也可以是 "horizontal"
。默认的 MXML 值是 "vertical"
。ActionScript 值可以是 FormItemDirection.VERTICAL
,也可以是 FormItemDirection.HORIZONTAL
。
如果 direction
为 "vertical"
,则 FormItem 的子项将垂直堆叠到 FormItem 标签的右侧。如果 direction
为 "horizontal"
,则子项将放置于一行中(如果可能)或两个同等大小的列中。
如果需要对 FormItem 子项的布局进行更多控制,您可以使用容器(如 Grid 或 Tile)作为 FormItem 的直属子项并将所需控件放入其中。
默认值为 FormItemDirection.VERTICAL。
此属性可用作数据绑定的源。修改此属性后,将调度 directionChanged
事件。
实现
public function get direction():String
public function set direction(value:String):void
相关 API 元素
itemLabel | 属性 |
label | 属性 |
required | 属性 |
required:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
如果为 true
,将显示一个指示符以指示 FormItem 子项要求用户进行输入。如果为 false
,则不会显示指示符。
此属性仅控制指示符显示。如果您需要输入验证,必须在子项上附加验证程序。
默认值为 false。
此属性可用作数据绑定的源。修改此属性后,将调度 requiredChanged
事件。
实现
public function get required():Boolean
public function set required(value:Boolean):void
FormItem | () | 构造函数 |
public function FormItem()
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
measure | () | 方法 |
override protected function measure():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
计算 FormItem 的首选大小、最小大小和最大大小。有关 measure()
方法的详细信息,请参阅 UIComponent.measure()
方法。
FormItem.measure()
方法首先确定要使用的列的数目。如果 direction
属性为 FormItemDirection.HORIZONTAL
,则在可能的情况下,所有控件都将放置于一行中。如果一行中无法容纳所有控件,则它们将分成两列。如果分成两列不起作用,则使用一列。如果 direction
为 FormItemDirection.VERTICAL
,则所有控件都将放置到一列(如 VBox
)。
FormItem 包含两个区域:标签区域和控件区域。无论控件的方向如何,标签的大小都是一样的。控件区域的大小取决于使用的行数和列数。
标签区域的宽度取决于 labelWidth
样式属性。如果此属性为 undefined
(默认设置),则使用父 Form 容器中最大标签的宽度。
如果所有子容器均位于一行,则控件区域的宽度为所有子容器的宽度与子容器之间的 horizontalGap
间距的总和。
如果所有子容器均位于一列,则控件区域的宽度为最宽子容器的宽度。
如果子容器位于多行多列上,则列宽为最宽子容器的宽度,控件区域的宽度为列宽与列数的乘积再加上各列之间的 horizontalGap
间距。
将 measuredWidth
设置为标签区域的宽度、控件区域的宽度和 indicatorGap
样式属性值这三者之和。还添加了 paddingLeft
和 paddingRight
样式属性值以及边框宽度。
将 measuredHeight
设置为子容器所有行的首选高度与各子容器之间的 verticalGap
间距的总和。还添加了 paddingTop
和 paddingBottom
样式属性以及边框高度。
将 measuredMinWidth
设置为标签区域的宽度、控件区域的最小宽度和 indicatorGap
样式属性值这三者之和。还添加了 paddingLeft
和 paddingRight
样式属性值以及边框宽度。
将 measuredMinHeight
设置为子容器所有行的最小高度与各个子容器之间的 verticalGap
间距的总和。还添加了 paddingTop
和 paddingBottom
样式属性以及边框高度。
updateDisplayList | () | 方法 |
override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
通过设置此容器的子容器的位置和大小来响应大小更改。有关 updateDisplayList()
方法的更多信息,请参阅 UIComponent.updateDisplayList()
方法。
有关如何定位 FormItem 控件的详细信息,请参阅 FormItem.measure()
方法。
根据 textAlign
样式属性对齐标签区域中的标签。表单中的所有标签互相对齐。
如果将 required
属性设置为 true
,则将在标签和控件之间放置用于指示该字段为必填字段的符号。
如 measure()
方法的文档中的描述,将以列的形式对控件进行定位。horizontalAlign
样式属性可确定将控件水平放置到的位置。
如果将 direction
属性设置为 "vertical"
,则任何未指定 width
的子容器将均使用与控件区域 1/4 宽度最接近的 measuredWidth
。这是为了避免控件的右边缘出现锯齿。
此方法在调用 super.updateDisplayList()
方法后才会进行其他操作。
参数
unscaledWidth:Number — 指定组件在组件坐标中的宽度(以像素为单位),而不考虑该组件的 scaleX 属性值。
| |
unscaledHeight:Number — 指定组件在组件坐标中的高度(以像素为单位),而不考虑该组件的 scaleY 属性值。
|
<?xml version="1.0"?> <!-- Simple example to demonstrate Halo Form layout container. --> <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:Declarations> <fx:Model id="checkModel"> <User> <FirstName>{fname.text}</FirstName> <DOB>{dob.text}</DOB> <Email>{email.text}</Email> <Age>{age.text}</Age> <SSN>{ssn.text}</SSN> <Zip>{zip.text}</Zip> <Phone>{phone.text}</Phone> </User> </fx:Model> <mx:StringValidator source="{fname}" property="text" minLength="4" maxLength="12"/> <mx:PhoneNumberValidator source="{phone}" property="text"/> <mx:DateValidator source="{dob}" property="text"/> <mx:EmailValidator source="{email}" property="text"/> <mx:NumberValidator source="{age}" property="text" integerError="Enter Integer value" minValue="18" maxValue="100" domain="int"/> <mx:SocialSecurityValidator source="{ssn}" property="text"/> <mx:ZipCodeValidator source="{zip}" property="text"/> </fx:Declarations> <s:Panel title="Form Container Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:VGroup left="10" right="10" top="10" bottom="10"> <s:Label width="100%" color="blue" text="Moving from one form field to another triggers the validator."/> <mx:Form width="100%" height="100%"> <mx:FormHeading label="Enter values into the form."/> <mx:FormItem label="First name"> <mx:TextInput id="fname" width="200"/> </mx:FormItem> <mx:FormItem label="Date of birth (mm/dd/yyyy)"> <mx:TextInput id="dob" width="200"/> </mx:FormItem> <mx:FormItem label="E-mail address"> <mx:TextInput id="email" width="200"/> </mx:FormItem> <mx:FormItem label="Age"> <mx:TextInput id="age" width="200"/> </mx:FormItem> <mx:FormItem label="SSN"> <mx:TextInput id="ssn" width="200"/> </mx:FormItem> <mx:FormItem label="Zip"> <mx:TextInput id="zip" width="200"/> </mx:FormItem> <mx:FormItem label="Phone"> <mx:TextInput id="phone" width="200"/> </mx:FormItem> </mx:Form> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:04 AM Z