Packagejp.progression.commands.net
Classpublic class PreloadSWF
InheritancePreloadSWF Inheritance Command Inheritance flash.events.EventDispatcher
ImplementsILoadable

PreloadSWF クラスは、CastPreloader クラスの読み込みタイミングを任意の位置に指定し、LoaderList コマンドで監視可能にするコマンドクラスです。


Example
  // CastPreloader クラスのサブクラスの CastEvent.CAST_LOAD_START 発生中に登録する
  protected override function atCastLoadStart():void {
   // コマンドを登録する
   addCommand(
    new Trace( "start" ),
    new LoaderList( {
      // 読み込み進捗状態を取得する
      onProgress:function():void {
       trace( this.bytesLoaded, this.bytesTotal );
      }
     },
     
     // 本体となる index.swf をこのタイミングで読み込み、親の LoaderList で監視する
     new PreloadSWF(),
     
     // index.swf と同時に読み込み管理したい対象を設定する
     new LoadURL( new URLRequest( "example.xml" ) ),
     new LoadBitmapData( new URLRequest( "example.png" ) )
    ),
    new Trace( "complete" )
   );
  }
  



Public Properties
 PropertyDefined by
  bytes : ByteArray
PreloadSWF
  bytesLoaded : uint
[read-only] コマンドの読み込み済みのバイト数です。 The number of bytes that are loaded for the command.
PreloadSWF
  bytesTotal : uint
[read-only] コマンド全体の圧縮後のバイト数です。 The number of compressed bytes in the entire command.
PreloadSWF
 InheritedcatchError : Function
コマンドの実行中に例外が発生した際に実行するエラー処理関数を取得または設定します。
Command
 InheritedclassName : String
インスタンスのクラス名を取得します。 Indicates the instance className of the Command.
Command
  data : *
読み込み操作によって受信したデータです。 The data received from the load operation.
PreloadSWF
 InheriteddefaultInterruptType : int
[static] interruptType プロパティの初期値を取得または設定します。 すでに生成済みのコマンドに対しては適用されません。
Command
 InheriteddefaultTimeout : Number
[static] timeout プロパティの初期値を取得または設定します。 すでに生成済みのコマンドに対しては適用されません。
Command
 Inheriteddelay : Number
コマンドが実際に実行されるまでの遅延時間を取得または設定します。 コマンド実行中に値を変更しても、処理に対して反映されません。
Command
 Inheriteddepth : int
コマンドツリー構造上での自身の深度を取得します。
Command
 Inheritedextra : Object
コマンドの実行処理、または中断処理の開始時に指定されているリレーオブジェクトを取得または設定します。 このコマンドが親の CommandList インスタンスによって実行されている場合には、親のリレーオブジェクトを順々に引き継ぎます。
Command
  factor : Number
percent プロパティの算出時の自身の重要性を取得または設定します。
PreloadSWF
 Inheritedgroup : String
インスタンスのグループ名を取得または設定します。 Indicates the instance group of the Command.
Command
 Inheritedid : String
インスタンスを表すユニークな識別子を取得または設定します。
Command
 InheritedinterruptType : int
中断処理時の処理方法を取得または設定します。 コマンド実行中に値を変更しても、処理に対して反映されません。
Command
 InheritedlatestData : *
自身から見て最後に関連付けられた読み込みデータを取得または設定します。 このコマンドが CommandList インスタンス上に存在する場合には、自身より前、または自身の親のデータを取得します。
Command
  loaded : uint
[read-only] 登録されている ILoadable を実装したインスタンスの内、すでに読み込み処理が完了した数を取得します。
PreloadSWF
 Inheritedname : String
インスタンスの名前を取得または設定します。 Indicates the instance name of the Command.
Command
 Inheritednext : Command
このコマンドが関連付けられている親の CommandList インスタンス内で、次に位置する Command インスタンスを取得します。
Command
 InheritedonComplete : Function
コマンドオブジェクトが ExecuteEvent.EXECUTE_COMPLETE イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。
Command
 InheritedonError : Function
コマンドオブジェクトが ExecuteErrorEvent.EXECUTE_ERROR イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。
Command
 InheritedonInterrupt : Function
コマンドオブジェクトが ExecuteEvent.EXECUTE_INTERRUPT イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。
Command
  onProgress : Function
コマンドオブジェクトが ProgressEvent.PROGRESS イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。
PreloadSWF
 InheritedonStart : Function
コマンドオブジェクトが ExecuteEvent.EXECUTE_START イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。
Command
 Inheritedparent : CommandList
この Command オブジェクトを含む CommandList オブジェクトを示します。 Indicates the CommandList object that contains this Command object.
Command
  percent : Number
[read-only] loaded プロパティと total プロパティから算出される読み込み状態をパーセントで取得します。
PreloadSWF
 Inheritedprevious : Command
このコマンドが関連付けられている親の CommandList インスタンス内で、一つ前に位置する Command インスタンスを取得します。
Command
  request : URLRequest
リクエストされる URL です。 コマンド実行中に値を変更しても、処理に対して反映されません。 The URL to be requested.
PreloadSWF
 Inheritedroot : Command
コマンドツリー構造の一番上に位置する Command インスタンスを取得します。
Command
 Inheritedscope : Object
コマンドの実行処理、または中断処理に指定されている関数内でのスコープ対象を取得または設定します。
Command
 Inheritedstate : int
コマンドの実行状態を取得します。
Command
  target : ILoadable
[read-only] 現在の読み込み対象を取得します。
PreloadSWF
 InheritedthresholdLength : int
[static] 同一プロセス上で実行可能な最大コマンド数を取得または設定します。 設定された閾値を超えて実行された場合には、強制的に 1 ミリ秒の遅延を発生させます。 この値が大きすぎる場合、スタックオーバーフローが発生する可能性があります。
Command
 Inheritedtimeout : Number
コマンドの実行中のタイムアウト時間を取得または設定します。 指定された時間中に executeComplete() メソッド、または interrupt() メソッドが実行されなかった場合にはエラーが送出されます。 この値が 0 に設定されている場合、タイムアウト処理は発生しません。
Command
  total : uint
[read-only] 登録されている ILoadable を実装したインスタンスの総数を取得します。
PreloadSWF
  url : String
[read-only] リクエストされる URL を示すストリングを取得します。
PreloadSWF
Public Methods
 MethodDefined by
  
PreloadSWF(request:URLRequest = null, initObject:Object = null)
新しい PreloadSWF インスタンスを作成します。 Creates a new PreloadSWF object.
PreloadSWF
  
PreloadSWF インスタンスのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。 Duplicates an instance of an PreloadSWF subclass.
PreloadSWF
  
dispose():void
保持しているデータを解放します。
PreloadSWF
 Inherited
execute(extra:Object = null):void
コマンド処理を実行します。
Command
 Inherited
実行中のコマンド処理が完了したことを通知します。 このメソッドを実行するためには、事前に execute() メソッドが実行されている必要があります。
Command
 Inherited
interrupt(enforced:Boolean = false):void
コマンド処理を中断します。 このメソッドを実行するためには、事前に execute() メソッドが実行されている必要があります。
Command
 Inherited
setProperties(parameters:Object):Command
インスタンスに対して、複数のプロパティを一括設定します。
Command
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。 Returns the string representation of the specified object.
Command
Protected Methods
 MethodDefined by
 Inherited
throwError(target:Command, error:Error):void
コマンド処理中に例外が発生したことを通知します。 エラー処理が発生すると、コマンド処理が停止します。 問題を解決し、通常フローに戻す場合には executeComplete() メソッドを、問題が解決されず中断処理を行いたい場合には interrupt() メソッドを実行してください。 関数内で問題が解決、または中断処理に移行しなかった場合には ExecuteErrorEvent.EXECUTE_ERROR イベントが送出されます。
Command
Events
 EventSummaryDefined by
 Inherited 処理が完了した場合に送出されます。 Command
 Inherited 処理の途中でエラーが発生した場合に送出されます。 Command
 Inherited 処理が中断された場合に送出されます。 Command
 Inherited 処理が開始された場合に送出されます。 Command
   ダウンロード処理を実行中にデータを受信したときに送出されます。 PreloadSWF
Property detail
bytesproperty
bytes:ByteArray  [read-write]Implementation
    public function get bytes():ByteArray
    public function set bytes(value:ByteArray):void
bytesLoadedproperty 
bytesLoaded:uint  [read-only]

コマンドの読み込み済みのバイト数です。 The number of bytes that are loaded for the command.

Implementation
    public function get bytesLoaded():uint

See also

bytesTotalproperty 
bytesTotal:uint  [read-only]

コマンド全体の圧縮後のバイト数です。 The number of compressed bytes in the entire command.

Implementation
    public function get bytesTotal():uint

See also

dataproperty 
data:*  [read-write]

読み込み操作によって受信したデータです。 The data received from the load operation.

Implementation
    public function get data():*
    public function set data(value:*):void
factorproperty 
factor:Number  [read-write]

percent プロパティの算出時の自身の重要性を取得または設定します。

Implementation
    public function get factor():Number
    public function set factor(value:Number):void

See also

loadedproperty 
loaded:uint  [read-only]

登録されている ILoadable を実装したインスタンスの内、すでに読み込み処理が完了した数を取得します。

Implementation
    public function get loaded():uint

See also

onProgressproperty 
onProgress:Function  [read-write]

コマンドオブジェクトが ProgressEvent.PROGRESS イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。

Implementation
    public function get onProgress():Function
    public function set onProgress(value:Function):void

See also

scope
flash.events.ProgressEvent.PROGRESS
percentproperty 
percent:Number  [read-only]

loaded プロパティと total プロパティから算出される読み込み状態をパーセントで取得します。

Implementation
    public function get percent():Number

See also

requestproperty 
request:URLRequest  [read-write]

リクエストされる URL です。 コマンド実行中に値を変更しても、処理に対して反映されません。 The URL to be requested.

Implementation
    public function get request():URLRequest
    public function set request(value:URLRequest):void
targetproperty 
target:ILoadable  [read-only]

現在の読み込み対象を取得します。

Implementation
    public function get target():ILoadable
totalproperty 
total:uint  [read-only]

登録されている ILoadable を実装したインスタンスの総数を取得します。

Implementation
    public function get total():uint

See also

urlproperty 
url:String  [read-only]

リクエストされる URL を示すストリングを取得します。

Implementation
    public function get url():String
Constructor detail
PreloadSWF()constructor
public function PreloadSWF(request:URLRequest = null, initObject:Object = null)

新しい PreloadSWF インスタンスを作成します。 Creates a new PreloadSWF object.

Parameters
request:URLRequest (default = null)読み込む SWF ファイルの絶対 URL または相対 URL です。 The absolute or relative URL of the SWF file to be loaded.
 
initObject:Object (default = null)設定したいプロパティを含んだオブジェクトです。
Method detail
clone()method
public override function clone():Command

PreloadSWF インスタンスのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。 Duplicates an instance of an PreloadSWF subclass.

Returns
Command元のオブジェクトと同じプロパティ値を含む新しい PreloadSWF インスタンスです。 A new PreloadSWF object that is identical to the original.
dispose()method 
public override function dispose():void

保持しているデータを解放します。

Event detail
progressevent 
Event object type: flash.events.ProgressEvent

ダウンロード処理を実行中にデータを受信したときに送出されます。