| 包 | spark.core |
| 接口 | public interface IEditableText extends IDisplayText , IEventDispatcher |
| 实现器 | RichEditableText, StyleableStageText, StyleableTextField |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。 | IEditableText | ||
| displayAsPassword : Boolean
指定文本字段是否是密码文本字段。 | IEditableText | ||
| editable : Boolean
标识文本是否可编辑的标志。 | IEditableText | ||
| enabled : Boolean
组件是否可以接受用户交互。 | IEditableText | ||
| focusEnabled : Boolean
指示切换到此组件时，是否可以获得焦点。 | IEditableText | ||
| horizontalScrollPosition : Number
文本的水平滚动位置。 | IEditableText | ||
 | isTruncated : Boolean [只读]
标识文本是否已截断的标志。 | IDisplayText | |
| lineBreak : String
控制文本内的自动换行。 | IEditableText | ||
| maxChars : int
文本字段中最多可包含的字符数（即用户输入的字符数）。 | IEditableText | ||
| multiline : Boolean
表示字段是否为多行文本字段。 | IEditableText | ||
| restrict : String
表示用户可输入到文本字段中的字符集。 | IEditableText | ||
| selectable : Boolean
一个布尔值，表示文本字段是否可选。 | IEditableText | ||
| selectionActivePosition : int [只读]
选择部分的活动位置或最后单击位置。 | IEditableText | ||
| selectionAnchorPosition : int [只读]
选择部分的锚点或最先单击位置。 | IEditableText | ||
| tabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。 | IEditableText | ||
| text : String
此文本组件所显示的文本。 | IDisplayText | |
| verticalScrollPosition : Number
文本的垂直滚动位置。 | IEditableText | ||
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | IEventDispatcher | |
将指定文本追加到文本组件的结尾，就好像您已在该结尾处单击并键入它一样。 | IEditableText | ||
|
将事件调度到事件流中。 | IEventDispatcher | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | IEventDispatcher | |
将指定的文本插入到文本组件中，就好像您已键入它一样。 | IEditableText | ||
|
从 EventDispatcher 对象中删除侦听器。 | IEventDispatcher | |
滚动以使指定范围位于视图中。 | IEditableText | ||
选择所有文本。 | IEditableText | ||
选择指定范围的字符。 | IEditableText | ||
将焦点设置到该文本字段。 | IEditableText | ||
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | IEventDispatcher | |
accessibilityProperties | 属性 |
accessibilityProperties:AccessibilityProperties| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
此显示对象的当前辅助功能选项。如果您修改 accessibilityProperties 属性或 accessibilityProperties 内部的任何字段，则必须调用 Accessibility.updateProperties() 方法以使您的更改生效。
请注意：对于在 Flash 创作环境中创建的对象，将使用您在“辅助功能”面板中为该对象输入的所有信息来填充 accessibilityProperties 的值。
实现
public function get accessibilityProperties():AccessibilityProperties public function set accessibilityProperties(value:AccessibilityProperties):voiddisplayAsPassword | 属性 |
displayAsPassword:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
指定文本字段是否是密码文本字段。如果此属性的值为 true，则文本字段被视为密码文本字段，并使用星号而不是实际字符来隐藏输入的字符。如果为 false，则不会将文本字段视为密码文本字段。启用密码模式时，“剪切”和“复制”命令及其对应的键盘快捷键将不起作用。此安全机制可防止不良用户使用快捷键在无人看管的计算机上破译密码。
实现
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voideditable | 属性 |
enabled | 属性 |
enabled:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
组件是否可以接受用户交互。将 enabled 属性设置为 false 后，某些组件仍会响应鼠标交互，如 mouseOver。因此，要完全禁用 UIComponent，您应该将 mouseEnabled 属性的值也设置为 false。如果将容器的 enabled 属性设置为 false，则 Flex 会使该容器及其所有子项的颜色变暗，并阻止用户向容器及其所有子项输入内容。
实现
public function get enabled():Boolean public function set enabled(value:Boolean):voidfocusEnabled | 属性 |
focusEnabled:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
指示切换到此组件时，是否可以获得焦点。当 UIComponent 用作另一组件的子组件时，可以将 focusEnabled 设置为 false，以便外部组件成为可获得焦点的实体。如果此属性是 false，则焦点将转换到已将 focusEnable 设置为 true 的第一个父项。
默认值为 true，spark.components.Scroller 组件除外。对于该组件，默认值为 false。
实现
public function get focusEnabled():Boolean public function set focusEnabled(value:Boolean):voidhorizontalScrollPosition | 属性 |
lineBreak | 属性 |
maxChars | 属性 |
multiline | 属性 |
multiline:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
表示字段是否为多行文本字段。如果值为 true，则文本字段为多行文本字段；如果值为 false，则文本字段为单行文本字段。在类型为 TextFieldType.INPUT 的字段中，multiline 值将确定 Enter 键是否创建新行（如果值为 false，则将忽略 Enter 键）。如果将文本粘贴到其 multiline 值为 false 的 TextField 中，则文本中将除去新行。
实现
public function get multiline():Boolean public function set multiline(value:Boolean):voidrestrict | 属性 |
restrict:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
表示用户可输入到文本字段中的字符集。如果 restrict 属性的值为 null，则可以输入任何字符。如果 restrict 属性的值为空字符串，则不能输入任何字符。如果 restrict 属性的值为一串字符，则只能在文本字段中输入该字符串中的字符。从左向右扫描该字符串。可以使用连字符 (-) 指定一个范围。只限制用户交互；脚本可将任何文本放入文本字段中。此属性不与属性检查器中的“嵌入字体”选项同步。
如果字符串以尖号 (^) 开头，则先接受所有字符，然后从接受字符集中排除字符串中 ^ 之后的字符。如果字符串不以尖号 (^) 开头，则最初不接受任何字符，然后将字符串中的字符包括在接受字符集中。
下例仅允许在文本字段中输入大写字符、空格和数字：
my_txt.restrict = "A-Z 0-9";
下例包含除小写字母之外的所有字符：
my_txt.restrict = "^a-z";
可以使用反斜杠输入 ^ 或 - 的本义。认可的反斜杠序列为 \-、\^ 或 \\。反斜杠在字符串中必须是一个本义字符，因此在 ActionScript 中指定时必须使用两个反斜杠。例如，下面的代码只包含短划线 (-) 和尖号 (^)：
my_txt.restrict = "\\-\\^";
可在字符串中的任何位置使用 ^，以在包含字符与排除字符之间进行切换。下面的代码只包含除大写字母 Q 之外的大写字母：
my_txt.restrict = "A-Z^Q";
可以使用 \u 转义序列构造 restrict 字符串。下面的代码只包含从 ASCII 32（空格）到 ASCII 126（代字号）之间的字符。
my_txt.restrict = "\u0020-\u007E";
实现
public function get restrict():String public function set restrict(value:String):voidselectable | 属性 |
selectable:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
一个布尔值，表示文本字段是否可选。值 true 表示文本可选。selectable 属性控制文本字段是否可选，而不控制文本字段是否可编辑。动态文本字段即使不可编辑，它也可能是可选的。如果动态文本字段是不可选的，则用户不能选择其中的文本。
如果 selectable 设置为 false，则文本字段中的文本不响应来自鼠标或键盘的选择命令，并且不能使用“复制”命令复制文本。如果 selectable 设置为 true，则可以使用鼠标或键盘选择文本字段中的文本，并且可以使用“复制”命令复制文本。即使文本字段是动态文本字段而不是输入文本字段，您也可以用这种方式选择文本。
实现
public function get selectable():Boolean public function set selectable(value:Boolean):voidselectionActivePosition | 属性 |
selectionAnchorPosition | 属性 |
tabIndex | 属性 |
tabIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
指定 SWF 文件中的对象按 Tab 键顺序排列。默认情况下，tabIndex 属性为 -1，这意味着没有为该对象设置任何 Tab 索引。
如果 SWF 文件中当前显示的任何对象包含 tabIndex 属性，则禁用 Tab 键自动排序，而使用该 SWF 文件中对象的 tabIndex 属性来计算 Tab 键顺序。这个自定义的 Tab 键排序仅包括指定了 tabIndex 属性的对象。
tabIndex 属性可以是非负整数。这些对象按照其 tabIndex 属性按升序进行排序。tabIndex 值为 1 的对象在 tabIndex 值为 2 的对象的前面。不要对多个对象使用相同的 tabIndex 值。
由 tabIndex 属性定义的自定义 Tab 键顺序为平构。这意味着不考虑 SWF 文件中对象的层次结构关系。SWF 文件中具有 tabIndex 属性的所有对象都排入 Tab 键顺序中，而 Tab 键顺序由 tabIndex 值的顺序确定。
注意：要设置 TLFTextField 实例的 Tab 键顺序，请将 TLFTextField 的显示子对象转换为 InteractiveObject，然后设置 tabIndex 属性。例如：
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;要将 TLFTextField 对象三个实例的 Tab 顺序从默认设置（
tlfInstance1、tlfInstance2 和 tlfInstance3）转变为相反的顺序，请使用：
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
实现
public function get tabIndex():int public function set tabIndex(value:int):voidverticalScrollPosition | 属性 |
appendText | () | 方法 |
insertText | () | 方法 |
scrollToRange | () | 方法 |
selectAll | () | 方法 |
public function selectAll():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
选择所有文本。
selectRange | () | 方法 |
setFocus | () | 方法 |
public function setFocus():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.0 |
将焦点设置到该文本字段。
Tue Jun 12 2018, 11:04 AM Z