flash.events.ProgressEvent - HTML 開発者用 Adobe® AIR® API リファレンスガイド

window.runtime プロパティ	window.runtime.flash.events.ProgressEvent

継承	ProgressEvent Event Object

ランタイムバージョン:

1.0,

ProgressEvent オブジェクトは、ロード処理が開始されたとき、またはソケットがデータを受信したときに送出されます。これらのイベントは通常、SWF ファイル、イメージまたはデータがアプリケーションにロードされるときに生成されます。次の 2 種類のキーボードイベントがあります。ProgressEvent.PROGRESS および ProgressEvent.SOCKET_DATAまた AIR では、NativeProcess クラスによって子プロセスとの間でデータの送受信が行われるときに、ProgressEvent オブジェクトが送出されます。

関連する API エレメント

プロパティ

	プロパティ		定義元
		bubbles : Boolean [読み取り専用] イベントがバブリングイベントかどうかを示します。	Event
		bytesLoaded : Number リスナーがイベントを処理しているときに読み込まれたアイテム数またはバイト数です。	ProgressEvent
		bytesTotal : Number 読み込みプロセスが成功した場合に読み込まれるアイテムまたはバイトの総数です。	ProgressEvent
		cancelable : Boolean [読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。	Event
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		currentTarget : Object [読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。	Event
		eventPhase : uint [読み取り専用] イベントフローの現在の段階です。	Event
		prototype : Object [静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		target : Object [読み取り専用] イベントターゲットです。	Event
		type : String [読み取り専用] イベントのタイプです。	Event

パブリックメソッド

継承されるパブリックメソッドを隠す

継承メソッドの表示

	メソッド		定義元
		ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 0) progress イベントに関する情報を含む Event オブジェクトを作成します。	ProgressEvent
		clone():Event [オーバーライド] ProgressEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。	ProgressEvent
		formatToString(className:String, ... arguments):String カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。	Event
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isDefaultPrevented():Boolean イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。	Event
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		preventDefault():void イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。	Event
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		stopImmediatePropagation():void イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。	Event
		stopPropagation():void イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。	Event
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String [オーバーライド] ProgressEvent オブジェクトのすべてのプロパティを含むストリングを返します。	ProgressEvent
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

定数

	定数		定義元
		ACTIVATE : String = "activate" [静的] ACTIVATE 定数は、type プロパティ（activate イベントオブジェクト）の値を定義します。	Event
		ADDED : String = "added" [静的] Event.ADDED 定数は、added イベントオブジェクトの type プロパティの値を定義します。	Event
		ADDED_TO_STAGE : String = "addedToStage" [静的] Event.ADDED_TO_STAGE 定数は、type プロパティ（addedToStage イベントオブジェクト）の値を定義します。	Event
		CANCEL : String = "cancel" [静的] Event.CANCEL 定数は、cancel イベントオブジェクトの type プロパティの値を定義します。	Event
		CHANGE : String = "change" [静的] Event.CHANGE 定数は、type プロパティ（change イベントオブジェクト）の値を定義します。	Event
		CLEAR : String = "clear" [静的] Event.CLEAR 定数は、clear イベントオブジェクトの type プロパティの値を定義します。	Event
		CLOSE : String = "close" [静的] Event.CLOSE 定数は、close イベントオブジェクトの type プロパティの値を定義します。	Event
		CLOSING : String = "closing" [静的] Event.CLOSING 定数は、closing イベントオブジェクトの type プロパティの値を定義します。	Event
		COMPLETE : String = "complete" [静的] Event.COMPLETE 定数は、complete イベントオブジェクトの type プロパティの値を定義します。	Event
		CONNECT : String = "connect" [静的] Event.CONNECT 定数は、connect イベントオブジェクトの type プロパティの値を定義します。	Event
		CONTEXT3D_CREATE : String = "context3DCreate" [静的] Event.CONTEXT3D_CREATE 定数は、context3Dcreate イベントオブジェクトの type プロパティの値を定義します。	Event
		COPY : String = "copy" [静的] copy イベントオブジェクトの type プロパティ値を定義します。	Event
		CUT : String = "cut" [静的] cut イベントオブジェクトの type プロパティ値を定義します。	Event
		DEACTIVATE : String = "deactivate" [静的] Event.DEACTIVATE 定数は、deactivate イベントオブジェクトの type プロパティの値を定義します。	Event
		DISPLAYING : String = "displaying" [静的] Event.DISPLAYING 定数は、displaying イベントオブジェクトの type プロパティの値を定義します。	Event
		ENTER_FRAME : String = "enterFrame" [静的] Event.ENTER_FRAME 定数は、enterFrame イベントオブジェクトの type プロパティの値を定義します。	Event
		EXIT_FRAME : String = "exitFrame" [静的] Event.EXIT_FRAME 定数は、exitFrame イベントオブジェクトの type プロパティの値を定義します。	Event
		EXITING : String = "exiting" [静的] Event.EXITING 定数は、exiting イベントオブジェクトの type プロパティの値を定義します。	Event
		FRAME_CONSTRUCTED : String = "frameConstructed" [静的] Event.FRAME_CONSTRUCTED 定数は、frameConstructed イベントオブジェクトの type プロパティの値を定義します。	Event
		FULLSCREEN : String = "fullScreen" [静的] Event.FULL_SCREEN 定数は、fullScreen イベントオブジェクトの type プロパティの値を定義します。	Event
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [静的] Event.HTML_BOUNDS_CHANGE 定数は、htmlBoundsChange イベントオブジェクトの type プロパティの値を定義します。	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [静的] Event.HTML_DOM_INITIALIZE 定数は、htmlDOMInitialize イベントオブジェクトの type プロパティの値を定義します。	Event
		HTML_RENDER : String = "htmlRender" [静的] Event.HTML_RENDER 定数は、htmlRender イベントオブジェクトの type プロパティの値を定義します。	Event
		ID3 : String = "id3" [静的] Event.ID3 定数は、id3 イベントオブジェクトの type プロパティの値を定義します。	Event
		INIT : String = "init" [静的] Event.INIT 定数は、init イベントオブジェクトの type プロパティの値を定義します。	Event
		LOCATION_CHANGE : String = "locationChange" [静的] Event.LOCATION_CHANGE 定数は、locationChange イベントオブジェクトの type プロパティの値を定義します。	Event
		MOUSE_LEAVE : String = "mouseLeave" [静的] Event.MOUSE_LEAVE 定数は、mouseLeave イベントオブジェクトの type プロパティの値を定義します。	Event
		NETWORK_CHANGE : String = "networkChange" [静的] Event.NETWORK_CHANGE 定数は、networkChange イベントオブジェクトの type プロパティの値を定義します。	Event
		OPEN : String = "open" [静的] Event.OPEN 定数は、open イベントオブジェクトの type プロパティの値を定義します。	Event
		PASTE : String = "paste" [静的] Event.PASTE 定数は、type プロパティ（paste イベントオブジェクト）の値を定義します。	Event
		PREPARING : String = "preparing" [静的] Event.PREPARING 定数は、preparing イベントオブジェクトの type プロパティの値を定義します。	Event
		PROGRESS : String = "progress" [静的] progress イベントオブジェクトの type プロパティ値を定義します。	ProgressEvent
		REMOVED : String = "removed" [静的] Event.REMOVED 定数は、removed イベントオブジェクトの type プロパティの値を定義します。	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [静的] Event.REMOVED_FROM_STAGE 定数は、removedFromStage イベントオブジェクトの type プロパティの値を定義します。	Event
		RENDER : String = "render" [静的] Event.RENDER 定数は、render イベントオブジェクトの type プロパティの値を定義します。	Event
		RESIZE : String = "resize" [静的] Event.RESIZE 定数は、resize イベントオブジェクトの type プロパティの値を定義します。	Event
		SCROLL : String = "scroll" [静的] Event.SCROLL 定数は、scroll イベントオブジェクトの type プロパティの値を定義します。	Event
		SELECT : String = "select" [静的] Event.SELECT 定数は、select イベントオブジェクトの type プロパティの値を定義します。	Event
		SELECT_ALL : String = "selectAll" [静的] Event.SELECT_ALL 定数は、selectAll イベントオブジェクトの type プロパティの値を定義します。	Event
		SOCKET_DATA : String = "socketData" [静的] socketData イベントオブジェクトの type プロパティ値を定義します。	ProgressEvent
		SOUND_COMPLETE : String = "soundComplete" [静的] Event.SOUND_COMPLETE 定数は、soundComplete イベントオブジェクトの type プロパティの値を定義します。	Event
		STANDARD_ERROR_CLOSE : String = "standardErrorClose" [静的] Event.STANDARD_ERROR_CLOSE 定数は、standardErrorClose イベントオブジェクトの type プロパティの値を定義します。	Event
		STANDARD_ERROR_DATA : String = "standardErrorData" [静的] standardErrorData イベントオブジェクトの type プロパティ値を定義します。	ProgressEvent
		STANDARD_INPUT_CLOSE : String = "standardInputClose" [静的] Event.STANDARD_INPUT_CLOSE 定数は、standardInputClose イベントオブジェクトの type プロパティの値を定義します。	Event
		STANDARD_INPUT_PROGRESS : String = "standardInputProgress" [静的] standardInputProgress イベントオブジェクトの type プロパティ値を定義します。	ProgressEvent
		STANDARD_OUTPUT_CLOSE : String = "standardOutputClose" [静的] Event.STANDARD_OUTPUT_CLOSE 定数は、standardOutputClose イベントオブジェクトの type プロパティの値を定義します。	Event
		STANDARD_OUTPUT_DATA : String = "standardOutputData" [静的] standardOutputData イベントオブジェクトの type プロパティ値を定義します。	ProgressEvent
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [静的] Event.TAB_CHILDREN_CHANGE 定数は、tabChildrenChange イベントオブジェクトの type プロパティの値を定義します。	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [静的] Event.TAB_ENABLED_CHANGE 定数は、tabEnabledChange イベントオブジェクトの type プロパティの値を定義します。	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [静的] Event.TAB_INDEX_CHANGE 定数は、tabIndexChange イベントオブジェクトの type プロパティの値を定義します。	Event
		TEXT_INTERACTION_MODE_CHANGE : String = "textInteractionModeChange" [静的] Event.TEXT_INTERACTION_MODE_CHANGE 定数は、interaction mode イベントオブジェクトの type プロパティの値を定義します。	Event
		UNLOAD : String = "unload" [静的] Event.UNLOAD 定数は、unload イベントオブジェクトの type プロパティの値を定義します。	Event
		USER_IDLE : String = "userIdle" [静的] Event.USER_IDLE 定数は、userIdle イベントオブジェクトの type プロパティの値を定義します。	Event
		USER_PRESENT : String = "userPresent" [静的] Event.USER_PRESENT 定数は、userPresent イベントオブジェクトの type プロパティの値を定義します。	Event

プロパティの詳細

bytesLoaded

プロパティ

bytesLoaded:Number

ランタイムバージョン:

1.0,

リスナーがイベントを処理しているときに読み込まれたアイテム数またはバイト数です。

bytesTotal

プロパティ

bytesTotal:Number

ランタイムバージョン:

1.0,

読み込みプロセスが成功した場合に読み込まれるアイテムまたはバイトの総数です。progress イベントが Socket オブジェクトに送出または関連付けられる場合は、コンストラクターの bytesTotal パラメーターに値が指定されない限り、bytesTotal は常に 0 になります。実際に送受信されたバイト数は設定されず、アプリケーション開発者に任されます。

コンストラクターの詳細

ProgressEvent

()

コンストラクター

public function ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 0)

ランタイムバージョン:

1.0,

progress イベントに関する情報を含む Event オブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメーターとして渡されます。

パラメーター

	`type:String` — イベントのタイプです。有効な値は次のとおりです。`ProgressEvent.PROGRESS`、 `ProgressEvent.SOCKET_DATA`、`ProgressEvent.STANDARD_ERROR_DATA`、`ProgressEvent.STANDARD_INPUT_PROGRESS` および `ProgressEvent.STANDARD_OUTPUT_DATA`。

	`bubbles:Boolean` (default = `false`) — Event オブジェクトがイベントフローのバブリング段階で処理されるかどうかを判断します。

	`cancelable:Boolean` (default = `false`) — Event オブジェクトがキャンセル可能かどうかを判断します。

	`bytesLoaded:Number` (default = `0`) — リスナーがイベントを処理しているときに読み込まれたアイテム数またはバイト数です。

	`bytesTotal:Number` (default = `0`) — 読み込みプロセスが成功した場合に読み込まれるアイテムまたはバイトの総数です。

メソッドの詳細

clone

()

メソッド

public function clone():Event

ランタイムバージョン:

1.0,

ProgressEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。

戻り値

Event — 元のオブジェクトと同じプロパティ値を含む新しい ProgressEvent オブジェクトです。

toString

()

メソッド

public function toString():String

ランタイムバージョン:

1.0,

ProgressEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。

[ProgressEvent type=value bubbles=value cancelable=value bytesLoaded=value bytesTotal=value]

戻り値

String — ProgressEvent オブジェクトのすべてのプロパティを含むストリングです。

定数の詳細

PROGRESS

定数

public static const PROGRESS:String = "progress"

ランタイムバージョン:

1.0,

type プロパティ（progress イベントオブジェクト）の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`bytesLoaded`	リスナーがイベントを処理しているときに読み込まれたアイテム数またはバイト数です。
`bytesTotal`	読み込みプロセスが成功した場合に最終的に読み込まれるアイテムまたはバイトの総数です。
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	進行状況をレポートするオブジェクトです。

SOCKET_DATA

定数

public static const SOCKET_DATA:String = "socketData"

ランタイムバージョン:

1.0,

type プロパティ（socketData イベントオブジェクト）の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	Event をアクティブに処理しているオブジェクトです。
`bytesLoaded`	リスナーがイベントを処理しているときに読み込まれたアイテム数またはバイト数です。
`bytesTotal`	0。このプロパティは、`socketData` イベントオブジェクトによって使用されません。
`target`	進行状況をレポートするソケットです。

関連する API エレメント

Socket.socketData

STANDARD_ERROR_DATA

定数

public static const STANDARD_ERROR_DATA:String = "standardErrorData"

ランタイムバージョン:

type プロパティ（standardErrorData イベントオブジェクト）の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	Event をアクティブに処理しているオブジェクトです。
`bytesLoaded`	このイベントにともない、NativeProcessObject.error によってバッファーされたエラーデータのバイト数です。
`bytesTotal`	0。このプロパティは、`standardErrorData` イベントオブジェクトによって使用されません。
`target`	エラーデータを報告する NativeProcess オブジェクトです。

関連する API エレメント

NativeProcess.standardErrorData

STANDARD_INPUT_PROGRESS

定数

public static const STANDARD_INPUT_PROGRESS:String = "standardInputProgress"

ランタイムバージョン:

type プロパティ（standardInputProgress イベントオブジェクト）の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	Event をアクティブに処理しているオブジェクトです。
`bytesLoaded`	このイベントにともない、NativeProcessObject.error によってバッファーされたエラーデータのバイト数です。
`bytesTotal`	0。このプロパティは、`standardInputProgress` イベントオブジェクトによって使用されません。
`target`	エラーデータを報告する NativeProcess オブジェクトです。

関連する API エレメント

NativeProcess.standardInputProgress

STANDARD_OUTPUT_DATA

定数

public static const STANDARD_OUTPUT_DATA:String = "standardOutputData"

ランタイムバージョン:

type プロパティ（standardOutputData イベントオブジェクト）の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	Event をアクティブに処理しているオブジェクトです。
`bytesLoaded`	このイベントにともない、NativeProcessObject.output によってバッファーされた出力データのバイト数です。
`bytesTotal`	0。このプロパティは、`standardOutputData` イベントオブジェクトによって使用されません。
`target`	出力データを報告する NativeProcess オブジェクトです。

関連する API エレメント

NativeProcess.standardOutputData

例

次の例は、ファイルを読み込むときに progress イベントをリッスンする方法を示しています。

注意：この例をテストするには、次の操作を実行します。

プロジェクトディレクトリに AIRAliases.js ファイルを追加します。
デスクトップに MySound.mp3 ファイルを配置します。
プロジェクトのアプリケーション記述ファイルを作成し、ADL を使用してプロジェクトをテストします。


<html>
    <head>
      <script src="AIRAliases.js" />
      <script>
        function init() {
            
            var file = air.File.desktopDirectory.resolvePath("MySound.mp3");
            var stream = new air.FileStream();
            file.addEventListener(air.ProgressEvent.PROGRESS, progressHandler);
            stream.openAsync(file, air.FileMode.READ);
        }

        function progressHandler(event) {
            air.trace("bytesLoaded=" + event.bytesLoaded + "; bytesTotal=" + event.bytesTotal);
        }

      </script>
    </head>
    <body onload='init()'>
    </body>
</html>

法律上の注意 | プライバシーポリシー