パッケージ | flash.events |
クラス | public class ErrorEvent |
継承 | ErrorEvent TextEvent Event Object |
サブクラス | AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent |
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 9, AIR 1.0, Flash Lite 4 |
ErrorEvent クラスで定義されるのは 1 つのタイプの error
イベント(ErrorEvent.ERROR
) のみです。 ErrorEvent クラスは、他のいくつかのエラーイベントクラス(AsyncErrorEvent、IOErrorEvent、SecurityErrorEvent、 SQLErrorEvent および UncaughtErrorEvent など)の基本クラスとしても機能します。
リスナーのいない error
イベントをチェックするには、uncaughtError
(UncaughtErrorEvent.UNCAUGHT_ERROR)イベントのリスナーを登録します。
また、不明なエラーが存在すると、デバッグ版の Flash Player または AIR Debug Launcher(ADL)アプリケーションでコンテンツが実行されているときに、エラーイベントを示すエラーダイアログボックスが表示されます。
関連する API エレメント
プロパティ | 定義元 | ||
---|---|---|---|
bubbles : Boolean [読み取り専用]
イベントがバブリングイベントかどうかを示します。 | Event | ||
cancelable : Boolean [読み取り専用]
イベントに関連付けられた動作を回避できるかどうかを示します。 | Event | ||
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
currentTarget : Object [読み取り専用]
イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 | Event | ||
errorID : int [読み取り専用]
特定のエラーに関連付けられた参照番号です。 | ErrorEvent | ||
eventPhase : uint [読み取り専用]
イベントフローの現在の段階です。 | Event | ||
target : Object [読み取り専用]
イベントターゲットです。 | Event | ||
text : String
textInput イベントの場合は、ユーザーが入力した文字または文字の連続です。 | TextEvent | ||
type : String [読み取り専用]
イベントのタイプです。 | Event |
メソッド | 定義元 | ||
---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
エラーイベントに関する情報を含む Event オブジェクトを作成します。 | ErrorEvent | ||
[オーバーライド]
ErrorEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。 | ErrorEvent | ||
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。 | Event | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。 | Event | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。 | Event | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。 | Event | ||
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。 | Event | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
[オーバーライド]
ErrorEvent オブジェクトのすべてのプロパティを含むストリングを返します。 | ErrorEvent | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object |
errorID | プロパティ |
ErrorEvent | () | コンストラクター |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 9, AIR 1.0, Flash Lite 4 |
エラーイベントに関する情報を含む Event オブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメーターとして渡されます。
パラメーターtype:String — イベントのタイプです。イベントリスナーは、継承された type プロパティを通じてこの情報にアクセスできます。エラーイベントのタイプは ErrorEvent.ERROR の 1 つのみです。
| |
bubbles:Boolean (default = false ) — Event オブジェクトでバブリングを実行できるかどうかを判断します。イベントリスナーは、継承された bubbles プロパティを通じてこの情報にアクセスできます。
| |
cancelable:Boolean (default = false ) — Event オブジェクトがキャンセル可能かどうかを判断します。イベントリスナーは、継承された cancelable プロパティを通じてこの情報にアクセスできます。
| |
text:String (default = " ") — エラーメッセージとして表示されるテキストです。イベントリスナーは、text プロパティを通じてこの情報にアクセスできます。
| |
id:int (default = 0 ) — 特定のエラーに関連付ける参照番号です(Adobe AIR でのみサポートされています)。
|
clone | () | メソッド |
toString | () | メソッド |
override public function toString():String
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 9, AIR 1.0, Flash Lite 4 |
ErrorEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。
[ErrorEvent type=value bubbles=value cancelable=value text=value errorID=value]
注意:toString()
メソッドによって返された errorId
値は、Adobe AIR でのみ使用できます。Flash Player 10.1 では errorID
プロパティがサポートされていますが、ErrorEvent オブジェクトで toString()
を呼び出しても、Flash Player では errorId
値は提供されません。
String — ErrorEvent オブジェクトのすべてのプロパティを含むストリングです。
|
ERROR | 定数 |
public static const ERROR:String = "error"
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 9, AIR 1.0, Flash Lite 4 |
type
プロパティ(error
イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target | ネットワーク操作エラーが発生したオブジェクトです。 |
text | エラーメッセージとして表示されるテキストです。 |
errorHandler()
)の使用方法を示します。ioError
イベントがある場合、ハンドラーはネットワークからロードしようとして、securityError
をスローします。
注意:MissingFile.xml という名前のファイルが SWF ファイルと同じディレクトリにある場合、この例は機能しません。
package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.*; public class ErrorEventExample extends Sprite { private var loader:URLLoader; private var request:URLRequest; public function ErrorEventExample() { loader = new URLLoader(); loader.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, errorHandler); request = new URLRequest(); loadFromFileSystem(); } private function loadFromFileSystem():void { request.url = "MissingFile.xml"; loader.load(request); } private function loadFromNetwork():void { request.url = "http://www.[yourDomain].com/MissingFile.xml"; loader.load(request); } private function errorHandler(event:ErrorEvent):void { trace("errorHandler: " + event); if(event is IOErrorEvent) { loadFromNetwork(); } } } }
Tue Jun 12 2018, 10:34 AM Z