| 包 | mx.core |
| 类 | public class FTETextField |
| 继承 | FTETextField  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 实现 | IFontContextComponent |
| 子类 | UIFTETextField |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
相关 API 元素
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。 | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。 | DisplayObject | |
| alpha : Number
表示指定对象的 Alpha 透明度值。 | DisplayObject | |
| alwaysShowSelection : Boolean
该属性没有在 FTETextField 中被实现，因为 FTETextField 不支持选择。 | FTETextField | ||
| antiAliasType : String
此属性对于 FTETextField 无效，因为 FTE 使用的字体呈示器比 TextField 更新。 | FTETextField | ||
| autoSize : String
控制文本字段的自动大小调整和对齐。 | FTETextField | ||
| background : Boolean
指定文本字段是否具有背景填充。 | FTETextField | ||
| backgroundColor : uint
文本字段背景的颜色。 | FTETextField | ||
| blendMode : String
BlendMode 类中的一个值，用于指定要使用的混合模式。 | DisplayObject | |
| blendShader : Shader [只写]
设置用于混合前景和背景的着色器。 | DisplayObject | |
| border : Boolean
指定文本字段是否具有边框。 | FTETextField | ||
| borderColor : uint
文本字段边框的颜色。 | FTETextField | ||
| bottomScrollV : int [只读]
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持滚动。 | FTETextField | ||
| buttonMode : Boolean
指定此 sprite 的按钮模式。 | Sprite | |
| cacheAsBitmap : Boolean
如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。 | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
如果为非 null，则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。 | DisplayObject | |
| caretIndex : int [只读]
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持编辑。 | FTETextField | ||
| condenseWhite : Boolean
一个布尔值，指定是否删除具有 HTML 文本的文本字段中的额外空白（空格、换行符等等）。 | FTETextField | ||
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| contextMenu : NativeMenu
指定与此对象相关联的上下文菜单。 | InteractiveObject | |
| defaultTextFormat : flash.text:TextFormat
指定应用于新插入文本（例如，用户输入的文本或使用 replaceSelectedText() 方法插入的文本）的格式。 | FTETextField | ||
| direction : String
FTETextField 显示的文本的方向性。 | FTETextField | ||
| displayAsPassword : Boolean
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持编辑。 | FTETextField | ||
| doubleClickEnabled : Boolean
指定此对象是否接收 doubleClick 事件。 | InteractiveObject | |
| dropTarget : DisplayObject [只读]
指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。 | Sprite | |
| embedFonts : Boolean
指定是否使用嵌入字体轮廓进行呈现。 | FTETextField | ||
| filters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。 | DisplayObject | |
| focusRect : Object
指定此对象是否显示焦点矩形。 | InteractiveObject | |
| fontContext : IFlexModuleFactory
FTETextField 用于创建 TextLine 对象的 IFlexModuleFactory 实例。 | FTETextField | ||
| graphics : Graphics [只读]
指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘图命令。 | Sprite | |
| gridFitType : String
此属性对于 FTETextField 无效，因为 FTE 使用的字体呈示器比 TextField 更新。 | FTETextField | ||
| height : Number
表示显示对象的高度，以像素为单位。 | DisplayObject | |
| hitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | |
| htmlText : String
包含文本字段内容的 HTML 表示形式。 | FTETextField | ||
| length : int [只读]
文本字段中的字符数。 | FTETextField | ||
| loaderInfo : LoaderInfo [只读]
返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
| locale : String
FTETextField 显示的文本的区域设置。 | FTETextField | ||
| mask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | |
| maxChars : int
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持编辑。 | FTETextField | ||
| maxScrollH : int [只读]
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持滚动。 | FTETextField | ||
| maxScrollV : int [只读]
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持滚动。 | FTETextField | ||
| metaData : Object
如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的，则获取 DisplayObject 实例的元数据对象。 | DisplayObject | |
| mouseChildren : Boolean
确定对象的子级是否支持鼠标或用户输入设备。 | DisplayObjectContainer | |
| mouseEnabled : Boolean
指定此对象是否接收鼠标或其他用户输入、消息。 | InteractiveObject | |
| mouseWheelEnabled : Boolean
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持滚动。 | FTETextField | ||
| mouseX : Number [只读]
表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。 | DisplayObject | |
| mouseY : Number [只读]
表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。 | DisplayObject | |
| multiline : Boolean
该属性在 FTETextField 中无效，因为 FTETextField 不支持编辑。 | FTETextField | ||
| name : String
表示 DisplayObject 的实例名称。 | DisplayObject | |
| needsSoftKeyboard : Boolean
指定当该 InteractiveObject 实例获得焦点时，是否显示虚拟键盘（显示在屏幕上的软键盘）。 | InteractiveObject | |
| numChildren : int [只读]
返回此对象的子项数目。 | DisplayObjectContainer | |
| numLines : int [只读]
定义多行文本字段中的文本行数。 | FTETextField | ||
| opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
| parent : DisplayObjectContainer [只读]
表示包含此显示对象的 DisplayObjectContainer 对象。 | DisplayObject | |
| restrict : String
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持滚动。 | FTETextField | ||
| root : DisplayObject [只读]
对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | |
| rotation : Number
表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。 | DisplayObject | |
| rotationX : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。 | DisplayObject | |
| rotationY : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。 | DisplayObject | |
| rotationZ : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。 | DisplayObject | |
| scale9Grid : Rectangle
当前有效的缩放网格。 | DisplayObject | |
| scaleX : Number
表示从注册点开始应用的对象的水平缩放比例（百分比）。 | DisplayObject | |
| scaleY : Number
表示从对象注册点开始应用的对象的垂直缩放比例（百分比）。 | DisplayObject | |
| scaleZ : Number
表示从对象的注册点开始应用的对象的深度缩放比例（百分比）。 | DisplayObject | |
| scrollH : int
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持滚动。 | FTETextField | ||
| scrollRect : Rectangle
显示对象的滚动矩形范围。 | DisplayObject | |
| scrollV : int
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持滚动。 | FTETextField | ||
| selectable : Boolean
设置该属性在 FTETextField 中不起作用，因为 FTETextField 不支持选择。 | FTETextField | ||
| selectionBeginIndex : int [只读]
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持选择。 | FTETextField | ||
| selectionEndIndex : int [只读]
该属性尚未在 FTETextField 中实现，因为 FTETextField 不支持选择。 | FTETextField | ||
| sharpness : Number
此属性在 FTETextField 中无效。 | FTETextField | ||
| softKeyboard : String
控制软键盘的外观。 | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
定义当显示软键盘时应在屏幕上保留的区域（在 iOS 上不支持）。 | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
控制此 sprite 中的声音。 | Sprite | |
| stage : Stage [只读]
显示对象的舞台。 | DisplayObject | |
| styleSheet : StyleSheet
将样式表附加到文本字段。 | FTETextField | ||
| tabChildren : Boolean
确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | |
| tabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | |
| tabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | |
| text : String
作为文本字段中当前文本的字符串。 | FTETextField | ||
| textColor : uint
文本字段中文本的颜色（采用十六进制格式）。 | FTETextField | ||
| textHeight : Number [只读]
文本的高度，以像素为单位。 | FTETextField | ||
| textSnapshot : flash.text:TextSnapshot [只读]
返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | |
| textWidth : Number [只读]
文本的宽度，以像素为单位。 | FTETextField | ||
| thickness : Number
此属性对于 FTETextField 无效，因为 FTE 使用的字体呈示器比 TextField 更新。 | FTETextField | ||
| transform : flash.geom:Transform
一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | DisplayObject | |
| type : String
文本字段的类型。 | FTETextField | ||
| useHandCursor : Boolean
布尔值，表示当指针滑过 buttonMode 属性设置为 true 的 sprite 时是否显示指针手形（手形光标）。 | Sprite | |
| useRichTextClipboard : Boolean
该属性没有在 FTETextField 中被实现，因为 FTETextField 不支持选择或剪贴板操作。 | FTETextField | ||
| visible : Boolean
显示对象是否可见。 | DisplayObject | |
| width : Number
表示显示对象的宽度，以像素为单位。 | DisplayObject | |
| wordWrap : Boolean
一个布尔值，表示文本字段是否自动换行。 | FTETextField | ||
| x : Number
表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。 | DisplayObject | |
| y : Number
表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。 | DisplayObject | |
| z : Number
表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | DisplayObject | |
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数。 | FTETextField | ||
|
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
|
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
|
表示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
|
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
|
将事件调度到事件流中。 | EventDispatcher | |
|
返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
|
返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
|
返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
|
返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
返回给定文本行的度量信息。 | FTETextField | ||
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
|
返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。 | DisplayObjectContainer | |
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
|
返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。 | DisplayObject | |
该方法已在 FTETextField 中实现且仅返回 defaultTextFormat 的副本，因为 FTETextField 不支持设置一个范围的格式。 | FTETextField | ||
|
将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。 | DisplayObject | |
|
将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。 | DisplayObject | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。 | DisplayObject | |
|
计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | DisplayObject | |
|
将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。 | DisplayObject | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
|
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
|
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。 | FTETextField | ||
|
显示虚拟键盘。 | InteractiveObject | |
|
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
|
设置循环操作动态属性的可用性。 | Object | |
该方法尚未在 FTETextField 中实现，因为 FTETextField 不支持选择。 | FTETextField | ||
如果 beginIndex 或 endIndex 不等于 -1，则此方法对于 FTETextField 无效，因为 FTETextField 不支持对范围设置格式。 | FTETextField | ||
|
允许用户拖动指定的 Sprite。 | Sprite | |
|
使用户可以在启用触摸的设备上拖动指定的 Sprite。 | Sprite | |
|
对源起于此对象的所有 MovieClip 递归停止时间轴执行。 | DisplayObjectContainer | |
|
结束 startDrag() 方法。 | Sprite | |
|
结束 startTouchDrag() 方法，用于启用触摸的设备。 | Sprite | |
|
交换两个指定子对象的 Z 轴顺序（从前到后顺序）。 | DisplayObjectContainer | |
|
在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。 | DisplayObjectContainer | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
属性详细信息
alwaysShowSelection | 属性 |
antiAliasType | 属性 |
autoSize | 属性 |
autoSize:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
控制文本字段的自动大小调整和对齐。TextFieldAutoSize 常数的可接受值为 TextFieldAutoSize.NONE（默认值）、TextFieldAutoSize.LEFT、TextFieldAutoSize.RIGHT 和 TextFieldAutoSize.CENTER。
如果 autoSize 设置为 TextFieldAutoSize.NONE（默认值），则不会进行调整。
如果 autoSize 设置为 TextFieldAutoSize.LEFT，会将文本视为左对齐文本，这意味着该文本字段的左边距保持固定，在右边可调整单个文本字段行。如果文本中包括换行符（例如 "\n" 或 "\r"），则会另外调整底边来适合文本的下一行。如果 wordWrap 也设置为 true，则仅调整文本字段的底边，而右边距保持固定。
如果 autoSize 设置为 TextFieldAutoSize.RIGHT，会将文本视为右对齐文本，这意味着该文本字段的右边距保持固定，可在左边调整单个文本字段行。如果文本中包括换行符（例如 "\n" 或 "\r")，则会另外调整底边来适合文本的下一行。如果 wordWrap 也设置为 true，则仅调整文本字段的底边，而左边距保持固定。
如果 autoSize 设置为 TextFieldAutoSize.CENTER，会将文本视为居中对齐文本，这意味着对单个文本字段行的调整将使其在左右边距间均衡分布。如果文本中包括换行符（例如 "\n" 或 "\r"），则会另外调整底边来适合文本的下一行。如果 wordWrap 也设置为 true，则仅调整文本字段的底边，而左右边距保持固定。
实现
public function get autoSize():String public function set autoSize(value:String):voidbackground | 属性 |
backgroundColor | 属性 |
border | 属性 |
borderColor | 属性 |
bottomScrollV | 属性 |
caretIndex | 属性 |
condenseWhite | 属性 |
condenseWhite:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
一个布尔值，指定是否删除具有 HTML 文本的文本字段中的额外空白（空格、换行符等等）。默认值为 false。condenseWhite 属性只影响使用 htmlText 属性（而非 text 属性）设置的文本。如果使用 text 属性设置文本，则忽略 condenseWhite。
如果 condenseWhite 设置为 true，请使用标准 HTML 命令（如 <BR> 和 <P>），将换行符放在文本字段中。
在设置 htmlText 属性之前设置 condenseWhite 属性。
实现
public function get condenseWhite():Boolean public function set condenseWhite(value:Boolean):voiddefaultTextFormat | 属性 |
defaultTextFormat:flash.text:TextFormat| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定应用于新插入文本（例如，用户输入的文本或使用 replaceSelectedText() 方法插入的文本）的格式。
注意：当选择要替换为 setSelection() 和 replaceSelectedText() 的字符时，仅在选择的文本达到和包括最后字符时才会应用 defaultTextFormat。下面是一个示例：
var my_txt:TextField new TextField();
my_txt.text = "Flash Macintosh version";
var my_fmt:TextFormat = new TextFormat();
my_fmt.color = 0xFF0000;
my_txt.defaultTextFormat = my_fmt;
my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
my_txt.replaceSelectedText("Windows version");
在访问 defaultTextFormat 属性时，返回的 TextFormat 对象已定义了它的所有属性。所有属性都不为 null。
注意：如果对文本字段应用了样式表，则不能设置该属性。
实现
public function get defaultTextFormat():flash.text:TextFormat public function set defaultTextFormat(value:flash.text:TextFormat):voiddirection | 属性 |
direction:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
FTETextField 显示的文本的方向性。
允许的值为“ltr”（适用于从左到右文本，就像在拉丁样式脚本中一样）和“rtl”（适用于从右到左文本，就像在阿拉伯语和希伯来语中一样）。
注意：此属性在 flash.text.TextField API 中不存在。
默认值为 "ltr"。
实现
public function get direction():String public function set direction(value:String):voiddisplayAsPassword | 属性 |
embedFonts | 属性 |
embedFonts:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定是否使用嵌入字体轮廓进行呈现。如果为 false，则 Flash Player 使用设备字体呈现文本字段。
如果将文本字段的 embedFonts 属性设置为 true，则必须使用应用于该文本字段的 TextFormat 对象的 font 属性来指定该文本的字体。如果指定的字体没有嵌入 SWF 文件中，则不会显示该文本。
实现
public function get embedFonts():Boolean public function set embedFonts(value:Boolean):voidfontContext | 属性 |
fontContext:IFlexModuleFactory| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
FTETextField 用于创建 TextLine 对象的 IFlexModuleFactory 实例。这通常是（但并不总是）ISWFContext。
如果您需要在包含 TLF 代码的 SWF 上下文之外的其他 SWF 上下文中创建行，则设置此方法。
注意：此属性在 flash.text.TextField API 中不存在。
默认值为 null。
实现
public function get fontContext():IFlexModuleFactory public function set fontContext(value:IFlexModuleFactory):voidgridFitType | 属性 |
htmlText | 属性 |
htmlText:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
包含文本字段内容的 HTML 表示形式。
Flash Player 支持以下 HTML 标签：
| 标签 | 说明 |
|---|---|
| 锚标签 |
<a> 标签创建超文本链接并支持以下属性：
|
| 粗体标签 |
<b> 标签以粗体形式呈现文本。粗体必须可用于所使用的字体。
|
| 换行标签 |
<br> 标签将在文本字段中创建一个换行符。将文本字段设置为多行文本字段以使用此标签。
|
| 字体标签 |
<font> 标签指定一种字体或一个字体列表来显示文本。字体标签支持以下属性：
|
| 图像标签 |
使用 <img> 标签可将外部图像文件（JPEG、GIF、PNG）、SWF 文件和影片剪辑嵌入到文本字段中。在文本字段中，文本在嵌入的图像旁自动换行。您必须将文本字段设置为多行才能在图像周围绕排文本。
Flash 以完全大小显示文本字段中嵌入的媒体。要指定嵌入的媒体的尺寸，请使用 通常情况下，文本字段中嵌入的图像显示在 对于应用程序安全沙箱中的 AIR 内容，AIR 会忽略 ActionScript TextField 对象的 HTML 内容中的 |
| 斜体标签 |
<i> 标签以斜体形式显示标签中的文本。斜体必须可用于所使用的字体。
|
| 列表项标签 |
<li> 标签在所包含的文本前放置项目符号。注意：因为 Flash Player 和 AIR 无法识别有序和无序列表标签（<ol> 和 <ul>），所以这些标签无法修改列表的呈现方式。所有列表都是无序的，所有列表项都使用项目符号。
|
| 段落标签 |
<p> 标签创建一个新段落。必须将文本字段设置为多行文本字段才能使用此标签。<p> 标签支持以下属性：
|
| Span 标签 |
<span> 标签只可用于 CSS 文本样式。它支持以下属性：
|
| 文本格式标签 |
使用
|
| 下划线标签 |
<u> 标签为标签文本添加下划线。
|
Flash Player 和 AIR 支持以下 HTML 实体：
| 实体 | 说明 |
|---|---|
| < | <（小于） |
| > | >（大于） |
| & | &（and 符） |
| " | "（双引号） |
| ' | '（撇号，单引号） |
Flash Player 和 AIR 还支持显式字符代码，如 &（ASCII 和号）和 €（Unicode € 符号）。
实现
public function get htmlText():String public function set htmlText(value:String):voidlength | 属性 |
locale | 属性 |
maxChars | 属性 |
maxScrollH | 属性 |
maxScrollV | 属性 |
mouseWheelEnabled | 属性 |
multiline | 属性 |
numLines | 属性 |
restrict | 属性 |
scrollH | 属性 |
scrollV | 属性 |
selectable | 属性 |
selectionBeginIndex | 属性 |
selectionEndIndex | 属性 |
sharpness | 属性 |
styleSheet | 属性 |
styleSheet:StyleSheet| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将样式表附加到文本字段。有关创建样式表的信息，请参阅 StyleSheet 类和《ActionScript 3.0 开发人员指南》。
您可以随时更改与文本字段相关的样式表。如果更改使用中的样式表，会使用新的样式表重绘文本字段。您可以将样式表设置为 null 或 undefined 以删除此样式表。如果删除正在使用的样式表，则不使用样式表重绘文本字段。
注意：如果删除样式表，则 TextField.text 和 TextField.htmlText 的内容都将体现先前由该样式表应用的格式。要保留不带格式的原始 TextField.htmlText 内容，请在删除样式表前将该值保存在变量中。
实现
public function get styleSheet():StyleSheet public function set styleSheet(value:StyleSheet):void相关 API 元素
text | 属性 |
text:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
作为文本字段中当前文本的字符串。各行之间用回车符（'\r'，即 ASCII 13）分隔。此属性包含文本字段中的无格式文本，不带 HTML 标签。
要获取 HTML 形式的文本，请使用 htmlText 属性。
注意：如果将样式表应用到文本字段，text 属性的内容将按 HTML 解释。
实现
public function get text():String public function set text(value:String):voidtextColor | 属性 |
textHeight | 属性 |
textWidth | 属性 |
thickness | 属性 |
type | 属性 |
useRichTextClipboard | 属性 |
wordWrap | 属性 |
构造函数详细信息
FTETextField | () | 构造函数 |
public function FTETextField()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
构造函数。
方法详细信息
appendText | () | 方法 |
getCharBoundaries | () | 方法 |
getCharIndexAtPoint | () | 方法 |
getFirstCharInParagraph | () | 方法 |
getImageReference | () | 方法 |
public function getImageReference(id:String):DisplayObject| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
该方法尚未在 FTETextField 中实现，因为在 TextField 中几乎没有组件会使用它。如果调用，则会引发运行时错误。
参数
id:String — 无
|
DisplayObject — 无
|
相关 API 元素
getLineIndexAtPoint | () | 方法 |
getLineIndexOfChar | () | 方法 |
getLineLength | () | 方法 |
getLineMetrics | () | 方法 |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回给定文本行的度量信息。
参数
lineIndex:int — 需要相关度量信息的行号。
|
flash.text:TextLineMetrics — 一个 TextLineMetrics 对象。
|
getLineOffset | () | 方法 |
getLineText | () | 方法 |
getParagraphLength | () | 方法 |
getTextFormat | () | 方法 |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
该方法已在 FTETextField 中实现且仅返回 defaultTextFormat 的副本，因为 FTETextField 不支持设置一个范围的格式。
参数
beginIndex:int (default = -1) | |
endIndex:int (default = -1) |
flash.text:TextFormat — 无
|
相关 API 元素
replaceSelectedText | () | 方法 |
replaceText | () | 方法 |
setSelection | () | 方法 |
setTextFormat | () | 方法 |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
如果 beginIndex 或 endIndex 不等于 -1，则此方法对于 FTETextField 无效，因为 FTETextField 不支持对范围设置格式。
参数
format:flash.text:TextFormat — 无
| |
beginIndex:int (default = -1) | |
endIndex:int (default = -1) |
相关 API 元素
Tue Jun 12 2018, 11:04 AM Z