GraphicElement  - AS3 Flex

图形元素的透明度级别。有效值为 0（完全透明）至 1（完全不透明）之间的十进制值。例如，值 .25 表示元素的不透明度为 25%。

指定此 GraphicElement 是否与其 DisplayObject 相关联，并呈示于 DisplayObject。

默认值为 false。

从锚点目标到控件的基线位置的垂直距离（以像素为单位）。

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

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

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

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

BlendMode 类中的一个值，用于指定要使用的混合模式。

默认值为 auto。

相关 API 元素

从组件的下边缘到锚点目标的下边缘的垂直距离（以像素为单位）。

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

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

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

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

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

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

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

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

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

绘制此 IGraphicElement 所在的共享 DisplayObject。

实现程序不得在此创建 DisplayObject，而应在 createDisplayObject() 方法中创建。

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

指示此 IGraphicElement 与其显示对象之间的关联。IGraphicElementContainer 管理此属性，且值是 DisplayObjectSharingMode 枚举类之一。

• DisplayObjectSharingMode.OWNS_UNSHARED_OBJECT 的值指示 IGraphicElement 专门拥有与其 displayObject 属性相对应的 DisplayObject。
• DisplayObjectSharingMode.OWNS_SHARED_OBJECT 的值指示 IGraphicElement 拥有与其 displayObject 属性相对应的 DisplayObject，但其他 IGraphicElement 也正在使用/绘制到该显示对象。根据特定实现，IGraphicElement 可能会执行显示对象的某些管理。例如，基类 GraphicElement 会清除显示对象的转换，将其可见性、Alpha 等属性重置为其默认值，且还清除每个 validateDisplayList() 调用上的图形。
• DisplayObjectSharingMode.USES_SHARED_OBJECT 的值指示 IGraphicElement 绘制到与其 displayObject 属性相对应的 DisplayObject。存在一个或多个绘制到相同 displayObject 的 IGraphicElement，且绘制的第一个元素将其模式设置为 DisplayObjectMode.OWNS_SHARED_OBJECT

GraphicElement 在其中绘制的实际 DisplayObject。这通常等效于 displayObject 属性。子类应该在此属性上（而不是在 displayObject 上）执行绘制命令。

应该绘制元素的 x 位置。

应该绘制元素的 y 位置。

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

相关 API 元素

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

相关 API 元素

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

相关 API 元素

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

相关 API 元素

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

相关 API 元素

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

相关 API 元素

包含当前与图形元素关联的每个滤镜对象的索引数组。mx.filters 包中的类定义了可使用的特定滤镜。

getter 返回滤镜数组的副本。filters 属性值仅可以通过 setter 进行更改。

相关 API 元素

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

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

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

图形元素的高度。

默认值为 0。

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

从组件中心到锚点目标的内容区域中心的水平距离（以像素为单位）。

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

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

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

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

组件的标识。

指定此元素是否包含在父代的布局中。

默认值为 true。

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

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

包含 GraphicElement 实现转换和分层支持的方法的所有实现细节。大多数情况下，应该不必修改此属性。

从组件的左边缘到锚点目标的左边缘的水平距离（以像素为单位）。

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

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

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

控制发光度遮罩是否剪辑设置了遮罩的内容的属性。只有图形元素应用了类型为 MaskType.LUMINOSITY 的遮罩，此属性才会起作用。

默认值为 false。

相关 API 元素

控制计算由发光度遮罩设置遮罩的图形元素的 RGB 颜色值的属性。如果为 true，则遮罩中的相应区域将反转并乘以源内容中像素的 RGB 颜色值。如果为 false，则直接使用源内容中像素的 RGB 颜色值。

默认值为 false。

相关 API 元素

调用显示对象被指定的 mask 对象遮罩。如果遮罩显示对象不在显示列表上，则会将其作为 displayObject 的子项添加到显示列表中。但不绘制 mask 对象本身。将 mask 设置为 null 可删除遮罩。若要将另一个 GraphicElement 用作遮罩，请在 Group 或其他容器中包装 GraphicElement。

相关 API 元素

定义将遮罩应用到 GraphicElement 的方式。

可能的值为 MaskType.CLIP、MaskType.ALPHA 和 MaskType.LUMINOSITY。

剪辑遮罩

遮罩处于剪辑模式下时，会将剪辑遮罩减少至 1 位。这意味着遮罩将不会影响源内容中像素的不透明度；它要么保留值不进行修改（如果遮罩中的相应像素具有非零 Alpha 值），要么使其完全透明（如果遮罩像素值为零 Alpha 值）。

使用剪辑遮罩时，仅遮罩定义的实际路径与形状矢量和填充用于确定源内容上的效果。会忽略遮罩上定义的笔触和位图滤镜。会将遮罩中任何填充的区域认为已填充，并呈示源内容。填充的类型和参数不相关；遮罩中的纯色填充、渐变填充或位图填充将全部呈示基础源内容，而与遮罩填充的 Alpha 值无关。

在剪辑遮罩中使用时，BitmapGraphics 被视为位图填充的矩形。结果，当遮罩的一部分（位图）按与相等尺寸的纯色填充矩形相同的方式影响遮罩时，源位图的 Alpha 通道不相关。

Alpha 遮罩

在 Alpha 模式下，会将源内容中的每个像素的不透明度与遮罩的相应区域的不透明度相乘。即，对于由不透明度为 0.5 的区域遮罩的、源内容中不透明度为 1 的像素，其结果不透明度将为 0.5。对于由不透明度为 0.5 的区域遮罩的、不透明度为 0.8 的源像素，其结果不透明度为 0.4。

从概念上讲，Alpha 遮罩等效于将转换的遮罩和源内容呈示到单独的 RGBA 表面中，并将遮罩内容的 Alpha 通道与源内容的 Alpha 通道相乘。在合成到源内容的表面中之前，会将所有遮罩内容呈示到其表面中。结果，所有 FXG 功能（如笔触、位图滤镜和填充不透明度）将影响最终合成的内容。

处于 Alpha 模式下时，会将任何位图数据的 Alpha 通道正常合成到遮罩 Alpha 通道中，并将影响最终呈示的内容。对于 BitmapGraphics 和位图填充的形状与路径，这保持 true。

发光度遮罩

发光度遮罩有时称为“柔化遮罩”，除以下方面外其作用极其类似于 Alpha 遮罩：源内容中像素的不透明度和 RGB 颜色值与遮罩中相应区域的不透明度和 RGB 颜色值相乘。

从概念上讲，发光度遮罩等效于将转换的遮罩和源内容呈示到单独的 RGBA 表面中，并将遮罩内容的 Alpha 通道和 RGB 颜色值与源内容的 Alpha 通道和 RGB 颜色值相乘。在合成到源内容的表面中之前，会将所有遮罩内容呈示到其表面中。结果，所有 FXG 功能（如笔触、位图滤镜和填充不透明度）将影响最终合成的内容。

发光度遮罩不是 Flash 的特有功能，但在诸如 Adobe Illustrator 和 Adobe Photoshop 等 Adobe Creative Suite 工具中通用。为了实现 Flash 呈示内容中发光度遮罩的视觉效果，指定发光度遮罩的图形元素实际上会实例化模仿发光度遮罩在 Adobe Creative Suite 工具中呈示时其可视外观的着色器滤镜。

由发光度遮罩设置遮罩的对象可以设置用于控制遮罩 RGB 颜色值和剪辑的属性。请参阅 luminosityInvert 和 luminosityClip 属性。

默认值为 MaskType.CLIP。

相关 API 元素

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

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

如果应用程序开发人员覆盖 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() 方法设置。

相对于元素的原点的默认测量界限左上角。

相对于元素的原点的默认测量界限左上角。

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

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

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

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

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

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

如果元素需要一个独占 DisplayObject，则为 true。开发人员通常不直接调用此方法，而会在其子类中覆盖它以指示需要一个独占 DisplayObject。通常子类在必须设置其属性时需要一个 DisplayObject。这样的 DisplayObject 属性的一些示例有：filters、blendMode、mask、rotation、alpha。

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

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

默认值为 parent 属性的值。

此组件的父容器或组件。只有可视元素应该具有 parent 属性。非可视项目应该使用其他属性引用其所属对象。一般而言，非可视对象使用 owner 属性引用其所属对象。

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

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

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

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

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

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

定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。

例如，如果希望某个布局为将旋转 90 度的某个对象进行调整，请设置该对象的 rotation 属性。如果不希望布局为要旋转的对象进行调整，请设置其 postLayoutTransformOffsets.rotationZ 属性。

从组件的右边缘到锚点目标的右边缘的水平距离（以像素为单位）。

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

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

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

指示元素从转换点的旋转（以度为单位）。

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

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

指示元素从转换点的旋转（以度为单位）。

从转换点开始应用的元素的水平缩放比例（百分比）。

从转换点开始应用的元素的垂直缩放比例（百分比）。

从转换点开始应用的元素的 z 缩放比例（百分比）。

从组件的上边缘到锚点目标的上边缘的垂直距离（以像素为单位）。

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

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

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

一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。在 Transform 类的条目中对特定属性 matrix、colorTransform 和三个只读属性（concatenatedMatrix、concatenatedColorTransform 和 pixelBounds）进行了说明。

transform 对象的每个属性本身都是一个对象。此概念很重要，因为设置 matrix 或 colorTransform 对象的新值的唯一方法是，创建新对象并将该对象复制到 transform.matrix 或 transform.colorTransform 属性。

例如，要增加显示对象矩阵的 tx 值，您必须制作整个矩阵对象的副本，然后将新对象复制到 transform 对象的 matrix 属性中：

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

不能直接设置 tx 属性。下面的代码对 myDisplayObject 不起作用：

    myDisplayObject.transform.matrix.tx += 10;
    

您也可以复制整个 transform 对象并为其赋予另一个显示对象的 transform 属性。例如，下面的代码将整个 transform 对象从 myOldDisplayObj 复制到 myNewDisplayObj：

现在，新显示对象 myNewDisplayObj 与旧显示对象 myOldDisplayObj 具有相同的矩阵、颜色转换和像素范围值。

请注意，AIR for TV 设备使用硬件加速（如果可用）进行颜色转换。

元素的 x 位置转换点。

元素的 y 位置转换点。

元素的 z 位置转换点。

从组件中心到锚点目标的内容区域中心的垂直距离（以像素为单位）。

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

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

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

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

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

如果对象不可视，但将 includeInLayout 属性设置为 true，则该对象占用容器中的空间，但不可视。

如果 visible 设置为 true，对象未必可视，由于其大小以及容器剪裁是否启用。

将 visible 设置为 false 应该会禁止组件获取焦点。

图形元素的宽度。

默认值为 0。

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

图形元素的 x 位置。

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

图形元素的 y 位置。

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

图形元素的 z 位置。

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

如果此 IGraphicElement 是兼容的且可以与序列中下一个 IGraphicElement 共享显示对象，则返回 true。

参数

如果此 IGraphicElement 是兼容的且可以与序列中上一个 IGraphicElement 共享显示对象，则返回 true。

在某些情况下，调用 setSharedDisplayObject() 方法时会将该元素本身传递到 IGraphicElementContainer。在这些情况下，不会调用此方法。

参数

确定是否可以跳过对 measure() 方法的调用。

处理在元素上设置的属性。此方法是一种高级方法，可在创建子类时覆盖。

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

某些元素具有可彼此交互的属性。通常，最好在启动时一次性处理所有这些属性以避免重复工作。

创建一个新 DisplayObject 以用于绘制此 IGraphicElement。

随后对 displayObject 属性的 getter 的调用必须返回相同的显示对象。

在创建 DisplayObject 之后，父 IGraphicElementContainer 将沿着显示对象传递到序列中剩余的元素。

IGraphicElementContainer 确保只在需要时调用此方法。

如果该元素希望参与 DisplayObject 共享，则新的 DisplayObject 必须实现 IShareableDisplayObject。此接口供 IGraphicElementContainer 使用，用于管理图形元素序列的失效和重新绘制，开发人员通常不能直接使用该接口。

若要重新评估共享序列，请在 IGraphicElementContainer 上调用 invalidateGraphicElementSharing() 方法。

要强制 IGraphicElementContainer 从其显示列表删除元素的当前 DisplayObject，并重新计算显示对象共享，请调用 IGraphicElementContainer 上的 discardDisplayObject() 方法。

按指定的元素大小，返回元素边界的 x 坐标。

如果将元素大小调整为特定尺寸，则此方法通常在调用 measure() 方法期间由布局使用，以预测该元素将来的位置。

参数

按指定的元素大小，返回元素边界的 y 坐标。如果将元素大小调整为特定尺寸，则此方法通常在调用 measure() 期间由布局使用，以预测该元素将来的位置。

参数

返回元素的布局高度。这是元素在屏幕上进行绘制时所用的大小。

参数

返回元素的布局宽度。这是元素在屏幕上进行绘制时所用的大小。

参数

返回元素在屏幕上进行绘制时所用的 x 坐标。

参数

返回元素在屏幕上进行绘制时所用的 y 坐标。

参数

返回用于相对于其同级组件计算组件的布局的转换矩阵。

此矩阵通常由组件的 2D 属性（如 x、y、rotation、scaleX、scaleY、transformX 和 transformY）定义。某些组件可以具有其他转换属性，这些属性在布局矩阵的顶层上应用，以确定最终计算的矩阵。例如，UIComponent 可定义 offsets 属性。

返回此元素的布局转换 Matrix3D。

此矩阵通常由组件的转换属性定义，例如，x、y、z、rotationX、rotationY、rotationZ、scaleX、scaleY、scaleZ、transformX 和 transformY。某些组件可以具有其他转换属性，这些属性在布局矩阵的顶层上应用，以确定最终计算的矩阵。例如，UIComponent 可定义 offsets 属性。

返回元素的最大高度。

参数

返回元素的最大宽度。

参数

返回元素的最小高度。

参数

返回元素的最小宽度。

参数

返回元素的首选高度。

参数

返回元素的首选宽度。

参数

返回元素界限每一侧上的笔触所占据的像素数。

参数

如果 GraphicElement 是使用 MXML 标签创建的，则由 MXML 编译器自动调用。如果通过 ActionScript 创建 GraphicElement，则必须手动设置 ID 属性。

参数

调用此方法将导致在呈示显示列表前调用元素的 validateDisplayList() 方法。

子类应该在 updateDisplayList() 中覆盖和完成其工作。

通知主机此元素已更改且需要更新其图层的实用程序方法。

当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。如果它们不同，该方法负责镜像元素的内容以及更新元素的布局后转换，以便子代继承镜像的坐标系。IVisualElement 通常通过以下方法实现镜像：使用 postLayoutTransformOffsets 按 -1 缩放 X 轴以及按元素宽度平移原点的 x 坐标。此“镜像”转换的净效果是反转 X 轴增加的方向，而不更改元素相对于其父代的原点的位置。

此对象影响其布局时（includeInLayout 为 true），使父代大小和显示列表失效的 Helper 方法。

调用此方法将导致在呈示显示列表前调用元素的 validateProperties() 方法。

子类应该在 commitProperties() 中完成其工作。

调用此方法将导致在呈示显示列表前调用元素的 validateSize() 方法。

子类应该在 measure() 中覆盖和完成其测量。默认情况下，设置 explicitWidth 和 explicitHeight 时，将不会调用 measure()。若要覆盖此默认行为，子类应该覆盖 skipMeasure()。

将 Point 对象从对象的（局部）坐标转换为舞台（全局）坐标。

此方法允许您转换任何给定的 x 和 y 坐标，将从相对于特定对象原点 (0,0) 的值（局部坐标）转换为相对于舞台原点的值（全局坐标）。

要使用此方法，请先创建 Point 类的一个实例。您指定的 x 和 y 值表示局部坐标，因为它们是相对于对象原点。

然后，您可以将创建的 Point 实例作为参数传递给 localToGlobal() 方法。该方法会返回一个新的 Point 对象，该对象具有相对于舞台原点（而不是对象原点）的 x 和 y 值。

参数

相关 API 元素

计算元素的默认大小。此方法是一种高级方法，可在创建 GraphicElement 的子类时覆盖。

您无需直接调用此方法。使用 addElement() 方法将元素添加到 IGraphicElementContainer 容器（例如，组）时，以及调用元素的 invalidateSize() 方法时，Flex 会调用 measure() 方法。

默认情况下您会设置元素的显式高度和显式宽度，Flex 不会调用 measure() 方法，即使您显式调用 invalidateSize() 方法也不例外。若要覆盖此行为，请覆盖 skipMeasure() 方法。

覆盖此方法时，必须设置 measuredWidth 和 measuredHeight 属性以定义默认大小。您可以选择设置 measuredX 和 measuredY 属性以定义相对于元素的原点的默认测量界限左上角。

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

• 组件需要显示的文本量。
• 组件所显示的 JPEG 图像的大小。

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

measure() 的默认实现会将 measuredWidth、measuredHeight、measuredX 和 measuredY 属性的值设置为 0。

将 IGraphicElement 添加到主机组件或从主机组件将其删除时由 IGraphicElementContainer 调用。

您通常无需调用此方法。

参数

用于 ILayoutElement 接口的实现，返回显式度量的高度预转换。

用于 ILayoutElement 接口的实现，返回测量宽度预转换的显式。

设置元素在屏幕上进行绘制时所用的坐标。

请注意，调用 setLayoutBoundSize() 方法会影响布局位置，因此请在调用 setLayoutBoundSize() 之后再调用 setLayoutBoundPosition()。

参数

设置元素的布局大小。这是元素在屏幕上进行绘制时所用的大小。

如果 width 和/或 height 参数尚未指定 (NaN)，则 Flex 会将该元素的布局大小设置为首选宽度和/或首选高度。

请注意，调用 setLayoutBoundSize() 方法会影响布局位置，因此请在调用 setLayoutBoundSize() 之后再调用 setLayoutBoundPosition()。

参数

设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。

此矩阵通常由组件的 2D 属性（如 x、y、rotation、scaleX、scaleY、transformX 和 transformY）定义。某些组件可以具有其他转换属性，这些属性在布局矩阵的顶层上应用，以确定最终计算的矩阵。例如，UIComponent 可定义 offsets。

请注意，在父坐标中计算时，布局 Matrix 是在 getPreferredSize()、getMinSize()、getMaxSize()、getLayoutSize() 方法中进行分解的；在父坐标和子坐标中计算时，布局 Matrix 是在 getLayoutPosition() 中进行分解的。计算转换矩阵的布局通常会显式调用此方法，并使用子坐标中的大小。调用此方法的布局会将 false 传递给 invalidateLayout() 方法，这样不会触发后续的布局传递。

参数

设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。

此矩阵通常由组件的转换属性定义，例如，x、y、z、rotationX、rotationY、rotationZ、scaleX、scaleY、scaleZ、transformX 和 transformY。某些组件可以具有其他转换属性，这些属性在布局矩阵的顶层上应用，以确定最终计算的矩阵。例如，UIComponent 可定义 offsets 属性。

请注意，在父坐标中计算时，布局 Matrix3D 是在 getPreferredSize()、getMinSize()、getMaxSize()、getLayoutSize() 中进行分解的；在父坐标和子坐标中计算时，布局 Matrix3D 是在 getLayoutPosition() 中进行分解的。计算转换矩阵的布局通常会显式调用此方法，并使用子坐标中的大小。调用此方法的布局会将 false 传递给 invalidateLayout() 方法，这样不会触发后续的布局传递。

参数

确定此元素是否可以将它自己绘制到该序列的 sharedDisplayObject。

当此 IGraphicElement 可以在共享的 DisplayObject graphics 属性中累积地绘制时，实现程序通常返回 true。在此 IGraphicElement 需要在 DisplayObject 上设置属性（不会应用于序列中的剩余元素）的所有情形下，此方法必须返回 false。此类属性的示例有 rotation、scale、transform、mask、alpha、filters、color transform、3D 和 layer。

当此方法返回 true 时，随后对 displayObject 属性的 getter 的调用必须返回相同的显示对象。

在某些情况下，sharedDisplayObject 属性可能本身就是 IGraphicElementContainer。在其余情形下，DisplayObject 是由序列中的第一个元素创建的。

当此 IGraphicElement 需要重新生成其序列时，它会通过调用其 invalidateGraphicElementSharing() 方法通知 IGraphicElementContainer。

参数

用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。此函数将指定提供的旋转值、缩放值和平移值，然后根据需要更新 x/y/z 属性以保持转换中心固定。

参数

转换元素的大小。

该方法计算图形元素的边框，好像元素的宽度/高度属性设置为传入的值。该方法返回边框的高度。

通常，该方法不能由开发人员使用。但是，您应该实现或重写由 ILayoutElement 接口定义的方法。

参数

一种实用程序方法，用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。如果 position 和 postLayoutPosition 参数为非 null，将对这两个参数设置布局前和布局后结果。

参数

转换元素的大小。

该方法计算图形元素的边框，好像元素的宽度/高度属性设置为传入的值。该方法返回边框的宽度。

通常，该方法不能由开发人员使用。但是，您应该实现或重写由 ILayoutElement 接口定义的方法。

参数

绘制元素和/或调整其内容的大小并定位该内容。此方法是一种高级方法，可在创建 GraphicElement 的子类时覆盖。

您无需直接调用此方法。使用 addElement() 方法将组件添加到 IGraphicElementContainer 容器（例如，组）时，以及调用元素的 invalidateDisplayList() 方法时，Flex 会调用 updateDisplayList() 方法。

您可以借助此方法使用针对元素的 displayObject（如 graphics.drawRect()）上的一些方法以编程方式进行绘制。

参数

由 IGraphicElementContainer 调用以在其 displayObject 属性中重新绘制此元素。

如果该元素是序列中的第一个元素（将 displayObjectSharingMode 设置为 DisplayObjectSharingMode.OWNS_SHARED_OBJECT），则它必须清除 displayObject 图形并根据需要对其进行设置以绘制剩余元素。

必须始终重新绘制该元素，即使该元素本身在上次调用 validateDisplayList() 方法之后未发生更改时也是如此。如果需要重新绘制 IGraphicElementContainer 中的任何元素，则它将重新绘制整个序列。

要确保调用此方法，请通过调用其 invalidateGraphicElementSize() 方法通知 IGraphicElementContainer。

即使此元素未通知 IGraphicElementContainer，也可能会调用此方法。

根据需要，通过立即调用 validateProperties()、validateSize() 和 validateDisplayList() 来验证并更新此对象的属性和布局。

由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。通常，子类应覆盖 commitProperties() 方法，而不是覆盖此方法。

由 IGraphicElementContainer 调用以验证此元素的大小。

当元素大小发生变化并将影响 IGraphicElementContainer 布局时，实现程序负责使父代的大小和显示列表失效。

要确保调用此方法，请通过调用其 invalidateGraphicElementSize() 方法通知 IGraphicElementContainer。

即使此元素未通知 IGraphicElementContainer，也可能会调用此方法。