用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
org.osmf.elements 

ImageElement  - AS3 OSMF

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

语言版本: ActionScript 3.0
产品版本: OSMF 1.0
运行时版本: Flash Player 10, AIR 1.5

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

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

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

查看示例

相关 API 元素



公共属性
 属性由以下参数定义
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedcontainer : IMediaContainer
[只读] 此元素使用的媒体容器。
MediaElement
 InheritedmetadataNamespaceURLs : Vector.<String>
[只读] 包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。
MediaElement
 Inheritedresource : MediaResourceBase
此媒体元素对其执行操作的媒体资源。
MediaElement
  smoothing : Boolean
指定在缩放图像时是否应进行平滑处理。
ImageElement
 InheritedtraitTypes : Vector.<String>
[只读] MediaTraitType 值的矢量,表示此媒体元素的特征类型。
MediaElement
受保护的属性
 属性由以下参数定义
 Inheritedloader : LoaderBase
此元素用于加载资源的 LoaderBase。
LoadableElementBase
公共方法
 方法由以下参数定义
  
ImageElement(resource:URLResource = null, loader:ImageLoader = null)
构造函数。
ImageElement
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
addMetadata(namespaceURL:String, metadata:Metadata):void
将 Metadata 对象添加到指定命名空间 URL 下的此 MediaElement 中。
MediaElement
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
返回存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。
MediaElement
 Inherited
返回指定类型的媒体特征。
MediaElement
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
确定此媒体元素是否包含指定类型的媒体特征。
MediaElement
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
删除存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。
MediaElement
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法由以下参数定义
 Inherited
将新的媒体特征添加到此媒体元素。
MediaElement
 Inherited
子类可以覆盖此方法以返回自定义 LoadTrait 子类。
LoadableElementBase
 Inherited
当媒体元素进入 LOADING 状态时,子类可以覆盖此方法以执行处理。
LoadableElementBase
 Inherited
当媒体元素进入 READY 状态时,子类可以覆盖此方法以执行处理。
LoadableElementBase
 Inherited
当媒体元素进入 UNLOADING 状态时,子类可以覆盖此方法以执行处理。
LoadableElementBase
 Inherited
从此媒体元素中删除媒体特征。
MediaElement
 Inherited
设置此媒体元素的特征。
MediaElement
事件
 事件 摘要 由以下参数定义
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited在元素的容器属性发生变化时调度。MediaElement
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited在发生影响媒体元素的操作的错误时调度。MediaElement
 Inherited当影响媒体元素操作的信息可用时调度。MediaElement
 Inherited在将 Metadata 对象添加到此媒体元素时调度。MediaElement
 Inherited在从此媒体元素中删除 Metadata 对象时调度。MediaElement
 Inherited在将某一特征添加到媒体元素时调度。MediaElement
 Inherited在从媒体元素中删除某一特征时调度。MediaElement
属性详细信息

smoothing

属性
smoothing:Boolean

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



实现
    public function get smoothing():Boolean
    public function set smoothing(value:Boolean):void
构造函数详细信息

ImageElement

()构造函数
public function ImageElement(resource:URLResource = null, loader:ImageLoader = null)

语言版本: ActionScript 3.0
产品版本: OSMF 1.0
运行时版本: Flash Player 10, AIR 1.5

构造函数。

参数
resource:URLResource (default = null) — 指向 ImageElement 将使用的图像源的 URLResource。
 
loader:ImageLoader (default = null) — 用于加载图像的 ImageLoader。如果为 null,将创建 ImageLoader。
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;    
        }
    }
}




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。