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

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

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

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

从内容区域顶边到组件基线位置的垂直距离（以像素为单位）。如果设置了此属性，组件的基线将锚定在其内容区域的顶边；当调整其容器大小时，这两条边始终相互独立。

仅当作用于 Canvas 容器中的组件时，或作用于 Panel 或 Application 容器中将 layout 属性设置为 absolute 的组件时，此属性才起作用。

默认值为 undefined，即不进行设置。

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

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

从组件底边到其内容区域底边之间的垂直距离（以像素为单位）。如果设置了此属性，组件的底边将锚定在其内容区域的底边；当调整其容器大小时，这两条边始终相互独立。

仅当作用于 Canvas 容器中的组件时，或作用于 Panel 或 Application 容器中将 layout 属性设置为 absolute 的组件时，此属性才起作用。

默认值为 undefined，即不进行设置。

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

用作边框的对象的名称。

边框是一个对象，供 Flex 用于确定组件大小。实际内容可能大于边框，也可能小于边框，但 Flex 在布置组件时将使用边框大小。此对象是可选的。如果省略了此对象，则使用组件的实际内容大小。

默认值为 "boundingBox".

未经缩放的内容范围。

供 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.

此组件的当前状态。对于 UIMovieClip，currentState 属性的值是当前的帧标签。

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

另请参见

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

在组件坐标中显式指定的组件高度（以像素为单位）。如果没有显式指定的高度，则值为 NaN。

另请参见

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

另请参见

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

另请参见

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

另请参见

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

另请参见

在组件坐标中显式指定的组件宽度（以像素为单位）。如果没有显式指定的宽度，则值为 NaN。

另请参见

一个标志，用于指示组件处于选中状态时是否可以获得焦点。

如果组件中的子组件实现了 IFocusManagerComponent 接口，但是您从不希望它获得焦点，作为一种优化，您可以先将 focusEnabled 设置为 false，然后再在子组件上调用 addChild()。

这将使 FocusManager 忽略此组件，并且使它不会对组件进行监视以查看 tabEnabled、tabChildren 和 mouseFocusEnabled 属性是否发生更改。这也意味着 addChild() 之后，您无法更改此值，也不能指望 FocusManager 进行监视。

注意：这并不意味着您无法在 setFocus() 方法中以编程方式使此对象获得焦点；它仅通知 FocusManager 在 Tab 和鼠标搜索中忽略此 IFocusManagerComponent 组件。

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

另请参见

此对象的高度（以像素为单位）。

从组件内容区域的中心到组件中心的水平距离（以像素为单位）。如果设置了此属性，组件的中心将锚定在其内容区域的中心；当调整其容器大小时，这两个中心在水平方向上始终相互独立。

仅当作用于 Canvas 容器中的组件时，或作用于 Panel 或 Application 容器中将 layout 属性设置为 absolute 的组件时，此属性才起作用。

默认值为 undefined，即不进行设置。

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

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

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

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

默认值为 true.

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

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

从组件内容区域的左边到组件左边之间的水平距离（以像素为单位）。如果设置了此属性，组件的左边将锚定在其内容区域的左边；当调整其容器大小时，这两条边始终相互独立。

仅当作用于 Canvas 容器中的组件时，或作用于 Panel 或 Application 容器中将 layout 属性设置为 absolute 的组件时，此属性才起作用。

默认值为 undefined，即不进行设置。

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

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

另请参见

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

另请参见

此对象的测量高度。

通常为图形外观硬编码此属性，因为此数字只是图形中的像素数目。对于代码外观来说，如果希望以特定大小进行绘制，也可以对其进行硬编码。如果此大小可以随属性更改，您可能还希望是 ILayoutManagerClient，以便在适当时调用 measure() 方法，从而能够计算 measuredHeight。

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

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

此对象的测量宽度。

通常为图形外观硬编码此属性，因为此数字只是图形中的像素数目。对于代码外观来说，如果希望以特定大小进行绘制，也可以对其进行硬编码。如果此大小可以随属性更改，您可能还希望是 ILayoutManagerClient，以便在适当时调用 measure() 方法，从而能够计算 measuredHeight。

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

另请参见

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

另请参见

一个标志，用于当使用鼠标选中组件时组件是否可以获得焦点。如果为 false，焦点将转移到第一个 mouseFocusEnabled 父项。

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

通常为此组件的父容器。但是，如果这是一个弹出组件，则所有者为弹出该组件的组件。例如，ComboBox 控件下拉列表的所有者是 ComboBox 控件本身。此属性并非由 Flex 管理，而由各个组件管理。因此，如果弹出一个组件，则应对此属性进行相应的设置。

包含此组件的文档。

以组件父项大小百分比的方式指定组件高度的数字。允许的值为从 0 到 100。

以组件父项大小百分比形式指定其宽度的数字。允许的值为从 0 到 100。

从组件右边到其内容区域右边之间的水平距离（以像素为单位）。如果设置了此属性，组件的右边将锚定在其内容区域的右边；当调整其容器大小时，这两条边始终相互独立。

仅当作用于 Canvas 容器中的组件时，或作用于 Panel 或 Application 容器中将 layout 属性设置为 absolute 的组件时，此属性才起作用。

默认值为 undefined，即不进行设置。

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

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

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

对此组件的 SystemManager 对象的引用。

要在 ToolTip 中显示的文本。

默认值为 null.

从控件内容区域的顶边到组件顶边之间的垂直距离（以像素为单位）。如果设置了此属性，组件的顶边将锚定在其内容区域的顶边；当调整其容器大小时，这两条边始终相互独立。

仅当作用于 Canvas 容器中的组件时，或作用于 Panel 或 Application 容器中将 layout 属性设置为 absolute 的组件时，此属性才起作用。

默认值为 undefined，即不进行设置。

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

由 EffectManager 使用。如果组件不使用 EffectManager 执行 Tween，则返回非空值。

从组件内容区域的中心到组件中心的垂直距离（以像素为单位）。如果设置了此属性，组件的中心将锚定在其内容区域的中心；当调整其容器大小时，这两个中心在垂直方向上始终相互独立。

仅当作用于 Canvas 容器中的组件时，或作用于 Panel 或 Application 容器中将 layout 属性设置为 absolute 的组件时，此属性才起作用。

默认值为 undefined，即不进行设置。

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

此对象的宽度（以像素为单位）。

构造函数。

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

参数

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

参数

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

参数

当组件获得焦点时，由 FocusManager 调用。组件应该绘制或隐藏表示组件具有焦点的图形。

参数

监视转换过程中大小和进度变化的主函数。

参数

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

参数

以递归方式查找所有 tabEnabled=true 的子项，并将它们添加到 focusableObjects 数组。

参数

当焦点进入我们的任一子项时调用。确保调用了焦点事件处理程序，以便从 Flex 焦点管理器进行控制。

参数

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

参数

返回指定的约束值。

参数

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

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

初始化对象。

另请参见

将此对象移动到指定的 x 和 y 坐标。

参数

通知父项大小已更改。

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

参数

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

参数

对于每个效果事件，注册 EffectManager 作为其中一个事件侦听器。

参数

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

参数

使用提供的 ID 解析子项。ID 是 createAutomationIDPart() 方法提供的一组属性。

参数

设置此对象的实际大小。

此方法主要用于实现 updateDisplayList() 方法。在此期间，您可以根据其显式大小、相对于父项的（百分比）大小以及度量大小计算此对象的实际大小。然后，通过调用 setActualSize() 将此实际大小应用于对象。

在其它情况下，您应该设置 width、height、percentWidth 或 percentHeight 属性，而非调用此方法。

参数

设置指定的约束值。

参数

当组件获得焦点时，由 FocusManager 调用。同样，该组件可以将焦点设置给某个内部组件。

当 visible 属性发生更改时调用。您应设置 visible 属性来显示或隐藏组件，而不是直接调用此方法。

参数

使用 addChild() 或 addChildAt() 方法将组件作为内容子项添加到容器时调度。如果已使用 rawChildren.addChild() 或 rawChildren.addChildAt() 方法将该组件作为非内容子项添加到容器，则不会调度此事件。

事件对象的属性有下列值：

当组件完成构建时调度。对于基于 Flash 的组件，同时还将调度 initialize 事件。

事件对象的属性有下列值：

视图状态更改后调度。

事件对象的属性有下列值：

在 currentState 属性更改后但视图状态更改前调度。

事件对象的属性有下列值：

在拖动操作完成时（将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时）由拖动启动器（作为要拖动的数据源的组件）调度。

您可以使用此事件执行拖放操作的任意最终清理。例如，将 List 控件项目从一个列表拖动到另一个列表时，如果不再需要此 List 控件项目，则可以将其从源列表中删除。

将数据从一个 Tree 控件拖动到另一个控件时，如果在 Tree 控件 dragComplete 事件的事件处理函数调用 Event.preventDefault()，它将阻止该放置操作。

事件对象的属性有下列值：

用户在放置目标上释放鼠标时由放置目标调度。

可以使用此事件处理函数将拖动数据添加到放置目标。

将数据从一个 Tree 控件拖动到另一个控件时，如果在 Tree 控件 dragDrop 事件的事件处理函数调用 Event.preventDefault()，它将阻止该放置操作。

事件对象的属性有下列值：

当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时，由该组件调度。

为使放置目标有效，您必须为此事件定义处理函数。在处理函数中，您可以通过更改放置目标的外观向用户提供可视反馈，即组件可以接受此拖动。例如，您可以围绕放置目标绘制一个边框，或者为放置目标提供焦点。

如果希望接受拖动，您必须调用 DragManager.acceptDragDrop() 方法。如果不调用 acceptDragDrop()，您将无法获得其它任何拖动事件。

action 属性的值始终是 DragManager.MOVE，即使用户执行的是复制操作也不例外。这是因为在控件识别出已按下 Ctrl 键来指示复制之前，即已发生 dragEnter 事件。dragOver 事件的事件对象的 action 属性确实包含指示拖动操作类型的值。

您可以通过调用 DragManager.showFeedback() 方法来更改拖动操作的类型。

事件对象的属性有下列值：

另请参见

用户在组件外拖动但没有将数据放置到目标时，由组件调度。

如果在处理 dragEnter 或 dragOver 事件时修改了放置目标的外观，则可以使用此事件将放置目标还原为正常外观。

事件对象的属性有下列值：

在拖动操作期间，当用户在鼠标位于组件上方的情况下移动鼠标时，由组件调度。

在处理函数中，您可以通过更改放置目标的外观向用户提供可视反馈，即组件可以接受此拖动。例如，您可以围绕放置目标绘制一个边框，或者为放置目标提供焦点。

您应该对此事件进行处理，从而在允许放置之前执行其它逻辑，例如，将数据放置在放置目标中的各不同位置，读取键盘输入以确定拖放操作是拖动还是复制拖放数据，或者根据拖放操作类型提供不同类型的可视反馈。

您还可以通过更改 DragManager.showFeedback() 方法来更改拖动操作的类型。action 属性的默认值为 DragManager.MOVE。

事件对象的属性有下列值：

另请参见

当对象的状态从可见变为不可见时调度。

事件对象的属性有下列值：

当组件完成构建并设置了所有初始化属性后调度。

事件对象的属性有下列值：

当用户在使用 PopUpManager 打开的某个组件外部单击时，从该组件调度。

事件对象的属性有下列值：

当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时，从该组件调度。

事件对象的属性有下列值：

移动对象后调度。

您可以通过以下方法移动组件：设置 x 或 y 属性、调用 move() 方法，在该组件上或其它组件上设置下列属性以使 LayoutManager 更改该组件的 x 或 y 属性：

• minWidth
• minHeight
• maxWidth
• maxHeight
• explicitWidth
• explicitHeight

调用 move() 方法时，将在此方法返回之前调度 move 事件。在其它所有情形下，在该属性更改之前都不会调度 move 事件。

事件对象的属性有下列值：

在组件初始化序列开始时调度。调度此事件时，组件恰处于原始状态。许多组件（如 Button 控件）可创建内部子组件来实现功能；例如，Button 控件可创建内部 UITextField 组件来呈现其标签文本。当 Flex 调度 preinitialize 事件时，尚未创建组件的子项（包括内部子项）。

事件对象的属性有下列值：

使用 removeChild() 或 removeChildAt() 方法将组件作为内容子项从容器中删除时调度。如果已使用 rawChildren.removeChild() 或 rawChildren.removeChildAt() 方法将组件作为非内容子项从容器中删除，则不会调度此事件。

事件对象的属性有下列值：

在调整组件大小时调度。

您可以通过以下方法调整组件大小：设置 width 或 height 属性、调用 setActualSize() 方法、在该组件上或其它组件上设置下列属性之一以使 LayoutManager 需要更改该组件的 width 或 height 属性：

• minWidth
• minHeight
• maxWidth
• maxHeight
• explicitWidth
• explicitHeight

在更改该属性之前，不会调度 resize 事件。

事件对象的属性有下列值：

当对象的状态从不可见变为可见时调度。

事件对象的属性有下列值：

要创建 ToolTip 时由组件调度。

如果创建了自己的 IToolTip 对象，并在传递到 toolTipCreate 处理函数的事件对象的 toolTip 属性中置入了对该对象的引用，则 ToolTipManager 将显示您的自定义 ToolTip。否则，ToolTipManager 将创建 ToolTipManager.toolTipClass 的实例以用于显示。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

事件对象的属性有下列值：

已隐藏组件的 ToolTip 并要将其放弃时由组件调度。

如果使用 ToolTipManager.hideEffect 属性指定了效果，则在停止播放该效果后调度此事件。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

事件对象的属性有下列值：

要隐藏组件的 ToolTip 时由组件调度。

如果使用 ToolTipManager.hideEffect 属性指定了效果，则在开始播放该效果之前调度此事件。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

事件对象的属性有下列值：

要显示组件的 ToolTip 时由组件调度。

如果使用 ToolTipManager.showEffect 属性指定了效果，则在开始播放该效果之前调度此事件。您可以使用此事件在 ToolTip 出现前对其进行修改。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

事件对象的属性有下列值：

显示组件的 ToolTip 时由组件调度。

如果使用 ToolTipManager.showEffect 属性指定了效果，则在停止播放该效果之后调度此事件。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

事件对象的属性有下列值：

用户将鼠标移动到设置了 toolTip 属性的组件上方后，由该组件调度。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

事件对象的属性有下列值：