| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。 | DisplayObject | |
| alpha : Number
表示指定对象的 Alpha 透明度值。 | DisplayObject | |
| blendMode : String
BlendMode 类中的一个值，用于指定要使用的混合模式。 | DisplayObject | |
| blendShader : Shader [只写]
设置用于混合前景和背景的着色器。 | DisplayObject | |
| cacheAsBitmap : Boolean
如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。 | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
如果为非 null，则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。 | DisplayObject | |
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| filters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。 | DisplayObject | |
| graphics : Graphics [只读]
指定属于该 Shape 对象的 Graphics 对象，可通过此对象执行矢量绘图命令。 | Shape | |
| height : Number
表示显示对象的高度，以像素为单位。 | DisplayObject | |
| initialized : Boolean
一个标志，用于确定某个对象是否已通过布局的所有三个阶段：提交、测量和布局（假设每个阶段都是必需的）。 | ProgrammaticSkin | ||
| loaderInfo : LoaderInfo [只读]
返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
| mask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | |
| measuredHeight : Number [只读]
此对象的测量高度。 | ProgrammaticSkin | ||
| measuredWidth : Number [只读]
此对象的测量宽度。 | ProgrammaticSkin | ||
| metaData : Object
如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的，则获取 DisplayObject 实例的元数据对象。 | DisplayObject | |
| mouseX : Number [只读]
表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。 | DisplayObject | |
| mouseY : Number [只读]
表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。 | DisplayObject | |
| name : String
表示 DisplayObject 的实例名称。 | DisplayObject | |
| nestLevel : int
此对象在所属关系层次结构中的深度。 | ProgrammaticSkin | ||
| opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
| parent : DisplayObjectContainer [只读]
表示包含此显示对象的 DisplayObjectContainer 对象。 | DisplayObject | |
| processedDescriptors : Boolean
临时或延迟子项创建操作后设置为 true，具体取决于发生对象。 | ProgrammaticSkin | ||
| root : DisplayObject [只读]
对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | |
| rotation : Number
表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。 | DisplayObject | |
| rotationX : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。 | DisplayObject | |
| rotationY : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。 | DisplayObject | |
| rotationZ : Number
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。 | DisplayObject | |
| scale9Grid : Rectangle
当前有效的缩放网格。 | DisplayObject | |
| scaleX : Number
表示从注册点开始应用的对象的水平缩放比例（百分比）。 | DisplayObject | |
| scaleY : Number
表示从对象注册点开始应用的对象的垂直缩放比例（百分比）。 | DisplayObject | |
| scaleZ : Number
表示从对象的注册点开始应用的对象的深度缩放比例（百分比）。 | DisplayObject | |
| scrollRect : Rectangle
显示对象的滚动矩形范围。 | DisplayObject | |
| stage : Stage [只读]
显示对象的舞台。 | DisplayObject | |
| styleName : Object
用于获取样式值的父组件。 | ProgrammaticSkin | ||
| transform : flash.geom:Transform
一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | DisplayObject | |
| updateCompletePendingFlag : Boolean
一个标志，确定某个对象是否已通过所有三个阶段的布局验证（假设需要通过所有验证）。 | ProgrammaticSkin | ||
| visible : Boolean
显示对象是否可见。 | DisplayObject | |
| width : Number
表示显示对象的宽度，以像素为单位。 | DisplayObject | |
| x : Number
表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。 | DisplayObject | |
| y : Number
表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。 | DisplayObject | |
| z : Number
表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | DisplayObject | |
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数。 | ProgrammaticSkin | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
将事件调度到事件流中。 | EventDispatcher | |
|
返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
|
返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。 | DisplayObject | |
返回指定样式属性的值。 | ProgrammaticSkin | ||
|
将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。 | DisplayObject | |
|
将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。 | DisplayObject | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。 | DisplayObject | |
|
计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | ProgrammaticSkin | ||
调用此方法将导致在呈示显示列表前调用组件的 validateProperties() 方法。 | ProgrammaticSkin | ||
调用此方法将导致在呈示显示列表前调用组件的 validateSize() 方法。 | ProgrammaticSkin | ||
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | DisplayObject | |
|
将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。 | DisplayObject | |
将此对象移动到指定的 x 和 y 坐标。 | ProgrammaticSkin | ||
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
设置该对象的高度和宽度。 | ProgrammaticSkin | ||
|
设置循环操作动态属性的可用性。 | Object | |
每当样式更改时，重绘此外观。 | ProgrammaticSkin | ||
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
| [覆盖]
返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexShape | |
当此控件绘制自身时，LayoutManager 调用此函数。 | ProgrammaticSkin | ||
验证并更新此对象的属性和布局，如果需要的话重绘对象。 | ProgrammaticSkin | ||
此函数是一个空存根，以便 ProgrammaticSkin 可以实现 ILayoutManagerClient 接口。 | ProgrammaticSkin | ||
此函数是一个空存根，以便 ProgrammaticSkin 可以实现 ILayoutManagerClient 接口。 | ProgrammaticSkin | ||
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
受保护的方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void
通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | ProgrammaticSkin | ||
创建水平渐变矩阵的实用程序函数。 | ProgrammaticSkin | ||
创建旋转渐变矩阵的实用程序函数。 | ProgrammaticSkin | ||
通过编程方式绘制此外观的图形。 | ProgrammaticSkin | ||
创建垂直渐变矩阵的实用程序函数。 | ProgrammaticSkin | ||
属性详细信息
initialized | 属性 |
measuredHeight | 属性 |
measuredWidth | 属性 |
nestLevel | 属性 |
processedDescriptors | 属性 |
processedDescriptors:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
临时或延迟子项创建操作后设置为 true，具体取决于发生对象。对于 Container 对象，在 createComponentsFromDescriptors() 方法结束（即 Container 对象使用其子项描述符创建子项）后，该属性设置为 true。
例如，如果 Accordion 容器使用延迟的实例化，则在用户导航到 Accordion 容器的第二个窗格并且该窗格创建其子项后，此窗格的 processedDescriptors 属性才变为 true。但是，如果 Accordion 已将 creationPolicy 属性设置为 "all"，则在应用程序启动期间此容器第二个窗格的 processedDescriptors 属性设置为 true。
非容器类都没有描述符，所以对于这些类，createChildren() 方法创建任何内部组件子项后，该属性设置为 true。
实现
public function get processedDescriptors():Boolean public function set processedDescriptors(value:Boolean):voidstyleName | 属性 |
updateCompletePendingFlag | 属性 |
构造函数详细信息
ProgrammaticSkin | () | 构造函数 |
public function ProgrammaticSkin()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
方法详细信息
drawRoundRect | () | 方法 |
protected function drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
通过编程方式在此外观的 Graphics 对象中绘制一个矩形。
矩形可以有圆角。其边缘使用 Graphics 对象的当前线条样式。可以使用纯色填充、渐变填充或无填充。纯色填充可以使用 Alpha 透明度。渐变填充可以为线性渐变或放射状渐变。可在沿着渐变的指定点上至多指定 15 个颜色和 Alpha 值，可为渐变指定旋转角度和转换矩阵。最后，该矩形可具有从其上切去的圆角矩形洞。
该通用矩形绘制例程被很多外观所使用。该例程调用 drawRect() 或 drawRoundRect() 方法（在 flash.display.Graphics 类中）在此外观的 Graphics 对象中进行绘制。
参数
x:Number — 此外观中矩形左上角的水平位置。
| |
y:Number — 此外观中矩形左上角的垂直位置。
| |
width:Number — 矩形的宽度（以像素为单位）。
| |
height:Number — 矩形的高度（以像素为单位）。
| |
cornerRadius:Object (default = null)null、Number 或 Object。如果为 null，则表示该角应为方形而不是弧形。如果为 Number，则为所有四个角指定相同半径（以像素为单位）。如果为 Object，则应具有 tl、tr、bl 和 br 属性，这些属性值是用于指定左上角、右上角、左下角、右下角的半径的 Number（以像素为单位）。例如，您可以传递简单 Object，如 { tl: 5, tr: 5, bl: 0, br: 0 }。默认值为 null（方形角）。
| |
color:Object (default = null)null、uint 或 Array。如果为 null，则不为矩形填充颜色。如果为 uint，则会指定一个 RGB 填充色。例如，传递 0xFF0000 可填充红色。如果为 Array，则应包含用于指定渐变颜色的 uint。例如，传递 [ 0xFF0000, 0xFFFF00, 0x0000FF ] 可填充红-黄-蓝渐变。在渐变中最多可以指定 15 种颜色。默认值为 null（无填充颜色）。
| |
alpha:Object (default = null)color 为空，则忽略此参数。如果 color 是用于指定 RGB 填充颜色的 uint，则 alpha 应该是用于指定填充透明度的 Number，其中 0.0 表示完全透明，1.0 表示完全不透明。在本例中，您还可以通过传递空值而不是 1.0 来指定完全不透明。如果 color 是用于指定渐变颜色的 Array，则 alpha 应该是长度相同的数字 Array，用于为渐变指定相应的 alpha 值。在本例中，默认值为 null（完全不透明）。
| |
gradientMatrix:Matrix (default = null)horizontalGradientMatrix()、verticalGradientMatrix() 和 rotatedGradientMatrix() 来创建此参数的值。
| |
gradientType:String (default = "linear")GradientType.LINEAR 或 GradientType.RADIAL。（GradientType 类位于 flash.display 包中。）
| |
gradientRatios:Array (default = null)color 参数中定义的颜色数匹配。各值均定义 100% 采样的颜色所在位置的宽度百分比。值 0 表示渐变框中的左侧位置，255 表示渐变框中的右侧位置。
| |
hole:Object (default = null) |
相关 API 元素
getStyle | () | 方法 |
horizontalGradientMatrix | () | 方法 |
protected function horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
创建水平渐变矩阵的实用程序函数。
参数
x:Number — 渐变的左边缘。
| |
y:Number — 渐变的上边缘。
| |
width:Number — 渐变的宽度。
| |
height:Number — 渐变的高度。
|
Matrix — 水平渐变矩阵。它是一个临时对象，只能用于对 drawRoundRect() 方法的单个后续调用。
|
invalidateDisplayList | () | 方法 |
public function invalidateDisplayList():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。
Invalidation 是一个很有用的机制，可将组件更改延迟到稍后屏幕更新时进行处理，从而消除了重复的工作。例如，要更改宽度和高度，如果在更改宽度后立即更新组件，然后在设置新高度后再次更新组件，就有些浪费。更改两个属性后再使用新的大小一次性呈示组件，效率会更高。
很少调用 Invalidation 方法。通常，在组件上设置属性会自动调用合适的 invalidation 方法。
invalidateProperties | () | 方法 |
public function invalidateProperties():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
调用此方法将导致在呈示显示列表前调用组件的 validateProperties() 方法。
对于扩展 UIComponent 的组件，这暗示调用 commitProperties()。
invalidateSize | () | 方法 |
public function invalidateSize():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
调用此方法将导致在呈示显示列表前调用组件的 validateSize() 方法。
对于扩展 UIComponent 的组件，这暗示调用 measure()，除非组件设置了 explicitWidth 和 explicitHeight。
move | () | 方法 |
rotatedGradientMatrix | () | 方法 |
protected function rotatedGradientMatrix(x:Number, y:Number, width:Number, height:Number, rotation:Number):Matrix| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
创建旋转渐变矩阵的实用程序函数。
参数
x:Number — 渐变的左边缘。
| |
y:Number — 渐变的上边缘。
| |
width:Number — 渐变的宽度。
| |
height:Number — 渐变的高度。
| |
rotation:Number — 旋转量（以度为单位）。
|
Matrix — 水平渐变矩阵。它是一个临时对象，只能用于对 drawRoundRect() 方法的单个后续调用。
|
setActualSize | () | 方法 |
styleChanged | () | 方法 |
updateDisplayList | () | 方法 |
protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
通过编程方式绘制此外观的图形。
子类应覆盖此方法并包扩对如 graphics.moveTo() 和 graphics.lineTo() 的方法的调用。
此过程发生在对源的任何缩放（如用户代码或缩放效果）之前。组件并不知道之后发生的缩放。
参数
unscaledWidth:Number — 该对象在进行任何缩放之前的宽度（以像素为单位）。
| |
unscaledHeight:Number — 该对象在进行任何缩放之前的高度（以像素为单位）。
|
validateDisplayList | () | 方法 |
public function validateDisplayList():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当此控件绘制自身时，LayoutManager 调用此函数。实际绘制发生在 updateDisplayList 函数中，它由此函数调用。
validateNow | () | 方法 |
public function validateNow():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
验证并更新此对象的属性和布局，如果需要的话重绘对象。
validateProperties | () | 方法 |
public function validateProperties():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
此函数是一个空存根，以便 ProgrammaticSkin 可以实现 ILayoutManagerClient 接口。外观不调用 LayoutManager.invalidateProperties()，它通常会触发对此方法的调用。
validateSize | () | 方法 |
verticalGradientMatrix | () | 方法 |
protected function verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
创建垂直渐变矩阵的实用程序函数。
参数
x:Number — 渐变的左边缘。
| |
y:Number — 渐变的上边缘。
| |
width:Number — 渐变的宽度。
| |
height:Number — 渐变的高度。
|
Matrix — 水平渐变矩阵。它是一个临时对象，只能用于对 drawRoundRect() 方法的单个后续调用。
|
Tue Jun 12 2018, 11:04 AM Z