UITextField  - AS3 Flex

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

如果此组件启用了自动化，则为 true；否则为 false。

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

用于自动化目的的此组件的所有者。

用于自动化目的的此组件的父级。

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

如果此组件对于自动化是可见的，则为 true；否则为 false。

首行文本基线的 y 坐标。

此实例的类的名称，如 "DataGridItemRenderer"。

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

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

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

默认值为 true。

相关 API 元素

一个标志，用于指示当组件获得焦点时是否应启用 IME。

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

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

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

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

默认值为 NaN。

相关 API 元素

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

默认值为 NaN。

相关 API 元素

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

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

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

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

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

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

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

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

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

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

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

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

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

默认值为 true。

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

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

默认值为 null。

相关 API 元素

指定此组件是否包含在父容器的布局中。如果为 true，则该对象将包含在其父容器的布局中，并由其父容器根据其布局规则调整其大小并确定其位置。如果为 false，则对象的父容器的布局不影响该对象的大小和位置。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

默认值为 parent 属性的值。

此组件的父容器或组件。

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

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

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

在 Spark 布局中使用时，该属性用于计算组件在缩放和旋转之后的边界高度。例如，如果组件旋转 90 度，则指定 percentHeight 将影响组件宽度。

以组件父代大小百分比的方式指定组件宽度。允许的值为 0-100。默认值为 NaN。设置 width 或 explicitWidth 属性会将此属性重置为 NaN。

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

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

在 Spark 布局中使用时，该属性用于计算组件在缩放和旋转之后的边界宽度。例如，如果组件旋转 90 度，则指定 percentWidth 将影响组件高度。

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

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

如果是 String，则它是 <fx:Style> 标签或 CSS 文件中一个或多个空格分隔类声明的名称。您不能在 styleName 中使用句号。例如，如果您使用名为 ".bigText" 的类样式，请将 styleName 属性设置为 "bigText"（无句号）。

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

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

要在 ToolTip 中显示的文本。

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

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

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

构造函数。

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

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

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

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

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

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

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

参数

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

相关 API 元素

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

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

相关 API 元素

初始化此组件。

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

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

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

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

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

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

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

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

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

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

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

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

参数

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

参数

相关 API 元素

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

参数

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

参数

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

参数

设置文本的字体颜色。

参数

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

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

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

参数

设置 UITextField 对象的 visible 属性。

参数

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

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

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

参数

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

参数

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