UIMovieClip  - AS3 Flex

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

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

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

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

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

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

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

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

我们是否应主动观察对 flash 对象的标签的更改。Flex currentState 属性依赖于此 flash 标签。如果将此属性设置为 true，则对于每个帧，都将查询 flash 对象的标签。如果标签已更改，则这将成为 Flex 对象的新 currentState。

注意：因为我们现在正在请求 flash 对象在每个单帧下的当前标签，所以将此属性设置为 true 可能会代价很高。

默认值为 false。

我们是否应主动观察对 flash 对象的大小的更改。如果将此属性设置为 true，则对于每个帧，都将确定 flash 对象的大小。如果大小已更改，则 flash 对象将相应地缩放以适合其显式边界（或者，如果不存在显式调整大小，则它将调整大小并通知其父代）。

注意：因为我们现在正在请求 flash 对象在每个单帧下的当前大小，所以将此属性设置为 true 可能会代价很高。

默认值为 false。

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

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

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

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

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

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

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

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

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

用作边框的对象的名称。

边框是一个对象，供 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 属性的值是当前的帧标签。

确定容器内各项目的呈示顺序。Spark 容器根据项目的 depth 属性确定这些项目的顺序，具有最低深度的项目在后面，具有较高深度的项目在前面。具有相同深度值的项目按照添加到容器中的顺序显示。

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

相关 API 元素

指定与该可视元素关联的可选 DesignLayer 实例。

当分配一个 DesignLayer 时，可视元素在最终将自身的有效可视性或透明度提交给它的支持 DisplayObject（如果适用）时，必须考虑其父层的可视性和透明度。

可视元素必须侦听来自关联层的父项发出的 layerPropertyChange 通知。当层的 effectiveAlpha 或 effectiveVisibility 发生改变时，元素必须计算其有效可视性（或透明度）且相应地应用。

该属性不应在 MXML 内直接设置。

designLayer 属性不用于 z 轴顺序控件，请参见 depth。

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

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

相关 API 元素

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

相关 API 元素

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

相关 API 元素

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

相关 API 元素

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

相关 API 元素

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

相关 API 元素

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

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

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

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

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

相关 API 元素

一个标志，指示子对象是否能够获得焦点。

注意：此属性与 Flash Player 使用的 tabChildren 属性类似。应该将 hasFocusableChildren 属性用于 Flex 应用程序。请勿使用 tabChildren 属性。

此属性通常为 false，因为大多数组件既可以自己获得焦点，也可以委托单个内部子组件获得焦点（但显示为该组件获得了焦点）。例如，TextInput 控件包含一个可成为焦点的 RichEditableText 子控件，但实际上当 RichEditableText 子组件获得焦点时，却显示为 TextInput 获得了焦点。TextInput 将 hasFocusableChildren 设置为 false，因为获得焦点的组件为 TextInput。其内部结构是一个抽象概念。

通常只有像 TabNavigator 和 Accordion 这样的导航器组件将此标志设置为 true，因为它们在按 Tab 键时获得了焦点，但焦点会在进一步按 Tab 键时转移到子容器的组件中。

默认值为 false，spark.components.Scroller 组件除外。对于该组件，默认值为 true。

默认值为 true。

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

如果元素具有 3D 矩阵，则为 true。

使用 hasLayoutMatrix3D，而不是调用和检查 getLayoutMatrix3D() 的返回值，因为该方法会返回一个有效的矩阵，即使元素是 2D 的也是如此。

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

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

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

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

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

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

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

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

默认值为 true。

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

当元素为 3D 时，则为 true。元素也可以是 3D 的，因为它具有 3D 转换属性或 3D 布局后转换偏移，或二者都有。

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

指定元素的所需布局方向：LayoutDirection.LTR（从左到右）、LayoutDirection.RTL（从右到左）或 null（继承）。此属性通常按继承样式回退。如果指定 null，则 layoutDirection 样式将设置为 undefined。类似 GraphicElement 的类（实现 ILayoutDirectionElement，但不支持样式）必须另外针对此属性支持 null 值，这意味着 layoutDirection 必须从其父代继承。

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

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

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

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

如果为 true，则该组件将使其投影矩阵在其边框的中央保持居中。如果未在组件上定义投影矩阵，则会自动添加一个。

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

相关 API 元素

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

相关 API 元素

此对象的测量高度。

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

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

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

此对象的测量宽度。

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

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

相关 API 元素

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

相关 API 元素

模块工厂用作上下文，用于为组件使用嵌入字体，和查找用于控制样式的样式管理器。

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

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

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

包含此组件的文档。

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

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

定义一组调整，可以使用一种对组件父项的布局不可见的方式将这些调整应用到组件的转换。例如，如果希望某个布局为将旋转 90 度的某个组件进行调整，请设置该组件的 rotation 属性。如果不希望布局为要旋转的组件进行调整，请设置其 postLayoutTransformOffsets.rotationZ 属性。

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

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

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

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

表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。例如，my_video.rotation = 450语句与 my_video.rotation = 90 是相同的。

表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。在计算过程中，Flex 的任一 2D 布局都会忽略此属性。

表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。在计算过程中，Flex 的任一 2D 布局都会忽略此属性。

表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。

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

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

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

默认值为 1.0。

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

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

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

默认值为 1.0。

指定沿着 z 轴的缩放因子的数值。

沿着 z 轴缩放不会影响在 z=0 平面中保持平放的典型组件。具有已应用 3D 转换的子项的组件，或具有非零 transformZ 的组件，将受到影响。

默认值为 1.0，即不缩放对象。

在计算过程中，Flex 的任一 2D 布局都会忽略此属性。

默认值为 1.0。

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

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

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

一个标志，指示子对象是否能够获得焦点

这与 Flash Player 使用的 tabEnabled 属性类似。

对于处理键盘输入的组件该标志通常为 true，但是控件栏中的一些组件将其设置为 false，因为它们不能像编辑器一样从另外的组件窃取焦点。

默认值为 true。

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

要在 ToolTip 中显示的文本。

默认值为 null。

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

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

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

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

设置组件转换中心的 x 坐标。

当该组件为 Spark 转换效果的目标时，可以通过设置 AnimateTransform.autoCenterTransform 属性来覆盖该属性。如果 autoCenterTransform 为 false，则转换中心由效果目标的 transformX、transformY 和 transformZ 属性决定。如果 autoCenterTransform 为 true，则效果出现在目标中心 (width/2, height/2) 附近。

在 Spark 效果类上设置该属性会覆盖目标组件上的设置。

设置组件转换中心的 y 坐标。

当该组件为 Spark 转换效果的目标时，可以通过设置 AnimateTransform.autoCenterTransform 属性来覆盖该属性。如果 autoCenterTransform 为 false，则转换中心由效果目标的 transformX、transformY 和 transformZ 属性决定。如果 autoCenterTransform 为 true，则效果出现在目标中心 (width/2, height/2) 附近。

在 Spark 效果类上设置该属性会覆盖目标组件上的设置。

设置组件转换中心的 z 坐标。

当该组件为 Spark 转换效果的目标时，可以通过设置 AnimateTransform.autoCenterTransform 属性来覆盖该属性。如果 autoCenterTransform 为 false，则转换中心由效果目标的 transformX、transformY 和 transformZ 属性决定。如果 autoCenterTransform 为 true，则效果出现在目标中心 (width/2, height/2) 附近。

在 Spark 效果类上设置该属性会覆盖目标组件上的设置。

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

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

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

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

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

显示对象是否可见。不可见的显示对象已被禁用。例如，如果 InteractiveObject 实例的 visible=false，则无法单击该对象。

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

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

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

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

默认值为 0。

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

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

默认值为 0。

表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。z 属性用于 3D 坐标，而不是屏幕坐标或像素坐标。

当您将显示对象的 z 属性设置为默认值 0 之外的其他值时，将自动创建一个相对应的 Matrix3D 对象，以便调整显示对象在三维中的位置和方向。在使用 z 轴时，x 和 y 属性的现有行为将从屏幕坐标或像素坐标更改为相对于 3D 父容器的位置。

例如，位于 x = 100、y = 100、z = 200 位置的 _root 的子级不在像素位置 (100,100) 处进行绘制。将在 3D 投影计算将其所置之处绘制该子级。计算方法为：

(x*cameraFocalLength/cameraRelativeZPosition, y*cameraFocalLength/cameraRelativeZPosition)

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

构造函数。

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

参数

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

参数

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

参数

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

参数

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

参数

当 width、height、x 或 y 值更改时，将使用此 enter 帧处理函数。这就是该更改可以进行延迟的原因，这样同时设置 x 和 y 仅会导致一个 change 事件。

参数

将数据绑定到此 UIComponent 对象。

参数

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

参数

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

参数

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

参数