語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
ErrorEvent 類別只會定義 error
事件類型的物件:ErrorEvent.ERROR
。ErrorEvent 類別也可以做為多個其他錯誤事件類別的基礎類別,其中包括 AsyncErrorEvent、IOErrorEvent、SecurityErrorEvent、SQLErrorEvent 以及 UncaughtErrorEvent 類別。
您可以為 uncaughtError
(UncaughtErrorEvent.UNCAUGHT_ERROR) 事件註冊偵聽程式,如此便可以檢查沒有任何偵聽程式的 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 。
| |
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]
注意:只有 Adobe AIR,才提供 toString()
方法傳回的 errorId
值。雖然 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 |
定義 error
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
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, 03:47 PM Z