| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
LoaderInfo クラスは、読み込まれる SWF ファイルやイメージファイル(JPEG、GIF、PNG ファイルなど)に関する情報を提供します。LoaderInfo オブジェクトは、すべての表示オブジェクトで使用できます。提供される情報には、読み込みの進行状況、読み込む側と読み込まれたコンテンツの URL、メディアの総バイト数、メディアの規格高さと幅などが含まれます。
次に示す 2 つの方法で LoaderInfo オブジェクトにアクセスできます。
-
flash.display.Loader オブジェクトの
contentLoaderInfo プロパティ — contentLoaderInfo プロパティは常にすべての Loader オブジェクトに対して使用できます。load() メソッドまたは loadBytes() メソッドを呼び出していない Loader オブジェクトや、読み込みが完了していない Loader オブジェクトの場合、contentLoaderInfo プロパティの各種プロパティにアクセスしようとするとエラーがスローされます。
-
表示オブジェクトの
loaderInfo プロパティ。
Loader オブジェクトの contentLoaderInfo プロパティは、Loader オブジェクトが読み込むコンテンツに関する情報を提供するのに対して、DisplayObject の loaderInfo プロパティは、その表示オブジェクトのルート SWF ファイルに関する情報を提供します。
Loader オブジェクトを使用して表示オブジェクト(SWF ファイル、ビットマップなど)をロードした場合、表示オブジェクトの loaderInfo プロパティは Loader オブジェクトの contentLoaderInfo プロパティと同じになります(DisplayObject.loaderInfo = Loader.contentLoaderInfo)。 SWF ファイルのメインクラスのインスタンスに Loader オブジェクトは含まれないので、loaderInfo プロパティは、SWF ファイルのメインクラスのインスタンスの LoaderInfo にアクセスする唯一の方法です。
次の図は、SWF ファイルのメインクラスのインスタンス、Loader オブジェクトの contentLoaderInfo プロパティ、読み込まれたオブジェクトの loaderInfo プロパティの場合のそれぞれ異なる LoaderInfo オブジェクトの使用方法を示します。
読み込み処理が完了していない場合、Loader オブジェクトの contentLoaderInfo プロパティのいくつかのプロパティは取得できません。bytesLoaded、bytesTotal、url、loaderURL、applicationDomain などのいくつかのプロパティは取得できます。 loaderInfo オブジェクトが init イベントを送出すると、loaderInfo オブジェクトと読み込み済みのイメージまたは SWF ファイルのすべてのプロパティにアクセスできます。
注意:LoaderInfo オブジェクトのプロパティはすべて読み取り専用です。
EventDispatcher.dispatchEvent() メソッドは、LoaderInfo オブジェクトに適用できません。LoaderInfo オブジェクトで dispatchEvent() を呼び出した場合、IllegalOperationError 例外がスローされます。
例を表示
actionScriptVersion:uint [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込み済みの SWF ファイルの ActionScript バージョンです。言語バージョンは、ActionScriptVersion クラスに列挙されているものを使用して指定されます。例えば、ActionScriptVersion.ACTIONSCRIPT2 や ActionScriptVersion.ACTIONSCRIPT3 です。
注意:このプロパティの値は、必ず、ActionScriptVersion.ACTIONSCRIPT2 または ActionScriptVersion.ACTIONSCRIPT3 のいずれかになります。ActionScript 1.0 と 2.0 はどちらも ActionScriptVersion.ACTIONSCRIPT2(バージョン 2.0)と見なされます。このプロパティは、ActionScript 1.0/2.0 と ActionScript 3.0 だけを区別します。
実装 public function get actionScriptVersion():uint 例外 | Error — ファイルのダウンロードが完了しておらず、要求した情報を取得していない場合 |
| |
| Error — ファイルが SWF ファイルでない場合 |
関連項目
applicationDomain:ApplicationDomain [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
外部 SWF ファイルが読み込まれると、読み込まれたクラスに含まれているすべての ActionScript 3.0 定義は applicationDomain プロパティに格納されます。
SWF ファイル内のすべてのコードは、アプリケーションドメイン内に存在するように定義されます。現在のアプリケーションドメインは、メインアプリケーションが実行されている場所です。システムドメインには、現在のドメインおよび Flash Player または Adobe AIR によって使用されるすべてのクラスを含む、すべてのアプリケーションドメインが含まれます。
システムドメインを除くすべてのアプリケーションドメインには、親ドメインが関連付けられています。メインアプリケーションの applicationDomain の親ドメインは、システムドメインです。読み込まれるクラスは、その親によってまだ定義されていない場合にのみ定義されます。読み込まれるクラスの定義を新しい定義でオーバーライドすることはできません。
アプリケーションドメインの使用例については、『ActionScript 3.0 のプログラミング』の「クライアントのシステム環境」の章を参照してください。
実装 public function get applicationDomain():ApplicationDomain 例外 | SecurityError — この呼び出し元のセキュリティサンドボックスからは、この ApplicationDomain にアクセスできません。 |
関連項目
bytes:ByteArray [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.115.0 |
LoaderInfo オブジェクトに関連付けられているバイト数です。
実装 public function get bytes():ByteArray 例外 | SecurityError —
この API にアクセスするオブジェクトが、セキュリティの制限のために読み込まれたオブジェクトにアクセスできません。このような状況は、例えば、Loader オブジェクトが contentLoaderInfo.content プロパティにアクセスしようとするときに、読み込まれたコンテンツにアクセスするセキュリティの許可が与えられていない場合に生じます。
詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。
|
bytesLoaded:uint [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
そのメディアの読み込み済みのバイト数です。この数値が bytesTotal の値と同じである場合、すべてのバイト数が読み込まれます。
実装 public function get bytesLoaded():uintbytesTotal:uint [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
メディアファイル全体の圧縮後のバイト数です。
最初の progress イベントが、この LoaderInfo オブジェクトの対応する Loader オブジェクトによって送出される前、bytesTotal は 0 です。Loader オブジェクトの最初の progress イベントの後、bytesTotal は、ダウンロードされる実際のバイト数を反映します。
実装 public function get bytesTotal():uint関連項目
childAllowsParent:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
コンテンツ(子)から読み込む側(親)への信頼関係を表します。子が親へのアクセスを許可されている場合は true、そうでない場合は false です。 このプロパティが true に設定されるのは、子オブジェクトが allowDomain() メソッドを呼び出して親ドメインへの許可を受けている場合、または子ドメインに URL ポリシーがロードされていて親ドメインへの許可を受けている場合です。 子と親が同じドメインに置かれている場合、このプロパティは true に設定されます。
詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。
実装 public function get childAllowsParent():Boolean 例外 | Error — ファイルのダウンロードが完了しておらず、要求した情報を取得していない場合に、スローされます。 |
childSandboxBridge:Object [読み書き可能]
Loader オブジェクトのサンドボックスにあるコードによってアクセスできるプロパティとメソッドを公開するために、ロードされたコンテンツのコードで設定できるオブジェクトです。このサンドボックスブリッジによって、アプリケーション以外のドメインからのコンテンツが AIR アプリケーションサンドボックスのスクリプトへのアクセスを制御しており、また、その逆も行っています。サンドボックスブリッジは、サンドボックス間のゲートウェイとして機能し、アプリケーションとアプリケーション以外のセキュリティサンドボックスの間での明示的なやり取りを提供します。
実装 public function get childSandboxBridge():Object public function set childSandboxBridge(value:Object):void 例外 関連項目
content:DisplayObject [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この LoaderInfo オブジェクトに関係した読み込まれたオブジェクトです。
実装 public function get content():DisplayObject 例外 | SecurityError —
この API にアクセスするオブジェクトが、セキュリティの制限のために読み込まれたオブジェクトにアクセスできません。このような状況は、例えば、Loader オブジェクトが contentLoaderInfo.content プロパティにアクセスしようとするときに、読み込まれたコンテンツにアクセスするセキュリティの許可が与えられていない場合に生じます。
詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。
|
contentType:String [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ロードされたファイルの MIME タイプです。ファイルのロードが正しく行われておらず、タイプを判別できない場合、この値は null です。 次のリストは、想定される値を示しています。
-
"application/x-shockwave-flash"
-
"image/jpeg"
-
"image/gif"
-
"image/png"
実装 public function get contentType():StringframeRate:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込み済みの SWF ファイルに関する 1 秒ごとのフレーム数を表す公称のフレームレートです。この数値はほとんどの場合整数ですが、整数でなくても構いません。
この値は、実際のフレームレートとは異なる場合があります。Flash Player または Adobe AIR は、すべてのロード済み SWF ファイルについて一度に 1 つのフレームレートしか使用せず、このフレームレートはメイン SWF ファイルの公称のフレームレートによって決まります。 また、メインのフレームレートは、ハードウェア、サウンド同期、およびその他の要素によっては達成できない場合があります。
実装 public function get frameRate():Number 例外 | Error — ファイルのダウンロードが完了しておらず、要求した情報を取得していない場合 |
| |
| Error — ファイルが SWF ファイルでない場合 |
height:int [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込まれたファイルの規格高さです。読み込まれたコンテンツやその親表示オブジェクトは拡大 / 縮小されている場合があるため、この値は表示されているコンテンツの実際の高さとは異なる場合があります。
実装 public function get height():int 例外 | Error — ファイルのダウンロードが完了しておらず、要求した情報を取得していない場合 |
loader:Loader [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この LoaderInfo オブジェクトに関係した Loader オブジェクトです。この LoaderInfo オブジェクトが、SWF ファイルのメインクラスのインスタンスの loaderInfo プロパティである場合、関係する Loader オブジェクトはありません。
実装 public function get loader():Loader 例外 | SecurityError —
この API にアクセスするオブジェクトが、セキュリティの制限のために Loader オブジェクトにアクセスできません。これは、例えば、読み込まれた SWF ファイルがその loaderInfo.loader プロパティにアクセスしようとするときに、読み込み元 SWF ファイルにアクセスするセキュリティの許可が与えられていない場合に生じます。
詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。
|
loaderURL:String [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この LoaderInfo オブジェクトによって記述されるメディアの読み込みを開始した SWF ファイルの URL です。SWF ファイルのメインクラスのインスタンスの場合、この URL は、SWF ファイル自体の URL と同じものです。
実装 public function get loaderURL():Stringparameters:Object [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込み済みの SWF ファイルに提供されるパラメータを表す、名前と値の組を含んだオブジェクトです。
for-in ループを使用すると、parameters オブジェクトからすべての名前と値を抽出できます。
パラメータは、メイン SWF ファイルの URL のクエリ文字列と、FlashVars HTML パラメータの値の 2 つから提供されます。この HTML パラメータはメイン SWF ファイルにのみ影響します。
parameters プロパティは、メインタイムラインのプロパティとして SWF ファイルパラメータを提供する ActionScript 1.0 および 2.0 の方法を置き換えます。
parameters プロパティの値は、ActionScript 1.0 または 2.0 を使用する SWF ファイルを含んだ Loader オブジェクトについては null です。ActionScript 3.0 を使用する SWF ファイルを含んだ Loader オブジェクトについてのみ、null 以外の値になります。
実装 public function get parameters():ObjectparentAllowsChild:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込む側(親)からコンテンツ(子)への信頼関係を表します。親が子のアクセスを許可している場合は true、そうでない場合は false です。 このプロパティが true に設定されるのは、親オブジェクトが allowDomain() メソッドを呼び出して子ドメインへの許可を受けている場合、または親ドメインに URL ポリシーファイルがロードされていて子ドメインへの許可を受けている場合です。 子と親が同じドメインに置かれている場合、このプロパティは true に設定されます。
詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。
実装 public function get parentAllowsChild():Boolean 例外 | Error — ファイルのダウンロードが完了しておらず、要求した情報を取得していない場合に、スローされます。 |
parentSandboxBridge:Object [読み書き可能]
ロードされたコンテンツのコードによってアクセスできるプロパティとメソッドを公開するために、Loader オブジェクトのサンドボックス内にあるコードで設定できるオブジェクトです。このサンドボックスブリッジによって、アプリケーション以外のドメインからのコンテンツが AIR アプリケーションサンドボックス内のスクリプトへのアクセスを制御しており、また、その逆も行っています。サンドボックスブリッジは、サンドボックス間のゲートウェイとして機能し、アプリケーションとアプリケーション以外のセキュリティサンドボックスの間での明示的なやり取りを提供します。
実装 public function get parentSandboxBridge():Object public function set parentSandboxBridge(value:Object):void 例外 | SecurityError — このプロパティを設定できるのは、Loader オブジェクトのサンドボックス内にあるコンテンツのみです。 |
関連項目
sameDomain:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込む側とそのコンテンツの間のドメインの関係を次のように表します。ドメインが同じ場合は true、異なる場合は false です。
実装 public function get sameDomain():Boolean 例外 | Error — ファイルのダウンロードが完了しておらず、要求した情報を取得していない場合に、スローされます。 |
sharedEvents:EventDispatcher [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
セキュリティ境界を越えてイベントを交換するために使用される EventDispatcher インスタンスです。Loader オブジェクトとロードされたコンテンツが、互いに信頼関係を確立していないセキュリティドメインに置かれている場合でも、どちらも sharedEvents にアクセスし、このオブジェクトを経由してイベントを送受信することができます。
実装 public function get sharedEvents():EventDispatcherswfVersion:uint [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込み済みの SWF ファイルのファイル形式のバージョンです。ファイル形式は、SWFVersion クラスに列挙されているものを使用して指定されます。例えば、SWFVersion.FLASH7 や SWFVersion.FLASH9 です。
実装 public function get swfVersion():uint 例外 | Error — ファイルのダウンロードが完了しておらず、要求した情報を取得していない場合 |
| |
| Error — ファイルが SWF ファイルでない場合 |
関連項目
url:String [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込まれるメディアの URL です。
この LoaderInfo オブジェクトの対応する Loader オブジェクトによって最初の progress イベントが送出されるまでは、url プロパティの値に、Loader オブジェクトの load() メソッドの呼び出しで指定した初期 URL しか反映されていない可能性があります。最初の progress イベントの後は、url プロパティはリダイレクトや相対 URL が解決された後のメディアの最終的な URL を反映します。
実装 public function get url():String関連項目
width:int [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込まれたコンテンツの規格幅です。読み込まれたコンテンツやその親表示オブジェクトは拡大 / 縮小されている場合があるため、この値は表示されているコンテンツの実際の幅とは異なる場合があります。
実装 public function get width():int 例外 | Error — ファイルのダウンロードが完了しておらず、要求した情報を取得していない場合 |
public static function getLoaderInfoByDefinition(object:Object):LoaderInfo| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.115.0 |
オブジェクトとして定義され、SWF ファイルに関連付けられている LoaderInfo オブジェクトを返します。
パラメータ
| object:Object — 関連付けられた LoaderInfo オブジェクトを取得する対象のオブジェクトです。 |
戻り値 | LoaderInfo —
関連付けられている LoaderInfo オブジェクトです。 null が、非デバッガビルドで呼び出されたとき(またはデバッグ機能が有効でないとき)、または参照されたオブジェクトに LoaderInfo オブジェクト(AIR ランタイムによって使用されるオブジェクトなど)が関連付けられていないときに返されます。
|
例外イベントオブジェクトの型: flash.events.Eventプロパティ Event.type = flash.events.Event.COMPLETE| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
データが正常にロードされたときに送出されます。つまり、すべてのコンテンツのダウンロードが完了し、ロードが完了したときに送出されます。complete イベントは、常に、init イベントの後に送出されます。 init イベントはオブジェクトにアクセス可能になったときに送出されますが、コンテンツはまだダウンロード中である可能性があります。
Event.COMPLETE 定数は、
type プロパティ(
complete イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|
bubbles
|
false
|
cancelable
|
false は、キャンセルするデフォルトの動作がないことを示します。
|
currentTarget
| イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target
| 読み込みが完了したネットワークオブジェクトです。 |
関連項目
イベントオブジェクトの型: flash.events.HTTPStatusEventプロパティ HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ネットワーク要求が HTTP を介して行われ、HTTP ステータスコードを検出できる場合に送出されます。
HTTPStatusEvent.HTTP_STATUS 定数は、
type プロパティ(
httpStatus イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|
bubbles
|
false
|
cancelable
|
false は、キャンセルするデフォルトの動作がないことを示します。
|
currentTarget
| イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
status
| サーバーから返された HTTP ステータスコードです。 |
target
| HTTP ステータスコードを受け取るネットワークオブジェクトです。 |
関連項目
イベントオブジェクトの型: flash.events.Eventプロパティ Event.type = flash.events.Event.INIT| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ロードされた SWF ファイルのプロパティおよびメソッドがアクセス可能で使用できる状態の場合に送出されます。ただし、コンテンツはダウンロード中の可能性があります。次に示す条件に適合するときに LoaderInfo オブジェクトは init イベントを送出します。
- 読み込まれたオブジェクトに関係したすべてのプロパティとメソッド、および LoaderInfo オブジェクトに関係したすべてのプロパティとメソッドにアクセスできます。
- すべての子オブジェクトのコンストラクタが完了済みです。
- ロードされた SWF のメインタイムラインの最初のフレームに含まれるすべての ActionScript コードが実行済みです。
例えば、ムービーまたはアニメーションの最初のフレームがロードされたとき、Event.INIT が送出されます。その時点で、ムービーはアクセス可能になり、表示リストに追加できます。ただし、ムービー全体のダウンロードには、さらに時間がかかる可能性があります。Event.COMPLETE は、ムービー全体がダウンロードされた時点で初めて送出されます。
init イベントは、常に、complete イベントの前に送出されます。
Event.INIT 定数は、
type プロパティ(
init イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|
bubbles
|
false
|
cancelable
|
false は、キャンセルするデフォルトの動作がないことを示します。
|
currentTarget
| イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target
| 読み込む SWF ファイルに関連付けられた LoaderInfo オブジェクトです。 |
関連項目
イベントオブジェクトの型: flash.events.IOErrorEventプロパティ IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
入出力エラーが発生して読み込み処理が失敗したときに送出されます。
type プロパティ(
ioError イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|
bubbles
|
false
|
cancelable
|
false は、キャンセルするデフォルトの動作がないことを示します。
|
currentTarget
| イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
errorID
| 特定のエラーに関連付けられた参照番号です(AIR のみ)。 |
target
| 入出力エラーが発生したネットワークオブジェクトです。 |
text
| エラーメッセージとして表示されるテキストです。 |
関連項目
イベントオブジェクトの型: flash.events.Eventプロパティ Event.type = flash.events.Event.OPEN| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込み操作が開始したときに送出されます。
Event.OPEN 定数は、
type プロパティ(
open イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|
bubbles
|
false
|
cancelable
|
false は、キャンセルするデフォルトの動作がないことを示します。
|
currentTarget
| イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target
| 接続をオープンしたネットワークオブジェクトです。 |
関連項目
イベントオブジェクトの型: flash.events.ProgressEventプロパティ ProgressEvent.type = flash.events.ProgressEvent.PROGRESS| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ダウンロード処理を実行中にデータを受信したときに送出されます。
type プロパティ(
progress イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|
bubbles
|
false
|
bytesLoaded
| リスナーがイベントを処理しているときに読み込まれたアイテム数またはバイト数です。 |
bytesTotal
| 読み込みプロセスが成功した場合に最終的に読み込まれるアイテムまたはバイトの総数です。 |
cancelable
|
false は、キャンセルするデフォルトの動作がないことを示します。
|
currentTarget
| イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target
| 進行状況をレポートする オブジェクトです。 |
関連項目
イベントオブジェクトの型: flash.events.Eventプロパティ Event.type = flash.events.Event.UNLOAD| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
読み込まれたオブジェクトが Loader オブジェクトの unload() メソッドを使用して削除されるたびに、LoaderInfo オブジェクトによって送出されます。または 2 番目の読み込みが同じ Loader オブジェクトによって実行され、読み込み開始前に元のコンテンツが削除された場合に、LoaderInfo オブジェクトによって送出されます。
Event.UNLOAD 定数は、
type プロパティ(
unload イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|
bubbles
|
false
|
cancelable
|
false は、キャンセルするデフォルトの動作がないことを示します。
|
currentTarget
| イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target
| 解放または置き換える SWF ファイルに関連付けられた LoaderInfo オブジェクトです。 |
関連項目
次の例では、LoaderInfoExample クラスを使用して、イメージをステージに表示します。ここでは以下の手順を実行します。
-
プロパティ
url を作成します。これはイメージの場所と名前です。
-
クラスコンストラクタは
loader という名前の Loader オブジェクトを作成します。
-
loader オブジェクトはイベントリスナーをインスタンス化して、イメージが正しく読み込まれるようにします。
-
コンストラクタは、
request という URLRequest オブジェクトの新しいインスタンスを作成しますが、その前に、ファイル名と場所が分かるように url を渡します。
-
次に
request オブジェクトが load() メソッド(loader オブジェクトのメソッド)に渡されます。このメソッドでは、イメージが表示リストに読み込まれます。
重要 : この例では、Image.gif という名前のファイルがコンパイル済み SWF ファイルと同じディレクトリに追加されている必要があります。メイン SWF ファイルのサイズ内に収まる領域を持つイメージを使用します。
package {
import flash.display.Loader;
import flash.display.LoaderInfo;
import flash.display.Sprite;
import flash.events.*;
import flash.net.URLRequest;
public class LoaderInfoExample extends Sprite {
private var url:String = "Image.gif";
public function LoaderInfoExample() {
var loader:Loader = new Loader();
loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
var request:URLRequest = new URLRequest(url);
loader.load(request);
addChild(loader);
}
private function initHandler(event:Event):void {
var loader:Loader = Loader(event.target.loader);
var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
}
private function ioErrorHandler(event:IOErrorEvent):void {
trace("ioErrorHandler: " + event);
}
}
}
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 12:14 AM -08:00