| 套件 | flash.events |
| 類別 | public class ThrottleEvent |
| 繼承 | ThrottleEvent  Event Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE。
這是廣播事件，表示所有具有針對此事件註冊之偵聽程式的 EventDispatcher 物件都會加以傳送。如需有關廣播事件的詳細資訊，請參閱 DisplayObject 類別。
注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。
Flash Player 可以將內容節流為低影格速率 (例如，影格速率通常會減為介於 2 到 8 fps 之間的值)。當內容的索引標籤隱藏或最小化時，會將內容節流。在行動裝置上，當背光關閉或螢幕保護程式模式開啟時，會將內容節流。在節流內容之前，會傳送內含 ThrottleEvent.state=ThrottleType.THROTTLE 的 ThrottleEvent。ThrottleEvent.targetFrameRate 屬性包含新目標影格速率的值。
內容可以在事件偵聽程式中執行程式碼，以準備進行節流。這是個警告外部內容，節流的內容不太有回應的機會。例如，可能會取消作用中的 FileReference.upload() 或 FileReference.download() 方法。或者，如果內容使用 LocalConnection 與另一個 SWF 進行通訊，這是報告 SWF 預期變得沒有回應的機會。請注意，節流的內容可能無法在進入節流之前完成非同步動作。內容會在事件偵聽程式傳回時進入節流狀態。
Flash Player 可以暫停內容。例如，每當沒有音效或視訊在播放，若在行動裝置的螢幕外捲動內容，就會暫停內容。在暫停內容之前，會傳送內含 ThrottleEvent.state=ThrottleType.PAUSE 和 ThrottleEvent.targetFrameRate=0 的 ThrottleEvent。就像內容收到 ThrottleType.THROTTLE 事件時一樣，內容可以在事件偵聽程式中執行程式碼，以準備暫停。當事件偵聽程式傳回時，內容會進入暫停狀態。暫停時，內容不會對按下滑鼠或鍵盤輸入等使用者互動有任何回應。不過，仍會收到 ActionScript 網路事件。
當 Flash Player 繼續播放節流或暫停狀態的內容時，會傳送內含 ThrottleEvent.state=ThrottleType.RESUME 的 ThrottleEvent。ThrottleEvent.targetFrameRate 描述影格速率且通常等於 Stage.frameRate。當舞台的任何部分變成可見或使用者要求繼續播放內容時，可能會繼續播放內容。
目前支援節流和暫停的平台如下：Flash Player Desktop Mac 和 Windows、AIR Mobile 以及 Flash Player Android。下列平台不會自動傳送 ThrottleEvent，因為它們尚不支援暫停或節流：AIR for TV 裝置、桌上型電腦版 AIR 以及 Flash Player Linux Desktop。
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | bubbles : Boolean [唯讀]
指出事件是否為反昇事件。 | Event | |
| cancelable : Boolean [唯讀]
指出是否可避免與事件相關聯的行為指令。 | Event | |
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| currentTarget : Object [唯讀]
正主動使用事件偵聽程式處理 Event 物件的物件。 | Event | |
| eventPhase : uint [唯讀]
事件流程中的目前階段。 | Event | |
| state : String [唯讀]
描述播放程式要進入的狀態：ThrottleType.THROTTLE、ThrottleType.PAUSE 或 ThrottleType.RESUME。 | ThrottleEvent | ||
| target : Object [唯讀]
事件目標。 | Event | |
| targetFrameRate : Number [唯讀]
傳送 ThrottleEvent 之後 Flash Player 或 AIR 的目標影格速率。 | ThrottleEvent | ||
| type : String [唯讀]
事件類型。 | Event | |
| 方法 | 定義自 | ||
|---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
建立包含 ThrottleEvent 相關資訊的 Event 物件。 | ThrottleEvent | ||
[覆寫]
建立 ThrottleEvent 物件的副本，然後設定每個屬性的值以符合原始物件的屬性值。 | ThrottleEvent | ||
|
公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。 | Event | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
檢查是否已經對事件呼叫 preventDefault() 方法。 | Event | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
如果可以取消事件的預設行為指令，則取消該行為指令。 | Event | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。 | Event | |
|
避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。 | Event | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
[覆寫]
傳回包含 ThrottleEvent 物件所有屬性的字串。 | ThrottleEvent | ||
|
會傳回指定之物件的基本值。 | Object | |
state | 屬性 |
targetFrameRate | 屬性 |
targetFrameRate:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11, AIR 3.2 |
傳送 ThrottleEvent 之後 Flash Player 或 AIR 的目標影格速率。
例如，如果即將暫停內容，則 targetFrameRate 是 0。如果即將節流內容，targetFrameRate 通常介於 2 到 8 之間，視內容執行所在的平台、是否播放音效以及其他因素而定。如果內容在暫停或節流之後回到預期的影格速率，則 targetFrameRate 等於 Stage.frameRate。
實作
public function get targetFrameRate():Number相關 API 元素
ThrottleEvent | () | 建構函式 |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11, AIR 3.2 |
建立包含 ThrottleEvent 相關資訊的 Event 物件。Event 物件會當做參數傳遞至事件偵聽程式。
參數type:String — 事件類型。事件偵聽程式可以透過繼承的 type 屬性來存取此資訊。ThrottleEvent 事件只有一種類型：ThrottleEvent.THROTTLE。
| |
bubbles:Boolean (default = false)bubbles 屬性來存取此資訊。
| |
cancelable:Boolean (default = false)cancelable 屬性來存取此資訊。
| |
state:String (default = null)ThrottleType.THROTTLE、ThrottleType.PAUSE 或 ThrottleType.RESUME。
| |
targetFrameRate:Number (default = 0)targetFrameRate 是 0。如果即將節流內容，targetFrameRate 通常介於 2 到 8 之間，視內容執行所在的平台、是否播放音效以及其他因素而定。如果內容在暫停或節流之後回到預期的影格速率，則 targetFrameRate 等於 Stage.frameRate。
|
相關 API 元素
clone | () | 方法 |
toString | () | 方法 |
THROTTLE | 常數 |
public static const THROTTLE:String = "throttle"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11, AIR 3.2 |
定義 ThrottleEvent 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 具有為 throttle 事件註冊之偵聽程式的任何 DisplayObject 實體。 |
state | ThrottleType.THROTTLE、ThrottleType.PAUSE 或 ThrottleType.RESUME。 |
targetFrameRate | 描述傳送 ThrottleEvent 之後 Flash Player 或 AIR 的目標影格速率。例如，如果即將暫停內容，targetFrameRate 會是 0。如果即將節流內容，targetFrameRate 通常介於 2 到 8 之間，視內容執行所在的平台、是否播放音效以及其他因素而定。如果內容在暫停或節流之後回到預期的影格速率，則 targetFrameRate 等於 Stage.frameRate。 |
相關 API 元素
Tue Jun 12 2018, 03:47 PM Z