ImageElement

包	org.osmf.elements
类	public class ImageElement
继承	ImageElement LoadableElementBase MediaElement EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

ImageElement 是专门为显示静止图像创建的媒体元素。它可以加载和显示任何 PNG、GIF 或 JPG 图像。

创建和使用 ImageElement 的基本步骤：

创建一个指向要加载的图像的 URL 的新 URLResource。
创建新的 ImageElement，将 URLResource 作为参数传递。
创建新的 MediaPlayer。
将 ImageElement 指定给 MediaPlayer 的 media 属性。
从 MediaPlayer 的 displayObject 属性获取 DisplayObject 并将其添加到显示列表中。请注意，可能无法立即使用 displayObject 属性，在这种情况下，您可以侦听 MediaPlayer 的 displayObjectChange 事件。
完成有关 ImageElement 的操作后，将 MediaPlayer 的 media 属性设置为 null 并将 DisplayObject 从显示列表中删除。

查看示例

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		container : IMediaContainer [只读] 此元素使用的媒体容器。	MediaElement
		metadataNamespaceURLs : Vector.<String> [只读] 包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。	MediaElement
		resource : MediaResourceBase 此媒体元素对其执行操作的媒体资源。	MediaElement
		smoothing : Boolean 指定在缩放图像时是否应进行平滑处理。	ImageElement
		traitTypes : Vector.<String> [只读] MediaTraitType 值的矢量，表示此媒体元素的特征类型。	MediaElement

受保护的属性

隐藏继承的受保护属性

显示继承的受保护属性

	属性		由以下参数定义
		loader : LoaderBase 此元素用于加载资源的 LoaderBase。	LoadableElementBase

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		ImageElement(resource:URLResource = null, loader:ImageLoader = null) 构造函数。	ImageElement
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		addMetadata(namespaceURL:String, metadata:Metadata):void 将 Metadata 对象添加到指定命名空间 URL 下的此 MediaElement 中。	MediaElement
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getMetadata(namespaceURL:String):Metadata 返回存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。	MediaElement
		getTrait(type:String):org.osmf.traits:MediaTraitBase 返回指定类型的媒体特征。	MediaElement
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		hasTrait(type:String):Boolean 确定此媒体元素是否包含指定类型的媒体特征。	MediaElement
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		removeMetadata(namespaceURL:String):Metadata 删除存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。	MediaElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

隐藏继承的受保护方法

显示继承的受保护方法

	方法		由以下参数定义
		addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void 将新的媒体特征添加到此媒体元素。	MediaElement
		createLoadTrait(resource:MediaResourceBase, loader:LoaderBase):org.osmf.traits:LoadTrait 子类可以覆盖此方法以返回自定义 LoadTrait 子类。	LoadableElementBase
		processLoadingState():void 当媒体元素进入 LOADING 状态时，子类可以覆盖此方法以执行处理。	LoadableElementBase
		processReadyState():void 当媒体元素进入 READY 状态时，子类可以覆盖此方法以执行处理。	LoadableElementBase
		processUnloadingState():void 当媒体元素进入 UNLOADING 状态时，子类可以覆盖此方法以执行处理。	LoadableElementBase
		removeTrait(type:String):org.osmf.traits:MediaTraitBase 从此媒体元素中删除媒体特征。	MediaElement
		setupTraits():void 设置此媒体元素的特征。	MediaElement

事件

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

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
containerChange	在元素的容器属性发生变化时调度。	MediaElement
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
mediaError	在发生影响媒体元素的操作的错误时调度。	MediaElement
mediaInfo	当影响媒体元素操作的信息可用时调度。	MediaElement
metadataAdd	在将 Metadata 对象添加到此媒体元素时调度。	MediaElement
metadataRemove	在从此媒体元素中删除 Metadata 对象时调度。	MediaElement
traitAdd	在将某一特征添加到媒体元素时调度。	MediaElement
traitRemove	在从媒体元素中删除某一特征时调度。	MediaElement

属性详细信息

smoothing

属性

smoothing:Boolean

指定在缩放图像时是否应进行平滑处理。默认值为 false。

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

构造函数详细信息

示例如何使用本示例

ImageElementExample.as

package
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.ImageElement;
    import org.osmf.elements.VideoElement;
    import org.osmf.media.MediaPlayer;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    
    public class ImageElementExample extends Sprite
    {
        public function ImageElementExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var imageElement:ImageElement = new ImageElement();
            imageElement.resource = new URLResource("http://mediapm.edgesuite.net/strobe/content/test/train.jpg");
            
            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = imageElement;    
        }
    }
}

法律声明 | 在线隐私策略

ImageElement - AS3 OSMF

包x

语言元素

附录

包 org.osmf.elements

smoothing

	`resource:URLResource` (default = `null`) — 指向 ImageElement 将使用的图像源的 URLResource。

	`loader:ImageLoader` (default = `null`) — 用于加载图像的 ImageLoader。如果为 null，将创建 ImageLoader。