| 套件 | fl.events |
| 類別 | public class RSLErrorEvent |
| 繼承 | RSLErrorEvent  ErrorEvent TextEvent Event Object |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5 |
| 執行階段版本: | Flash Player 10.1, AIR 2 |
RSLPreloader 載入的錯誤事件。這個事件會指出 RSL 下載失敗，並提供失敗的檔案、已嘗試以及已失敗的檔案數量等相關資訊。使用自訂事件預先載入迴圈，且透過 Flash 編寫來自動產生 RSLPreloader 程式碼時，此事件會由主要時間軸來傳送。在這種情況下，請使用 addEventListener 且不需要參考 RSLPreloader。
相關 API 元素
公用屬性
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | bubbles : Boolean [唯讀]
指出事件是否為反昇事件。 | Event | |
| cancelable : Boolean [唯讀]
指出是否可避免與事件相關聯的行為指令。 | Event | |
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| currentTarget : Object [唯讀]
正主動使用事件偵聽程式處理 Event 物件的物件。 | Event | |
| errorID : int [唯讀]
包含與特定錯誤相關聯的參考號碼。 | ErrorEvent | |
| eventPhase : uint [唯讀]
事件流程中的目前階段。 | Event | |
| failedURLs : Array [唯讀]
傳回下載失敗的檔案陣列。 | RSLErrorEvent | ||
| rslsFailed : int [唯讀]
傳回下載失敗的檔案數目。 | RSLErrorEvent | ||
| rslsLoaded : int [唯讀]
傳回下載成功的檔案數目。 | RSLErrorEvent | ||
| rslsTotal : int [唯讀]
傳回下載的檔案總數，包括成功及下載失敗。 | RSLErrorEvent | ||
| target : Object [唯讀]
事件目標。 | Event | |
| text : String
用於 textInput 事件，代表使用者所輸入的字元或字元序列。 | TextEvent | |
| type : String [唯讀]
事件類型。 | Event | |
公用方法
| 方法 | 定義自 | ||
|---|---|---|---|
RSLErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, rslsLoaded:int = 0, rslsFailed:int = 0, rslsTotal:int = 0, failedURLs:Array = null)
建立包含 RSLError 事件資訊的 RSLErrorEvent 物件。 | RSLErrorEvent | ||
| [覆寫]
建立 ErrorEvent 物件的副本，然後設定每個屬性值以符合原始物件的屬性值。 | ErrorEvent | |
|
公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。 | Event | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
檢查是否已經對事件呼叫 preventDefault() 方法。 | Event | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
如果可以取消事件的預設行為指令，則取消該行為指令。 | Event | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。 | Event | |
|
避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。 | Event | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
| [覆寫]
傳回包含 ErrorEvent 物件所有屬性的字串。 | ErrorEvent | |
|
會傳回指定之物件的基本值。 | Object | |
公用常數
| 常數 | 定義自 | ||
|---|---|---|---|
| RSL_LOAD_FAILED : String = "rslLoadFailed" [靜態]
當 RSL 完成下載以及一或多個檔案失敗時由 RSLPreloader 傳送。 | RSLErrorEvent | ||
屬性詳細資訊
failedURLs | 屬性 |
rslsFailed | 屬性 |
rslsLoaded | 屬性 |
rslsTotal | 屬性 |
建構函式詳細資料
RSLErrorEvent | () | 建構函式 |
public function RSLErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, rslsLoaded:int = 0, rslsFailed:int = 0, rslsTotal:int = 0, failedURLs:Array = null)| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5 |
| 執行階段版本: | Flash Player 10.1, AIR 2 |
建立包含 RSLError 事件資訊的 RSLErrorEvent 物件。RSLErrorEvent 物件會當做參數傳遞至事件偵聽程式。
參數type:String — 事件類型。可能的值為：RSLEvent.RSL_LOAD_COMPLETE 和 RSLEvent.RSL_PROGRESS。
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = false) | |
rslsLoaded:int (default = 0) | |
rslsFailed:int (default = 0) | |
rslsTotal:int (default = 0) | |
failedURLs:Array (default = null) |
常數詳細資訊
RSL_LOAD_FAILED | 常數 |
public static const RSL_LOAD_FAILED:String = "rslLoadFailed"| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5 |
| 執行階段版本: | Flash Player 10.1, AIR 2 |
當 RSL 完成下載以及一或多個檔案失敗時由 RSLPreloader 傳送。使用自訂的事件迴圈預先載入時，使用者內容「必須」偵聽此事件，以便判斷何時結束載入動畫迴圈。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | true |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 正要加入顯示清單中的 DisplayObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性，存取目前正在處理該事件之顯示清單中的物件。 |
rslsLoaded | 下載成功的檔案數目。 |
rslsFailed | 下載失敗的檔案數目。 |
rslsTotal | 下載的檔案總數，包括成功及下載失敗。 |
failedURLs | 下載失敗的檔案陣列。 |
import fl.events.RSLErrorEvent;
myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler);
function rslLoadFailedHandler(e:RSLErrorEvent) {
gotoAndPlay('rslLoadFailure');
}
相關 API 元素
Tue Jun 12 2018, 03:47 PM Z