IUITextField  - AS3 Flex

如果设置为 true 且文本字段没有焦点，Flash Player 将以灰色突出显示文本字段中的所选内容。如果设置为 false 且文本字段没有焦点，则 Flash Player 不会突出显示文本字段中的所选内容。

用于此文本字段的消除锯齿类型。将 flash.text.AntiAliasType 常数用于此属性。仅在字体为嵌入（即 embedFonts 属性设置为 true）时可以控制此设置。默认设置为 flash.text.AntiAliasType.NORMAL。

要设置此属性的值，请使用下列字符串值：

控制文本字段的自动大小调整和对齐。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，则仅调整文本字段的底边，而左右边距保持固定。

指定文本字段是否具有背景填充。如果为 true，则文本字段具有背景填充。如果为 false，则文本字段没有背景填充。使用 backgroundColor 属性来设置文本字段的背景颜色。

文本字段背景的颜色。默认值为 0xFFFFFF（白色）。即使当前没有背景，也可检索或设置此属性，但只有当文本字段已将 background 属性设置为 true 时，才可以看到颜色。

指定文本字段是否具有边框。如果为 true，则文本字段具有边框。如果为 false，则文本字段没有边框。使用 borderColor 属性来设置边框颜色。

文本字段边框的颜色。默认值为 0x000000（黑色）。即使当前没有边框，也可检索或设置此属性，但只有当文本字段已将 border 属性设置为 true 时，才可以看到颜色。

一个整数（从 1 开始的索引），表示指定文本字段中当前可以看到的最后一行。可将文本字段看作文本块上的一个窗口。scrollV 属性是此窗口中最顶端可见行的从 1 开始的索引。

当前可以看到文本字段中 scrollV 和 bottomScrollV 表示的行之间的所有文本。

插入点（尖号）位置的索引。如果没有显示任何插入点，则在将焦点恢复到字段时，值将为插入点所在的位置（通常为插入点上次所在的位置，如果字段不曾具有焦点，则为 0）。

选择范围索引是从零开始的（例如，第一个位置为 0、第二个位置为 1，依此类推）。

一个布尔值，指定是否删除具有 HTML 文本的文本字段中的额外空白（空格、换行符等等）。默认值为 false。condenseWhite 属性只影响使用 htmlText 属性（而非 text 属性）设置的文本。如果使用 text 属性设置文本，则忽略 condenseWhite。

如果 condenseWhite 设置为 true，请使用标准 HTML 命令（如 <BR> 和 <P>），将换行符放在文本字段中。

在设置 htmlText 属性之前设置 condenseWhite 属性。

指定应用于新插入文本（例如，用户输入的文本或使用 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。

注意：如果对文本字段应用了样式表，则不能设置该属性。

指定文本字段是否是密码文本字段。如果此属性的值为 true，则文本字段被视为密码文本字段，并使用星号而不是实际字符来隐藏输入的字符。如果为 false，则不会将文本字段视为密码文本字段。启用密码模式时，“剪切”和“复制”命令及其对应的键盘快捷键将不起作用。此安全机制可防止不良用户使用快捷键在无人看管的计算机上破译密码。

指定此对象是否接收 doubleClick 事件。默认值为 false，这意味着在默认情况下，InteractiveObject 实例不接收 doubleClick 事件。如果将 doubleClickEnabled 属性设置为 true，实例在其范围内接收 doubleClick 事件。InteractiveObject 实例的 mouseEnabled 属性也必须设置为 true，以便对象能够接收 doubleClick 事件。

设置此属性不会调度任何事件。必须使用 addEventListener() 方法为 doubleClick 事件添加事件侦听器。

指定是否使用嵌入字体轮廓进行呈现。如果为 false，则 Flash Player 使用设备字体呈现文本字段。

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

指定此对象是否显示焦点矩形。它可以采用三个值中的一个：true、false 或 null。true 和 false 值按预期工作，指定是否显示焦点矩形。null 值表示此对象遵循舞台的 stageFocusRect 属性。

用于此文本字段的网格固定类型。仅在文本字段的 flash.text.AntiAliasType 属性设置为 flash.text.AntiAliasType.ADVANCED 时才应用此属性。

使用的网格固定类型确定了 Flash Player 是否强制让粗水平线和垂直线适合像素网格或子像素网格。

对于 flash.text.GridFitType 属性，您可以使用下列字符串值：

包含文本字段内容的 HTML 表示形式。

Flash Player 支持以下 HTML 标签：

Flash Player 和 AIR 支持以下 HTML 实体：

Flash Player 和 AIR 还支持显式字符代码，如 &（ASCII 和号）和 €（Unicode € 符号）。

如果为 true，paddingLeft 和 paddingRight 样式不会在组件文本周围添加空间。

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

文本字段中的字符数。如 tab (\t) 之类的字符视为一个字符。

文本字段中最多可包含的字符数（即用户输入的字符数）。脚本可以插入比 maxChars 允许的字符数更多的文本；maxChars 属性仅表示用户可以输入多少文本。如果此属性的值为 0，则用户可以输入无限数量的文本。

scrollH 的最大值。

scrollV 的最大值。

指定此对象是否接收鼠标或其他用户输入、消息。默认值为 true，这表示默认情况下，显示列表上的任何 InteractiveObject 实例都会接收鼠标事件或其他用户输入事件。如果将 mouseEnabled 设置为 false，则实例将不接收任何鼠标事件（或其他用户输入事件，例如键盘事件）。显示列表上的该实例的任何子级都不会受到影响。要更改显示列表上对象的所有子级的 mouseEnabled 行为，请使用 flash.display.DisplayObjectContainer.mouseChildren。

设置此属性不会调度任何事件。您必须使用 addEventListener() 方法才能创建交互式功能。

一个布尔值，表示当用户单击某个文本字段并滚动鼠标滚轮时，Flash Player 是否自动滚动多行文本字段。默认情况下，此值为 true。如果您想让文本字段在用户滚动鼠标滚轮时不随之滚动，或要实现您自己的文本字段滚动方式，可以使用此属性。

表示字段是否为多行文本字段。如果值为 true，则文本字段为多行文本字段；如果值为 false，则文本字段为单行文本字段。在类型为 TextFieldType.INPUT 的字段中，multiline 值将确定 Enter 键是否创建新行（如果值为 false，则将忽略 Enter 键）。如果将文本粘贴到其 multiline 值为 false 的 TextField 中，则文本中将除去新行。

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

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

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

定义多行文本字段中的文本行数。如果 wordWrap 属性设置为 true，则在文本自动换行时会增加行数。

表示用户可输入到文本字段中的字符集。如果 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";
     

当前水平滚动位置。如果 scrollH 属性为 0，则不能水平滚动文本。此属性值是一个以像素为单位表示水平位置的整数。

水平滚动的单位是像素，而垂直滚动的单位是行。水平滚动以像素计量是因为您通常使用的大多数字体都是按比例隔开的；这意味着字符可以有不同的宽度。Flash Player 按行进行垂直滚动是因为用户通常希望看到完整的一行文本，而不是一行的局部。即使一行中包含多种字体，行的高度也会调整到与使用的最大字体相适合。

注意： scrollH 属性是从 0 开始的，不像 scrollV 垂直滚动属性是从 1 开始的。

文本在文本字段中的垂直位置。scrollV 属性可帮助用户定位到长篇文章的特定段落，还可用于创建滚动文本字段。

垂直滚动的单位是行，而水平滚动的单位是像素。如果显示的第一行是文本字段中的第一行，则 scrollV 设置为 1（而非 0）。水平滚动以像素计量是因为大多数字体都是按比例隔开的；这意味着字符可以有不同的宽度。Flash 按行进行垂直滚动是因为用户通常希望看到完整的一行文本，而不是一行的局部。即使一行上有多种字体，行的高度也会调整到与使用的最大字体相适合。

一个布尔值，表示文本字段是否可选。值 true 表示文本可选。selectable 属性控制文本字段是否可选，而不控制文本字段是否可编辑。动态文本字段即使不可编辑，它也可能是可选的。如果动态文本字段是不可选的，则用户不能选择其中的文本。

如果 selectable 设置为 false，则文本字段中的文本不响应来自鼠标或键盘的选择命令，并且不能使用“复制”命令复制文本。如果 selectable 设置为 true，则可以使用鼠标或键盘选择文本字段中的文本，并且可以使用“复制”命令复制文本。即使文本字段是动态文本字段而不是输入文本字段，您也可以用这种方式选择文本。

当前所选内容中第一个字符从零开始的字符索引值。例如，第一个字符的索引值是 0，第二个字符的索引值是 1，依此类推。如果未选定任何文本，此属性为 caretIndex 的值。

当前所选内容中最后一个字符从零开始的字符索引值。例如，第一个字符的索引值是 0，第二个字符的索引值是 1，依此类推。如果未选定任何文本，此属性为 caretIndex 的值。

此文本字段中字型边缘的清晰度。仅在文本字段的 flash.text.AntiAliasType 属性设置为 flash.text.AntiAliasType.ADVANCED 时才应用此属性。sharpness 的范围是从 -400 到 400 的一个数字。如果尝试将 sharpness 设置为该范围外的值，则 Flash 会将该属性设置为范围内最接近的值（-400 或 400）。

将样式表附加到文本字段。有关创建样式表的信息，请参阅 StyleSheet 类和《ActionScript 3.0 开发人员指南》。

您可以随时更改与文本字段相关的样式表。如果更改使用中的样式表，会使用新的样式表重绘文本字段。您可以将样式表设置为 null 或 undefined 以删除此样式表。如果删除正在使用的样式表，则不使用样式表重绘文本字段。

注意：如果删除样式表，则 TextField.text 和 TextField.htmlText 的内容都将体现先前由该样式表应用的格式。要保留不带格式的原始 TextField.htmlText 内容，请在删除样式表前将该值保存在变量中。

指定此对象是否遵循 Tab 键顺序。如果该对象遵循 Tab 键顺序，值为 true；否则值为 false。默认情况下，值为 false，但以下情况除外：

• 对于 SimpleButton 对象，值为 true。
• 对于具有 type = "input" 的 TextField 对象，值为 true。
• 对于具有 buttonMode = true 的 Sprite 对象或 MovieClip 对象，值为 true。

指定 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;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

作为文本字段中当前文本的字符串。各行之间用回车符（'\r'，即 ASCII 13）分隔。此属性包含文本字段中的无格式文本，不带 HTML 标签。

要获取 HTML 形式的文本，请使用 htmlText 属性。

注意：如果将样式表应用到文本字段，text 属性的内容将按 HTML 解释。

文本字段中文本的颜色（采用十六进制格式）。十六进制颜色系统使用六位数表示颜色值。每位数有 16 个可能的值或字符。字符范围从 0 到 9，然后从 A 到 F。例如，黑色是 0x000000；白色是 0xFFFFFF。

文本的高度，以像素为单位。

文本的宽度，以像素为单位。

此文本字段中字型边缘的粗细。仅在 flash.text.AntiAliasType 设置为 flash.text.AntiAliasType.ADVANCED 时才可应用此属性。

thickness 的范围是从 -200 到 200 的一个数字。如果要尝试将 thickness 设置为该范围外的值，则该属性会设置为范围内最接近的值（-200 或 200）。

文本字段的类型。以下 TextFieldType 常量中的任一个：TextFieldType.DYNAMIC（指定用户无法编辑的动态文本字段），或 TextFieldType.INPUT（指定用户可以编辑的输入文本字段）。

指定在复制和粘贴文本时是否同时复制和粘贴其格式。如果设置为 true，则在文本字段之间复制和粘贴时，Flash Player 也将复制和粘贴格式设置（例如，对齐方式、粗体和斜体）。复制和粘贴过程中的原始和目标文本字段必须已将 useRichTextClipboard 设置为 true。默认值为 false。

一个布尔值，表示文本字段是否自动换行。如果 wordWrap 的值为 true，则该文本字段自动换行；如果值为 false，则该文本字段不自动换行。默认值为 false。

将 newText 参数指定的字符串追加到文本字段的文本的末尾。此方法要比对 text 属性的加法赋值 (+=)（如 someTextField.text += moreText）更有效，对于包含大量内容的文本字段尤其有效。

参数

返回一个矩形，该矩形是字符的边框。

参数

在 x 和 y 参数指定的位置返回从零开始的字符索引值。

参数

如果给定一个字符索引，则返回同一段落中第一个字符的索引。

参数

返回给定 id 或已使用 <img> 标签添加到 HTML 格式文本字段中的图像或 SWF 文件的 DisplayObject 引用。<img> 标签的格式如下：

   <img src = 'filename.jpg' id = 'instanceName' >

参数

在 x 和 y 参数指定的位置返回从零开始的行索引值。

参数

返回 charIndex 参数指定的字符所在的行的索引值（从零开始）。

参数

返回特定文本行中的字符数。

参数

返回给定文本行的度量信息。

参数

返回 lineIndex 参数指定的行中第一个字符的字符索引。

参数

返回 lineIndex 参数指定的行的文本。

参数

如果给定一个字符索引，则返回包含给定字符的段落的长度。长度与段落中的第一个字符（由 getFirstCharInParagraph() 返回）有关，与传入的字符索引无关。

参数

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

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

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

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

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

参数

返回 TextFormat 对象，其中包含 beginIndex 和 endIndex 参数指定的文本范围的格式信息。在生成的 TextFormat 对象中，只设置指定的整个文本共有的属性。所有混合型属性（意味着它在文本中的不同位置有不同的值）的值都为 null。

如果没有为这些参数指定值，则此方法适用于文本字段中的所有文本。

下表描述三种可能的用法：

参数

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

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

使用 value 参数的内容替换当前所选内容。使用当前默认字符格式和默认段落格式，在当前所选内容的所在位置插入文本。不将该文本视为 HTML。

可以使用 replaceSelectedText() 方法插入和删除文本，而不破坏其余文本的字符和段落格式。

注意：如果已对文本字段应用了样式表，则此方法不起作用。

参数

将 beginIndex 和 endIndex 参数指定的字符范围替换为 newText 参数的内容。正如所设计的一样，将替换从 beginIndex 到 endIndex-1 的文本。

注意：如果已对文本字段应用了样式表，则此方法不起作用。

参数

设置文本的字体颜色。

参数

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

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

将第一个字符和最后一个字符的索引值（使用 beginIndex 和 endIndex 参数指定）指定的文本设置为所选内容。如果两个参数值相同，则此方法会设置插入点，就如同设置 caretIndex 属性一样。

参数

将 format 参数指定的文本格式应用于文本字段中的指定文本。format 的值必须是指定所需文本格式设置更改的 TextFormat 对象。只有 format 的非空属性才会应用到文本字段。不会应用 format 的设置为 null 的任何属性。默认情况下，新创建的 TextFormat 对象的所有属性都设置为 null。

注意：如果已对文本字段应用了样式表，则此方法不起作用。

setTextFormat() 方法会更改应用于文本字段中一定范围的字符或整个文本的文本格式设置。要将 format 的属性应用于文本字段中的所有文本，请不要指定 beginIndex 和 endIndex 的值。要将 format 的属性应用于一定范围的文本，请指定 beginIndex 和 endIndex 参数的值。可以使用 length 属性来确定索引值。

TextFormat 对象中包含两种类型的格式设置信息：字符级格式设置和段落级格式设置。文本字段中的每个字符都可以有自己的字符格式设置，例如字体名称、字体大小、粗体和斜体。

对于段落，通过检查段落的第一个字符可了解整个段落的格式设置。段落格式设置的示例有左边距、右边距和缩进。

对于用户手动插入的任何文本或通过 replaceSelectedText() 方法替换的任何文本，将接收默认的文本格式设置（而非为文本插入点指定的格式设置）以应用于新文本。要为新文本设置默认格式，请使用 defaultTextFormat。

参数

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

参数