SpriteVisualElement

包	spark.core
类	public class SpriteVisualElement
继承	SpriteVisualElement FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
实现	IVisualElement, IMXMLObject, IFlexModule

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

SpriteVisualElement 类是 IVisualElement 接口的基于占用内存较少的 Sprite 的实现。Spark 容器可以布置和呈示 SpriteVisualElement 对象。

如果使用 ActionScript 将 FXG 组件添加到某个应用程序，则该组件应为 SpriteVisualElement 类型。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		accessibilityImplementation : AccessibilityImplementation InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。	InteractiveObject
		accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。	DisplayObject
		alpha : Number 表示指定对象的 Alpha 透明度值。	DisplayObject
		baseline : Object 从锚点目标到控件的基线位置的垂直距离（以像素为单位）。	SpriteVisualElement
		baselinePosition : Number [只读] 组件第一行文本的基线的 y 坐标。	SpriteVisualElement
		blendMode : String [覆盖] BlendMode 类中的一个值，用于指定要使用的混合模式。	SpriteVisualElement
		blendShader : Shader [只写] 设置用于混合前景和背景的着色器。	DisplayObject
		bottom : Object 从组件的下边缘到锚点目标的下边缘的垂直距离（以像素为单位）。	SpriteVisualElement
		buttonMode : Boolean 指定此 sprite 的按钮模式。	Sprite
		cacheAsBitmap : Boolean 如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。	DisplayObject
		cacheAsBitmapMatrix : Matrix 如果为非 null，则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。	DisplayObject
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		contextMenu : NativeMenu 指定与此对象相关联的上下文菜单。	InteractiveObject
		depth : Number 确定容器内各项目的呈示顺序。	SpriteVisualElement
		designLayer : DesignLayer 指定与该可视元素关联的可选 DesignLayer 实例。	SpriteVisualElement
		doubleClickEnabled : Boolean 指定此对象是否接收 doubleClick 事件。	InteractiveObject
		dropTarget : DisplayObject [只读] 指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。	Sprite
		filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。	DisplayObject
		focusRect : Object 指定此对象是否显示焦点矩形。	InteractiveObject
		graphics : Graphics [只读] 指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘图命令。	Sprite
		hasLayoutMatrix3D : Boolean [只读] 如果元素具有 3D 矩阵，则为 true。	SpriteVisualElement
		height : Number 表示显示对象的高度，以像素为单位。	DisplayObject
		hitArea : Sprite 指定一个 sprite 用作另一个 sprite 的点击区域。	Sprite
		horizontalCenter : Object 从组件中心到锚点目标的内容区域中心的水平距离（以像素为单位）。	SpriteVisualElement
		id : String 组件的标识。	SpriteVisualElement
		includeInLayout : Boolean 指定此组件是否包含在父容器的布局中。	SpriteVisualElement
		is3D : Boolean [只读] 当元素为 3D 时，则为 true。	SpriteVisualElement
		layoutDirection : String 指定元素的所需布局方向：LayoutDirection.LTR（从左到右）、LayoutDirection.RTL（从右到左）或 null（继承）。	SpriteVisualElement
		left : Object 从组件的左边缘到锚点目标的左边缘的水平距离（以像素为单位）。	SpriteVisualElement
		loaderInfo : LoaderInfo [只读] 返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。	DisplayObject
		luminosityClip : Boolean 控制发光度遮罩是否剪辑设置了遮罩的内容的属性。	SpriteVisualElement
		luminosityInvert : Boolean 控制计算由发光度遮罩设置遮罩的图形元素的 RGB 颜色值的属性。	SpriteVisualElement
		mask : DisplayObject [覆盖] 设置遮罩。	SpriteVisualElement
		maskType : String 遮罩类型。	SpriteVisualElement
		metaData : Object 如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的，则获取 DisplayObject 实例的元数据对象。	DisplayObject
		moduleFactory : IFlexModuleFactory 模块工厂用作上下文，用于为组件使用嵌入字体，和查找用于控制样式的样式管理器。	SpriteVisualElement
		mouseChildren : Boolean 确定对象的子级是否支持鼠标或用户输入设备。	DisplayObjectContainer
		mouseEnabled : Boolean 指定此对象是否接收鼠标或其他用户输入、消息。	InteractiveObject
		mouseX : Number [只读] 表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。	DisplayObject
		mouseY : Number [只读] 表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。	DisplayObject
		name : String 表示 DisplayObject 的实例名称。	DisplayObject
		needsSoftKeyboard : Boolean 指定当该 InteractiveObject 实例获得焦点时，是否显示虚拟键盘（显示在屏幕上的软键盘）。	InteractiveObject
		numChildren : int [只读] 返回此对象的子项数目。	DisplayObjectContainer
		opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。	DisplayObject
		owner : DisplayObjectContainer 此 IVisualElement 对象的所有者。	SpriteVisualElement
		parent : DisplayObjectContainer [只读] 表示包含此显示对象的 DisplayObjectContainer 对象。	DisplayObject
		percentHeight : Number 以组件父代大小百分比的方式指定组件高度。	SpriteVisualElement
		percentWidth : Number 以组件父代大小百分比的方式指定组件宽度。	SpriteVisualElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets 定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。	SpriteVisualElement
		right : Object 从组件的右边缘到锚点目标的右边缘的水平距离（以像素为单位）。	SpriteVisualElement
		root : DisplayObject [只读] 对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。	DisplayObject
		rotation : Number 表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。	DisplayObject
		rotationX : Number [覆盖] 表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。	SpriteVisualElement
		rotationY : Number [覆盖] 表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。	SpriteVisualElement
		rotationZ : Number 表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。	DisplayObject
		scale9Grid : Rectangle 当前有效的缩放网格。	DisplayObject
		scaleX : Number 表示从注册点开始应用的对象的水平缩放比例（百分比）。	DisplayObject
		scaleY : Number 表示从对象注册点开始应用的对象的垂直缩放比例（百分比）。	DisplayObject
		scaleZ : Number 表示从对象的注册点开始应用的对象的深度缩放比例（百分比）。	DisplayObject
		scrollRect : Rectangle 显示对象的滚动矩形范围。	DisplayObject
		softKeyboard : String 控制软键盘的外观。	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle 定义当显示软键盘时应在屏幕上保留的区域（在 iOS 上不支持）。	InteractiveObject
		soundTransform : flash.media:SoundTransform 控制此 sprite 中的声音。	Sprite
		stage : Stage [只读] 显示对象的舞台。	DisplayObject
		tabChildren : Boolean 确定对象的子项是否支持 Tab 键。	DisplayObjectContainer
		tabEnabled : Boolean 指定此对象是否遵循 Tab 键顺序。	InteractiveObject
		tabIndex : int 指定 SWF 文件中的对象按 Tab 键顺序排列。	InteractiveObject
		textSnapshot : flash.text:TextSnapshot [只读] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。	DisplayObjectContainer
		top : Object 从组件的上边缘到锚点目标的上边缘的垂直距离（以像素为单位）。	SpriteVisualElement
		transform : flash.geom:Transform 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	DisplayObject
		transformX : Number 设置组件转换中心的 x 坐标。	SpriteVisualElement
		transformY : Number 设置组件转换中心的 y 坐标。	SpriteVisualElement
		transformZ : Number 设置组件转换中心的 z 坐标。	SpriteVisualElement
		useHandCursor : Boolean 布尔值，表示当指针滑过 buttonMode 属性设置为 true 的 sprite 时是否显示指针手形（手形光标）。	Sprite
		verticalCenter : Object 从组件中心到锚点目标的内容区域中心的垂直距离（以像素为单位）。	SpriteVisualElement
		visible : Boolean [覆盖] 控制此可视元素的可见性。	SpriteVisualElement
		width : Number 表示显示对象的宽度，以像素为单位。	DisplayObject
		x : Number 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。	DisplayObject
		y : Number 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。	DisplayObject
		z : Number 表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。	DisplayObject

受保护的属性

	属性		由以下参数定义
		viewHeight : Number [只写] 定义图形在布局中使用的垂直空间。	SpriteVisualElement
		viewWidth : Number [只写] 定义图形在布局中使用的水平空间。	SpriteVisualElement

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		SpriteVisualElement() 构造函数。	SpriteVisualElement
		addChild(child:DisplayObject):DisplayObject 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 表示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。	DisplayObjectContainer
		contains(child:DisplayObject):Boolean 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。	DisplayObject
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 x 坐标。	SpriteVisualElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 y 坐标。	SpriteVisualElement
		getChildAt(index:int):DisplayObject 返回位于指定索引处的子显示对象实例。	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 返回具有指定名称的子显示对象。	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 返回 DisplayObject 的 child 实例的索引位置。	DisplayObjectContainer
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的布局高度。	SpriteVisualElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的布局宽度。	SpriteVisualElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 x 坐标。	SpriteVisualElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 y 坐标。	SpriteVisualElement
		getLayoutMatrix():Matrix 返回用于相对于其同级组件计算组件的布局的转换矩阵。	SpriteVisualElement
		getLayoutMatrix3D():Matrix3D 返回此元素的布局转换 Matrix3D。	SpriteVisualElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最大高度。	SpriteVisualElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最大宽度。	SpriteVisualElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最小高度。	SpriteVisualElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最小宽度。	SpriteVisualElement
		getObjectsUnderPoint(point:Point):Array 返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。	DisplayObjectContainer
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的首选高度。	SpriteVisualElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的首选宽度。	SpriteVisualElement
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。	DisplayObject
		globalToLocal(point:Point):Point 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。	DisplayObject
		globalToLocal3D(point:Point):Vector3D 将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。	DisplayObject
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		hitTestObject(obj:DisplayObject):Boolean 计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。	DisplayObject
		initialized(document:Object, id:String):void 如果 SpriteVisualElement 是使用 MXML 标签创建的，则由 MXML 编译器自动调用。	SpriteVisualElement
		invalidateLayoutDirection():void 当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。	SpriteVisualElement
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		local3DToGlobal(point3d:Vector3D):Point 将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。	DisplayObject
		localToGlobal(point:Point):Point 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。	DisplayObject
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeChild(child:DisplayObject):DisplayObject 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void 从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		requestSoftKeyboard():Boolean 显示虚拟键盘。	InteractiveObject
		setChildIndex(child:DisplayObject, index:int):void 更改现有子项在显示对象容器中的位置。	DisplayObjectContainer
		setLayoutBoundsPosition(newBoundsX:Number, newBoundsY:Number, postLayoutTransform:Boolean = true):void 设置元素在屏幕上进行绘制时所用的坐标。	SpriteVisualElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void 设置元素的布局大小。	SpriteVisualElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void 设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。	SpriteVisualElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void 设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。	SpriteVisualElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 允许用户拖动指定的 Sprite。	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void 使用户可以在启用触摸的设备上拖动指定的 Sprite。	Sprite
		stopAllMovieClips():void 对源起于此对象的所有 MovieClip 递归停止时间轴执行。	DisplayObjectContainer
		stopDrag():void 结束 startDrag() 方法。	Sprite
		stopTouchDrag(touchPointID:int):void 结束 startTouchDrag() 方法，用于启用触摸的设备。	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 交换两个指定子对象的 Z 轴顺序（从前到后顺序）。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。	DisplayObjectContainer
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。	FlexSprite
		transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void 用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。	SpriteVisualElement
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void 一种实用程序方法，用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。	SpriteVisualElement
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

	方法		由以下参数定义
		invalidateParentSizeAndDisplayList():void 此对象影响其布局时（includeInLayout 为 true），使父代大小和显示列表失效。	SpriteVisualElement
		transformHeightForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 转换元素的大小。	SpriteVisualElement
		transformWidthForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 转换元素的大小。	SpriteVisualElement

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
added	将显示对象添加到显示列表中时调度。	DisplayObject
addedToStage	在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。	DisplayObject
clear	当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。	InteractiveObject
click	用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。	InteractiveObject
contextMenu	当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。	InteractiveObject
copy	在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。	InteractiveObject
cut	在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。	InteractiveObject
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
doubleClick	如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。	InteractiveObject
enterFrame	[播放事件] 播放头进入新帧时调度。	DisplayObject
exitFrame	[广播事件] 播放头退出当前帧时调度。	DisplayObject
focusIn	显示对象获得焦点后调度。	InteractiveObject
focusOut	显示对象失去焦点后调度。	InteractiveObject
frameConstructed	[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。	DisplayObject
gestureDirectionalTap	当用户使用 InteractiveObject 实例沿触摸面边缘创建接触点时调度（如在 Siri Remote for Apple TV 上沿触摸面边缘轻击）。有些设备也可能将这种接触解释为多个触摸事件的组合。	InteractiveObject
gestureLongPress	当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时（例如，在配有触摸屏的移动电话或平板电脑上的显示对象上按下和释放两个手指）调度。	InteractiveObject
gesturePan	当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上的显示对象上从左向右移动手指）调度。	InteractiveObject
gestureRotate	当用户在接触点处使用 InteractiveObject 实例执行旋转手势时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上旋转这两个手指）调度。	InteractiveObject
gestureSwipe	当用户在接触点处使用 InteractiveObject 实例执行滑动手势（例如，在配有触摸屏的移动电话或平板电脑上用三根手指触摸屏幕，然后在一个显示对象上平行移动这三根手指）时调度。	InteractiveObject
gestureTap	当用户使用 InteractiveObject 实例创建接触点，然后点击启用触屏的设备时（例如，将几个手指放在显示对象上以打开菜单，然后点击一个手指在配有触摸屏的移动电话或平板电脑上选择一个菜单项）调度。	InteractiveObject
gestureZoom	当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上快速分开手指）调度。	InteractiveObject
imeStartComposition	此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序	InteractiveObject
keyDown	用户按下某个键时调度。	InteractiveObject
keyFocusChange	用户尝试使用键盘导航更改焦点时调度。	InteractiveObject
keyUp	用户释放某个键时调度。	InteractiveObject
middleClick	当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。	InteractiveObject
middleMouseDown	当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。	InteractiveObject
middleMouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
mouseDown	当用户在 InteractiveObject 实例上按下指针设备按钮时调度。	InteractiveObject
mouseFocusChange	用户尝试使用指针设备更改焦点时调度。	InteractiveObject
mouseMove	用户移动 InteractiveObject 上的指针设备时调度。	InteractiveObject
mouseOut	用户将指针设备从 InteractiveObject 实例上移开时调度。	InteractiveObject
mouseOver	用户将指针设备移动到 InteractiveObject 实例上时调度。	InteractiveObject
mouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
mouseWheel	当鼠标滚轮滚动到 InteractiveObject 实例上时调度。	InteractiveObject
nativeDragComplete	当用户释放拖动手势时由拖动启动器 InteractiveObject 调度。	InteractiveObject
nativeDragDrop	在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。	InteractiveObject
nativeDragEnter	当拖动手势进入其边界时由 InteractiveObject 调度。	InteractiveObject
nativeDragExit	当拖动手势离开其边界时由 InteractiveObject 调度。	InteractiveObject
nativeDragOver	当拖动手势保持在其边界内时，由 InteractiveObject 持续调度。	InteractiveObject
nativeDragStart	在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。	InteractiveObject
nativeDragUpdate	在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。	InteractiveObject
paste	在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。	InteractiveObject
proximityBegin	当用户将活动笔针放低经过屏幕的邻近检测阈值上时调度。	InteractiveObject
proximityEnd	当用户将活动笔针抬高放在屏幕的邻近检测阈值上时调度。	InteractiveObject
proximityMove	当用户将活动笔针移动到屏幕上但仍保留在邻近检测阈值中时调度。	InteractiveObject
proximityOut	当用户直接将活动笔针从此 InteractiveObject 上移开但仍保留在屏幕的邻近检测阈值中时调度。	InteractiveObject
proximityOver	当用户直接将活动笔针移动到此 InteractiveObject 上但仍保留在屏幕的邻近检测阈值中时调度。	InteractiveObject
proximityRollOut	当用户从此 InteractiveObject 及其任一子项中移开而仍保留在屏幕的邻近检测阈值中时调度。	InteractiveObject
proximityRollOver	当用户将活动笔针从显示列表中子项的对象树中滑过此 InteractiveObject 时（而仍保留在屏幕的邻近检测阈值中）时调度。	InteractiveObject
releaseOutside	在用户首先在 InteractiveObject 实例上按下按钮，然后将指针设备移离 InteractiveObject 实例，释放指针设备上的按钮时调度。	InteractiveObject
removed	将要从显示列表中删除显示对象时调度。	DisplayObject
removedFromStage	在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。	DisplayObject
render	[广播事件] 将要更新和呈现显示列表时调度。	DisplayObject
rightClick	当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。	InteractiveObject
rightMouseDown	当用户在 InteractiveObject 实例上按下指针设备按钮时调度。	InteractiveObject
rightMouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
rollOut	用户将指针设备从 InteractiveObject 实例上移开时调度。	InteractiveObject
rollOver	用户将指针设备移动到 InteractiveObject 实例上时调度。	InteractiveObject
selectAll	在用户为全选操作激活特定于平台的加速键组合或从文本上下文菜单中选择“全选”时调度。	InteractiveObject
softKeyboardActivate	在放开软键盘之后立即调度。	InteractiveObject
softKeyboardActivating	在放开软键盘之前立即调度。	InteractiveObject
softKeyboardDeactivate	在隐藏软键盘之后立即调度。	InteractiveObject
tabChildrenChange	对象的 tabChildren 标志值发生更改时调度。	InteractiveObject
tabEnabledChange	对象的 tabEnabled 标志发生更改时调度。	InteractiveObject
tabIndexChange	对象的 tabIndex 属性值发生更改时调度。	InteractiveObject
textInput	当用户输入一个或多个文本字符时调度。	InteractiveObject
touchBegin	当用户第一次触摸启用触摸的设备时（例如，用手指触摸配有触摸屏的移动电话或平板）调度。	InteractiveObject
touchEnd	当用户移除与启用触摸的设备的接触时（例如，将手指从配有触摸屏的移动电话或平板电脑上抬起）调度。	InteractiveObject
touchMove	当用户触碰设备时进行调度，而且会连续调度，直到接触点被删除。	InteractiveObject
touchOut	当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从一个显示对象拖到另一个显示对象）调度。	InteractiveObject
touchOver	当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。	InteractiveObject
touchRollOut	当用户移动接触点，使其远离启用触摸的设备上的 InteractiveObject 实例时（例如，在配有触摸屏的移动电话或平板电脑上将一个手指从显示对象上的一点移动到显示对象外的一点）调度。	InteractiveObject
touchRollOver	当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。	InteractiveObject
touchTap	当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时（例如，在配有触摸屏的移动电话或平板的显示对象上的某一点处按下并释放手指）调度。	InteractiveObject

属性详细信息

baseline

属性

baseline:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

实现
public function get baseline():Object
public function set baseline(value:Object):void

baselinePosition

属性

baselinePosition:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

各组件应覆盖此属性。

实现
public function get baselinePosition():Number

blendMode

属性

blendMode:String[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

默认值为 auto。

实现
override public function get blendMode():String
override public function set blendMode(value:String):void

bottom

属性

bottom:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

实现
public function get bottom():Object
public function set bottom(value:Object):void

depth

属性

depth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

实现
public function get depth():Number
public function set depth(value:Number):void

designLayer

属性

designLayer:DesignLayer

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

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

实现
public function get designLayer():DesignLayer
public function set designLayer(value:DesignLayer):void

hasLayoutMatrix3D

属性

hasLayoutMatrix3D:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

实现
public function get hasLayoutMatrix3D():Boolean

horizontalCenter

属性

horizontalCenter:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

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

实现
public function get horizontalCenter():Object
public function set horizontalCenter(value:Object):void

id

属性

id:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

组件的标识。

实现
public function get id():String
public function set id(value:String):void

includeInLayout

属性

includeInLayout:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

指定此组件是否包含在父容器的布局中。如果为 true，则该对象将包含在其父容器的布局中，并由其父容器根据其布局规则调整其大小并确定其位置。如果为 false，则对象的父容器的布局不影响该对象的大小和位置。

实现
public function get includeInLayout():Boolean
public function set includeInLayout(value:Boolean):void

is3D

属性

is3D:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

实现
public function get is3D():Boolean

layoutDirection

属性

layoutDirection:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

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

实现
public function get layoutDirection():String
public function set layoutDirection(value:String):void

left

属性

left:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

实现
public function get left():Object
public function set left(value:Object):void

luminosityClip

属性

luminosityClip:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

实现
public function get luminosityClip():Boolean
public function set luminosityClip(value:Boolean):void

luminosityInvert

属性

luminosityInvert:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

实现
public function get luminosityInvert():Boolean
public function set luminosityInvert(value:Boolean):void

mask

属性

mask:DisplayObject[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

设置遮罩。将遮罩添加到显示列表中。遮罩不得位于显示列表或元素数组中。

实现
override public function get mask():DisplayObject
override public function set mask(value:DisplayObject):void

maskType

属性

maskType:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

遮罩类型。可能的值为 MaskType.CLIP、MaskType.ALPHA 或 MaskType.LUMINOSITY。

剪辑遮罩

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

Alpha 遮罩

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

发光度遮罩

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

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

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

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

实现
public function get maskType():String
public function set maskType(value:String):void

moduleFactory

属性

moduleFactory:IFlexModuleFactory

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get moduleFactory():IFlexModuleFactory
public function set moduleFactory(value:IFlexModuleFactory):void

owner

属性

owner:DisplayObjectContainer

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

默认值为 parent 属性的值。

实现
public function get owner():DisplayObjectContainer
public function set owner(value:DisplayObjectContainer):void

percentHeight

属性

percentHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

实现
public function get percentHeight():Number
public function set percentHeight(value:Number):void

percentWidth

属性

percentWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

实现
public function get percentWidth():Number
public function set percentWidth(value:Number):void

postLayoutTransformOffsets

属性

postLayoutTransformOffsets:mx.geom:TransformOffsets

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

实现
public function get postLayoutTransformOffsets():mx.geom:TransformOffsets
public function set postLayoutTransformOffsets(value:mx.geom:TransformOffsets):void

right

属性

right:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

实现
public function get right():Object
public function set right(value:Object):void

rotationX

属性

rotationX:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

实现
override public function get rotationX():Number
override public function set rotationX(value:Number):void

rotationY

属性

rotationY:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

实现
override public function get rotationY():Number
override public function set rotationY(value:Number):void

top

属性

top:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

实现
public function get top():Object
public function set top(value:Object):void

transformX

属性

transformX:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

实现
public function get transformX():Number
public function set transformX(value:Number):void

transformY

属性

transformY:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

实现
public function get transformY():Number
public function set transformY(value:Number):void

transformZ

属性

transformZ:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

实现
public function get transformZ():Number
public function set transformZ(value:Number):void

verticalCenter

属性

verticalCenter:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

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

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

实现
public function get verticalCenter():Object
public function set verticalCenter(value:Object):void

viewHeight

属性

viewHeight:Number [只写]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

定义图形在布局中使用的垂直空间。设置此值时，不会缩放内容。但是，如果指定 height 属性的值，就会缩放内容。

在以下两种情形下这会很有用：1) 指定的 viewHeight 大于内容的正常大小。如果这样做，会使图形占用的空间比其可视大小更多。2) 指定的 viewHeight 小于内容的正常大小。如果您的图形具有额外的镶边或具有超出图形边缘的边框，则您可以这样做。在这种情形下，请务必在布局中禁用剪切。

实现
protected function set viewHeight(value:Number):void

viewWidth

属性

viewWidth:Number [只写]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

定义图形在布局中使用的水平空间。设置此值时，不会缩放内容。但是，如果指定 width 属性的值，就会缩放内容。

在以下两种情形下这会很有用：1) 指定的 viewWidth 大于内容的正常大小。如果这样做，会使图形占用的空间比其可视大小更多。2) 指定的 viewWidth 小于内容的正常大小。如果您的图形具有额外的镶边或具有超出图形边缘的边框，则您可以这样做。在这种情形下，请务必在布局中禁用剪切。

实现
protected function set viewWidth(value:Number):void

visible

属性

visible:Boolean[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

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

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

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

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

实现
override public function get visible():Boolean
override public function set visible(value:Boolean):void

构造函数详细信息

()

构造函数

public function SpriteVisualElement()

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

方法详细信息

getBoundsXAtSize

()

方法

public function getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

参数

	`width:Number` — 元素的界限宽度，或要使用首选宽度的 NaN。

	`height:Number` — 元素的界限高度，或要使用首选高度的 NaN。

	`postLayoutTransform:Boolean` (default = `true`) — 当 `postLayoutTransform` 为 true 时，该方法会返回元素边框左上角的 x 坐标。边框位于元素的父坐标空间中，并基于指定的边界大小、布局位置和布局转换矩阵进行计算。

Number — 按指定的元素大小，元素边界的 x 坐标。

getBoundsYAtSize

()

方法

public function getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

参数

	`width:Number` — 元素的界限宽度，或要使用首选宽度的 NaN。

	`height:Number` — 元素的界限高度，或要使用首选高度的 NaN。

	`postLayoutTransform:Boolean` (default = `true`) — 当 `postLayoutTransform` 为 true 时，该方法会返回元素边框左上角的 y 坐标。边框位于元素的父坐标空间中，并基于指定的边界大小、布局位置和布局转换矩阵进行计算。

Number — 按指定的元素大小，元素边界的 y 坐标。

getLayoutBoundsHeight

()

方法

public function getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

参数

postLayoutTransform:Boolean (default = true) — 当 postLayoutTransform 为 true 时，该方法会返回元素的边框宽度。边框位于元素的父坐标空间中，并基于元素的布局大小和布局转换矩阵进行计算。

Number — 元素的布局高度。

()

方法

public function getLayoutMatrix():Matrix

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

Matrix — 此元素的布局转换 Matrix。不要直接修改返回值；请调用 setLayoutMatrix() 方法。

()

方法

public function initialized(document:Object, id:String):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

参数

	`document:Object` — 包含此 SpriteVisualElement（未使用）的 MXML 文档。

	`id:String` — 此 SpriteVisualElement 的 MXML ID。

invalidateLayoutDirection

()

方法

public function invalidateLayoutDirection():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

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

invalidateParentSizeAndDisplayList

()

方法

protected function invalidateParentSizeAndDisplayList():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

setLayoutBoundsPosition

()

方法

public function setLayoutBoundsPosition(newBoundsX:Number, newBoundsY:Number, postLayoutTransform:Boolean = true):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

参数

	`newBoundsX:Number` — 边框左上角的 X 坐标。

	`newBoundsY:Number` — 边框左上角的 Y 坐标。

	`postLayoutTransform:Boolean` (default = `true`) — 当 `postLayoutTransform` 为 `true` 时，元素的定位方式为：其边框的左上角为 (x, y)。边框位于元素的父坐标空间中，并基于元素的布局大小、布局位置和布局转换矩阵进行计算。

setLayoutBoundsSize

()

方法

public function setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

参数

	`width:Number` — 元素的布局宽度。

	`height:Number` — 元素的布局高度。

	`postLayoutTransform:Boolean` (default = `true`) — 如果 `postLayoutTransform` 为 true，则指定的大小就是元素的边框的大小。边框位于元素的父坐标空间中，并基于元素的布局大小、布局位置和布局转换矩阵进行计算。

setLayoutMatrix

()

方法

public function setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

参数

	`value:Matrix` — 矩阵。

	`invalidateLayout:Boolean` — 设置为 `true`，将使父容器重新布局其子代。通常情况下，会将 `true` 传递给 `invalidateLayout()` 方法。

setLayoutMatrix3D

()

方法

public function setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

参数

	`value:Matrix3D` — 矩阵。

	`invalidateLayout:Boolean` — 设置为 `true`，将使父容器重新布局其子代。通常情况下，会将 `true` 传递给 `invalidateLayout()` 方法。

transformAround

()

方法

 public function transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

参数

	`transformCenter:Vector3D` — 在组件自己的坐标中用于相对于其父项保持固定的点。

	`scale:Vector3D` (default = `null`) — 转换的缩放的新值。

	`rotation:Vector3D` (default = `null`) — 转换的旋转的新值

	`translation:Vector3D` (default = `null`) — 转换的平移的新值。

	`postLayoutScale:Vector3D` (default = `null`) — 转换的布局后缩放的新值。

	`postLayoutRotation:Vector3D` (default = `null`) — 转换的布局后旋转的新值。

	`postLayoutTranslation:Vector3D` (default = `null`) — 转换的布局后平移的新值。

	`invalidateLayout:Boolean` (default = `true`) — 如果为 `true`，则父容器的大小和显示将无效。调用此方法的布局会传递 `false`，这样不会触发后续的布局传递。

transformHeightForLayout

()

方法

protected function transformHeightForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

转换元素的大小。

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

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

参数

	`width:Number` — 目标预转换宽度。

	`height:Number` — 目标预转换高度。

	`postLayoutTransform:Boolean` (default = `true`) — 为 `true` 时，返回的边框位于其父空间中已转换元素的周围（首先应用元素的转换）。

Number — 返回转换的高度。Transformation 是此元素的布局转换矩阵。

transformPointToParent

()

方法

public function transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

参数

	`localPosition:Vector3D` — 将要转换的点，指定为对象的本地坐标。

	`position:Vector3D` — 将保存布局前结果的 Vector3D 点。如果为 null，则忽略该参数。

	`postLayoutPosition:Vector3D` — 将保存布局后结果的 Vector3D 点。如果为 null，则忽略该参数。

transformWidthForLayout

()

方法

protected function transformWidthForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

转换元素的大小。

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

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

参数

	`width:Number` — 目标预转换宽度。

	`height:Number` — 目标预转换高度。

	`postLayoutTransform:Boolean` (default = `true`) — 为 `true` 时，返回的边框位于其父空间中已转换元素的周围（首先应用元素的转换）。

Number — 返回转换的宽度。Transformation 是此元素的布局转换矩阵。

法律声明 | 在线隐私策略

SpriteVisualElement - AS3 Flex

包x

语言元素

附录

包 spark.core

baseline

baselinePosition

blendMode

bottom

depth

designLayer

hasLayoutMatrix3D

horizontalCenter

id

includeInLayout

is3D

layoutDirection

left

luminosityClip

luminosityInvert

mask

maskType

moduleFactory

owner

percentHeight

percentWidth

postLayoutTransformOffsets

right

rotationX

rotationY

top

transformX

transformY

transformZ

verticalCenter

viewHeight

viewWidth

visible