BitmapAsset

包	mx.core
类	public class BitmapAsset
继承	BitmapAsset FlexBitmap Bitmap DisplayObject EventDispatcher Object
实现	IFlexAsset, IFlexDisplayObject, ILayoutDirectionElement

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

BitmapAsset 是 flash.display.Bitmap 类的子类，表示您在 Flex 应用程序中嵌入的位图图像。它用于实现 IFlexDisplayObject 接口，此接口允许在 Image 控件中显示嵌入的位图图像，或将位图图像用作容器背景或组件外观。

嵌入的位图图像可以是 JPEG、GIF 或 PNG 文件。您还可以嵌入由 Flash 生成的 SWF 文件中的位图元件。在上述每种情况下，MXML 编译器都会自动生成一个类，用于扩展 BitmapAsset 以显示嵌入的位图图像。

在写入 Flex 应用程序时，通常不必直接使用 BitmapAsset 类。例如，您可以通过编写如下内容来嵌入 GIF 文件并在 Image 控件中显示该图像：

  <mx:Image id="logo" source="@Embed(source='Logo.gif')"/>

也可以使用 CSS 语法编写如下内容来将该图像用作应用程序的背景图像

  <fx:Style>
      @namespace mx "library://ns.adobe.com/flex/mx"
      mx|Application {
          backgroundImage: Embed(source="Logo.gif")
      }
  <fx:Style/>

而不必了解 MXML 编译器已为您创建了 BitmapAsset 的一个子类。

不过，了解在 ActionScript 级别发生的操作可能会有用。要在 ActionScript 中嵌入位图图像，需要声明一个 Class 类型的变量，然后在其上放置 [Embed] 元数据。例如，您可以按如下所示嵌入 GIF 文件：

  [Bindable]
  [Embed(source="Logo.gif")]
  private var logoClass:Class;

MXML 编译器可识别 .gif 扩展名，将 GIF 数据的代码转换为播放器使用的位图格式，然后自动生成 BitmapAsset 类的子类，并将变量设置为引用此自动生成的类。接着，您可以借助 new 运算符来使用此类引用创建 BitmapAsset 实例，还可以对其应用 BitmapAsset 类的 API：

  var logo:BitmapAsset = BitmapAsset(new logoClass());
  logo.bitmapData.noise(4);

但是，您极少需要自己创建 BitmapAsset 实例，因为只需将 image-related 属性和样式设置为一个 image-producing 类，而组件会根据需要创建图像实例。例如，要在 Image 控件中显示此图像，您可以将 Image 的 source 属性设置为 logoClass。在 MXML 中，您可以按照以下方法执行此操作：

  <mx:Image id="logo" source="{logoClass}"/>

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。	DisplayObject
		alpha : Number 表示指定对象的 Alpha 透明度值。	DisplayObject
		bitmapData : BitmapData 被引用的 BitmapData 对象。	Bitmap
		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
		height : Number 表示显示对象的高度，以像素为单位。	DisplayObject
		layoutDirection : String 指定元素的所需布局方向：LayoutDirection.LTR（从左到右）、LayoutDirection.RTL（从右到左）或 null（继承）。	BitmapAsset
		loaderInfo : LoaderInfo [只读] 返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。	DisplayObject
		mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。	DisplayObject
		measuredHeight : Number [只读] 此对象的测量高度。	BitmapAsset
		measuredWidth : Number [只读] 此对象的测量宽度。	BitmapAsset
		metaData : Object 如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的，则获取 DisplayObject 实例的元数据对象。	DisplayObject
		mouseX : Number [只读] 表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。	DisplayObject
		mouseY : Number [只读] 表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。	DisplayObject
		name : String 表示 DisplayObject 的实例名称。	DisplayObject
		opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。	DisplayObject
		parent : DisplayObjectContainer [只读] 表示包含此显示对象的 DisplayObjectContainer 对象。	DisplayObject
		pixelSnapping : String 控制 Bitmap 对象是否贴紧至最近的像素。	Bitmap
		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
		smoothing : Boolean 控制在缩放时是否对位图进行平滑处理。	Bitmap
		stage : Stage [只读] 显示对象的舞台。	DisplayObject
		transform : flash.geom:Transform 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	DisplayObject
		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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		BitmapAsset(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false) 构造函数。	BitmapAsset
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。	DisplayObject
		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
		invalidateLayoutDirection():void 当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。	BitmapAsset
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		local3DToGlobal(point3d:Vector3D):Point 将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。	DisplayObject
		localToGlobal(point:Point):Point 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。	DisplayObject
		move(x:Number, y:Number):void 将此对象移动到指定的 x 和 y 坐标。	BitmapAsset
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setActualSize(newWidth:Number, newHeight:Number):void 设置此对象的实际大小。	BitmapAsset
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。	FlexBitmap
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

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

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
added	将显示对象添加到显示列表中时调度。	DisplayObject
addedToStage	在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。	DisplayObject
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
enterFrame	[播放事件] 播放头进入新帧时调度。	DisplayObject
exitFrame	[广播事件] 播放头退出当前帧时调度。	DisplayObject
frameConstructed	[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。	DisplayObject
removed	将要从显示列表中删除显示对象时调度。	DisplayObject
removedFromStage	在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。	DisplayObject
render	[广播事件] 将要更新和呈现显示列表时调度。	DisplayObject

属性详细信息

layoutDirection

属性

layoutDirection:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4.1

运行时版本:

Flash Player 10, AIR 1.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

measuredHeight

属性

measuredHeight:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此对象的测量高度。

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

实现
public function get measuredHeight():Number

measuredWidth

属性

measuredWidth:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此对象的测量宽度。

实现
public function get measuredWidth():Number

构造函数详细信息

()

构造函数

public function BitmapAsset(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

参数

	`bitmapData:BitmapData` (default = `null`) — 位图图像的数据。

	`pixelSnapping:String` (default = "`auto`") — 位图是否与最近的像素对齐。

	`smoothing:Boolean` (default = `false`) — 在缩放时是否对位图进行平滑处理。

方法详细信息

invalidateLayoutDirection

()

方法

public function invalidateLayoutDirection():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.1

运行时版本:

Flash Player 10, AIR 1.5

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

move

()

方法

public function move(x:Number, y:Number):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将此对象移动到指定的 x 和 y 坐标。

参数

	`x:Number` — 此对象的新 x 位置。

	`y:Number` — 此对象的新 y 位置。

setActualSize

()

方法

public function setActualSize(newWidth:Number, newHeight:Number):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置此对象的实际大小。

此方法主要用于实现 updateDisplayList() 方法。在此期间，您可以根据其显式大小、相对于父项的（百分比）大小以及度量大小计算此对象的实际大小。然后，通过调用 setActualSize() 将此实际大小应用于对象。

在其他情况下，您应该设置 width、height、percentWidth 或 percentHeight 属性，而非调用此方法。

参数

	`newWidth:Number` — 此对象的新宽度。

	`newHeight:Number` — 此对象的新高度。

法律声明 | 在线隐私策略

BitmapAsset - AS3 Flex

类 x

layoutDirection

measuredHeight

measuredWidth

BitmapAsset

invalidateLayoutDirection

move

setActualSize