BitmapImage

包	spark.primitives
类	public class BitmapImage
继承	BitmapImage GraphicElement EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4.0

运行时版本:

Flash Player 10, AIR 2.0

BitmapImage 元素在其父元素的坐标空间内定义一个矩形区域，使用从源文件或源 URL 获取的位图数据填充。

查看示例

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		alpha : Number 图形元素的透明度级别。	GraphicElement
		alwaysCreateDisplayObject : Boolean 指定此 GraphicElement 是否与其 DisplayObject 相关联，并呈示于 DisplayObject。	GraphicElement
		baseline : Object 从锚点目标到控件的基线位置的垂直距离（以像素为单位）。	GraphicElement
		baselinePosition : Number [只读] 组件第一行文本的基线的 y 坐标。	GraphicElement
		bitmapData : BitmapData [只读] 返回 BitmapData 对象的副本，该对象表示当前加载的图像内容（未缩放）。	BitmapImage
		blendMode : String BlendMode 类中的一个值，用于指定要使用的混合模式。	GraphicElement
		bottom : Object 从组件的下边缘到锚点目标的下边缘的垂直距离（以像素为单位）。	GraphicElement
		bytesLoaded : Number [只读] 已加载的图像的字节数。	BitmapImage
		bytesTotal : Number [只读] 已加载的或待加载的总图像数据（以字节为单位）。	BitmapImage
		clearOnLoad : Boolean 指示是否在加载新内容之前清除以前的图像内容。	BitmapImage
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		contentLoader : IContentLoader 可选自定义图像加载器（即	BitmapImage
		contentLoaderGrouping : String 要传递给相关联的 IContentLoader 实例的 load() 方法的可选内容分组标识符。	BitmapImage
		depth : Number 确定容器内各项目的呈示顺序。	GraphicElement
		designLayer : DesignLayer 指定与该可视元素关联的可选 DesignLayer 实例。	GraphicElement
		displayObject : DisplayObject [只读] 绘制此 IGraphicElement 所在的共享 DisplayObject。	GraphicElement
		displayObjectSharingMode : String 指示此 IGraphicElement 与其显示对象之间的关联。	GraphicElement
		explicitHeight : Number 指定该组件在组件坐标中显式高度（以像素为单位）的数字。	GraphicElement
		explicitMaxHeight : Number 布局过程中父级要考虑的组件最大建议高度。	GraphicElement
		explicitMaxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。	GraphicElement
		explicitMinHeight : Number 布局过程中父级要考虑的组件最小建议高度。	GraphicElement
		explicitMinWidth : Number 布局过程中父级要考虑的组件最小建议宽度。	GraphicElement
		explicitWidth : Number 指定该组件在组件坐标中显式宽度（以像素为单位）的数字。	GraphicElement
		fillMode : String 确定位图填充尺寸的方式。	BitmapImage
		filters : Array 包含当前与图形元素关联的每个滤镜对象的索引数组。	GraphicElement
		hasLayoutMatrix3D : Boolean [只读] 如果元素具有 3D 矩阵，则为 true。	GraphicElement
		height : Number 图形元素的高度。	GraphicElement
		horizontalAlign : String 当内容的高宽比不是 1:1 且 scaleMode 设置为 mx.graphics.BitmapScaleMode.LETTERBOX 时，内容的水平对齐方式。	BitmapImage
		horizontalCenter : Object 从组件中心到锚点目标的内容区域中心的水平距离（以像素为单位）。	GraphicElement
		id : String 组件的标识。	GraphicElement
		includeInLayout : Boolean 指定此元素是否包含在父代的布局中。	GraphicElement
		is3D : Boolean [只读] 当元素为 3D 时，则为 true。	GraphicElement
		layoutDirection : String 指定元素的所需布局方向：LayoutDirection.LTR（从左到右）、LayoutDirection.RTL（从右到左）或 null（继承）。	GraphicElement
		left : Object 从组件的左边缘到锚点目标的左边缘的水平距离（以像素为单位）。	GraphicElement
		luminosityClip : Boolean 控制发光度遮罩是否剪辑设置了遮罩的内容的属性。	GraphicElement
		luminosityInvert : Boolean 控制计算由发光度遮罩设置遮罩的图形元素的 RGB 颜色值的属性。	GraphicElement
		mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。	GraphicElement
		maskType : String 定义将遮罩应用到 GraphicElement 的方式。可能的值为 MaskType.CLIP、MaskType.ALPHA 和 MaskType.LUMINOSITY。剪辑遮罩 - 遮罩处于剪辑模式下时，会将剪辑遮罩减少至 1 位。	GraphicElement
		maxHeight : Number 布局过程中父级要考虑的组件最大建议高度。	GraphicElement
		maxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。	GraphicElement
		measuredHeight : Number 组件的默认高度（以像素为单位）。	GraphicElement
		measuredWidth : Number 组件的默认宽度（以像素为单位）。	GraphicElement
		measuredX : Number 相对于元素的原点的默认测量界限左上角。	GraphicElement
		measuredY : Number 相对于元素的原点的默认测量界限左上角。	GraphicElement
		minHeight : Number 布局过程中父级要考虑的组件最小建议高度。	GraphicElement
		minWidth : Number 布局过程中父级要考虑的组件最小建议宽度。	GraphicElement
		owner : DisplayObjectContainer 此 IVisualElement 对象的所有者。	GraphicElement
		parent : DisplayObjectContainer [只读] 此组件的父容器或组件。	GraphicElement
		percentHeight : Number 以组件父代大小百分比的方式指定组件高度。	GraphicElement
		percentWidth : Number 以组件父代大小百分比的方式指定组件宽度。	GraphicElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets 定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。	GraphicElement
		preliminaryHeight : Number 当布局请求图像的“测量”范围，但图像数据尚未完成加载时，提供要使用的高度的估计值。	BitmapImage
		preliminaryWidth : Number 当布局请求图像的“测量”范围，但图像数据尚未完成加载时，提供要使用的宽度的估计值。	BitmapImage
		right : Object 从组件的右边缘到锚点目标的右边缘的水平距离（以像素为单位）。	GraphicElement
		rotation : Number 指示元素从转换点的旋转（以度为单位）。	GraphicElement
		rotationX : Number 指示 element 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。	GraphicElement
		rotationY : Number 表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。	GraphicElement
		rotationZ : Number 指示元素从转换点的旋转（以度为单位）。	GraphicElement
		scaleMode : String 确定当 fillMode 设置为 mx.graphics.BitmapFillMode.SCALE 时如何缩放图像。	BitmapImage
		scaleX : Number 从转换点开始应用的元素的水平缩放比例（百分比）。	GraphicElement
		scaleY : Number 从转换点开始应用的元素的垂直缩放比例（百分比）。	GraphicElement
		scaleZ : Number 从转换点开始应用的元素的 z 缩放比例（百分比）。	GraphicElement
		smooth : Boolean 指定是否将平滑处理算法应用于位图图像。	BitmapImage
		smoothingQuality : String 确定如何缩小图像。	BitmapImage
		source : Object 用于位图填充的源。	BitmapImage
		sourceHeight : Number [只读] 提供原始图像数据的未缩放高度。	BitmapImage
		sourceWidth : Number [只读] 提供原始图像数据的未缩放宽度。	BitmapImage
		top : Object 从组件的上边缘到锚点目标的上边缘的垂直距离（以像素为单位）。	GraphicElement
		transform : flash.geom:Transform 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	GraphicElement
		transformX : Number 元素的 x 位置转换点。	GraphicElement
		transformY : Number 元素的 y 位置转换点。	GraphicElement
		transformZ : Number 元素的 z 位置转换点。	GraphicElement
		trustedSource : Boolean [只读] 一个只读标志，指示是否将当前加载的内容视为是从其安全策略允许跨域图像访问的源加载的。	BitmapImage
		verticalAlign : String 当内容的高宽比不是 1:1 且 scaleMode 设置为 mx.graphics.BitmapScaleMode.LETTERBOX 时，内容的垂直对齐方式。	BitmapImage
		verticalCenter : Object 从组件中心到锚点目标的内容区域中心的垂直距离（以像素为单位）。	GraphicElement
		visible : Boolean 控制此可视元素的可见性。	GraphicElement
		width : Number 图形元素的宽度。	GraphicElement
		x : Number 图形元素的 x 位置。	GraphicElement
		y : Number 图形元素的 y 位置。	GraphicElement
		z : Number 图形元素的 z 位置。	GraphicElement

受保护的属性

隐藏继承的受保护属性

显示继承的受保护属性

	属性		由以下参数定义
		drawnDisplayObject : DisplayObject [只读] GraphicElement 在其中绘制的实际 DisplayObject。	GraphicElement
		drawX : Number [只读] 应该绘制元素的 x 位置。	GraphicElement
		drawY : Number [只读] 应该绘制元素的 y 位置。	GraphicElement
		hasComplexLayoutMatrix : Boolean [只读] 如果 GraphicElement 具有任何非平移 (x,y) 转换属性，则返回 true。	GraphicElement
		layoutFeatures : AdvancedLayoutFeatures 包含 GraphicElement 实现转换和分层支持的方法的所有实现细节。	GraphicElement
		needsDisplayObject : Boolean [只读] 如果元素需要一个独占 DisplayObject，则为 true。	GraphicElement

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		BitmapImage() 构造函数。	BitmapImage
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		canShareWithNext(element:IGraphicElement):Boolean 如果此 IGraphicElement 是兼容的且可以与序列中下一个 IGraphicElement 共享显示对象，则返回 true。	GraphicElement
		canShareWithPrevious(element:IGraphicElement):Boolean 如果此 IGraphicElement 是兼容的且可以与序列中上一个 IGraphicElement 共享显示对象，则返回 true。	GraphicElement
		createDisplayObject():DisplayObject 创建一个新 DisplayObject 以用于绘制此 IGraphicElement。	GraphicElement
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 x 坐标。	GraphicElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 y 坐标。	GraphicElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的布局高度。	GraphicElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的布局宽度。	GraphicElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 x 坐标。	GraphicElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 y 坐标。	GraphicElement
		getLayoutMatrix():Matrix 返回用于相对于其同级组件计算组件的布局的转换矩阵。	GraphicElement
		getLayoutMatrix3D():Matrix3D 返回此元素的布局转换 Matrix3D。	GraphicElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最大高度。	GraphicElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最大宽度。	GraphicElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最小高度。	GraphicElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最小宽度。	GraphicElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的首选高度。	GraphicElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的首选宽度。	GraphicElement
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initialized(document:Object, id:String):void 如果 GraphicElement 是使用 MXML 标签创建的，则由 MXML 编译器自动调用。	GraphicElement
		invalidateDisplayList():void 调用此方法将导致在呈示显示列表前调用元素的 validateDisplayList() 方法。	GraphicElement
		invalidateLayoutDirection():void 当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。	GraphicElement
		invalidateProperties():void 调用此方法将导致在呈示显示列表前调用元素的 validateProperties() 方法。	GraphicElement
		invalidateSize():void 调用此方法将导致在呈示显示列表前调用元素的 validateSize() 方法。	GraphicElement
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		localToGlobal(point:Point):Point 将 Point 对象从对象的（局部）坐标转换为舞台（全局）坐标。	GraphicElement
		parentChanged(value:IGraphicElementContainer):void 将 IGraphicElement 添加到主机组件或从主机组件将其删除时由 IGraphicElementContainer 调用。	GraphicElement
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setLayoutBoundsPosition(newBoundsX:Number, newBoundsY:Number, postLayoutTransform:Boolean = true):void 设置元素在屏幕上进行绘制时所用的坐标。	GraphicElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void 设置元素的布局大小。	GraphicElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void 设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。	GraphicElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void 设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。	GraphicElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean 确定此元素是否可以将它自己绘制到该序列的 sharedDisplayObject。	GraphicElement
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		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 用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。	GraphicElement
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void 一种实用程序方法，用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。	GraphicElement
		validateDisplayList():void 由 IGraphicElementContainer 调用以在其 displayObject 属性中重新绘制此元素。	GraphicElement
		validateNow():void 根据需要，通过立即调用 validateProperties()、validateSize() 和 validateDisplayList() 来验证并更新此对象的属性和布局。	GraphicElement
		validateProperties():void 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。	GraphicElement
		validateSize():void 由 IGraphicElementContainer 调用以验证此元素的大小。	GraphicElement
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

隐藏继承的受保护方法

显示继承的受保护方法

	方法		由以下参数定义
		canSkipMeasurement():Boolean 确定是否可以跳过对 measure() 方法的调用。	GraphicElement
		commitProperties():void [覆盖] 处理在元素上设置的属性。	BitmapImage
		getStrokeExtents(postLayoutTransform:Boolean = true):Rectangle 返回元素界限每一侧上的笔触所占据的像素数。	GraphicElement
		invalidateDisplayObjectSharing():void 通知主机此元素已更改且需要更新其图层的实用程序方法。	GraphicElement
		invalidateParentSizeAndDisplayList():void 此对象影响其布局时（includeInLayout 为 true），使父代大小和显示列表失效的 Helper 方法。	GraphicElement
		measure():void [覆盖] 计算元素的默认大小。	BitmapImage
		preferredHeightPreTransform():Number 用于 ILayoutElement 接口的实现，返回显式度量的高度预转换。	GraphicElement
		preferredWidthPreTransform():Number 用于 ILayoutElement 接口的实现，返回测量宽度预转换的显式。	GraphicElement
		transformHeightForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 转换元素的大小。	GraphicElement
		transformWidthForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 转换元素的大小。	GraphicElement
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void [覆盖] 绘制元素和/或调整其内容的大小并定位该内容。	BitmapImage

事件

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

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
complete	在内容加载完成时调度。	BitmapImage
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
httpStatus	在通过 HTTP 发出网络请求并且 Flash Player 或 AIR 可以检测到 HTTP 状态代码时调度。	BitmapImage
ioError	发生输入/输出错误时调度。	BitmapImage
progress	当加载内容时调度。	BitmapImage
ready	在内容加载完成时调度。	BitmapImage
securityError	发生安全性错误时调度。	BitmapImage

属性详细信息

bitmapData

属性

bitmapData:BitmapData [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

返回 BitmapData 对象的副本，该对象表示当前加载的图像内容（未缩放）。对于不受信任的跨域内容，此属性为 null。

默认值为 null。

实现
public function get bitmapData():BitmapData

bytesLoaded

属性

bytesLoaded:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

已加载的图像的字节数。仅与由请求 URL 加载的图像相关。

默认值为 NaN。

实现
public function get bytesLoaded():Number

bytesTotal

属性

bytesTotal:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

已加载的或待加载的总图像数据（以字节为单位）。仅与由请求 URL 加载的图像相关。

默认值为 NaN。

实现
public function get bytesTotal():Number

clearOnLoad

属性

clearOnLoad:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

指示是否在加载新内容之前清除以前的图像内容。

默认值为 true。

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

contentLoader

属性

contentLoader:IContentLoader

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

要与内容加载器客户端相关联的可选自定义图像加载器（即图像缓存或排队）。

默认值为 null。

实现
public function get contentLoader():IContentLoader
public function set contentLoader(value:IContentLoader):void

contentLoaderGrouping

属性

contentLoaderGrouping:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

要传递给相关联的 IContentLoader 实例的 load() 方法的可选内容分组标识符。仅在分配有效的 contentLoader 时才会考虑此属性。

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

fillMode

属性

fillMode:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

确定位图填充尺寸的方式。如果在标签中设置此属性的值，请使用字符串（如“repeat”）。如果您在 ActionScript 中设置此属性的值，请使用常量（如 mx.graphics.BitmapFillMode.CLIP）。

设置为 BitmapFillMode.CLIP（“clip”）时，位图在区域的边缘处结束。

设置为 BitmapFillMode.REPEAT（“repeat”）时，位图将重复以填充区域。

设置为 BitmapFillMode.SCALE（“scale”）时，位图将拉伸以填充区域。

默认值为 BitmapFillMode.SCALE。

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

相关 API 元素

mx.graphics.BitmapFillMode

horizontalAlign

属性

horizontalAlign:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

当内容的高宽比不是 1:1 且 scaleMode 设置为 mx.graphics.BitmapScaleMode.LETTERBOX 时，内容的水平对齐方式。

可以是 HorizontalAlign.LEFT ("left")、HorizontalAlign.RIGHT ("right") 或 HorizontalAlign.CENTER ("center") 之一。

仅当 fillMode 设置为 mx.graphics.BitmapFillMode.SCALE（“缩放”）时，此属性才适用。

默认值为 HorizontalAlign.CENTER。

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

preliminaryHeight

属性

preliminaryHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

当布局请求图像的“测量”范围，但图像数据尚未完成加载时，提供要使用的高度的估计值。如果为 NaN，则在图像完成加载之前，测量高度将一直是 0。

默认值为 NaN。

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

preliminaryWidth

属性

preliminaryWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

当布局请求图像的“测量”范围，但图像数据尚未完成加载时，提供要使用的宽度的估计值。如果为 NaN，则在图像完成加载之前，测量宽度将一直是 0。

默认值为 NaN。

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

scaleMode

属性

scaleMode:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10.1, AIR 2.0

确定当 fillMode 设置为 mx.graphics.BitmapFillMode.SCALE 时如何缩放图像。

当设置为 mx.graphics.BitmapScaleMode.STRETCH（“伸展”）时，图像被伸展以适应区域。

在设置为 BitmapScaleMode.LETTERBOX ("letterbox") 时，根据原始未缩放的图像的高宽比对图像进行缩放。

当设置为 BitmapScaleMode.ZOOM（“缩放”），图像会缩放以适应原始的未缩放图像的高宽比。这会导致在一个轴上出现裁剪。

默认值为 BitmapScaleMode.STRETCH。

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

smooth

属性

smooth:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

指定是否将平滑处理算法应用于位图图像。

如果为 false，则使用最近邻点算法来呈现放大的位图图像，而且该图像看起来是像素化的。如果为 true，则使用双线性算法来呈示放大的位图图像。使用最近邻点算法呈现通常较快。

默认值为 false。

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

smoothingQuality

属性

smoothingQuality:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

确定如何缩小图像。当设置为 BitmapSmoothingQuality.HIGH 时，将重新采样图像（如果数据来源受信任），以达到更高质量的结果。如果设置为 BitmapSmoothingQuality.DEFAULT，则使用缩放的位图填充的默认舞台品质。

默认值为 BitmapSmoothingQuality.DEFAULT。

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

source

属性

source:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

用于位图填充的源。可以呈示基于各种图形源的填充，其中包括：

Bitmap 或 BitmapData 实例。
表示 DisplayObject 子类的类。BitmapFill 会将该类实例化并为其创建位图呈示。
DisplayObject 的实例。BitmapFill 将其复制到 Bitmap 中以供填充使用。
外部图像文件的名称。

如果使用某个图像文件作为源，则它可以是 PNG、GIF 或 JPG 类型。

要指定一个嵌入的图像源，可以使用 @Embed 指令，如下例所示：

      source="@Embed('<i>image_location</i>')"

可通过 URL、URLRequest 或文件引用指定图像位置。如果是文件引用，则其位置是相对于要编译的文件的位置的。

BitmapImage 类旨在与嵌入图像或在运行时加载的图像一起使用。

如果该源是 Bitmap 或 BitmapData 实例，或者是外部图像文件，则一旦不再需要该源时，调用者有责任清除该源。如果 ImageLoader 创建了 BitmapData 实例，则它将在该源更改后清除 BitmapData。

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

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

sourceHeight

属性

sourceHeight:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

提供原始图像数据的未缩放高度。

默认值为 NaN。

实现
public function get sourceHeight():Number

sourceWidth

属性

sourceWidth:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

提供原始图像数据的未缩放宽度。

默认值为 NaN。

实现
public function get sourceWidth():Number

trustedSource

属性

trustedSource:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 9, AIR 1.5

一个只读标志，指示是否将当前加载的内容视为是从其安全策略允许跨域图像访问的源加载的。为 false 时，不允许执行高级位图操作，如高品质缩放和拼贴。在全部加载图像后设置此标志。

默认值为 true。

实现
public function get trustedSource():Boolean

verticalAlign

属性

verticalAlign:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

当内容的高宽比不是 1:1 且 scaleMode 设置为 mx.graphics.BitmapScaleMode.LETTERBOX 时，内容的垂直对齐方式。

可以是 VerticalAlign.TOP ("top")、VerticalAlign.BOTTOM ("bottom") 或 VerticalAlign.MIDDLE ("middle") 之一。

此属性仅在 scaleMode 设置为 BitmapFillMode.SCALE ("scale") 时才适用。

默认值为 VerticalAlign.MIDDLE。

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

构造函数详细信息

()

构造函数

public function BitmapImage()

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

方法详细信息

commitProperties

()

方法

override protected function commitProperties():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

measure

()

方法

override protected function measure():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

计算元素的默认大小。此方法是一种高级方法，可在创建 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。

updateDisplayList

()

方法

override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

参数

	`unscaledWidth:Number` — 指定组件在组件坐标中的宽度（以像素为单位），而不考虑该组件的 `scaleX` 属性值。

	`unscaledHeight:Number` — 指定组件在组件坐标中的高度（以像素为单位），而不考虑该组件的 `scaleY` 属性值。

事件详细信息

complete

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.COMPLETE

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

在内容加载完成时调度。仅对基于 URL 和 ByteArray 的源（这些源需要加载器）调度此事件。

请注意，对于通过加载器加载的内容，将调度 ready 和 complete 事件。

对于其它源类型（如嵌入），仅调度 ready。

Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	已完成加载的网络对象。

httpStatus

事件

事件对象类型: flash.events.HTTPStatusEvent
属性 HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

在通过 HTTP 发出网络请求并且 Flash Player 或 AIR 可以检测到 HTTP 状态代码时调度。

HTTPStatusEvent.HTTP_STATUS 常量定义 httpStatus 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`status`	由服务器返回的 HTTP 状态代码。
`target`	接收 HTTP 状态代码的网络对象。

ioError

事件

事件对象类型: flash.events.IOErrorEvent
属性 IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

发生输入/输出错误时调度。

定义 ioError 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`errorID`	与特定错误关联的引用编号（仅限 AIR）。
`target`	发生输入/输出错误的网络对象。
`text`	要显示为错误消息的文本。

相关 API 元素

flash.events.IOErrorEvent

progress

事件

事件对象类型: flash.events.ProgressEvent
属性 ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

当加载内容时调度。

注意：不能保证调度 progress 事件。在不调度任何 progress 事件的情况下，也可能会接收 complete 事件。如果加载的内容是本地文件，就可能会出现这种情况。

定义 progress 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`bytesLoaded`	在侦听器处理事件时加载的项数或字节数。
`bytesTotal`	如果加载进程成功，最终将加载的项目或字节总数。
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	报告进度的对象。

ready

事件

事件对象类型: mx.events.FlexEvent
属性 FlexEvent.type = mx.events.FlexEvent.READY

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

在内容加载完成时调度。与 complete 事件不同，将为所有源类型调度此事件。

请注意，对于通过加载器加载的内容，将调度 ready 和 complete 事件。

对于其它源类型（如嵌入），仅调度 ready。

FlexEvent.READY 常量为 ready 事件定义事件对象的 type 属性的值。此事件由 BitmapImage 和 Spark Image 类调度以指示指定的图像源已完全加载。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`returnValue`	null
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果使用 `myImage.addEventListener()` 注册事件侦听器，则 myImage 是 `currentTarget` 的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	FlexEvent.READY

securityError

事件

事件对象类型: flash.events.SecurityErrorEvent
属性 SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

发生安全性错误时调度。

SecurityErrorEvent.SECURITY_ERROR 常量定义 securityError 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	报告安全错误的网络对象。
`text`	要显示为错误消息的文本。

相关 API 元素

flash.events.SecurityErrorEvent

示例如何使用本示例

BitmapImageExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- BitmapGraphicExample.mxml -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark">

    <s:Panel title="Bitmap Graphic Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <s:Group left="10" right="10" top="10" bottom="10">
            <!-- Single image, not resized, not repeated. -->
            <s:Graphic x="0" y="0">             
                <s:BitmapImage id="bg1" source="@Embed('assets/AirIcon12x12.gif')" fillMode="clip"/>
            </s:Graphic>

            <!-- Single image, scaled to fit specified dimensions. -->
            <s:Graphic x="150" y="0">
                <s:BitmapImage id="bg2" source="@Embed('assets/AirIcon12x12.gif')" width="60" height="60" fillMode="scale"/>
            </s:Graphic>

            <!-- Repeated image to fit specified dimensions. -->
            <s:Graphic x="300" y="0">
                <s:BitmapImage id="bg3" source="@Embed('assets/AirIcon12x12.gif')" width="120" height="120" fillMode="repeat"/>
            </s:Graphic>
        </s:Group>
    </s:Panel>

</s:Application>

法律声明 | 在线隐私策略

BitmapImage - AS3 Flex

包x

语言元素

附录

包 spark.primitives

bitmapData

bytesLoaded

bytesTotal

clearOnLoad

contentLoader

contentLoaderGrouping

fillMode

horizontalAlign

preliminaryHeight

preliminaryWidth

scaleMode

smooth

smoothingQuality

source

sourceHeight

sourceWidth

trustedSource

verticalAlign

BitmapImage

commitProperties

measure

updateDisplayList

complete

httpStatus

ioError

progress

ready

securityError