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

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

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

另请参见

flash.text.TextField
mx.core.UITextFormat


公共属性
 属性定义方
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
DisplayObject
 Inheritedalpha : Number
指示指定对象的 Alpha 透明度值。
DisplayObject
 InheritedalwaysShowSelection : Boolean
如果设置为 true 且文本字段没有焦点,Flash Player 将以灰色突出显示文本字段中的所选内容。
TextField
 InheritedantiAliasType : String
用于此文本字段的消除锯齿类型。
TextField
  automationDelegate : Object
正在处理相关自动化功能的委托对象。
UITextField
  automationName : String
可用作此对象的标识符的名称。
UITextField
  automationValue : Array
[只读 (read-only)] 此值通常对应于对象的经渲染的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。
UITextField
 InheritedautoSize : String
控制文本字段的自动大小调整和对齐。
TextField
 Inheritedbackground : Boolean
指定文本字段是否具有背景填充。
TextField
 InheritedbackgroundColor : uint
文本字段背景的颜色。
TextField
  baselinePosition : Number
[只读 (read-only)] 首行文本基线的 y 坐标。
UITextField
 InheritedblendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
DisplayObject
 InheritedblendShader : Shader
[只写] 设置用于混合前景和背景的着色器。
DisplayObject
 Inheritedborder : Boolean
指定文本字段是否具有边框。
TextField
 InheritedborderColor : uint
文本字段边框的颜色。
TextField
 InheritedbottomScrollV : int
[只读 (read-only)] 一个整数(从 1 开始的索引),指示指定文本字段中当前可以看到的最后一行。
TextField
 InheritedcacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。
DisplayObject
 InheritedcaretIndex : int
[只读 (read-only)] 插入点(尖号)位置的索引。
TextField
  className : String
[只读 (read-only)] 此实例的类的名称,如“DataGridItemRenderer”。
UITextField
 InheritedcondenseWhite : Boolean
一个布尔值,指定是否删除具有 HTML 文本的文本字段中的额外空白(空格、换行符等等)。
TextField
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcontextMenu : NativeMenu
指定与此对象相关联的上下文菜单。
InteractiveObject
 InheriteddefaultTextFormat : TextFormat
指定应用于新插入文本(例如,用户输入的文本或使用 replaceSelectedText() 方法插入的文本)的格式。
TextField
 InheriteddisplayAsPassword : Boolean
指定文本字段是否是密码文本字段。
TextField
  document : Object
对与此 UITextField 对象关联的文档对象的引用。
UITextField
 InheriteddoubleClickEnabled : Boolean
指定此对象是否接收 doubleClick 事件。
InteractiveObject
 InheritedembedFonts : Boolean
指定是否使用嵌入字体轮廓进行呈现。
TextField
  enabled : Boolean
一个指示是否启用组件的布尔值。
UITextField
  explicitHeight : Number
指定该组件在组件坐标中显式高度(以像素为单位)的数字。
UITextField
  explicitMaxHeight : Number
[只读 (read-only)] 采用组件坐标指定组件最大高度(以像素为单位)的数字(如果设置了 maxHeight 属性)。
UITextField
  explicitMaxWidth : Number
[只读 (read-only)] 采用组件坐标指定组件最大宽度(以像素为单位)的数字(如果设置了 maxWidth 属性)。
UITextField
  explicitMinHeight : Number
[只读 (read-only)] 布局过程中父级要考虑的组件最小建议高度。
UITextField
  explicitMinWidth : Number
[只读 (read-only)] 布局过程中父级要考虑的组件最小建议宽度。
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
[只读 (read-only)] 文本字段中的字符数。
TextField
 InheritedloaderInfo : LoaderInfo
[只读 (read-only)] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
DisplayObject
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
DisplayObject
 InheritedmaxChars : int
文本字段中最多可包含的字符数(即用户输入的字符数)。
TextField
  maxHeight : Number
[只读 (read-only)] 布局过程中父级要考虑的组件最大建议高度。
UITextField
 InheritedmaxScrollH : int
[只读 (read-only)] scrollH 的最大值。
TextField
 InheritedmaxScrollV : int
[只读 (read-only)] scrollV 的最大值。
TextField
  maxWidth : Number
[只读 (read-only)] 布局过程中父级要考虑的组件最大建议宽度。
UITextField
  measuredHeight : Number
[只读 (read-only)] 组件的默认高度(以像素为单位)。
UITextField
  measuredMinHeight : Number
组件的默认最小高度(以像素为单位)。
UITextField
  measuredMinWidth : Number
组件的默认最小宽度(以像素为单位)。
UITextField
  measuredWidth : Number
[只读 (read-only)] 组件的默认宽度(以像素为单位)。
UITextField
  minHeight : Number
[只读 (read-only)] 布局过程中父级要考虑的组件最小建议高度。
UITextField
  minWidth : Number
[只读 (read-only)] 布局过程中父级要考虑的组件最小建议宽度。
UITextField
  moduleFactory : IFlexModuleFactory
用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。
UITextField
 InheritedmouseEnabled : Boolean
指定此对象是否接收鼠标消息。
InteractiveObject
 InheritedmouseWheelEnabled : Boolean
一个布尔值,指示当用户单击某个文本字段并滚动鼠标滚轮时,Flash Player 是否自动滚动多行文本字段。
TextField
 InheritedmouseX : Number
[只读 (read-only)] 指示鼠标位置的 x 坐标,以像素为单位。
DisplayObject
 InheritedmouseY : Number
[只读 (read-only)] 指示鼠标位置的 y 坐标,以像素为单位。
DisplayObject
 Inheritedmultiline : Boolean
指示字段是否为多行文本字段。
TextField
 Inheritedname : String
指示 DisplayObject 的实例名称。
DisplayObject
  nestLevel : int
此对象在所属关系层次结构中的深度。
UITextField
  nonInheritingStyles : Object
此 UITextField 非继承样式链的起始位置。
UITextField
  nonZeroTextHeight : Number
[只读 (read-only)] 与 textHeight 不同,此方法将返回一个非零值,即使文本为空。
UITextField
 InheritednumLines : int
[只读 (read-only)] 定义多行文本字段中的文本行数。
TextField
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
DisplayObject
  owner : DisplayObjectContainer
默认情况下,设置为此对象的父容器。
UITextField
  parent : DisplayObjectContainer
[只读 (read-only)] 此组件的父容器或组件。
UITextField
  percentHeight : Number
以组件父项大小百分比的方式指定组件高度的数字。
UITextField
  percentWidth : Number
以组件父项大小百分比形式指定其宽度的数字。
UITextField
  processedDescriptors : Boolean
createChildren() 方法创建任意内部组件子项后设置为 true。
UITextField
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 Inheritedrestrict : String
指示用户可输入到文本字段中的字符集。
TextField
 Inheritedroot : DisplayObject
[只读 (read-only)] 对于加载的 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
[只读 (read-only)] 当前所选内容中第一个字符从零开始的字符索引值。
TextField
 InheritedselectionEndIndex : int
[只读 (read-only)] 当前所选内容中最后一个字符从零开始的字符索引值。
TextField
 Inheritedsharpness : Number
此文本字段中字型边缘的清晰度。
TextField
 Inheritedstage : Stage
[只读 (read-only)] 显示对象的舞台。
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
[只读 (read-only)] 文本的高度,以像素为单位。
TextField
 InheritedtextWidth : Number
[只读 (read-only)] 文本的宽度,以像素为单位。
TextField
 Inheritedthickness : Number
此文本字段中字型边缘的粗细。
TextField
  toolTip : String
要在 ToolTip 中显示的文本。
UITextField
 Inheritedtransform : 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):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
使用 newText 参数的内容替换 beginIndex 和 endIndex 参数指定的字符范围。
TextField
  
重放指定的事件。
UITextField
  
调整对象大小。
UITextField
  
设置文本的字体颜色。
UITextField
  
设置此组件的焦点。
UITextField
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
setSelection(beginIndex:int, endIndex:int):void
将第一个字符和最后一个字符的索引值(使用 beginIndex 和 endIndex 参数指定)指定的文本设置为所选内容。
TextField
  
setStyle(styleProp:String, value:*):void
不执行任何操作。
UITextField
 Inherited
setTextFormat(format:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
将 format 参数指定的文本格式应用于文本字段中的指定文本。
TextField
  
setVisible(visible:Boolean, noEvent:Boolean = false):void
设置此 UITextField 对象的 visible 属性。
UITextField
  
检测对样式属性的更改。
UITextField
 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当用户在 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
 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将要从显示列表中删除显示对象时调度。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对象的 tabChildren 标志值发生更改时调度。InteractiveObject
 Inherited对象的 tabEnabled 标志发生更改时调度。InteractiveObject
 Inherited对象的 tabIndex 属性值发生更改时调度。InteractiveObject
 Inherited用户输入一个或多个文本字符时,Flash Player 将调度 textInput 事件。TextField
样式
 样式 说明 定义方
  
color
类型: uint 格式: Color CSS 继承: yes
组件中文本(包括组件标签)的颜色。 默认值为 0x0B333C.
UITextField
  
disabledColor
类型: uint 格式: Color CSS 继承: yes
禁用时组件中文本的颜色。 默认值为 0xAAB3B3.
UITextField
  
fontAntiAliasType
类型: String CSS 继承: yes
设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash.text.AntiAliasType.NORMAL) 和 "advanced" (flash.text.AntiAliasType.ADVANCED)。

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

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

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

默认值为 "advanced".

另请参见

UITextField
  
fontFamily
类型: String CSS 继承: yes
使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。 默认值为 "Verdana".
UITextField
  
fontGridFitType
类型: String CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash.text.GridFitType.NONE)、"pixel" (flash.text.GridFitType.PIXEL) 和"subpixel" (flash.text.GridFitType.SUBPIXEL)。

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

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

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

默认值为 "pixel".

另请参见

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

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

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

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

默认值为 0.

另请参见

UITextField
  
fontSize
类型: Number 格式: Length CSS 继承: yes
文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。
UITextField
  
fontStyle
类型: String CSS 继承: yes
确定文本是否使用斜体。可识别的值为 "normal""italic"。 默认值为 "normal".
UITextField
  
fontThickness
类型: Number CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。

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

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

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

默认值为 0.

另请参见

UITextField
  
fontWeight
类型: String CSS 继承: yes
确定文本是否使用粗体。可识别的值为 normalbold。Button 控件的默认值为 bold。所有其它控件的默认值为 normal
UITextField
  
kerning
类型: Boolean CSS 继承: yes
一个布尔值,指示是启用 (true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。 默认值为 false.
UITextField
  
leading
类型: Number 格式: Length CSS 继承: yes
文本行之间附加的垂直空间。

默认值为 2。

ComboBox 控件的默认值为 0。

UITextField
  
letterSpacing
类型: Number CSS 继承: yes
各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。 默认值为 0.
UITextField
  
paddingLeft
类型: Number 格式: Length CSS 继承: no
组件左边框与其内容区域左边缘之间的像素数目。

默认值为 0。

Button 控件的默认值为 10。

ComboBox 控件的默认值为 5。

Form 容器的默认值为 16。

Tree 控件的默认值为 2。

UITextField
  
paddingRight
类型: Number 格式: Length CSS 继承: no
组件右边框与其内容区域右边缘之间的像素数目。

默认值为 0。

Button 控件的默认值为 10。

ComboBox 控件的默认值为 5。

Form 容器的默认值为 16。

UITextField
  
textAlign
类型: String CSS 继承: yes
容器内文本的对齐情况。可能值有:"left""right""center"

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

UITextField
  
textDecoration
类型: String CSS 继承: yes
确定文本是否加下划线。可能值有:"none""underline"。 默认值为 "none".
UITextField
  
textIndent
类型: Number 格式: Length CSS 继承: yes
文本第一行偏离容器左侧的距离(以像素为单位)。 默认值为 0.
UITextField
属性详细信息
automationDelegate属性
automationDelegate:Object  [读写]

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



实现
    public function get automationDelegate():Object
    public function set automationDelegate(value:Object):void
automationName属性 
automationName:String  [读写]

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



实现
    public function get automationName():String
    public function set automationName(value:String):void
automationValue属性 
automationValue:Array  [只读 (read-only)]

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



实现
    public function get automationValue():Array
baselinePosition属性 
baselinePosition:Number  [只读 (read-only)]

首行文本基线的 y 坐标。



实现
    public function get baselinePosition():Number
className属性 
className:String  [只读 (read-only)]

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

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



实现
    public function get className():String
document属性 
document:Object  [读写]

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



实现
    public function get document():Object
    public function set document(value:Object):void
enabled属性 
enabled:Boolean  [读写]

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

默认值为 true.



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

另请参见

explicitHeight属性 
explicitHeight:Number  [读写]

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

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

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



实现
    public function get explicitHeight():Number
    public function set explicitHeight(value:Number):void
explicitMaxHeight属性 
explicitMaxHeight:Number  [只读 (read-only)]

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

默认值为 NaN.



实现
    public function get explicitMaxHeight():Number

另请参见

explicitMaxWidth属性 
explicitMaxWidth:Number  [只读 (read-only)]

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

默认值为 NaN.



实现
    public function get explicitMaxWidth():Number

另请参见

explicitMinHeight属性 
explicitMinHeight:Number  [只读 (read-only)]

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

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

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

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



实现
    public function get explicitMinHeight():Number
explicitMinWidth属性 
explicitMinWidth:Number  [只读 (read-only)]

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

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

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

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



实现
    public function get explicitMinWidth():Number
explicitWidth属性 
explicitWidth:Number  [读写]

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

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

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



实现
    public function get explicitWidth():Number
    public function set explicitWidth(value:Number):void
focusPane属性 
focusPane:Sprite  [读写]

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



实现
    public function get focusPane():Sprite
    public function set focusPane(value:Sprite):void
ignorePadding属性 
ignorePadding:Boolean  [读写]

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

默认值为 true.



实现
    public function get ignorePadding():Boolean
    public function set ignorePadding(value:Boolean):void
imeMode属性 
imeMode:String  [读写]

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

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

默认值为 null.



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

另请参见

includeInLayout属性 
includeInLayout:Boolean  [读写]

指定此组件是否包含在父容器的布局中。如果为 true,则该对象包含在其父容器的布局中。如果为 false,则由其父容器按布局规则定位该对象,但计算下一子项的位置时将忽略该对象。



实现
    public function get includeInLayout():Boolean
    public function set includeInLayout(value:Boolean):void
inheritingStyles属性 
inheritingStyles:Object  [读写]

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



实现
    public function get inheritingStyles():Object
    public function set inheritingStyles(value:Object):void
initialized属性 
initialized:Boolean  [读写]

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



实现
    public function get initialized():Boolean
    public function set initialized(value:Boolean):void
isPopUp属性 
isPopUp:Boolean  [读写]

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



实现
    public function get isPopUp():Boolean
    public function set isPopUp(value:Boolean):void
maxHeight属性 
maxHeight:Number  [只读 (read-only)]

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

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

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

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



实现
    public function get maxHeight():Number
maxWidth属性 
maxWidth:Number  [只读 (read-only)]

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

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

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

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



实现
    public function get maxWidth():Number
measuredHeight属性 
measuredHeight:Number  [只读 (read-only)]

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



实现
    public function get measuredHeight():Number
measuredMinHeight属性 
measuredMinHeight:Number  [读写]

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



实现
    public function get measuredMinHeight():Number
    public function set measuredMinHeight(value:Number):void
measuredMinWidth属性 
measuredMinWidth:Number  [读写]

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



实现
    public function get measuredMinWidth():Number
    public function set measuredMinWidth(value:Number):void
measuredWidth属性 
measuredWidth:Number  [只读 (read-only)]

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



实现
    public function get measuredWidth():Number
minHeight属性 
minHeight:Number  [只读 (read-only)]

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

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

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



实现
    public function get minHeight():Number
minWidth属性 
minWidth:Number  [只读 (read-only)]

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

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

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



实现
    public function get minWidth():Number
moduleFactory属性 
moduleFactory:IFlexModuleFactory  [读写]

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



实现
    public function get moduleFactory():IFlexModuleFactory
    public function set moduleFactory(value:IFlexModuleFactory):void
nestLevel属性 
nestLevel:int  [读写]

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



实现
    public function get nestLevel():int
    public function set nestLevel(value:int):void
nonInheritingStyles属性 
nonInheritingStyles:Object  [读写]

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



实现
    public function get nonInheritingStyles():Object
    public function set nonInheritingStyles(value:Object):void
nonZeroTextHeight属性 
nonZeroTextHeight:Number  [只读 (read-only)]

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



实现
    public function get nonZeroTextHeight():Number
owner属性 
owner:DisplayObjectContainer  [读写]

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

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

默认值为 parent 属性的值。



实现
    public function get owner():DisplayObjectContainer
    public function set owner(value:DisplayObjectContainer):void
parent属性 
parent:DisplayObjectContainer  [只读 (read-only)]

此组件的父容器或组件。



实现
    public function get parent():DisplayObjectContainer
percentHeight属性 
percentHeight:Number  [读写]

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

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

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



实现
    public function get percentHeight():Number
    public function set percentHeight(value:Number):void
percentWidth属性 
percentWidth:Number  [读写]

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

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

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



实现
    public function get percentWidth():Number
    public function set percentWidth(value:Number):void
processedDescriptors属性 
processedDescriptors:Boolean  [读写]

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



实现
    public function get processedDescriptors():Boolean
    public function set processedDescriptors(value:Boolean):void
styleName属性 
styleName:Object  [读写]

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

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

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



实现
    public function get styleName():Object
    public function set styleName(value:Object):void
systemManager属性 
systemManager:ISystemManager  [读写]

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



实现
    public function get systemManager():ISystemManager
    public function set systemManager(value:ISystemManager):void
toolTip属性 
toolTip:String  [读写]

要在 ToolTip 中显示的文本。



实现
    public function get toolTip():String
    public function set toolTip(value:String):void
tweeningProperties属性 
tweeningProperties:Array  [读写]

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

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



实现
    public function get tweeningProperties():Array
    public function set tweeningProperties(value:Array):void
updateCompletePendingFlag属性 
updateCompletePendingFlag:Boolean  [读写]

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



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

构造函数。

方法详细信息
getExplicitOrMeasuredHeight()方法
public function getExplicitOrMeasuredHeight():Number

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

返回
Number — 一个 Number,在已定义的情况下是 explicitHeight,在未定义的情况下是 measuredHeight.
getExplicitOrMeasuredWidth()方法 
public function getExplicitOrMeasuredWidth():Number

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

返回
Number — 一个 Number,在已定义的情况下是 explicitWidth,在未定义的情况下是 measuredWidth。
getStyle()方法 
public function getStyle(styleProp:String):*

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

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

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

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

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

参数

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

返回
* — 样式值。
getTextStyles()方法 
public function getTextStyles():TextFormat

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

返回
TextFormat — TextFormat 对象。

另请参见

getUITextFormat()方法 
public function getUITextFormat():UITextFormat

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

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

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

另请参见

initialize()方法 
public function initialize():void

初始化此组件。

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

invalidateDisplayList()方法 
public function invalidateDisplayList():void

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

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

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

invalidateProperties()方法 
public function invalidateProperties():void

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

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

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

invalidateSize()方法 
public function invalidateSize():void

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

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

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

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

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

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

参数

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

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

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

参数

child:DisplayObject — 子 DisplayObject。

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

另请参见

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

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

参数

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

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

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

参数

event:Event — 要重放的事件。

返回
Boolean — 如果重放成功,则为 true
setActualSize()方法 
public function setActualSize(w:Number, h:Number):void

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

参数

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

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

设置文本的字体颜色。

参数

color:uint — 新的字体颜色。

setFocus()方法 
public function setFocus():void

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

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

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

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

参数

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

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

设置 UITextField 对象的 visible 属性。

参数

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

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

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

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

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

参数

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

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

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

参数

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

返回
Boolean — 如果此文本需要截断,则返回 true
validateNow()方法 
public function validateNow():void

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