UIComponent  - AS3 Flex

一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 description 属性。

getter 仅返回 accessibilityProperties.description。如果 accessibilityProperties 为 null，则返回“”。setter 先检查 accessibilityProperties 是否为 null，如果是，则将其设置为新的 AccessibilityProperties 实例。随后会设置 accessibilityProperties.description。

一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 silent 属性。

请注意，accessibilityEnabled 与 silent 相反；silent 为 false 时，accessibilityEnabled 为 true。

getter 仅返回 accessibilityProperties.silent。如果 accessibilityProperties 为 null，则返回 true。setter 先检查 accessibilityProperties 是否为 null，如果是，则将其设置为新的 AccessibilityProperties 实例。随后会设置 accessibilityProperties.silent。

一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 name 属性。

getter 仅返回 accessibilityProperties.name。如果 accessibilityProperties 为 null，则返回“”。setter 先检查 accessibilityProperties 是否为 null，如果是，则将其设置为新的 AccessibilityProperties 实例。随后会设置 accessibilityProperties.name。

一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 shortcut 属性。

getter 仅返回 accessibilityProperties.shortcut。如果 accessibilityProperties 为 null，则返回“”。setter 先检查 accessibilityProperties 是否为 null，如果是，则将其设置为新的 AccessibilityProperties 实例。随后会设置 accessibilityProperties.shortcut。

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

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

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

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

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

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

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

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

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

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，baseline.s2="@Clear()" 将取消对状态 s2 中 baseline 约束的设置。或者在 ActionScript 代码中，button.baseline = undefined 将取消对 button 中 baseline 约束的设置。

默认情况下，锚点目标是容器的内容区域的上边缘。在具有高级约束的布局中，目标可以是一个约束行。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“anchorTargetName:value”将属性值设置为一个字符串，如“row1:10”。

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

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

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，bottom.s2="@Clear()" 将取消对状态 s2 中 botton 约束的设置。或者在 ActionScript 代码中，button.bottom = undefined 将取消对 button 中 bottom 约束的设置。

默认情况下，锚点目标是容器的内容区域。在具有高级约束的布局中，目标可以是一个约束行。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“anchorTargetName:value”将属性值设置为一个字符串，如“row1:10”。

供 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 位置。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。

匹配 CSS 伪选择器时要使用的状态。默认情况下，此状态为 currentState。

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

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

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

相关 API 元素

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

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

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

相关 API 元素

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

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

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

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

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

引用与此 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，spark.components.Scroller 组件除外。对于该组件，默认值为 false。

相关 API 元素

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

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

如果 UIComponent 具有任何非平移 (x,y) 转换属性，则返回 true。

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

注意：此属性与 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。

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

相关 API 元素

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

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

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

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

设置此属性将导致 resize 事件被调度。有关何时调度此事件的详细信息，请参阅 resize 事件。

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

相关 API 元素

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，horizontalCenter.s2="@Clear()" 将取消对状态 s2 中 horizontalCenter 约束的设置。或者在 ActionScript 代码中，button.horizontalCenter = undefined 将取消对 button 中 horizontalCenter 约束的设置。

默认锚点目标是容器本身。

在具有高级约束的布局中，锚点目标可以是一个约束列。那么，内容区域就是前一列（或容器侧）与目标列之间的空间。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“constraintColumnId:value”将属性值设置为一个字符串，如“col1:10”。

组件 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] 的形式对其引用。

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

如果此 UIComponent 实例为文档对象，则为 true。这意味着该对象位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。

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

用于相对于其同级组件计算组件的布局的转换矩阵。此矩阵由组件的 3D 属性（包括诸如 x、y、rotation、scaleX、scaleY、transformX 和 transformY 以及 rotationX、rotationY、scaleZ、z 和 transformZ 等 2D 属性）定义。

大多数组件上并未设置任何 3D 转换属性。

该布局矩阵与 postLayoutTransformOffsets 属性的值相结合用于确定组件的最终计算矩阵。

相关 API 元素

对于组件，此布局约束属性是基于类似命名的样式的外观。要将 MXML 中属性的状态特定的值设置为其默认值 undefined，请使用 @Clear() 指令。例如，在 MXML 代码中，left.s2="@Clear()" 将取消对状态 s2 中 left 约束的设置。或者在 ActionScript 代码中，button.left = undefined 将取消对 button 中 left 约束的设置。

默认情况下，锚点目标是容器的内容区域。在具有高级约束的布局中，目标可以是一个约束列。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“anchorTargetName:value”将属性值设置为一个字符串，如“col1:10”。