用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.core 

UITextField  - AS3 Flex

mx.core
public class UITextField
继承UITextField Inheritance FlexTextField Inheritance TextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
实现 IAutomationObject, IIMESupport, IFlexModule, IInvalidating, ISimpleStyleClient, IToolTipManagerClient, IUITextField
子类 AdvancedDataGridItemRenderer, DataGridItemRenderer, UITextFieldGridItemRenderer

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

UITextField 类定义许多 Flex 组件用来显示文本的组件。例如,mx.controls.Button 控件使用 UITextField 组件定义 Button 控件的标签区域。

UITextField 类扩展 flash.text.TextField 类以支持 Flex 所需的其他功能,如 CSS 样式、无效/度量/布局、启用/禁用、工具提示和支持输入中文、日文和韩文文本的 IME(输入法编辑器)。

警告:如果 UITextField 继承 layoutDirection="rtl",它将修改其自己的 transform.matrix 以在本地复原默认坐标系。

相关 API 元素



公共属性
 属性由以下参数定义
 InheritedaccessibilityImplementation : AccessibilityImplementation
InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
DisplayObject
 Inheritedalpha : Number
表示指定对象的 Alpha 透明度值。
DisplayObject
 InheritedalwaysShowSelection : Boolean
如果设置为 true 且文本字段没有焦点,Flash Player 将以灰色突出显示文本字段中的所选内容。
TextField
 InheritedantiAliasType : String
用于此文本字段的消除锯齿类型。
TextField
  automationDelegate : Object
正在处理相关自动化功能的委托对象。
UITextField
  automationEnabled : Boolean
[只读] 如果此组件启用了自动化,则为 true;否则为 false。
UITextField
  automationName : String
可用作此对象的标识符的名称。
UITextField
  automationOwner : DisplayObjectContainer
[只读] 用于自动化目的的此组件的所有者。
UITextField
  automationParent : DisplayObjectContainer
[只读] 用于自动化目的的此组件的父级。
UITextField
  automationValue : Array
[只读] 此值通常对应于对象的经呈示的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。
UITextField
  automationVisible : Boolean
[只读] 如果此组件对于自动化是可见的,则为 true;否则为 false。
UITextField
 InheritedautoSize : String
控制文本字段的自动大小调整和对齐。
TextField
 Inheritedbackground : Boolean
指定文本字段是否具有背景填充。
TextField
 InheritedbackgroundColor : uint
文本字段背景的颜色。
TextField
  baselinePosition : Number
[只读] 首行文本基线的 y 坐标。
UITextField
 InheritedblendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
DisplayObject
 InheritedblendShader : Shader
[只写] 设置用于混合前景和背景的着色器。
DisplayObject
 Inheritedborder : Boolean
指定文本字段是否具有边框。
TextField
 InheritedborderColor : uint
文本字段边框的颜色。
TextField
 InheritedbottomScrollV : int
[只读] 一个整数(从 1 开始的索引),表示指定文本字段中当前可以看到的最后一行。
TextField
 InheritedcacheAsBitmap : Boolean
如果设置为 true,则 Flash 运行时将缓存显示对象的内部位图表示形式。
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
如果为非 null,则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。
DisplayObject
 InheritedcaretIndex : int
[只读] 插入点(尖号)位置的索引。
TextField
  className : String
[只读] 此实例的类的名称,如“DataGridItemRenderer”。
UITextField
 InheritedcondenseWhite : Boolean
一个布尔值,指定是否删除具有 HTML 文本的文本字段中的额外空白(空格、换行符等等)。
TextField
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcontextMenu : NativeMenu
指定与此对象相关联的上下文菜单。
InteractiveObject
 InheriteddefaultTextFormat : flash.text:TextFormat
指定应用于新插入文本(例如,用户输入的文本或使用 replaceSelectedText() 方法插入的文本)的格式。
TextField
 InheriteddisplayAsPassword : Boolean
指定文本字段是否是密码文本字段。
TextField
  document : Object
对与此 UITextField 对象关联的文档对象的引用。
UITextField
 InheriteddoubleClickEnabled : Boolean
指定此对象是否接收 doubleClick 事件。
InteractiveObject
 InheritedembedFonts : Boolean
指定是否使用嵌入字体轮廓进行呈现。
TextField
  enabled : Boolean
一个指示是否启用组件的布尔值。
UITextField
  enableIME : Boolean
[只读] 一个标志,用于指示当组件获得焦点时是否应启用 IME。
UITextField
  explicitHeight : Number
指定该组件在组件坐标中显式高度(以像素为单位)的数字。
UITextField
  explicitMaxHeight : Number
[只读] 采用组件坐标指定组件最大高度(以像素为单位)的数字(如果设置了 maxHeight 属性)。
UITextField
  explicitMaxWidth : Number
[只读] 采用组件坐标指定组件最大宽度(以像素为单位)的数字(如果设置了 maxWidth 属性)。
UITextField
  explicitMinHeight : Number
[只读] 布局过程中父级要考虑的组件最小建议高度。
UITextField
  explicitMinWidth : Number
[只读] 布局过程中父级要考虑的组件最小建议宽度。
UITextField
  explicitWidth : Number
指定该组件在组件坐标中显式宽度(以像素为单位)的数字。
UITextField
 Inheritedfilters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
DisplayObject
  focusPane : Sprite
在组件中共享并用作绘制焦点指示符的叠加层的单个 Sprite 对象。
UITextField
 InheritedfocusRect : Object
指定此对象是否显示焦点矩形。
InteractiveObject
 InheritedgridFitType : String
用于此文本字段的网格固定类型。
TextField
 Inheritedheight : Number
表示显示对象的高度,以像素为单位。
DisplayObject
 InheritedhtmlText : String
包含文本字段内容的 HTML 表示形式。
TextField
  ignorePadding : Boolean
如果为 true,paddingLeft 和 paddingRight 样式不会在组件文本周围添加空间。
UITextField
  imeMode : String
指定 IME(输入法编辑器)模式。
UITextField
  includeInLayout : Boolean
指定此组件是否包含在父容器的布局中。
UITextField
  inheritingStyles : Object
此 UITextField 继承样式链的起始位置。
UITextField
  initialized : Boolean
一个标志,确定对象是否已通过三个阶段的布局验证(假定需要完成所有阶段)。
UITextField
  isPopUp : Boolean
PopUpManager 将其设置为 true 以指示已弹出该组件。
UITextField
 Inheritedlength : int
[只读] 文本字段中的字符数。
TextField
 InheritedloaderInfo : LoaderInfo
[只读] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
DisplayObject
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
DisplayObject
 InheritedmaxChars : int
文本字段中最多可包含的字符数(即用户输入的字符数)。
TextField
  maxHeight : Number
[只读] 布局过程中父级要考虑的组件最大建议高度。
UITextField
 InheritedmaxScrollH : int
[只读] scrollH 的最大值。
TextField
 InheritedmaxScrollV : int
[只读] scrollV 的最大值。
TextField
  maxWidth : Number
[只读] 布局过程中父级要考虑的组件最大建议宽度。
UITextField
  measuredHeight : Number
[只读] 组件的默认高度(以像素为单位)。
UITextField
  measuredMinHeight : Number
组件的默认最小高度(以像素为单位)。
UITextField
  measuredMinWidth : Number
组件的默认最小宽度(以像素为单位)。
UITextField
  measuredWidth : Number
[只读] 组件的默认宽度(以像素为单位)。
UITextField
 InheritedmetaData : Object
如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的,则获取 DisplayObject 实例的元数据对象。
DisplayObject
  minHeight : Number
[只读] 布局过程中父级要考虑的组件最小建议高度。
UITextField
  minWidth : Number
[只读] 布局过程中父级要考虑的组件最小建议宽度。
UITextField
  moduleFactory : IFlexModuleFactory
用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。
UITextField
 InheritedmouseEnabled : Boolean
指定此对象是否接收鼠标或其他用户输入、消息。
InteractiveObject
 InheritedmouseWheelEnabled : Boolean
一个布尔值,表示当用户单击某个文本字段并滚动鼠标滚轮时,Flash Player 是否自动滚动多行文本字段。
TextField
 InheritedmouseX : Number
[只读] 表示此鼠标或用户输入设备位置的 x 坐标,以像素为单位。
DisplayObject
 InheritedmouseY : Number
[只读] 表示此鼠标或用户输入设备位置的 y 坐标,以像素为单位。
DisplayObject
 Inheritedmultiline : Boolean
表示字段是否为多行文本字段。
TextField
 Inheritedname : String
表示 DisplayObject 的实例名称。
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
指定当该 InteractiveObject 实例获得焦点时,是否显示虚拟键盘(显示在屏幕上的软键盘)。
InteractiveObject
  nestLevel : int
此对象在所属关系层次结构中的深度。
UITextField
  nonInheritingStyles : Object
此 UITextField 非继承样式链的起始位置。
UITextField
  nonZeroTextHeight : Number
[只读] 与 textHeight 不同,此方法将返回一个非零值,即使文本为空。
UITextField
 InheritednumLines : int
[只读] 定义多行文本字段中的文本行数。
TextField
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
DisplayObject
  owner : DisplayObjectContainer
默认情况下,设置为此对象的父容器。
UITextField
  parent : DisplayObjectContainer
[覆盖] [只读] 此组件的父容器或组件。
UITextField
  percentHeight : Number
以组件父代大小百分比的方式指定组件高度。
UITextField
  percentWidth : Number
以组件父代大小百分比的方式指定组件宽度。
UITextField
  processedDescriptors : Boolean
createChildren() 方法创建任意内部组件子项后设置为 true。
UITextField
 Inheritedrestrict : String
表示用户可输入到文本字段中的字符集。
TextField
 Inheritedroot : DisplayObject
[只读] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
DisplayObject
 Inheritedrotation : Number
表示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。
DisplayObject
 InheritedrotationX : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转(以度为单位)。
DisplayObject
 InheritedrotationY : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转(以度为单位)。
DisplayObject
 InheritedrotationZ : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转(以度为单位)。
DisplayObject
 Inheritedscale9Grid : Rectangle
当前有效的缩放网格。
DisplayObject
 InheritedscaleX : Number
表示从注册点开始应用的对象的水平缩放比例(百分比)。
DisplayObject
 InheritedscaleY : Number
表示从对象注册点开始应用的对象的垂直缩放比例(百分比)。
DisplayObject
 InheritedscaleZ : Number
表示从对象的注册点开始应用的对象的深度缩放比例(百分比)。
DisplayObject
 InheritedscrollH : int
当前水平滚动位置。
TextField
 InheritedscrollRect : Rectangle
显示对象的滚动矩形范围。
DisplayObject
 InheritedscrollV : int
文本在文本字段中的垂直位置。
TextField
 Inheritedselectable : Boolean
一个布尔值,表示文本字段是否可选。
TextField
 InheritedselectionBeginIndex : int
[只读] 当前所选内容中第一个字符从零开始的字符索引值。
TextField
 InheritedselectionEndIndex : int
[只读] 当前所选内容中最后一个字符从零开始的字符索引值。
TextField
 Inheritedsharpness : Number
此文本字段中字型边缘的清晰度。
TextField
 Inherited    softKeyboard : String
控制软键盘的外观。
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
定义当显示软键盘时应在屏幕上保留的区域(在 iOS 上不支持)。
InteractiveObject
 Inheritedstage : Stage
[只读] 显示对象的舞台。
DisplayObject
  styleName : Object
此组件使用的类样式。
UITextField
 InheritedstyleSheet : StyleSheet
将样式表附加到文本字段。
TextField
  systemManager : ISystemManager
返回此组件使用的 SystemManager 对象。
UITextField
 InheritedtabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。
InteractiveObject
 InheritedtabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。
InteractiveObject
 Inheritedtext : String
作为文本字段中当前文本的字符串。
TextField
 InheritedtextColor : uint
文本字段中文本的颜色(采用十六进制格式)。
TextField
 InheritedtextHeight : Number
[只读] 文本的高度,以像素为单位。
TextField
 InheritedtextInteractionMode : String
[只读] 交互模式属性,默认值为 TextInteractionMode.NORMAL。
TextField
 InheritedtextWidth : Number
[只读] 文本的宽度,以像素为单位。
TextField
 Inheritedthickness : Number
此文本字段中字型边缘的粗细。
TextField
  toolTip : String
要在 ToolTip 中显示的文本。
UITextField
 Inheritedtransform : flash.geom:Transform
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
DisplayObject
  tweeningProperties : Array
当前在此对象上进行补间的属性数组。
UITextField
 Inheritedtype : String
文本字段的类型。
TextField
  updateCompletePendingFlag : Boolean
一个标志,确定对象是否已通过三个阶段的布局验证(假定需要完成所有阶段)。
UITextField
 InheriteduseRichTextClipboard : Boolean
指定在复制和粘贴文本时是否同时复制和粘贴其格式。
TextField
 Inheritedvisible : Boolean
显示对象是否可见。
DisplayObject
 Inheritedwidth : Number
表示显示对象的宽度,以像素为单位。
DisplayObject
 InheritedwordWrap : Boolean
一个布尔值,表示文本字段是否自动换行。
TextField
 Inheritedx : Number
表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。
DisplayObject
 Inheritedy : Number
表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。
DisplayObject
 Inheritedz : Number
表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。
DisplayObject
公共方法
 方法由以下参数定义
  
构造函数。
UITextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
将 newText 参数指定的字符串追加到文本字段的文本的末尾。
TextField
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
DisplayObject
 Inherited
返回一个矩形,该矩形是字符的边框。
TextField
 Inherited
在 x 和 y 参数指定的位置返回从零开始的字符索引值。
TextField
  
确定是使用显式高度还是测量高度的一种简便方法
UITextField
  
确定是使用显式宽度还是测量宽度的一种简便方法
UITextField
 Inherited
如果给定一个字符索引,则返回同一段落中第一个字符的索引。
TextField
 Inherited
返回给定 id 或已使用 <img> 标签添加到 HTML 格式文本字段中的图像或 SWF 文件的 DisplayObject 引用。
TextField
 Inherited
在 x 和 y 参数指定的位置返回从零开始的行索引值。
TextField
 Inherited
返回 charIndex 参数指定的字符所在的行的索引值(从零开始)。
TextField
 Inherited
getLineLength(lineIndex:int):int
返回特定文本行中的字符数。
TextField
 Inherited
返回给定文本行的度量信息。
TextField
 Inherited
getLineOffset(lineIndex:int):int
返回 lineIndex 参数指定的行中第一个字符的字符索引。
TextField
 Inherited
返回 lineIndex 参数指定的行的文本。
TextField
 Inherited
如果给定一个字符索引,则返回包含给定字符的段落的长度。
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。
DisplayObject
  
getStyle(styleProp:String):*
获取已在此组件的样式查找链中的某个位置设置过的样式属性。
UITextField
 Inherited
getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
返回 TextFormat 对象,其中包含 beginIndex 和 endIndex 参数指定的文本范围的格式信息。
TextField
  
返回给出此 UITextField 对象的字符格式设置信息的 TextFormat 对象。
UITextField
  
返回包含此组件的格式设置信息的 UITextFormat 对象。
UITextField
 Inherited
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。
DisplayObject
 Inherited
将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。
DisplayObject
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
计算显示对象的边框,以确定它是否与 obj 显示对象的边框重叠或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。
DisplayObject
  
初始化此组件。
UITextField
  
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。
UITextField
  
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。
UITextField
  
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。
UITextField
 Inherited
isFontCompatible(fontName:String, fontStyle:String):Boolean
[静态] 如果具有指定的 fontName 和 fontStyle(其中的 Font.fontType 为 flash.text.FontType.EMBEDDED)的嵌入字体可用,则将返回 true。
TextField
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。
DisplayObject
 Inherited
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。
DisplayObject
  
将组件移动到其父项内的指定位置。
UITextField
  
如果该子项是此对象的子项或者属于该对象,则返回 true。
UITextField
  
为 UITextField 对象分配父项时调用此函数。
UITextField
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
使用 value 参数的内容替换当前所选内容。
TextField
 Inherited
replaceText(beginIndex:int, endIndex:int, newText:String):void
将 beginIndex 和 endIndex 参数指定的字符范围替换为 newText 参数的内容。
TextField
  
重放指定的事件。
UITextField
 Inherited
显示虚拟键盘。
InteractiveObject
  
调整对象大小。
UITextField
  
设置文本的字体颜色。
UITextField
  
设置此组件的焦点。
UITextField
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
setSelection(beginIndex:int, endIndex:int):void
将第一个字符和最后一个字符的索引值(使用 beginIndex 和 endIndex 参数指定)指定的文本设置为所选内容。
TextField
  
setStyle(styleProp:String, value:*):void
不执行任何操作。
UITextField
 Inherited
setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
将 format 参数指定的文本格式应用于文本字段中的指定文本。
TextField
  
setVisible(visible:Boolean, noEvent:Boolean = false):void
设置此 UITextField 对象的 visible 属性。
UITextField
  
检测对样式属性的更改。
UITextField
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
[覆盖] 返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。
FlexTextField
  
truncateToFit(truncationIndicator:String = null):Boolean
截断文本使其在水平方向适合为控件定义的区域,并向文本追加省略号 (...)。
UITextField
  
验证并更新此对象的属性和布局,如果需要的话重绘对象。
UITextField
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 由以下参数定义
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited将显示对象添加到显示列表中时调度。DisplayObject
 Inherited在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。DisplayObject
 Inherited在修改控件值后调度,这与 textInput 事件不同,后者是在修改值之前调度的。TextField
 Inherited当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。InteractiveObject
 Inherited用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。InteractiveObject
 Inherited
    contextMenu
当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。InteractiveObject
 Inherited在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。InteractiveObject
 Inherited在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。InteractiveObject
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。InteractiveObject
 Inherited[播放事件] 播放头进入新帧时调度。DisplayObject
 Inherited[广播事件] 播放头退出当前帧时调度。DisplayObject
 Inherited显示对象获得焦点后调度。InteractiveObject
 Inherited显示对象失去焦点后调度。InteractiveObject
 Inherited[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。DisplayObject
 Inherited当用户使用 InteractiveObject 实例沿触摸面边缘创建接触点时调度(如在 Siri Remote for Apple TV 上沿触摸面边缘轻击)。有些设备也可能将这种接触解释为多个触摸事件的组合。InteractiveObject
 Inherited当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时(例如,在配有触摸屏的移动电话或平板电脑上的显示对象上按下和释放两个手指)调度。InteractiveObject
 Inherited当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上的显示对象上从左向右移动手指)调度。InteractiveObject
 Inherited当用户在接触点处使用 InteractiveObject 实例执行旋转手势时(例如,将两个手指放在屏幕上,然后在配有触摸屏的移动电话或平板电脑上的显示对象上旋转这两个手指)调度。InteractiveObject
 Inherited当用户在接触点处使用 InteractiveObject 实例执行滑动手势(例如,在配有触摸屏的移动电话或平板电脑上用三根手指触摸屏幕,然后在一个显示对象上平行移动这三根手指)时调度。InteractiveObject
 Inherited当用户使用 InteractiveObject 实例创建接触点,然后点击启用触屏的设备时(例如,将几个手指放在显示对象上以打开菜单,然后点击一个手指在配有触摸屏的移动电话或平板电脑上选择一个菜单项)调度。InteractiveObject
 Inherited当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时(例如,将两个手指放在屏幕上,然后在配有触摸屏的移动电话或平板电脑上的显示对象上快速分开手指)调度。InteractiveObject
 Inherited此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序InteractiveObject
 Inherited用户按下某个键时调度。InteractiveObject
 Inherited用户尝试使用键盘导航更改焦点时调度。InteractiveObject
 Inherited用户释放某个键时调度。InteractiveObject
 Inherited当用户单击支持 HTML 的文本字段中的超链接(其中的 URL 以“event:”开头)时调度。TextField
 Inherited当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited用户尝试使用指针设备更改焦点时调度。InteractiveObject
 Inherited用户移动 InteractiveObject 上的指针设备时调度。InteractiveObject
 Inherited用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited当鼠标滚轮滚动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited当用户释放拖动手势时由拖动启动器 InteractiveObject 调度。InteractiveObject
 Inherited在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。InteractiveObject
 Inherited当拖动手势进入其边界时由 InteractiveObject 调度。InteractiveObject
 Inherited当拖动手势离开其边界时由 InteractiveObject 调度。InteractiveObject
 Inherited当拖动手势保持在其边界内时,由 InteractiveObject 持续调度。InteractiveObject
 Inherited在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。InteractiveObject
 Inherited在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。InteractiveObject
 Inherited在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。InteractiveObject
 Inherited当用户将活动笔针放低经过屏幕的邻近检测阈值上时调度。InteractiveObject
 Inherited
    proximityEnd
当用户将活动笔针抬高放在屏幕的邻近检测阈值上时调度。InteractiveObject
 Inherited当用户将活动笔针移动到屏幕上但仍保留在邻近检测阈值中时调度。InteractiveObject
 Inherited
    proximityOut
当用户直接将活动笔针从此 InteractiveObject 上移开但仍保留在屏幕的邻近检测阈值中时调度。InteractiveObject
 Inherited当用户直接将活动笔针移动到此 InteractiveObject 上但仍保留在屏幕的邻近检测阈值中时调度。InteractiveObject
 Inherited当用户从此 InteractiveObject 及其任一子项中移开而仍保留在屏幕的邻近检测阈值中时调度。InteractiveObject
 Inherited当用户将活动笔针从显示列表中子项的对象树中滑过此 InteractiveObject 时(而仍保留在屏幕的邻近检测阈值中)时调度。InteractiveObject
 Inherited在用户首先在 InteractiveObject 实例上按下按钮,然后将指针设备移离 InteractiveObject 实例,释放指针设备上的按钮时调度。InteractiveObject
 Inherited将要从显示列表中删除显示对象时调度。DisplayObject
 Inherited在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。DisplayObject
 Inherited[广播事件] 将要更新和呈现显示列表时调度。DisplayObject
 Inherited当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited用户滚动后由 TextField 对象调度。TextField
 Inherited在用户为全选操作激活特定于平台的加速键组合或从文本上下文菜单中选择“全选”时调度。InteractiveObject
 Inherited在放开软键盘之后立即调度。InteractiveObject
 Inherited在放开软键盘之前立即调度。InteractiveObject
 Inherited在隐藏软键盘之后立即调度。InteractiveObject
 Inherited对象的 tabChildren 标志值发生更改时调度。InteractiveObject
 Inherited对象的 tabEnabled 标志发生更改时调度。InteractiveObject
 Inherited对象的 tabIndex 属性值发生更改时调度。InteractiveObject
 Inherited用户输入一个或多个文本字符时,Flash Player 将调度 textInput 事件。TextField
 Inherited当用户更改文本字段交互模式时,Flash Player 会调度 textInteractionModeChange 事件。TextField
 Inherited当用户第一次触摸启用触摸的设备时(例如,用手指触摸配有触摸屏的移动电话或平板)调度。InteractiveObject
 Inherited当用户移除与启用触摸的设备的接触时(例如,将手指从配有触摸屏的移动电话或平板电脑上抬起)调度。InteractiveObject
 Inherited当用户触碰设备时进行调度,而且会连续调度,直到接触点被删除。InteractiveObject
 Inherited当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从一个显示对象拖到另一个显示对象)调度。InteractiveObject
 Inherited当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从显示对象外的一点拖动到显示对象上的一点)调度。InteractiveObject
 Inherited当用户移动接触点,使其远离启用触摸的设备上的 InteractiveObject 实例时(例如,在配有触摸屏的移动电话或平板电脑上将一个手指从显示对象上的一点移动到显示对象外的一点)调度。InteractiveObject
 Inherited当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从显示对象外的一点拖动到显示对象上的一点)调度。InteractiveObject
 Inherited当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时(例如,在配有触摸屏的移动电话或平板的显示对象上的某一点处按下并释放手指)调度。InteractiveObject
样式

样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。

常见样式
 样式 说明 由以下参数定义
  
color
类型: uint 格式: Color CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

组件中文本(包括组件标签)的颜色。Halo 主题的默认值为 0x0B333C。Spark 主题的默认值为 0x000000
UITextField
  
disabledColor
类型: uint 格式: Color CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

禁用时组件中文本的颜色。 默认值为 0xAAB3B3
UITextField
  
fontAntiAliasType
类型: String CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash.text.AntiAliasType.NORMAL) 和 "advanced" (flash.text.AntiAliasType.ADVANCED)。

默认值为 "advanced",该值将启用字体的高级消除锯齿功能。设置为 "normal" 可禁用高级消除锯齿功能。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不能将其应用于部分字符。

默认值为 "advanced"

相关 API 元素

UITextField
  
fontFamily
类型: String CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。Halo 主题的默认字体为 "Verdana"。Spark 主题的默认字体为 "Arial"
UITextField
  
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)。

仅当使用嵌入字体并将 fontAntiAliasType 属性设置为 "advanced" 时,才应用此属性。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

默认值为 "pixel"

相关 API 元素

UITextField
  
fontSharpness
类型: Number CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。

仅当使用嵌入字体并将 fontAntiAliasType 属性设置为 "advanced" 时,才应用此属性。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

默认值为 0

相关 API 元素

UITextField
  
fontSize
类型: Number 格式: Length CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

文本的高度,以像素为单位。在 Halo 主题中,除 ColorPicker 控件外,所有其它控件的默认值均为 10。对于 Halo 主题的 ColorPicker 控件,默认值为 11。在 Spark 主题中,除 ColorPicker 控件外,所有其它控件的默认值均为 12。对于 Spark 主题的 ColorPicker 控件,默认值为 11。
UITextField
  
fontStyle
类型: String CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

确定文本是否使用斜体。可识别的值为 "normal""italic"。 默认值为 "normal"
UITextField
  
fontThickness
类型: Number CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。

仅当使用嵌入字体并将 fontAntiAliasType 属性设置为 "advanced" 时,才应用此属性。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

默认值为 0

相关 API 元素

UITextField
  
fontWeight
类型: String CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

确定文本是否使用粗体。可识别的值为 normalbold。Button 控件的默认值为 bold。所有其它控件的默认值为 normal
UITextField
  
kerning
类型: Boolean CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

一个布尔值,表示是启用 (true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。 默认值为 false
UITextField
  
leading
类型: Number 格式: Length CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

文本行之间附加的垂直空间。

默认值为 2。

ComboBox 控件的默认值为 0。

UITextField
  
letterSpacing
类型: Number CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。 默认值为 0
UITextField
  
locale
类型: String CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 4  运行时版本: Flash10, AIR 1.5

此组件显示的文本的区域设置。

FTE 和 TLF 使用此区域设置将 Unicode 字符映射到字体字型并查找后备字体。

注意:仅当 MX 组件将 UIFTETextField 指定为其 textFieldClass 时此样式才适用。

默认值为 "en"
UITextField
  
paddingLeft
类型: Number 格式: Length CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

组件左边框与其内容区域左边缘之间的像素数目。

默认值为 0。

在 Halo 主题中,Button 控件的默认值为 10,在 Spark 主题中,其默认值为 6。

ComboBox 控件的默认值为 5。

Form 容器的默认值为 16。

Tree 控件的默认值为 2。

UITextField
  
paddingRight
类型: Number 格式: Length CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

组件右边框与其内容区域右边缘之间的像素数目。

默认值为 0。

在 Halo 主题中,Button 控件的默认值为 10,在 Spark 主题中,其默认值为 6。

ComboBox 控件的默认值为 5。

Form 容器的默认值为 16。

UITextField
  
textAlign
类型: String CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

容器内文本的对齐方式。可能值有:"left""right""center"

大多数组件的默认值为 "left"。对于 FormItem 组件,默认值为 "right"。对于 Button、LinkButton 和 AccordionHeader 组件,默认值为 "center",且仅当将 labelPlacement 属性设置为 "left""right" 时,才能识别此属性。如果将 labelPlacement 设置为 "top""bottom",将居中文本及所有图标。

UITextField
  
textDecoration
类型: String CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

确定文本是否加下划线。可能值有:"none""underline"。 默认值为 "none"
UITextField
  
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
UITextField
  
textIndent
类型: Number 格式: Length CSS 继承:
语言版本: ActionScript 3.0  产品版本: Flex 3  运行时版本: Flash9, AIR 1.1

文本第一行偏离容器左侧的距离(以像素为单位)。 默认值为 0
UITextField
属性详细信息

automationDelegate

属性
automationDelegate:Object

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

正在处理相关自动化功能的委托对象。



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

automationEnabled

属性 
automationEnabled:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 9, AIR 1.1

如果此组件启用了自动化,则为 true;否则为 false。



实现
    public function get automationEnabled():Boolean

automationName

属性 
automationName:String

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

可用作此对象的标识符的名称。



实现
    public function get automationName():String
    public function set automationName(value:String):void

automationOwner

属性 
automationOwner:DisplayObjectContainer  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 9, AIR 1.1

用于自动化目的的此组件的所有者。



实现
    public function get automationOwner():DisplayObjectContainer

automationParent

属性 
automationParent:DisplayObjectContainer  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 9, AIR 1.1

用于自动化目的的此组件的父级。



实现
    public function get automationParent():DisplayObjectContainer

automationValue

属性 
automationValue:Array  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

此值通常对应于对象的经呈示的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。



实现
    public function get automationValue():Array

automationVisible

属性 
automationVisible:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 9, AIR 1.1

如果此组件对于自动化是可见的,则为 true;否则为 false。



实现
    public function get automationVisible():Boolean

baselinePosition

属性 
baselinePosition:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

首行文本基线的 y 坐标。



实现
    public function get baselinePosition():Number

className

属性 
className:String  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

此实例的类的名称,如 "DataGridItemRenderer"

此字符串不包括包名称。如果您还需要包名称,请调用 flash.utils 包中的 getQualifiedClassName() 方法。将返回一个字符串,如 "mx.controls.dataGridClasses::DataGridItemRenderer"



实现
    public function get className():String

document

属性 
document:Object

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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



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

enabled

属性 
enabled:Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

一个指示是否启用组件的布尔值。此属性只影响文本的颜色,而不影响 UITextField 的可编辑性。要控制可编辑性,请使用 flash.text.TextField.type 属性。

默认值为 true。



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

相关 API 元素

enableIME

属性 
enableIME:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

一个标志,用于指示当组件获得焦点时是否应启用 IME。



实现
    public function get enableIME():Boolean

explicitHeight

属性 
explicitHeight:Number

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于该值是组件坐标值,因此针对其父项的真正 explicitHeightscaleY 属性影响。

设置 height 属性,同时也会将此属性设置为指定的高度值。



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

explicitMaxHeight

属性 
explicitMaxHeight:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

采用组件坐标指定组件最大高度(以像素为单位)的数字(如果设置了 maxHeight 属性)。由于 maxHeight 为只读,因此此方法返回 NaN。必须覆盖此方法并添加 setter 才能使用此属性。

默认值为 NaN。



实现
    public function get explicitMaxHeight():Number

相关 API 元素

explicitMaxWidth

属性 
explicitMaxWidth:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

采用组件坐标指定组件最大宽度(以像素为单位)的数字(如果设置了 maxWidth 属性)。由于 maxWidth 为只读,因此此方法返回 NaN。必须覆盖此方法并添加 setter 才能使用此属性。

默认值为 NaN。



实现
    public function get explicitMaxWidth():Number

相关 API 元素

explicitMinHeight

属性 
explicitMinHeight:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最小建议高度。此值采用组件坐标(以像素为单位)。

应用程序开发人员一般不设置 explicitMinHeight 属性。而是设置 minHeight 属性的值,该值设置 explicitMinHeight 属性。不会更改 minHeight 的值。

在布局过程中,如果应用程序开发人员明确设置了 minHeight,则使用 explicitMinHeight 的值。否则,使用 measuredMinHeight 的值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 minHeightscaleY 属性影响。



实现
    public function get explicitMinHeight():Number

explicitMinWidth

属性 
explicitMinWidth:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最小建议宽度。此值采用组件坐标(以像素为单位)。

应用程序开发人员一般不设置 explicitMinWidth 属性。而是设置 minWidth 属性的值,该值设置 explicitMinWidth 属性。不会更改 minWidth 的值。

在布局过程中,如果应用程序开发人员明确设置了 minWidth,则使用 explicitMinWidth 的值。否则,使用 measuredMinWidth 的值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 minWidthscaleX 属性影响。



实现
    public function get explicitMinWidth():Number

explicitWidth

属性 
explicitWidth:Number

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于该值是组件坐标值,因此针对其父项的真正 explicitWidthscaleX 属性影响。

设置 width 属性,同时也会将此属性设置为指定的宽度值。



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

focusPane

属性 
focusPane:Sprite

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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



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

ignorePadding

属性 
ignorePadding:Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

如果为 truepaddingLeftpaddingRight 样式不会在组件文本周围添加空间。

默认值为 true。



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

imeMode

属性 
imeMode:String

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

指定 IME(输入法编辑器)模式。IME 使用户能够用中文、日文和韩文输入文本。当控件获得焦点时,Flex 设置指定的 IME 模式;当该控件失去焦点时,则将其设置回为先前的值。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。

默认值为 null。



实现
    public function get imeMode():String
    public function set imeMode(value:String):void

相关 API 元素

includeInLayout

属性 
includeInLayout:Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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



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

inheritingStyles

属性 
inheritingStyles:Object

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

此 UITextField 继承样式链的起始位置。getStyle() 方法访问 inheritingStyles[styleName] 以搜索整个原型链接的链。此对象由 initProtoChain() 方法设置。通常情况下,您不需要直接访问此属性。



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

initialized

属性 
initialized:Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

一个标志,确定对象是否已通过三个阶段的布局验证(假定需要完成所有阶段)。



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

isPopUp

属性 
isPopUp:Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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



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

maxHeight

属性 
maxHeight:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最大建议高度。此值采用组件坐标(以像素为单位)。此属性的默认值由组件开发人员设置。

组件开发人员使用此属性设置组件高度的上限。

如果应用程序开发人员覆盖 maxHeight 的默认值,则将在 explicitMaxHeight 中存储新值。不会更改 maxHeight 的默认值。因此,在布局过程中,如果应用程序开发人员明确设置了 maxHeight,则对组件最大建议高度使用 explicitMaxHeight 的值。如果用户未明确设置 maxHeight,则使用默认值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 maxHeightscaleY 属性影响。有些组件从理论上没有高度限制。在这些情况下,可将其 maxHeight 设置为 UIComponent.DEFAULT_MAX_HEIGHT



实现
    public function get maxHeight():Number

maxWidth

属性 
maxWidth:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最大建议宽度。此值采用组件坐标(以像素为单位)。此属性的默认值由组件开发人员设置。

组件开发人员使用此属性设置组件宽度的上限。

如果应用程序开发人员覆盖 maxWidth 的默认值,则将在 explicitMaxWidth 中存储新值。不会更改 maxWidth 的默认值。因此,在布局过程中,如果应用程序开发人员明确设置了 maxWidth,则对组件最大建议宽度使用 explicitMaxWidth 的值。如果用户未明确设置 maxWidth,则使用默认值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 maxWidthscaleX 属性影响。有些组件从理论上没有宽度限制。在这些情况下,可将其 maxWidth 设置为 UIComponent.DEFAULT_MAX_WIDTH



实现
    public function get maxWidth():Number

measuredHeight

属性 
measuredHeight:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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



实现
    public function get measuredHeight():Number

measuredMinHeight

属性 
measuredMinHeight:Number

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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



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

measuredMinWidth

属性 
measuredMinWidth:Number

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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



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

measuredWidth

属性 
measuredWidth:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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



实现
    public function get measuredWidth():Number

minHeight

属性 
minHeight:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最小建议高度。此值采用组件坐标(以像素为单位)。默认值取决于组件的实现方式。

如果应用程序开发人员设置 minHeight 的值,则将在 explicitMinHeight 中存储新值。不会更改 minHeight 的默认值。因此,在布局过程中,如果应用程序开发人员明确设置了 minHeight,则对组件最小建议高度使用 explicitMinHeight 的值。如果应用程序开发人员未明确设置 minHeight,则使用 measuredMinHeight 的值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 minHeightscaleY 属性影响。



实现
    public function get minHeight():Number

minWidth

属性 
minWidth:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最小建议宽度。此值采用组件坐标(以像素为单位)。默认值取决于组件的实现方式。

如果应用程序开发人员设置 minWidth 的值,则将在 explicitMinWidth 中存储新值。不会更改 minWidth 的默认值。因此,在布局过程中,如果应用程序开发人员明确设置了 minWidth,则对组件最小建议宽度使用 explicitMinWidth 的值。如果应用程序开发人员未明确设置 minWidth,则使用 measuredMinWidth 的值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此,如果父项为 Container,则此属性可能不会产生任何效果,要么就是容器在此属性中不起作用。由于此值位于组件坐标中,因此与其父项相关的真正 minWidthscaleX 属性影响。



实现
    public function get minWidth():Number

moduleFactory

属性 
moduleFactory:IFlexModuleFactory

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。这是嵌入字体起作用而必需的项目。



实现
    public function get moduleFactory():IFlexModuleFactory
    public function set moduleFactory(value:IFlexModuleFactory):void

nestLevel

属性 
nestLevel:int

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

此对象在所属关系层次结构中的深度。测量和布局代码都使用此编号。如果 DisplayList 中没有此组件,则值为 0。



实现
    public function get nestLevel():int
    public function set nestLevel(value:int):void

nonInheritingStyles

属性 
nonInheritingStyles:Object

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

此 UITextField 非继承样式链的起始位置。getStyle() 方法访问 nonInheritingStyles[styleName] 方法以搜索整个原型链接的链。此对象由 initProtoChain() 方法设置。通常情况下,您不需要直接访问此属性。



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

nonZeroTextHeight

属性 
nonZeroTextHeight:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

与 textHeight 不同,此方法将返回一个非零值,即使文本为空。在这种情况下,它返回文本不为空的情况下 textHeight 的值。



实现
    public function get nonZeroTextHeight():Number

owner

属性 
owner:DisplayObjectContainer

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

默认情况下,设置为此对象的父容器。但是,如果此对象是由其父项弹出的子组件(如 ComboBox 控件的下拉列表),则所有者是弹出该对象的组件。

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

默认值为 parent 属性的值。



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

parent

属性 
parent:DisplayObjectContainer  [只读] [覆盖]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

此组件的父容器或组件。



实现
    override public function get parent():DisplayObjectContainer

percentHeight

属性 
percentHeight:Number

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

以组件父代大小百分比的方式指定组件高度。允许的值为 0-100。默认值为 NaN。设置 heightexplicitHeight 属性会将此属性重置为 NaN。

仅当先前已设置此属性时,此属性才会返回数值;它不会以百分比形式反映组件的确切大小。

对于 UITextField 控件,此属性始终设置为 NaN。

在 Spark 布局中使用时,该属性用于计算组件在缩放和旋转之后的边界高度。例如,如果组件旋转 90 度,则指定 percentHeight 将影响组件宽度。



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

percentWidth

属性 
percentWidth:Number

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

以组件父代大小百分比的方式指定组件宽度。允许的值为 0-100。默认值为 NaN。设置 widthexplicitWidth 属性会将此属性重置为 NaN。

仅当先前已设置此属性时,此属性才会返回数值;它不会以百分比形式反映组件的确切大小。

对于 UITextField 控件,此属性始终设置为 NaN。

在 Spark 布局中使用时,该属性用于计算组件在缩放和旋转之后的边界宽度。例如,如果组件旋转 90 度,则指定 percentWidth 将影响组件高度。



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

processedDescriptors

属性 
processedDescriptors:Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

createChildren() 方法创建任意内部组件子项后设置为 true



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

styleName

属性 
styleName:Object

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

此组件使用的类样式。它可以是 String、CSSStyleDeclaration 或 IStyleClient。

如果是 String,则它是 <fx:Style> 标签或 CSS 文件中一个或多个空格分隔类声明的名称。您不能在 styleName 中使用句号。例如,如果您使用名为 ".bigText" 的类样式,请将 styleName 属性设置为 "bigText"(无句号)。

如果是 IStyleClient(通常是 UIComponent),则此组件将使用 styleName 对象中的所有样式。



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

systemManager

属性 
systemManager:ISystemManager

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

返回此组件使用的 SystemManager 对象。



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

toolTip

属性 
toolTip:String

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

要在 ToolTip 中显示的文本。



实现
    public function get toolTip():String
    public function set toolTip(value:String):void

tweeningProperties

属性 
tweeningProperties:Array

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

当前在此对象上进行补间的属性数组。

用于警告 EffectManager 此对象的某些属性正在进行补间,因此 EffectManger 不能尝试对相同属性设置动画效果。



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

updateCompletePendingFlag

属性 
updateCompletePendingFlag:Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

一个标志,确定对象是否已通过三个阶段的布局验证(假定需要完成所有阶段)。



实现
    public function get updateCompletePendingFlag():Boolean
    public function set updateCompletePendingFlag(value:Boolean):void
构造函数详细信息

UITextField

()构造函数
public function UITextField()

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

构造函数。

方法详细信息

getExplicitOrMeasuredHeight

()方法
public function getExplicitOrMeasuredHeight():Number

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

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

getExplicitOrMeasuredWidth

()方法 
public function getExplicitOrMeasuredWidth():Number

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

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

getStyle

()方法 
public function getStyle(styleProp:String):*

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

获取已在此组件的样式查找链中的某个位置设置过的样式属性。

因为此方法同样可用于获取任何类型的样式属性,所以返回值可能是 Boolean、String、Number、int、uint(用于 RGB 颜色)、Class(用于外观)或任何类型的对象。因此,只需将返回类型指定为 *。

如果要获取特定的样式属性,您需要了解其类型,而且通常希望将结果存储在该类型的某个变量中。无需将 * 转换为该类型。

var backgroundColor:uint = getStyle("backgroundColor");

如果在样式查找链中的任何位置都未设置样式属性,则 getStyle() 的返回值为 undefined。请注意,undefined 是一个特殊值,它与 false""NaN0null 均不同。如果没有有效的样式值,则总是 undefined。可以使用方法 IStyleManager2.isValidStyleValue() 来测试是否设置了值。

参数

styleProp:String — 样式属性的名称。

返回
* — 样式值。

getTextStyles

()方法 
public function getTextStyles():flash.text:TextFormat

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

返回给出此 UITextField 对象的字符格式设置信息的 TextFormat 对象。

返回
flash.text:TextFormat — TextFormat 对象。

相关 API 元素

getUITextFormat

()方法 
public function getUITextFormat():mx.core:UITextFormat

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

返回包含此组件的格式设置信息的 UITextFormat 对象。此方法与 flash.text.TextField 类的 getTextFormat() 方法类似,但它返回 UITextFormat 对象而不是 TextFormat 对象。

UITextFormat 类扩展 TextFormat 类以添加文本测量方法 measureText()measureHTMLText()

返回
mx.core:UITextFormat — 包含此组件格式设置信息的对象。

相关 API 元素

initialize

()方法 
public function initialize():void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

初始化此组件。

IUIComponent 接口要求使用此方法,但实际上,它不会对 UITextField 执行任何操作。

invalidateDisplayList

()方法 
public function invalidateDisplayList():void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。

Invalidation 是一个很有用的机制,可将组件更改延迟到稍后屏幕更新时进行处理,从而消除了重复的工作。例如,要更改宽度和高度,如果在更改宽度后立即更新组件,然后在设置新高度后再次更新组件,就有些浪费。更改两个属性后再使用新的大小一次性呈示组件,效率会更高。

很少调用 Invalidation 方法。通常,在组件上设置属性会自动调用合适的 invalidation 方法。

invalidateProperties

()方法 
public function invalidateProperties():void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。

Invalidation 是一个很有用的机制,可将组件更改延迟到稍后屏幕更新时进行处理,从而消除了重复的工作。例如,要更改文本颜色和大小,如果在更改颜色后立即进行更新,然后在设置大小后再更新大小,就有些浪费。同时更改两个属性后再使用新的大小和颜色一次性呈示文本,效率会更高。

很少调用 Invalidation 方法。通常,在组件上设置属性会自动调用合适的 invalidation 方法。

invalidateSize

()方法 
public function invalidateSize():void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。

Invalidation 是一个很有用的机制,可将组件更改延迟到稍后屏幕更新时进行处理,从而消除了重复的工作。例如,要更改文本和字体大小,如果在更改文本后立即进行更新,然后在设置大小后再更新大小,就有些浪费。更改两个属性后再使用新的大小一次性呈示文本,效率会更高。

很少调用 Invalidation 方法。通常,在组件上设置属性会自动调用合适的 invalidation 方法。

move

()方法 
public function move(x:Number, y:Number):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

将组件移动到其父项内的指定位置。调用此方法的效果与设置组件的 xy 属性完全相同。

如果您正在覆盖自定义组件中的 updateDisplayList() 方法,则应调用 move() 方法,而不是设置 xy 属性。二者的区别在于:调用 move() 方法可更改组件的位置,并在调用此方法时调度 move 事件;而设置 xy 属性也会更改组件的位置,但要在下次刷新屏幕时才调度此事件。

参数

x:Number — 组件在其父项内的左侧位置。
 
y:Number — 组件在其父项内的顶部位置。

owns

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

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

如果该子项是此对象的子项或者属于该对象,则返回 true

参数

child:DisplayObject — 子 DisplayObject。

返回
Boolean — 如果该子项是 UITextField 对象的子项或者属于该对象,则返回 true

相关 API 元素

parentChanged

()方法 
public function parentChanged(p:DisplayObjectContainer):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

为 UITextField 对象分配父项时调用此函数。您通常无需调用此方法。

参数

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

replayAutomatableEvent

()方法 
public function replayAutomatableEvent(event:Event):Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

重放指定的事件。如果已在 superclass 中定义默认重放行为,组件作者可能应调用 super.replayAutomatableEvent。

参数

event:Event — 要重放的事件。

返回
Boolean — 如果重放成功,则为 true

setActualSize

()方法 
public function setActualSize(w:Number, h:Number):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

调整对象大小。调用 setActualSize() 方法并不设置 explictWidthexplicitHeight 属性,因此,将来进行布局计算时可能会导致对象还原为先前的大小。这一点与直接设置 widthheight 属性不同。此方法主要适用于实现 updateDisplayList() 方法的组件开发人员、Effects 以及 LayoutManager。

参数

w:Number — 对象的宽度。
 
h:Number — 对象的高度。

setColor

()方法 
public function setColor(color:uint):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

设置文本的字体颜色。

参数

color:uint — 新的字体颜色。

setFocus

()方法 
public function setFocus():void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

设置此组件的焦点。组件可能依次将焦点传递给子组件。

注意:使用此方法设置焦点时,只有 TextInput 和 TextArea 控件加亮显示。当用户按 Tab 键切换控件时,所有控件都加亮显示。

setStyle

()方法 
public function setStyle(styleProp:String, value:*):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

不执行任何操作。UITextField 不能包含嵌入式样式。

参数

styleProp:String — 样式属性的名称。
 
value:* — 样式的新值。

setVisible

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

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

设置 UITextField 对象的 visible 属性。

参数

visible:Boolean — 将其设置为 true 可使此 UITextField 可见;将其设置为 false 可使它不可见。
 
noEvent:Boolean (default = false) — 将其设置为 true 可禁止当您更改可见性时生成事件。

styleChanged

()方法 
public function styleChanged(styleProp:String):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

检测对样式属性的更改。设置任何样式属性后,Flex 将调用 styleChanged() 方法,向其传递所设置样式的名称。

此方法是一种高级方法,可在创建 UIComponent 的子类时覆盖。创建自定义组件时,可以覆盖 styleChanged() 方法,以检查传递给它的样式名称,并对更改进行相应处理。这允许您覆盖现有样式的默认行为或添加自己的自定义样式属性。

如果您处理样式属性,覆盖 styleChanged() 方法时应调用 invalidateDisplayList() 方法,以使 Flex 在下次更新屏幕时执行组件的 updateDisplayList() 方法。

参数

styleProp:String — 样式属性的名称;如果此组件的所有样式均已更改,则为 null。

truncateToFit

()方法 
public function truncateToFit(truncationIndicator:String = null):Boolean

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

截断文本使其在水平方向适合为控件定义的区域,并向文本追加省略号 (...)。

参数

truncationIndicator:String (default = null) — 截断后追加的文本。如果传递 null,将使用可本地化的字符串,如 "..."

返回
Boolean — 如果此文本需要截断,则返回 true

validateNow

()方法 
public function validateNow():void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

验证并更新此对象的属性和布局,如果需要的话重绘对象。通常只有当脚本执行完毕后,才会处理要求进行大量计算的处理属性。例如,对 width 属性的设置可能会延迟,因为此设置需要重新计算这些对象的子项或父项的宽度。如果脚本多次设置了 width 属性,则延迟处理可防止进行多次处理。此方法允许您手动覆盖此行为。





[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。