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