组件上当前播放的效果列表，如 EffectInstance 实例的 Array。

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

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

IAutomationTabularData 接口的实现，可用于检索数据。

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

组件第一行文本的基线的 y 坐标。

此属性用于实现 baseline 约束样式，还可用于将 FormItem 的标签与 FormItem 中的控件对齐。

各组件应覆盖此属性。

供 Flex 使用，表示建议为对象实施位图缓存。如果 cachePolicy 为 UIComponentCachePolicy.AUTO，则 cacheHeuristic 用于控制对象的 cacheAsBitmap 属性。

指定此对象的位图缓存策略。在 MXML 中，可能值为 "on"、"off" 和 "auto"（默认值）。

在 ActionScript 中，可能值为 UIComponentCachePolicy.ON、UIComponentCachePolicy.OFF 和 UIComponentCachePolicy.AUTO（默认值）。

• 如果值为 UIComponentCachePolicy.ON，则表示对象始终作为位图缓存。
• 如果值为 UIComponentCachePolicy.OFF，则表示对象从不作为位图缓存。
• 如果值为 UIComponentCachePolicy.AUTO，则表示框架将使用试探法确定此对象是否应作为位图缓存。

默认值为 UIComponentCachePolicy.AUTO.

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

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

返回鼠标在内容坐标系中的 x 位置。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。

返回内容坐标系中鼠标的 y 位置。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。

组件的当前视图状态。将其设置为 "" 或 null 可将组件重置回其基本状态。

当您使用此属性设置组件的状态时，Flex 将应用您定义的转移。您还可以使用 setCurrentState() 方法设置当前状态，此方法可以有选择性地更改状态，而无需应用转移。

此属性可用作数据绑定的源。修改此属性后，将调度 currentStateChange 事件。

另请参见

获取控制此组件及其同级组件的光标的 CursorManager。每个顶级窗口都包含自己的 CursorManager 实例；为确保使用的实例正确，请使用此方法。

引用 UIComponentDescriptor（如果有），过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。如果此 UIComponent 实例并非基于描述符创建，则此属性为 null。

另请参见

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

指定 UIComponent 对象是否接收 doubleClick 事件。默认值为 false，即 UIComponent 对象不接收 doubleClick 事件。

还必须将 mouseEnabled 属性设置为 true（默认值），这样对象才能接收 doubleClick 事件。

默认值为 false.

组件是否可以接受用户交互。将 enabled 属性设置为 false 后，某些组件仍会响应鼠标交互，如 mouseOver。因此，要完全禁用 UIComponent，您应该将 mouseEnabled 属性的值也设置为 false。如果将容器的 enabled 属性设置为 false，则 Flex 会使该容器及其所有子项的颜色变暗，并阻止用户向容器及其所有子项输入内容。

此属性可用作数据绑定的源。修改此属性后，将调度 enabledChanged 事件。

当验证程序监视组件并且验证失败时，组件的错误提示中将显示的文本。

您可以使用 errorString 属性显示组件的验证错误，而无需实际使用 validator 类。当您将 String 值写入 errorString 属性时，Flex 将在组件周围绘制红色边框以指示验证错误，并且当您将鼠标指针移至组件上方时，该 String 将作为验证错误消息显示在工具提示中，就像验证程序检测到验证错误一样。

若要清除验证错误，请为 errorString 属性写入一个空 String ""。

请注意，为 errorString 属性写入值不会触发 valid 或 invalid 事件，只会更改边框颜色和显示验证错误消息。

此属性可用作数据绑定的源。修改此属性后，将调度 errorStringChanged 事件。

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

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 explicitHeightChanged 事件。

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

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

在布局过程中，如果应用程序开发人员明确设置了 maxHeight，则使用 explicitMaxHeight 的值。否则，使用 maxHeight 的默认值。

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

默认值为 NaN.

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMaxHeightChanged 事件。

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

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

在布局过程中，如果应用程序开发人员明确设置了 maxWidth，则使用 explicitMaxWidth 的值。否则，使用 maxWidth 的默认值。

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

默认值为 NaN.

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMaxWidthChanged 事件。

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

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

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

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

默认值为 NaN.

此属性可用作数据绑定的源。修改此属性后，将调度 explictMinHeightChanged 事件。

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

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

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

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

默认值为 NaN.

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMinWidthChanged 事件。

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

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 explicitWidthChanged 事件。

此 UIComponent 的上下文菜单。

默认值为 null.

指示切换到此组件时，是否可以接收焦点。当 UIComponent 用作另一组件的子组件时，可以将 focusEnabled 设置为 false，以便外部组件成为可获得焦点的实体。如果此属性是 false，则焦点将转换到已将 focusEnable 设置为 true 的第一个父项。

默认值为 true.

获取控制此组件及其同级组件的焦点的 FocusManager。每个弹出框都有自己的焦点循环，因此也有自己的 FocusManager 实例。为确保使用的实例正确，请使用此方法。

与此对象相关联的焦点窗格。如果对象的任一子项包含焦点，该对象将具有焦点窗格。

指定组件在父坐标中的高度的数字（以像素为单位）。默认值为 0，但当 Flex 在应用程序中设置完组件的大小后，此属性将包含实际的组件高度。

请注意：您可以在 MXMLheight 属性中指定一个百分比值（如 height="100%"），但无法在 ActionScript 的 height 属性中使用百分比值；可改用 percentHeight 属性。

设置此属性将导致 resize 事件被调度。有关何时调度此事件的详细信息，请参阅 resize 事件。如果组件的 scaleY 属性不是 100，则组件在其内部坐标中的高度将不匹配。因此，如果 100 个像素高的组件将 scaleY 设为 200，则会在父级中占用 100 个像素，但其内部高度被认为是 50 个像素。

此属性可用作数据绑定的源。修改此属性后，将调度 heightChanged 事件。

组件 ID。此值将作为对象的实例名称，因此不应包含任何空格或特殊字符。应用程序中的每个组件都应具有唯一的 ID。

如果将使用第三方工具对您的应用程序进行测试，请为每个组件赋予一个有意义的 ID。测试工具使用 ID 代表其脚本中的控件，因此使用有意义的名称可使脚本更具可读性。例如，将某个按钮的值设置为 submit_button 而不是 b1 或 button1。

指定此组件是否包含在父容器的布局中。如果为 true，则该对象包含在其父容器的布局中。如果为 false，则由其父容器按布局规则定位该对象，但计算下一子项的位置时将忽略该对象。

默认值为 true.

此属性可用作数据绑定的源。修改此属性后，将调度 includeInLayoutChanged 事件。

此组件的继承样式链的开头内容。getStyle() 方法只需访问 inheritingStyles[styleName]，即可搜索整个与原型链接的链。此对象由 initProtoChain() 设置。开发人员通常不需要直接访问此属性。

一个标志，用于确定某个对象是否已通过布局的所有三个阶段：提交、测量和布局（假设每个阶段都是必需的）。

重复组件的索引。如果组件不在 Repeater 中，则值为 -1。

一个 Array，包含从此 UIComponent 对象的父文档引用该对象所需的索引。除非 UIComponent 对象位于一个或多个 Repeater 中，否则该 Array 为空。第一个元素与最外面的 Repeater 对应。例如，如果 id 为“b”并且 instanceIndices 为 [2,4]，则在父文档中将以 b[2][4] 的形式对其引用。

确定此 UIComponent 实例是否为文档对象，也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。

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

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

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

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

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

默认值为 10000.

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMaxHeightChanged 事件。

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

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

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

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

默认值为 10000.

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMaxWidthChanged 事件。

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

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

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

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

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

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMinHeightChanged 事件。

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

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMinWidthChanged 事件。

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

单击时是否可接收焦点。如果值为 false，则焦点将转换到已将 mouseFocusEnable 设置为 true 的第一个父项。例如，您可以将某个 Button 控件的此属性设置为 false，这样可使用 Tab 键将焦点移动到该控件，但在单击该控件时不会使其获得焦点。

默认值为 true.

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

此组件的非继承样式链的开头内容。getStyle() 方法只需访问 nonInheritingStyles[styleName]，即可搜索整个与原型链接的链。此对象由 initProtoChain() 设置。开发人员通常不需要直接访问此属性。

此容器包含的自动化子项数。此和不应包含任何复合子项，尽管它在自动化层次中确实包含这些不重要的子项。

此 UIComponent 的所有者。默认情况下，它是此 UIComponent 的父项。不过，如果此 UIComponent 对象是由其父项弹出的一个子组件（如 ComboBox 控件的下拉列表），则所有者是弹出此 UIComponent 对象的组件。

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

默认值为 parent 属性的值。

此组件的父容器或组件。只有 UIComponent 对象应该具有父属性。非 UIComponent 对象应该使用其它属性引用其所属对象。一般而言，非 UIComponent 对象使用 owner 属性引用其所属对象。

引用包含此 UIComponent 实例的 Application 对象。此 Application 对象可能存在于另一应用程序的 SWFLoader 控件中，依此类推，从而形成可使用 parentApplication 遍历的 Application 对象链。Application 的 parentApplication 属性永远不会是其本身；它通常是加载该对象的 Application 或为空（对于顶级 Application）。使用 parentApplication 属性遍历应用程序链与使用 parentDocument 属性遍历文档链类似。您可以使用 Application 类的 application 属性访问顶级应用程序。

此属性可用作数据绑定的源。修改此属性后，将调度 initialize 事件。

引用此 UIComponent 的父文档对象。文档对象是位于 Flex 应用程序、MXML 组件或 AS 组件层次结构顶层的 UIComponent。对于此类 Application 对象，parentDocument 属性为空。此属性在 MXML 脚本中非常有用，可以使文档对象链提升一个层次。它有助于使用 parentDocument.parentDocument 遍历此链等。它的类型为 Object，以便创作者可以访问始祖文档对象上的属性和方法而无需进行转换。

此属性可用作数据绑定的源。修改此属性后，将调度 initialize 事件。

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

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 resize 事件。

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

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

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

此属性可用作数据绑定的源。修改此属性后，将调度 resize 事件。

临时或延迟子项创建操作后设置为 true，具体取决于发生对象。对于 Container 对象，在 createComponentsFromDescriptors() 方法结束（即 Container 对象使用其子项描述符创建子项）后，该属性设置为 true。

例如，如果 Accordion 容器使用延迟的实例化，则在用户导航到 Accordion 容器的第二个窗格并且该窗格创建其子项后，此窗格的 processedDescriptors 属性才变为 true。但是，如果 Accordion 已将 creationPolicy 属性设置为 "all"，则在应用程序启动期间此容器第二个窗格的 processedDescriptors 属性设置为 true。

非容器类都没有描述符，所以对于这些类，createChildren() 方法创建任何内部组件子项后，该属性设置为 true。

对生成此 UIComponent 的父文档中 Repeater 对象的引用。如果 UIComponent 是由单个 Repeater 对象创建的，请使用此属性，而不要使用 repeaters 属性。如果此 UIComponent 是由嵌套 Repeater 对象创建的，请使用 repeaters 属性。

如果此 UIComponent 并非由 Repeater 创建，则该属性设置为 null。

项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。如果 UIComponent 是由单个 Repeater 对象创建的，请使用此属性，而不要使用 repeaterIndices 属性。如果此 UIComponent 是由嵌套 Repeater 对象创建的，请使用 repeaterIndices 属性。

如果此 UIComponent 并非由 Repeater 创建，则该属性设置为 -1。

一个 Array，包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。除非此 UIComponent 位于一个或多个 Repeater 中，否则该 Array 为空。

Array 中的第一个元素与最外面的 Repeater 对应。例如，如果 repeaterIndices 为 [2,4]，则表示使用项目 dataProvider[2] 的外部 Repeater 和使用项目 dataProvider[4] 的内部 Repeater。

请注意，如果任一 Repeater 的 startingIndex 属性并非 0，则此属性将与 instanceIndices 属性不同。例如，即使 Repeater 从 dataProvider[4] 开始，第一个重复对象的文档引用也是 b[0]，而不是 b[4]。

一个 Array，包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。除非此 UIComponent 位于一个或多个 Repeater 中，否则该 Array 为空。第一个元素与最外面的 Repeater 对象对应。

引用管理所有应用程序本地化资源的对象。此项是 singleton 实例，实现 IResourceManager 接口。

此属性可用作数据绑定的源。修改此属性后，将调度 unused 事件。

用于指定水平缩放系数的数字。

默认值为 1.0，即不缩放对象。将 scaleX 值设为 2.0 表示对象将放大 2 倍，将 scaleX 值设为 0.5 表示对象将缩小 2 倍。

值 0.0 是无效值。不要将它设置为 0.0，但可以设置为一个很小的值，或者将 visible 属性设置为 false 来隐藏此组件。

默认值为 1.0.

此属性可用作数据绑定的源。修改此属性后，将调度 scaleXChanged 事件。

用于指定垂直缩放系数的数字。

默认值为 1.0，即不缩放对象。将 scaleY 值设为 2.0 表示对象将放大 2 倍，将 scaleY 值设为 0.5 表示对象将缩小 2 倍。

值 0.0 是无效值。不要将它设置为 0.0，但可以设置为一个很小的值，或者将 visible 属性设置为 false 来隐藏此组件。

默认值为 1.0.

此属性可用作数据绑定的源。修改此属性后，将调度 scaleYChanged 事件。

返回包含此对象的基本绘图表面大小和位置的对象。

用于确定自动化对象是否显示在自动化层次中的标志。层次中不可见的容器的子项显示为下一个最高可见父项的子项。通常，用于布局的容器（如框和画布）不显示在层次中。

如果合适，某些控件强制其子项在层次中显示。例如，List 控件将始终强制项目渲染器（包括框）显示在层次中。实现程序必须支持将此属性设置为 true。

为此组件定义的视图状态。您只能对应用程序的根或 MXML 组件的根标签指定 states 属性。如果对其它控件指定此属性，则编译器将生成错误。

存储此对象的内嵌继承样式。第一次调用该组件的 setStyle() 方法来设置继承样式时，将创建此 CSSStyleDeclaration。开发人员通常不需要直接访问此属性。

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

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

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

默认值为 null.

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

要在 ToolTip 中显示的文本。

默认值为 null.

此属性可用作数据绑定的源。修改此属性后，将调度 toolTipChanged 事件。

一个 Transition 对象 Array，其中的每个 Transition 对象都定义一组效果，用于在视图状态发生更改时播放。

另请参见

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

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

对象的唯一标识符。Flex 数据驱动的控件（包括作为 List 类的子类的所有控件）使用 UID 跟踪数据提供程序项目。

Flex 可自动创建和管理 UID。但是，有时您必须通过实现 IUID 接口来提供自己的 uid 属性，或通过提供自己的 uid 属性来提高处理效率。对于 Flex 中的大多数用途，UID 不必是全局唯一标识符，通过数据服务发送消息除外。

另请参见

用于确定组件的未缩放高度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成，还应将此高度作为参数传递到 updateDisplayList() 中。

用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成，还应将此宽度作为参数传递到 updateDisplayList() 中。

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

供验证程序用来将子字段与此组件相关联。

控制此 UIComponent 的可见性。如果为 true，则对象可见。

当设置为 true 时，此对象将调度 show 事件。当设置为 false 时，此对象将调度 hide 事件。无论在哪种情况下，对象的子项都不会生成 show 或 hide 事件，除非明确地针对该对象编写一个实现来执行此操作。

默认值为 true.

此属性可用作数据绑定的源。修改此属性后，将调度 show 事件。

指定组件在父坐标中的宽度的数字（以像素为单位）。默认值为 0，但当 Flex 在应用程序中设置完组件的大小后，此属性将包含实际的组件宽度。

请注意：您可以在 MXMLwidth 属性中指定一个百分比值（如 width="100%"），但无法在 ActionScript 的 width 属性中使用百分比值。可改用 percentWidth 属性。

设置此属性将导致 resize 事件被调度。有关何时调度此事件的详细信息，请参阅 resize 事件。如果组件的 scaleX 属性不是 1.0，则组件在其内部坐标中的宽度将不匹配。因此，如果 100 个像素宽的组件将 scaleX 设为 2，则会在父级中占用 100 个像素，但其内部宽度被认为是 50 个像素。

此属性可用作数据绑定的源。修改此属性后，将调度 widthChanged 事件。

指定组件在其父容器中的水平位置（以像素为单位）的数字。

如果组件的父级是布局容器（如 HBox、Grid 或 Form），则直接设置此属性或调用 move() 都不会有任何效果，或只有暂时的效果，因为这些容器的布局计算会将 x 位置设置为此计算结果。但当父级是 Canvas 或其它绝对定位容器时，则必须几乎始终设置 x 属性，因为这些容器的默认值为 0。

默认值为 0.

此属性可用作数据绑定的源。修改此属性后，将调度 xChanged 事件。

指定组件在其父容器中的垂直位置（以像素为单位）的数字。

如果组件的父级是布局容器（如 HBox、Grid 或 Form），则直接设置此属性或调用 move() 都不会有任何效果，或只有暂时的效果，因为这些容器的布局计算会将 x 位置设置为此计算结果。但当父级是 Canvas 或其它绝对定位容器时，则必须几乎始终设置 x 属性，因为这些容器的默认值为 0。

默认值为 0.

此属性可用作数据绑定的源。修改此属性后，将调度 yChanged 事件。

构造函数。

调整焦点矩形。

参数

这是一个内部方法，供 Flex 框架用于支持 Dissolve 效果。您无需调用或覆盖它。

排队稍后调用的函数。

在每次更新屏幕之前，Flash Player 或 AIR 都会调用为更新预定的函数集。有时，应在下次更新时调用函数，以执行为当前更新预定的其余代码。部分功能（如效果）可能会延迟排队的函数，直到功能完成为止。

参数

创建子对象后执行任何最终处理。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

删除此组件实例中的样式属性。

此操作不一定会使 getStyle() 方法返回 undefined。

参数

处理对组件设置的属性。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

您无需直接调用此方法，当您使用 addChild() 方法向容器中添加组件时，或调用组件的 invalidateProperties() 方法时，Flex 都会调用 commitProperties() 方法。应在调用 measure() 方法之前调用 commitProperties() 方法。这允许您设置 measure() 方法可能会用到的属性值。

一些组件的属性可能会影响需要创建的子对象的数目或种类，也有些组件的属性彼此之间会相互影响（例如 horizontalScrollPolicy 和 horizontalScrollPosition 属性）。通常，最好在启动时一次性处理所有这些属性以避免重复工作。

另请参见

将 Point 对象从内容坐标转换为全局坐标。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。全局坐标指定的像素位置随舞台的左上角，即应用窗口的最外侧边缘而变化。

参数

另请参见

将 Point 对象由内容坐标转换为本地坐标。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。本地坐标指定的像素位置随组件的左上角而变化。

参数

另请参见

返回标识此容器中的子项的一组属性。在应用程序的生命期内，不应更改这些值。

参数

‏‏创建组件的子对象。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

可在自身内部创建其它组件或对象的组件称为复合组件。例如，Flex ComboBox 控件实际上包含一个 TextInput 控件（用于定义 ComboBox 的文本区域）和一个 Button 控件（用于定义 ComboBox 箭头）。组件实现 createChildren() 方法以在其内部创建子对象（如其它组件）。

在 createChildren() 方法的覆盖内部，您可以调用 addChild() 方法来添加各个子对象。

您无需直接调用此方法，Flex 会调用 createChildren() 方法来响应对 addChild() 方法的调用，用以将组件添加到其父项。

另请参见

根据所用的嵌入字体使用上下文创建新对象。

此方法用于解决在将框架加载为 RSL（RSL 具有自己的 SWF 上下文）情况下，访问应用程序 SWF 中嵌入的字体问题。嵌入字体只能从创建它们的 SWF 文件上下文中访问。通过使用应用程序 SWF 上下文，RSL 可以在能够访问应用程序的嵌入字体的应用程序 SWF 上下文中创建对象。

仅当设置此对象的字体样式后才调用此方法。

参数

使用给定的 moduleFactory 创建对象。如果 moduleFactory 为 null，或者无法使用模块工厂创建对象，则重新使用 systemManager 创建对象。

参数

在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。此函数可以对一个或多个 repeater 中的象创建多维引用，如 b[2][4]。如果索引为 null，它将创建一个简单的非 Array 引用。

参数

在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。此函数可以对一个或多个 Repeater 中的对象删除多维引用，如 b[2][4]。如果索引为 null，它将删除简单的非 Array 引用。

参数

返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。

将事件调度到事件流中。事件目标是对其调用 dispatchEvent() 方法的 EventDispatcher 对象。

参数

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

UIComponent 通过创建由 focusSkin 样式指定的类实例并将其适当定位来实现此控制。

参数

通过编程方式在此外观的 Graphics 对象中绘制一个矩形。

矩形可以有圆角。其边缘使用 Graphics 对象的当前线条样式。可以使用纯色填充、渐变填充或无填充。纯色填充可以使用 Alpha 透明度。渐变填充可以为线性渐变或放射状渐变。可在沿着渐变的指定点上至多指定 15 个颜色和 Alpha 值，可为渐变指定旋转角度和转换矩阵。最后，该矩形可具有从其上切去的圆角矩形洞。

该通用矩形绘制例程被很多外观所使用。该例程调用 drawRect() 或 drawRoundRect() 方法（在 flash.display.Graphics 类中）在此外观的 Graphics 对象中进行绘制。

参数

停止在组件上播放效果实例时，由效果实例调用。您可以使用此方法还原 effectStarted() 方法在开始播放效果时对组件所做的修改，或在效果结束时，执行一些其它操作。

参数

开始在组件上播放效果实例时，由效果实例调用。作为效果的一部分，您可以使用此方法来修改组件。在效果结束时，您可以使用 effectFinished() 方法还原修改。

参数

结束组件上当前播放的所有效果。

将数据绑定到此 UIComponent 对象。MXML 容器/绑定问题 (177074) 的解决方案：覆盖 Container.executeBindings()，以便在调用 BindingManager.executeBindings() 时首选 descriptor.document 而不是 parentDocument。这样，就应始终为使用描述符创建的实例提供正确行为，并将为使用程序创建的实例提供初始行为。（在后一种情况中，可能会出现错误，也可能不出现错误。）可能会针对更新程序 1 提供更完整的修补程序，以保证非 DI 方案和重设父级组件方案中的行为均正确。

参数

打印完成后调用。对于 UIComponent 类，此方法不执行任何操作。Flex 容器将覆盖此方法以在打印后还原容器。

此方法通常不适用于应用程序开发人员。

参数

另请参见

当 UIComponent 对象获得焦点时调用的事件处理函数。如果覆盖此方法，请确保调用基类版本。

参数

当 UIComponent 对象失去焦点时调用的事件处理函数。如果覆盖此方法，请确保调用基类版本。

参数

在指定的索引位置提供自动化对象。该列表不应包含任何复合子项。

参数

查找此 UIComponent 实例的类型选择器。算法沿 superclass 链进行。例如，假设 MyButton 类扩展了 Button。MyButton 实例将先查找 MyButton 类型选择器，然后查找 Button 类型选择器。接着，将查找 UIComponent 类型选择器。（我们认为 superclass 链截止到 UIComponent，而不是 Object。）

返回一个约束布局值，这与获取此组件的约束样式的方式类似。

参数

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

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

获取当前具有焦点的对象。它可能并非此对象。请注意，此方法不一定返回具有焦点的组件。它可能返回具有焦点的组件的内部子组件。若要获取具有焦点的组件，请使用 focusManager.focus 属性。

返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目；如果此 Repeater 未重复，则返回 null。对于最外侧的 Repeater，whichRepeater 参数为 0；对于向内数的下一个 Repeater，此参数为 1，依此类推。如果尚未指定 whichRepeater，则使用最内侧的 Repeater。

参数

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

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

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

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

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

参数

另请参见

将 Point 对象由全局坐标转换为内容坐标。全局坐标指定的像素位置随舞台的左上角，即应用窗口的最外侧边缘而变化。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。

参数

另请参见

返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。

由于性能原因，该 Matrix 存储在一个静态变量中，通过调用 horizontalGradientMatrix() 和 verticalGradientMatrix() 可以重复使用此变量。因此，您应该在再次调用 horizontalGradientMatrix() 或 verticalGradientMatrix() 之前将生成的 Matrix 传递给 drawRoundRect()。

参数

完成对此组件的初始化。

此方法是您首次使用 addChild() 或 addChildAt() 向父项添加组件时所需执行的最后一段代码。它可处理一些与调度 initialize 事件相关的辅助工作。如果您正在编写组件，则无需覆盖此方法。

初始化此组件的内部结构。

初始化 UIComponent 是创建可视组件实例这一过程中的第四个步骤，首次将实例添加到父项时会自动执行此步骤。因此，您一般无需调用 initialize()；Flex 框架会从 UIComponent 的 addChild() 和 addChildAt() 方法的覆盖中为您调用它。

创建可视化组件实例过程中的第一个步骤是使用 new 运算符进行构建：

var okButton:Button = new Button();

构建完成后，新的 Button 实例是一个孤立 DisplayObject；该实例尚不包含用于显示其标签的作为子项的 UITextField，也没有父项。

第二个步骤是为新构建的实例配置适当的属性、样式和事件处理程序：

okButton.label = "OK";
      okButton.setStyle("cornerRadius", 0);
      okButton.addEventListener(MouseEvent.CLICK, clickHandler);

第三个步骤是将该实例添加到父项：

someContainer.addChild(okButton);

首次将组件添加到父项时，调用 addChild() 或 addChildAt() 会导致自动调用 initialize。

此方法首先调度 preinitialize 事件，这使利用此组件的开发人员可在创建该组件的内部结构之前改造它。接着，它会调用 createChildren() 方法来创建组件的内部结构；对于 Button，此方法将为标签创建并添加 UITextField。然后，它会调度 initialize 事件，这使开发人员可在创建组件的内部结构之后改造它。

请注意，是首次向父项附加组件的操作触发了对组件内部结构的创建。如果组件的内部结构中包含其它 UIComponent，这就是一个递归过程。在此过程中，DisplayObjects 树以每次一个叶节点的速度增长。

如果您正在编写组件，则无需覆盖此方法。

初始化此组件的辅助功能代码。

此方法由 initialize() 方法调用，用于与组件的辅助功能代码挂钩，这些代码位于 mx.accessibility 包中的单独类中。因为挂钩过程在每个子类中使用不同的静态变量，所以支持辅助功能的每个子类都必须覆盖此方法。

初始化用于跟踪此组件的重复实例的各个属性。

MXML<mx:Repeater/> 标记可能会导致创建组件的重复实例（Repeater 数据提供程序中的每个项目一个实例）。UIComponent 的 instanceIndices、repeaters 和 repeaterIndices 属性跟踪各实例来自哪个数据项目和哪个 Repeater。

此方法是内部方法，由 Flex 框架自动调用。您不必调用或覆盖它。

参数

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

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

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

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

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

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

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

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

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

通常由包含 UITextField 对象的组件覆盖，其中 UITextField 对象获取焦点。

参数

为 keyDown 事件调用的事件处理函数。如果覆盖此方法，请确保调用基类版本。

参数

为 keyUp 事件调用的事件处理函数。如果覆盖此方法，请确保调用基类版本。

参数

将 Point 对象由本地坐标转换为内容坐标。本地坐标指定的像素位置随组件的左上角而变化。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。

参数

另请参见

计算组件的默认大小和（可选）默认最小大小。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

您无需直接调用此方法，使用 addChild() 方法将组件添加到某个容器时，以及调用组件的 invalidateSize() 方法时，Flex 将调用 measure() 方法。

当设置组件的特定高度和宽度时，Flex 不会调用 measure() 方法，即使您显式调用 invalidateSize() 方法也不例外。也就是说，仅当组件的 explicitWidth 属性或 explicitHeight 属性设置为 NaN 时，Flex 才调用 measure() 方法。

覆盖此方法时，必须设置 measuredWidth 和 measuredHeight 属性以定义默认大小。您可以选择设置 measuredMinWidth 和 measuredMinHeight 属性来确定默认的最小大小。

大多数组件都会根据其显示内容以及影响内容显示的属性来计算这些值。一少部分组件只有硬编码的默认值。

measure() 的概念点供组件提供其原始或固有大小作为默认值。因此，measuredWidth 和 measuredHeight 属性应由以下几个因素确定：

• 组件需要显示的文本量。
• 文本的样式，如 fontSize。
• 组件所显示的 JPEG 图像的大小。
• 组件子项的测量大小或显式大小。
• 任何边框、边距和间隙。

某些情况下，确定默认值的方式并不固定。例如，对于一个简单的 GreenCircle 组件，可能只需在其 measure() 方法中设置 measuredWidth = 100 和 measuredHeight = 100 便可提供合理的默认大小。而在其它情况下（例如 TextArea），相应计算（例如查找合适的宽度和高度，使其刚好适合显示所有文本并拥有黄金矩形的高宽比）所耗费的时间可能会过长。

measure() 的默认实现将 measuredWidth、measuredHeight、measuredMinWidth 和 measuredMinHeight 设置为 0。

另请参见

测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标记），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。

参数

测量指定的文本，假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。

参数

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

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

参数

将样式更改传播到子项。您通常无需调用此方法。

参数

如果 owner 属性链从 child 指向此 UIComponent，则返回 true。

参数

当在父项中添加或删除 UIComponent 对象时由 Flex 调用。开发人员通常无需调用此方法。

参数

准备 IFlexDisplayObject 用于打印。对于 UIComponent 类，此方法不执行任何操作。Flex 容器将覆盖此方法，为打印做准备；例如，从打印的输出内容中删除滚动条。

此方法通常不适用于应用程序开发人员。

参数

另请参见

为此组件构建或重新构建 CSS 样式缓存；如果 recursive 参数为 true，还会为此组件的所有后代执行同样的操作。

在下列情形中，Flex 框架将调用此方法：

• 使用 addChild() 或 addChildAt() 方法将 UIComponent 添加到父项时。
• 更改 UIComponent 的 styleName 属性时。
• 使用 CSSStyleDeclaration 的 setStyle() 方法设置 CSS 选择器中的样式时。

因为构建样式缓存涉及到复杂的计算，所以若非必要，应避免更改 styleName 或设置选择器样式。

通过调用 UIComponent 的 setStyle() 方法来设置实例样式时，不会调用此方法。与设置选择器样式相比，设置实例样式的速度较快。

您无需调用或覆盖此方法。

参数