fl.controls
public class TextArea
继承TextArea Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
实现 IFocusManagerComponent

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

TextArea 组件是一个带有边框和可选滚动条的多行文本字段。 TextArea 组件支持 Adobe Flash Player 的 HTML 呈现功能。

查看示例

另请参见

TextInput



公共 属性
 属性定义方
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
DisplayObject
 Inheritedalpha : Number
指示指定对象的 Alpha 透明度值。
DisplayObject
  alwaysShowSelection : Boolean
获取或设置一个布尔值,指示当文本字段不具有焦点时 Flash Player 是否突出显示文本字段中的选定内容。
TextArea
 InheritedblendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
DisplayObject
 InheritedbuttonMode : Boolean
指定此 sprite 的按钮模式。
Sprite
 InheritedcacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 将缓存显示对象的内部位图表示形式。
DisplayObject
  condenseWhite : Boolean
获取或设置一个布尔值,该值指示是否从包含 HTML 文本的 TextArea 组件中删除额外空白。
TextArea
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcontextMenu : ContextMenu
指定与此对象相关联的上下文菜单。
InteractiveObject
  displayAsPassword : Boolean
获取或设置一个布尔值,该值指示 TextArea 组件实例是否是用于密码的文本字段。
TextArea
 InheriteddoubleClickEnabled : Boolean
指定此对象是否接收 doubleClick 事件。
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] 指定拖动 sprite 时经过的显示对象,或放置 sprite 的显示对象。
Sprite
  editable : Boolean
获取或设置一个布尔值,指示用户能否编辑组件中的文本。
TextArea
  enabled : Boolean
获取或设置一个值,该值指示组件是否可以接受用户交互。
TextArea
 Inheritedfilters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
DisplayObject
 InheritedfocusEnabled : Boolean
获取或设置一个布尔值,该值指示组件是否可以在用户单击它后获得焦点。
UIComponent
 InheritedfocusManager : IFocusManager
获取或设置为此组件及其同级组件控制焦点的 FocusManager。
UIComponent
 InheritedfocusRect : Object
指定此对象是否显示焦点矩形。
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] 指定属于此 sprite 的 Graphics 对象,在此 sprite 中可执行矢量绘画命令。
Sprite
 Inheritedheight : Number
获取或设置组件的高度,以像素为单位。
UIComponent
 InheritedhitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。
Sprite
  horizontalScrollBar : UIScrollBar
[read-only] 获取对水平滚动条的引用。
TextArea
  horizontalScrollPolicy : String
获取或设置水平滚动条的滚动策略。
TextArea
  horizontalScrollPosition : Number
获取或设置用户水平滚动文本字段后滚动条滑块位置的变化,以像素为单位。
TextArea
  htmlText : String
获取或设置文本字段所含字符串的 HTML 表示形式。
TextArea
  imeMode : String
获取或设置输入法编辑器 (IME) 的模式。
TextArea
  length : Number
[read-only] 获取 TextArea 组件所包含的字符个数。
TextArea
 InheritedloaderInfo : LoaderInfo
[read-only] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
DisplayObject
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
DisplayObject
  maxChars : int
获取或设置用户可以在文本字段中输入的最大字符数。
TextArea
  maxHorizontalScrollPosition : int
[read-only] 获取 horizontalScrollPosition 属性的最大值。
TextArea
  maxVerticalScrollPosition : int
[read-only] 获取 verticalScrollPosition 属性的最大值。
TextArea
 InheritedmouseChildren : Boolean
确定对象的子项是否支持鼠标。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
指定此对象是否接收鼠标消息。
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
获取或设置一个值,该值指示组件是否可以在用户单击它后获得焦点。
UIComponent
 InheritedmouseX : Number
[read-only] 指示鼠标位置的 x 坐标,以像素为单位。
DisplayObject
 InheritedmouseY : Number
[read-only] 指示鼠标位置的 y 坐标,以像素为单位。
DisplayObject
 Inheritedname : String
指示 DisplayObject 的实例名称。
DisplayObject
 InheritednumChildren : int
[read-only] 返回此对象的子项数目。
DisplayObjectContainer
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] 指示包含此显示对象的 DisplayObjectContainer 对象。
DisplayObject
 Inheritedprototype : Object
[static] 对类或函数对象的原型对象的引用。
Object
  restrict : String
获取或设置文本字段从用户处接受的字符串。
TextArea
 Inheritedroot : DisplayObject
[read-only] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
DisplayObject
 Inheritedrotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。
DisplayObject
 Inheritedscale9Grid : Rectangle
当前有效的缩放网格。
DisplayObject
 InheritedscaleX : Number
将组件的当前宽度与缩放系数相乘。
UIComponent
 InheritedscaleY : Number
将组件的当前高度与缩放系数相乘。
UIComponent
 InheritedscrollRect : Rectangle
显示对象的滚动矩形范围。
DisplayObject
  selectionBeginIndex : int
[read-only] 获取包含一个或多个字符的选定内容中第一个所选字符的索引位置。
TextArea
  selectionEndIndex : int
[read-only] 获取包含一个或多个字符的选定内容中最后一个所选字符的索引位置。
TextArea
 InheritedsoundTransform : SoundTransform
控制此 sprite 中的声音。
Sprite
 Inheritedstage : Stage
[read-only] 显示对象的舞台。
DisplayObject
 InheritedtabChildren : Boolean
确定对象的子项是否支持 Tab 键。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。
InteractiveObject
 InheritedtabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。
InteractiveObject
  text : String
获取或设置字符串,其中包含当前 TextInput 组件中的文本。
TextArea
  textField : TextField
对 TextArea 组件的内部文本字段的引用。
TextArea
  textHeight : Number
[read-only] 获取文本的高度,以像素为单位。
TextArea
 InheritedtextSnapshot : TextSnapshot
[read-only] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。
DisplayObjectContainer
  textWidth : Number
[read-only] 获取文本的宽度,以像素为单位。
TextArea
 Inheritedtransform : Transform
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
DisplayObject
 InheriteduseHandCursor : Boolean
布尔值,指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形(手形光标)。
Sprite
 Inheritedversion : String = "3.0.0.13"
组件的版本号。
UIComponent
  verticalScrollBar : UIScrollBar
[read-only] 获取对垂直滚动条的引用。
TextArea
  verticalScrollPolicy : String
获取或设置垂直滚动条的滚动策略。
TextArea
  verticalScrollPosition : Number
获取或设置用户垂直滚动文本字段后滚动条滑块位置的变化,以像素为单位。
TextArea
 Inheritedvisible : Boolean
获取或设置一个值,该值指示当前组件实例是否可见。
UIComponent
 Inheritedwidth : Number
获取或设置组件的宽度(以像素为单位)。
UIComponent
  wordWrap : Boolean
获取或设置一个布尔值,指示文本是否在行末换行。
TextArea
 Inheritedx : Number
获取或设置 x 坐标,该坐标表示组件在其父容器内沿 x 轴的位置。
UIComponent
 Inheritedy : Number
获取或设置 y 坐标,该坐标表示组件在其父容器内沿 y 轴的位置。
UIComponent
公共 方法
 方法定义方
  
创建新的 TextArea 组件实例。
TextArea
 Inherited
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
  
将指定字符串附加到 TextArea 组件所包含的最后一个字符之后。
TextArea
 Inherited
指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。
DisplayObjectContainer
 Inherited
删除此组件实例中的样式属性。
UIComponent
 Inherited
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。
DisplayObjectContainer
 Inherited
将事件调度到事件流中。
EventDispatcher
  
在此组件上显示或隐藏焦点指示符。
TextArea
 Inherited
启动立即绘制操作,但不像 invalidateNow 那样使全部设置失效。
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
DisplayObject
 Inherited
返回位于指定索引处的子显示对象实例。
DisplayObjectContainer
 Inherited
返回具有指定名称的子显示对象。
DisplayObjectContainer
 Inherited
返回 DisplayObject 的 child 实例的索引位置。
DisplayObjectContainer
 Inherited
检索当前具有焦点的对象。
UIComponent
  
检索有关指定文本行的信息。
TextArea
 Inherited
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。
DisplayObject
 Inherited
检索组件的样式查找链中设置的样式属性。
UIComponent
  
[static] 检索当前组件的默认样式映射。
TextArea
 Inherited
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。
DisplayObject
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
在未另外指定的情况下,将属性标记为无效,并在下一帧上重绘组件。
UIComponent
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。
DisplayObject
 Inherited
[static] 将多个类的样式合并到一个对象中。
UIComponent
 Inherited
将组件移动到其父项内的指定位置。
UIComponent
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。
DisplayObjectContainer
 Inherited
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
更改现有子项在显示对象容器中的位置。
DisplayObjectContainer
  
设置此组件的焦点。
TextArea
 Inherited
设置循环操作动态属性的可用性。
Object
  
setSelection(setSelection:int, endIndex:int):void
设置在具有焦点的文本区域中选定内容的范围。
TextArea
 Inherited
setSize(width:Number, height:Number):void
将组件设置为指定宽度和高度。
UIComponent
 Inherited
setStyle(style:String, value:Object):void
对此组件实例设置样式属性。
UIComponent
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
允许用户拖动指定的 Sprite。
Sprite
 Inherited
结束 startDrag() 方法。
Sprite
 Inherited
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。
DisplayObjectContainer
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
验证并更新此对象的属性和布局,如果需要的话重绘对象。
UIComponent
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件摘要定义方
 Inherited Flash Player 获得操作系统焦点并变为活动状态时调度。EventDispatcher
 Inherited 将显示对象添加到显示列表中时调度。DisplayObject
 Inherited 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。DisplayObject
   当 TextArea 组件中的文本更改时调度。TextArea
 Inherited 用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。InteractiveObject
 Inherited Flash Player 失去操作系统焦点并变为非活动状态时调度。EventDispatcher
 Inherited 如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。InteractiveObject
   当用户在该组件中按下 Enter 键时调度。TextArea
 Inherited 播放头进入新帧时调度。DisplayObject
 Inherited 显示对象获得焦点后调度。InteractiveObject
 Inherited 显示对象失去焦点后调度。InteractiveObject
 Inherited 在组件可见性从可见改为不可见以后调度。UIComponent
 Inherited 用户按下某个键时调度。InteractiveObject
 Inherited 用户尝试使用键盘导航更改焦点时调度。InteractiveObject
 Inherited 用户释放某个键时调度。InteractiveObject
 Inherited 在 Flash Player 窗口中,用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited 用户尝试使用指针设备更改焦点时调度。InteractiveObject
 Inherited 用户移动 InteractiveObject 上的指针设备时调度。InteractiveObject
 Inherited 用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited 在 Flash Player 窗口中,用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited 在 Flash Player 窗口中,用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited 在 Flash Player 窗口中,鼠标滚轮滚动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited 在移动组件以后调度。UIComponent
 Inherited 将要从显示列表中删除显示对象时调度。DisplayObject
 Inherited 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。DisplayObject
 Inherited 将要更新和呈现显示列表时调度。DisplayObject
 Inherited 在调整组件大小以后调度。UIComponent
 Inherited 用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited 用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
   当滚动内容时调度。TextArea
 Inherited 在组件可见性从不可见改为可见以后调度。UIComponent
 Inherited 对象的 tabChildren 标志值发生更改时调度。InteractiveObject
 Inherited 对象的 tabEnabled 标志发生更改时调度。InteractiveObject
 Inherited 对象的 tabIndex 属性值发生更改时调度。InteractiveObject
   当用户在该组件中输入、删除或粘贴文本时调度。TextArea
样式
 样式说明定义方
  
disabledSkin
类型: Class
该类提供当 TextArea 组件的 enabled 属性设置为 false 时该组件的背景。 默认值为 TextArea_disabledSkin.
TextArea
 Inherited 类型: flash.text.TextFormat
用于在禁用了按钮的情况下呈现组件标签的 TextFormat 对象。 默认值为 TextFormat("_sans", 11, 0x999999, false, false, false, '', '', TextFormatAlign.LEFT, 0, 0, 0, 0).
UIComponent
  
embedFonts
类型: Boolean
指示是否使用嵌入字体轮廓呈现文本字段。 如果该值为 true,则 Flash Player 使用嵌入字体轮廓呈现文本字段。 如果该值为 false,则 Flash Player 使用设备字体呈现文本字段。

如果将文本字段的 embedFonts 属性设置为 true,则必须使用应用于该文本字段的 TextFormat 对象的 font 属性来指定该文本的字体。 如果指定的字体没有嵌入 SWF 文件中,则不会显示该文本。

. 默认值为 false.
TextArea
 Inherited 类型: Number   格式: Length
用于分隔组件的外边框和焦点指示符的外边框的填充(以像素为单位)。 默认值为 2.
UIComponent
 Inherited 类型: Class
用于显示焦点指示符的外观。 默认值为 focusRectSkin.
UIComponent
 Inherited 类型: flash.text.TextFormat
用于呈现组件标签的 TextFormat 对象。 默认值为 TextFormat("_sans", 11, 0x000000, false, false, false, '', '', TextFormatAlign.LEFT, 0, 0, 0, 0).
UIComponent
  
textPadding
类型: Number   格式: Length
用于分隔组件边框和文本的填充(以像素为单位)。 默认值为 3.
TextArea
  
upSkin
类型: Class
提供 TextArea 组件的背景的类。 默认值为 TextArea_upSkin.
TextArea
属性详细信息
alwaysShowSelection属性
alwaysShowSelection:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个布尔值,指示当文本字段不具有焦点时 Flash Player 是否突出显示文本字段中的选定内容。 如果该值设置为 true 且文本字段不具有焦点,Flash Player 将以灰色突出显示选定内容。 如果该值设置为 false 且文本字段不具有焦点,则 Flash Player 不会突出显示选定内容。

默认值为 false.


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

另请参见

condenseWhite属性 
condenseWhite:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个布尔值,该值指示是否从包含 HTML 文本的 TextArea 组件中删除额外空白。 空格和换行符都属于组件中的额外空白。 true 值指示删除多余的空白;false 值指示不删除多余的空白。

此属性只影响使用 htmlText 属性设置的文本,而不影响使用 text 属性设置的文本。 如果使用 text 属性设置文本,则忽略 condenseWhite 属性。

如果将 condenseWhite 属性设置为 true,则必须使用标准 HTML 命令(如 <br> 和 <p>)将换行符放在文本字段中。

默认值为 false.


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

另请参见


示例
如何使用示例

下例使用 CheckBox 组件切换 TextArea 组件的 condenseWhite 属性:

import fl.controls.CheckBox;
import fl.controls.ScrollPolicy;
import fl.controls.TextArea;

var str:String;

var plainTextArea:TextArea = new TextArea();
plainTextArea.verticalScrollPolicy = ScrollPolicy.ON;
plainTextArea.setSize(260, 360);
plainTextArea.move(10, 10);
addChild(plainTextArea);

var htmlTextArea:TextArea = new TextArea();
htmlTextArea.verticalScrollPolicy = ScrollPolicy.ON;
htmlTextArea.condenseWhite = true;
htmlTextArea.setSize(260, 360);
htmlTextArea.move(280, 10);
addChild(htmlTextArea);

var condenseCheckBox:CheckBox = new CheckBox();
condenseCheckBox.textField.autoSize = TextFieldAutoSize.LEFT;
condenseCheckBox.label = "condenseWhite:";
condenseCheckBox.selected = htmlTextArea.condenseWhite;
condenseCheckBox.move(htmlTextArea.x, htmlTextArea.y + htmlTextArea.height);
condenseCheckBox.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(condenseCheckBox);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/lorem.html"));

function completeHandler(event:Event):void {
    str = event.target.data as String;
    plainTextArea.text = str;
    htmlTextArea.htmlText = str;
}

function clickHandler(event:MouseEvent):void {
    var sel:Boolean = event.currentTarget.selected;
    htmlTextArea.condenseWhite = sel;
    htmlTextArea.htmlText = str;
}
displayAsPassword属性 
displayAsPassword:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个布尔值,该值指示 TextArea 组件实例是否是用于密码的文本字段。 true 值指示当前创建的实例用于包含密码;false 值指示该实例不用于包含密码。

如果此属性的值为 true,则用户在该文本区域中输入的字符不会显示出来。 改由显示星号代替用户输入的每个字符。 此外,“剪切”和“复制”命令及其键盘快捷键将被禁用,以防止有人从无人看管的计算机上获取密码。

默认值为 false.


实现
    public function get displayAsPassword():Boolean
    public function set displayAsPassword(value:Boolean):void
editable属性 
editable:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个布尔值,指示用户能否编辑组件中的文本。 true 值指示用户可以编辑组件所包含的文本;false 值指示用户不能编辑组件所包含的文本。

默认值为 true.


实现
    public function get editable():Boolean
    public function set editable(value:Boolean):void
enabled属性 
enabled:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个值,该值指示组件是否可以接受用户交互。 true 值指示组件可以接受用户交互;false 值指示组件无法接受用户交互。

如果将 enabled 属性设置为 false,则容器的颜色将变暗,并且禁止用户输入(Label 和 ProgressBar 组件除外)。


实现
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
horizontalScrollBar属性 
horizontalScrollBar:UIScrollBar  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取对水平滚动条的引用。


实现
    public function get horizontalScrollBar():UIScrollBar

另请参见

horizontalScrollPolicy属性 
horizontalScrollPolicy:String  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置水平滚动条的滚动策略。 它可以是以下值之一:

默认值为 ScrollPolicy.AUTO.


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

另请参见


示例
如何使用示例

下例创建一个 TextArea 组件实例,并将其 horizontalScrollPolicy 属性设置为 ScrollPolicy.ON,以便无论文本区域当前包含多少内容,水平滚动条都始终可见:

import fl.controls.TextArea;
import fl.controls.ScrollPolicy;

var myTextArea:TextArea = new TextArea();
myTextArea.wordWrap = false;
myTextArea.horizontalScrollPolicy = ScrollPolicy.ON;
myTextArea.text = "The quick brown fox jumped over the lazy dog.";
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
addChild(myTextArea);
horizontalScrollPosition属性 
horizontalScrollPosition:Number  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置用户水平滚动文本字段后滚动条滑块位置的变化,以像素为单位。 如果该值为 0,则文本字段未水平滚动。

默认值为 0.


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

另请参见

htmlText属性 
htmlText:String  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置文本字段所含字符串的 HTML 表示形式。

默认值为 "".


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

另请参见


示例
如何使用示例

下例创建一个 TextArea 组件实例,并使用各种 HTML 标签设置文本的样式:

import fl.controls.TextArea;

var myText:String = "";
myText += "<p>You can use the <b> tag to create <b>bold</b> text.</p>";
myText += "<p>You can use the <i> tag to create <i>italic</i> text.</p>";
myText += "<p>You can use the <u> tag to create <u>underlined</a> text.</p>";
myText += "<p>You can use the <a> tag to create <a href='http://www.adobe.com'>links to other sites</a>.</p>";
myText += "<p>You can use the <br> tag to create<br>new lines of text<br>whenever you want.</p>";
myText += "<p>You can use the <font> tag to specificy different font <font color='#FF0000'>colors</font>, <font size='16'>sizes</font>, or <font face='Times New Roman'>faces</font>.</p>";
myText += "<p>You can use the <img> tag to load images or SWF files:<br><img src='http://www.helpexamples.com/flash/images/logo.png'>.</p>";

var myTextArea:TextArea = new TextArea();
myTextArea.htmlText = myText;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
addChild(myTextArea);

下例创建一个 TextArea 组件实例,并使用 HTML 锚标签创建链接:

import fl.controls.TextArea;

var str:String = "<p>Check out the following links:</p>";
str += "<li><a href=\"event:flash\"><u>Flash</u></a></li>";
str += "<li><a href=\"event:flex\"><u>Flex</u></a></li>";
str += "<li><a href=\"event:devnet\"><u>Developer Center</u></a></li>";

var myTextArea:TextArea = new TextArea();
myTextArea.htmlText += str;
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.LINK, linkHandler);
addChild(myTextArea);

function linkHandler(event:TextEvent):void {
    var url:String = "http://www.adobe.com/go/" + event.text;
    var urlReq:URLRequest = new URLRequest(url);
    navigateToURL(urlReq);
}
imeMode属性 
imeMode:String  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置输入法编辑器 (IME) 的模式。 IME 使用户能够使用 QWERTY 键盘从中文、日文和韩文字符集输入字符。

Flash 在组件获得焦点时将 IME 设置为指定模式,并在组件失去焦点后还原为初始值。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。 将此属性设置为 null 阻止对组件使用 IME。


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

另请参见

length属性 
length:Number  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取 TextArea 组件所包含的字符个数。

默认值为 0.


实现
    public function get length():Number

另请参见

maxChars属性 
maxChars:int  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置用户可以在文本字段中输入的最大字符数。

默认值为 0.


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

另请参见


示例
如何使用示例

下例创建一个 TextArea 组件实例,并设置其 maxChars 属性以限制可在文本区域中输入的文本量:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea();
myTextArea.maxChars = 500;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.TEXT_INPUT, textInputHandler);
addChild(myTextArea);

var charCountLabel:Label = new Label();
charCountLabel.autoSize = TextFieldAutoSize.LEFT;
charCountLabel.move(myTextArea.x, myTextArea.y + myTextArea.height);
addChild(charCountLabel);

charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;

function textInputHandler(event:TextEvent):void {
    updateCount();
}

function updateCount():void {
    charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;
}
maxHorizontalScrollPosition属性 
maxHorizontalScrollPosition:int  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取 horizontalScrollPosition 属性的最大值。

默认值为 0.


实现
    public function get maxHorizontalScrollPosition():int

另请参见

maxVerticalScrollPosition属性 
maxVerticalScrollPosition:int  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取 verticalScrollPosition 属性的最大值。

默认值为 1.


实现
    public function get maxVerticalScrollPosition():int

另请参见

restrict属性 
restrict:String  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置文本字段从用户处接受的字符串。

请注意,未包含在本字符串中的以编程方式输入的字符也为文本字段所接受。

字符串中字符的读取顺序为从左到右。 可以使用连字符 (-) 指定一个字符范围。

如果此属性的值为 null,则文本字段会接受所有字符。 如果此属性设置为空字符串 (""),则文本字段不接受任何字符。

如果字符串以尖号 (^) 开头,则先接受所有字符,然后从接受字符集中排除字符串中 ^ 之后的字符。 如果字符串不以尖号 (^) 开头,则最初不接受任何字符,然后将字符串中的字符包括在接受字符集中。

默认值为 null.


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

另请参见

selectionBeginIndex属性 
selectionBeginIndex:int  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取包含一个或多个字符的选定内容中第一个所选字符的索引位置。

所选字符的索引位置为从零开始并由文本区域中显示的第一个字符开始计算。 如果未选择任何内容,则该值将设置为尖号的位置。

默认值为 0.


实现
    public function get selectionBeginIndex():int

另请参见

selectionEndIndex属性 
selectionEndIndex:int  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取包含一个或多个字符的选定内容中最后一个所选字符的索引位置。

所选字符的索引位置为从零开始并由文本区域中显示的第一个字符开始计算。 如果未选择任何内容,则该值将设置为尖号的位置。

默认值为 0.


实现
    public function get selectionEndIndex():int

另请参见

text属性 
text:String  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置字符串,其中包含当前 TextInput 组件中的文本。 此属性包含无格式文本,不包含 HTML 标签。 若要检索格式为 HTML 的文本,请使用 htmlText 属性。

默认值为 "".


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

另请参见

textField属性 
public var textField:TextField

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

对 TextArea 组件的内部文本字段的引用。

textHeight属性 
textHeight:Number  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取文本的高度,以像素为单位。

默认值为 0.


实现
    public function get textHeight():Number

另请参见


示例
如何使用示例

下例创建一个 TextArea 组件实例,每当调度 change 事件时就显示 textWidthtextHeight 属性:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);

var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);

var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);

function changeHandler(event:Event):void {
    widthLabel.text = "textWidth: " + myTextArea.textWidth;
    heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
textWidth属性 
textWidth:Number  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取文本的宽度,以像素为单位。

默认值为 0.


实现
    public function get textWidth():Number

另请参见


示例
如何使用示例

下例创建一个 TextArea 组件实例,每当调度 change 事件时就显示 textWidthtextHeight 属性:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);

var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);

var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);

function changeHandler(event:Event):void {
    widthLabel.text = "textWidth: " + myTextArea.textWidth;
    heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
verticalScrollBar属性 
verticalScrollBar:UIScrollBar  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取对垂直滚动条的引用。


实现
    public function get verticalScrollBar():UIScrollBar

另请参见


示例
如何使用示例

下例创建一个 TextArea 组件实例,并为组件垂直滚动条设置 pageSize 属性:

import fl.controls.TextArea;
import fl.events.ScrollEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
myTextArea.verticalScrollBar.pageSize = 1;
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);

var myURLLoader:URLLoader = new URLLoader();
myURLLoader.addEventListener(Event.COMPLETE, completeHandler);
myURLLoader.load(new URLRequest("http://www.helpexamples.com/flash/lorem.txt"));

function scrollHandler(event:ScrollEvent):void {
    trace("scroll: " + myTextArea.verticalScrollPosition + " of " + myTextArea.maxVerticalScrollPosition);
}

function completeHandler(event:Event):void {
    var txt:String = URLLoader(event.currentTarget).data as String;
    myTextArea.text = txt;
}
verticalScrollPolicy属性 
verticalScrollPolicy:String  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置垂直滚动条的滚动策略。 它可以是以下值之一:

默认值为 ScrollPolicy.AUTO.


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

另请参见


示例
如何使用示例

下例创建一个 TextArea 组件实例,并将其 verticalScrollPolicy 属性设置为 ScrollPolicy.ON,以便无论文本区域当前包含多少内容,垂直滚动条都始终可见:

import fl.controls.TextArea;
import fl.controls.ScrollPolicy;

var myTextArea:TextArea = new TextArea();
myTextArea.verticalScrollPolicy = ScrollPolicy.ON;
myTextArea.text = "The quick brown fox jumped over the lazy dog.";
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
addChild(myTextArea);
verticalScrollPosition属性 
verticalScrollPosition:Number  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置用户垂直滚动文本字段后滚动条滑块位置的变化,以像素为单位。 如果该值为 1,则文本字段未垂直滚动。

默认值为 1.


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

另请参见


示例
如何使用示例

下例使用 Slider 组件滚动 TextArea 组件的内容:

import fl.controls.ScrollPolicy;
import fl.controls.Slider;
import fl.controls.SliderDirection
import fl.controls.TextArea;
import fl.events.ScrollEvent;
import fl.events.SliderEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.horizontalScrollPolicy = ScrollPolicy.OFF;
myTextArea.verticalScrollPolicy = ScrollPolicy.OFF;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea)

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.width = myTextArea.width;
mySlider.move(myTextArea.x, myTextArea.y + myTextArea.height + 10);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));

function completeHandler(event:Event):void {
    var txt:String = event.target.data as String;
    myTextArea.text = txt;
    myTextArea.drawNow();

    mySlider.minimum = myTextArea.verticalScrollPosition;
    mySlider.maximum = myTextArea.maxVerticalScrollPosition;
    mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
    addChild(mySlider);
}

function scrollHandler(event:ScrollEvent):void {
    trace("scrolled:");
    mySlider.value = event.position;
}

function changeHandler(event:SliderEvent):void {
    trace("changed:");
    myTextArea.verticalScrollPosition = event.value;
}
wordWrap属性 
wordWrap:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个布尔值,指示文本是否在行末换行。 true 值指示文本换行;false 值指示文本不换行。

默认值为 true.


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

另请参见

构造函数详细信息
TextArea()构造函数
public function TextArea()

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

创建新的 TextArea 组件实例。

方法详细信息
appendText()方法
public function appendText(text:String):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

将指定字符串附加到 TextArea 组件所包含的最后一个字符之后。 与通过对 text 属性使用加法赋值来连接两个字符串(例如 myTextArea.text += moreText)相比,此方法的效率更高。 此方法在 TextInput 组件包含大量内容时特别有用。

参数

text:String — 要追加到现有文本末尾的字符串。

drawFocus()方法 
public override function drawFocus(focused:Boolean):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

在此组件上显示或隐藏焦点指示符。

UIComponent 类通过创建并放置 focusSkin 样式指定的类的实例来实现该方法。

参数

focused:Boolean — 指示是显示还是隐藏焦点指示符。 如果该值为 true,则显示焦点指示符;如果该值为 false,则隐藏焦点指示符。

getLineMetrics()方法 
public function getLineMetrics(lineIndex:int):TextLineMetrics

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

检索有关指定文本行的信息。

参数

lineIndex:int — 要检索的信息所在行的行号。

返回
TextLineMetrics
getStyleDefinition()方法 
public static function getStyleDefinition():Object

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

检索当前组件的默认样式映射。 样式映射包含适合组件的类型,具体取决于组件使用的样式。 例如,disabledTextFormat 样式包含 null 值或 TextFormat 对象。 可以使用这些样式并对当前组件调用 setStyle()。 下面的代码覆盖指定组件上默认的 disabledTextFormat 样式:
componentInstance.setStyle("disabledTextFormat", new TextFormat());

返回
Object — 默认样式对象。

另请参见


示例
如何使用示例

下例为多个组件类创建一个样式浏览器:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
setFocus()方法 
public override function setFocus():void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

设置此组件的焦点。 组件可能接下来将焦点提供给子组件。

注意:此方法设置焦点时,只有 TextInput 和 TextArea 组件显示焦点指示符。 所有组件在用户使用 Tab 切换到它时都显示焦点指示符。

setSelection()方法 
public function setSelection(setSelection:int, endIndex:int):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

设置在具有焦点的文本区域中选定内容的范围。 选定内容的范围从由 start 参数指定的索引处开始,到由 end 参数指定的索引处结束。 选定的文本被视为从零开始的一串字符,其中第一个选定字符位于索引 0 处,第二个字符位于索引 1 处,依此类推。

如果文本字段不具有焦点,则此方法无效。

参数

setSelection:int — 选定内容中第一个字符的索引位置。
 
endIndex:int — 选定内容中最后一个字符的索引位置。

事件详细信息
change 事件
事件对象类型: flash.events.Event
Event.type property = flash.events.Event.CHANGE

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当 TextArea 组件中的文本更改时调度。

定义 change 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已修改其值的对象。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
enter 事件  
事件对象类型: fl.events.ComponentEvent
ComponentEvent.type property = fl.events.ComponentEvent.ENTER

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当用户在该组件中按下 Enter 键时调度。

定义 enter 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理事件对象的对象。
target调度了事件的对象。target 不一定是侦听该事件的对象。使用 currentTarget 属性可以访问侦听该事件的对象。
scroll 事件  
事件对象类型: fl.events.ScrollEvent
ScrollEvent.type property = fl.events.ScrollEvent.SCROLL

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当滚动内容时调度。

定义 scroll 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理事件对象的对象。
delta1;一个指示完成了多少滚动量的值。
directionvertical;ScrollBar 的方向。
position0;Scrollbar 滑块移动后的位置。
target调度了事件的对象。target 不一定是侦听该事件的对象。使用 currentTarget 属性可以访问侦听该事件的对象。

示例
如何使用示例

下例将文本加载到 TextArea 组件中,并在用户滚动 TextArea 时跟踪滚动方向、滚动位置和最大滚动位置:

import fl.controls.ScrollBarDirection;
import fl.controls.TextArea;
import fl.events.ScrollEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));

function completeHandler(event:Event):void {
    var txt:String = event.target.data as String;
    myTextArea.text = txt;
}

function scrollHandler(event:ScrollEvent):void {
    var myTA:TextArea = event.currentTarget as TextArea;
    var pos:Number = event.position;
    var maxPos:Number;
    
    if (event.direction == ScrollBarDirection.VERTICAL) {
        maxPos = myTA.maxVerticalScrollPosition;
    } else {
        maxPos = myTA.maxHorizontalScrollPosition;
    }
    trace("scroll: " + event.direction + " (" + pos.toFixed(2) + " of " + maxPos + ")");
}
textInput 事件  
事件对象类型: flash.events.TextEvent
TextEvent.type property = flash.events.TextEvent.TEXT_INPUT

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当用户在该组件中输入、删除或粘贴文本时调度。

定义 textInput 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelabletrue;调用 preventDefault() 方法以取消默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target在其中输入字符的文本字段。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
text用户输入的字符或字符序列。
示例 如何使用示例

此示例演示了如何侦听 TextArea 类的实例的事件。

若要运行该示例,请按照下列步骤操作:

  1. 将 TextArea 组件拖到舞台上,并将其命名为 ta1
  2. 将 TextArea 组件拖到舞台上,并将其命名为 ta2
  3. 将该代码作为 TextAreaExample.as 另存到 FLA 文件所在的同一目录中。
  4. 将 FLA 文件中的 Document 类设置为 TextAreaExample。
package
{
    import fl.controls.TextArea;
    import fl.events.ComponentEvent;
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.TextEvent;
    import flash.text.TextField;
    
    public class TextAreaExample extends Sprite
    {
        private var testString:String         = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus quis nisl vel tortor nonummy vulputate. Quisque sit amet eros sed purus euismod tempor. Morbi tempor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos. Curabitur diam. Suspendisse at purus in ipsum volutpat viverra. Nulla pellentesque libero id libero. Proin pretium suscipit lectus. Donec in sapien vel nulla egestas semper. Mauris massa. In aliquet sem ac libero. In eget orci. Sed feugiat. Vestibulum vel felis in lectus imperdiet scelerisque. Vestibulum vestibulum neque at est. Etiam purus quam, laoreet quis, accumsan sed, porttitor ut, erat. Proin volutpat. In facilisis dolor gravida felis. Curabitur nisi lacus, euismod non, pharetra et, mollis a, tellus. Donec lectus orci, viverra at, luctus ac, sodales id, quam. Phasellus faucibus lacus ut est. Curabitur id diam eu massa bibendum lobortis. Vivamus quis elit. Donec mi justo, dictum vitae, cursus sit amet, lacinia consectetuer, d ut, vulputate sed, molestie et, arcu. Nullam mi.';
        private var testStringHTML:String     = 'This is <font color="#FF0000">HTML text</font> in a <b>TextArea control</b>. Use the <u>htmlText property</u> of the <font color="#008800">TextArea control</font> to include basic HTML markup in your text.';
        
        public function TextAreaExample() {
            ta1.text = testString;
            ta2.htmlText = testStringHTML;
            configureListeners(ta1);
            configureListeners(ta2);
        }
        private function configureListeners(ta:TextArea):void {
            ta.addEventListener(TextEvent.TEXT_INPUT,announceEvent);
            ta.addEventListener(Event.CHANGE,announceEvent);
            ta.addEventListener(ComponentEvent.ENTER,announceEvent);
            ta.addEventListener(Event.SCROLL,announceEvent);            
        }
        private function announceEvent(e:Event):void {
            trace(e.toString());    
        }
    }
}




 

评论添加到页面后给我发送电子邮件 | 评论报告

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/fl/controls/TextArea.html