onProgress (FileReference.onProgress イベントリスナー)

onProgress = function(fileRef: FileReference , bytesLoaded: Number , bytesTotal: Number ) {}

ファイルのアップロード処理中またはダウンロード処理中に定期的に呼び出されます。onProgress リスナーは、Flash Player がバイトをサーバーに転送しているときに呼び出され、最終的に転送が成功しなくても、転送の実行中は定期的に呼び出されます。ファイルの転送が成功して完了したかどうか、およびそのタイミングを確認するには、onComplete を使用します。

場合によっては、onProgress リスナーが呼び出されないこともあります。たとえば、転送対象ファイルが非常に小さい場合や、アップロードやダウンロードが非常に短時間に終わる場合などです。

ファイルアップロードの進捗状況は、OS X 10.3 より前の Macintosh プラットフォームでは確認できません。onProgress イベントはアップロード処理中に呼び出されますが、bytesLoaded パラメータの値は、進捗状況を確認できないことを示す -1 です。

対応バージョン : ActionScript 1.0、Flash Player 8

パラメータ

fileRef:FileReference - 処理を開始した FileReference オブジェクト。

bytesLoaded:Number - これまで転送されたバイト数。

bytesTotal:Number - 転送するファイルの全体サイズ (バイト単位)。サイズが決定できない場合、この値は -1 になります。

例

次の例では、onProgress イベントリスナーを使用してダウンロードの進捗状況をトレースします。

import flash.net.FileReference;

var listener:Object = new Object();

listener.onProgress = function(file:FileReference, bytesLoaded:Number, bytesTotal:Number):Void {
    trace("onProgress: " + file.name + " with bytesLoaded: " + bytesLoaded + " bytesTotal: " + bytesTotal);
}

var fileRef:FileReference = new FileReference();
fileRef.addListener(listener);
var url:String = "http://www.adobe.com/platform/whitepapers/platform_overview.pdf";
fileRef.download(url, "FlashPlatform.pdf");

onProgress (FileReference.onProgress イベントリスナー)

パラメータ

例

関連項目