Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
flash.events 

IOErrorEvent  - AS3

パッケージflash.events
クラスpublic class IOErrorEvent
継承IOErrorEvent Inheritance ErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

IOErrorEvent オブジェクトは、エラーが発生して入力操作または出力操作が失敗したときに送出されます。

リスナーのない error イベントを確認するには、デバッグ版の Flash Player または AIR Debug Launcher(ADL)を使用します。IOErrorEvent コンストラクターの text パラメーターで定義されたストリングが表示されます。

例を表示

関連する API エレメント



パブリックプロパティ
 プロパティ定義元
 Inheritedbubbles : Boolean
[読み取り専用] イベントがバブリングイベントかどうかを示します。
Event
 Inheritedcancelable : Boolean
[読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。
Event
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。
Object
 InheritedcurrentTarget : Object
[読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
Event
 InheritederrorID : int
[読み取り専用] 特定のエラーに関連付けられた参照番号です。
ErrorEvent
 InheritedeventPhase : uint
[読み取り専用] イベントフローの現在の段階です。
Event
 Inheritedtarget : Object
[読み取り専用] イベントターゲットです。
Event
 Inheritedtext : String
textInput イベントの場合は、ユーザーが入力した文字または文字の連続です。
TextEvent
 Inheritedtype : String
[読み取り専用] イベントのタイプです。
Event
パブリックメソッド
 メソッド定義元
  
IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
ioError イベントに関する特定の情報を含んでいる Event オブジェクトを作成します。
IOErrorEvent
  
[オーバーライド] IOErrorEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。
IOErrorEvent
 Inherited
formatToString(className:String, ... arguments):String
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。
Event
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。
Event
 Inherited
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。
Event
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。
Object
  
[オーバーライド] IOErrorEvent オブジェクトのすべてのプロパティを含むストリングを返します。
IOErrorEvent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
パブリック定数
 定数定義元
  IO_ERROR : String = "ioError"
[静的] ioError イベントオブジェクトの type プロパティ値を定義します。
IOErrorEvent
  STANDARD_ERROR_IO_ERROR : String = "standardErrorIoError"
[静的] standardErrorIoError イベントは、NativeProcess オブジェクトの standardError ストリームからデータを読み取り中にエラーが発生した場合に送出されます。
IOErrorEvent
  STANDARD_INPUT_IO_ERROR : String = "standardInputIoError"
[静的] standardInputIoError イベントは、NativeProcess オブジェクトの standardInput へデータを書き込み中にエラーが発生した場合に送出されます。
IOErrorEvent
  STANDARD_OUTPUT_IO_ERROR : String = "standardOutputIoError"
[静的] standardOutputIoError イベントは、NativeProcess オブジェクトの standardOutput ストリームからデータを読み取り中にエラーが発生した場合に送出されます。
IOErrorEvent
コンストラクターの詳細

IOErrorEvent

()コンストラクター
public function IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

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

パラメーター
type:String — イベントのタイプです。イベントリスナーは、継承された type プロパティを通じてこの情報にアクセスできます。入出力エラーイベントのタイプは、IOErrorEvent.IO_ERROR のみです。
 
bubbles:Boolean (default = false) — Event オブジェクトがイベントフローのバブリング段階で処理されるかどうかを判断します。イベントリスナーは、継承された bubbles プロパティを通じてこの情報にアクセスできます。
 
cancelable:Boolean (default = false) — Event オブジェクトがキャンセル可能かどうかを判断します。イベントリスナーは、継承された cancelable プロパティを通じてこの情報にアクセスできます。
 
text:String (default = "") — エラーメッセージとして表示されるテキストです。イベントリスナーは、text プロパティを通じてこの情報にアクセスできます。
 
id:int (default = 0) — 特定のエラーに関連付ける参照番号です(Adobe AIR でのみサポートされています)。

関連する API エレメント

メソッドの詳細

clone

()メソッド
override public function clone():Event

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

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

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

toString

()メソッド 
override public function toString():String

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

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

[IOErrorEvent type=value bubbles=value cancelable=value text=value errorID=value] errorId は、Adobe AIR でのみ使用できます。

戻り値
String — IOErrorEvent オブジェクトのすべてのプロパティを含むストリングです。
定数の詳細

IO_ERROR

定数
public static const IO_ERROR:String = "ioError"

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0, Flash Player 9, Flash Lite 4

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

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

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
errorID特定のエラーに関連付けられた参照番号です(AIR のみ)。
target入出力エラーが発生したネットワークオブジェクトです。
textエラーメッセージとして表示されるテキストです。

関連する API エレメント

STANDARD_ERROR_IO_ERROR

定数 
public static const STANDARD_ERROR_IO_ERROR:String = "standardErrorIoError"

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 2, Flash Lite 4

standardErrorIoError イベントは、NativeProcess オブジェクトの standardError ストリームからデータを読み取り中にエラーが発生した場合に送出されます。

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

プロパティ
bubblesなし。
cancelable不可。キャンセルするデフォルトの動作がないことを示します。
errorID特定のエラーに関連付けられた参照番号です。
targetエラーが発生したオブジェクトです。
textエラーメッセージとして表示されるテキストです。

STANDARD_INPUT_IO_ERROR

定数 
public static const STANDARD_INPUT_IO_ERROR:String = "standardInputIoError"

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 2, Flash Lite 4

standardInputIoError イベントは、NativeProcess オブジェクトの standardInput へデータを書き込み中にエラーが発生した場合に送出されます。

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

プロパティ
bubblesなし。
cancelable不可。キャンセルするデフォルトの動作がないことを示します。
errorID特定のエラーに関連付けられた参照番号です。
targetエラーが発生したオブジェクトです。
textエラーメッセージとして表示されるテキストです。

STANDARD_OUTPUT_IO_ERROR

定数 
public static const STANDARD_OUTPUT_IO_ERROR:String = "standardOutputIoError"

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 2, Flash Lite 4

standardOutputIoError イベントは、NativeProcess オブジェクトの standardOutput ストリームからデータを読み取り中にエラーが発生した場合に送出されます。

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

プロパティ
bubblesなし。
cancelable不可。キャンセルするデフォルトの動作がないことを示します。
errorID特定のエラーに関連付けられた参照番号です。
targetエラーが発生したオブジェクトです。
textエラーメッセージとして表示されるテキストです。

IOErrorEventExample.as

次の例では、IOErrorEventExample クラスを使用して、存在しないファイルのロードを試行したときに、エラーイベントオブジェクトがどのように送出されるかを示します。この例では、次の処理を実行します。
  1. このクラスコンストラクターが URLLoader オブジェクトの新しいインスタンスを作成し、そのインスタンスを変数 loader に割り当てます。
  2. URLLoader インスタンスは、タイプが ioError のイベントリスナーをインスタンス化します。このタイプのイベントリスナーには、サブスクライバメソッド ioErrorHandler() が関連付けられています。このサブスクライバメソッドは、trace() を使用してイベントに関する情報を出力します。
  3. 次に、コンストラクターは URLRequest オブジェクトの新しいインスタンス request を作成します。MissingFile.xml が渡されるため、見つからないファイルのファイル名と場所が明らかになります。
  4. 次に、request 変数が loader.load() に渡され、見つからないファイルのロードが試行されます。ファイルは見つからないため、イベントハンドラーによって ioError イベントが送出されます。

注意:

  • 「ローカルでの再生に関するセキュリティ」を「ローカルファイルにのみアクセスする」に設定して SWF ファイルをコンパイルする必要があります。
  • "MissingFile.xml" という名前のファイルを、SWF ファイルと同じレベルに置かないでください。

package {
    import flash.display.Sprite;
    import flash.events.IOErrorEvent;
    import flash.net.URLLoader;
    import flash.net.URLRequest;

    public class IOErrorEventExample extends Sprite {
        public function IOErrorEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);

            var request:URLRequest = new URLRequest("MissingFile.xml");
            loader.load(request);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}




[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。