egret.ImageLoader

包    egret

类    public class ImageLoader

继承    egret.ImageLoader → egret.EventDispatcher → egret.HashObject

ImageLoader 类可用于加载图像（JPG、PNG 或 GIF）文件。使用 load() 方法来启动加载。被加载的图像对象数据将存储在 ImageLoader.data 属性上 。

公共属性

属性
crossOrigin : string [静态]指定是否启用跨域资源共享,如果ImageLoader实例有设置过crossOrigin属性将使用设置的属性
crossOrigin : string 当从其他站点加载一个图片时，指定是否启用跨域资源共享(CORS)，默认值为null
data : egret.BitmapData 使用 load() 方法加载成功的 BitmapData 图像数据

公共方法

方法
ImageLoader() 构造函数
load(url:string):void 启动一次图像加载

事件

Events
egret.Event.COMPLETE 加载完成
egret.IOErrorEvent.IO_ERROR 加载失败

属性详细信息

crossOrigin

crossOrigin : string

• 支持版本:Egret 2.5.7
• 运行平台:Web,Native

指定是否启用跨域资源共享,如果ImageLoader实例有设置过crossOrigin属性将使用设置的属性

crossOrigin

crossOrigin : string

• 支持版本:Egret 2.4
• 运行平台:Web,Native

当从其他站点加载一个图片时，指定是否启用跨域资源共享(CORS)，默认值为null。

可以设置为"anonymous","use-credentials"或null,设置为其他值将等同于"anonymous"。

data

data : egret.BitmapData = null

• 支持版本:Egret 2.4
• 运行平台:Web,Native

使用 load() 方法加载成功的 BitmapData 图像数据。

方法详细信息

ImageLoader()

public ImageLoader()

构造函数

• 支持版本:Egret 2.4
• 运行平台:Web,Native

load()

public load(url:string):void

启动一次图像加载。

注意：若之前已经调用过加载请求，重新调用 load() 将终止先前的请求，并开始新的加载。

• 支持版本:Egret 2.4
• 运行平台:Web,Native
• 参数
  • url:string - 要加载的图像文件的地址。

示例

/*
 * 下面的示例使用 egret.ImageLoader 类加载图片。
 */
class  ImageLoaderExample  extends  egret.DisplayObjectContainer  {
  public  constructor()  {
    super();
    var imageLoader:egret.ImageLoader  =  new  egret.ImageLoader();
    imageLoader.addEventListener(egret.Event.COMPLETE,this.loadCompleteHandler,this);
    imageLoader.load("resource/assets/lark.png");
  }
  private  loadCompleteHandler(event:egret.Event):void  {
    var imageLoader =  <egret.ImageLoader>event.currentTarget;
    let texture =  new  egret.Texture();
    texture._setBitmapData(imageLoader.data);
    var bitmap:egret.Bitmap  =  new  egret.Bitmap(texture);
    this.addChild(bitmap);
  }
}