| Paket | flash.events |
| Klasse | public class ThrottleEvent |
| Vererbung | ThrottleEvent  Event Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE.
Bei diesem Ereignis handelt es sich um ein broadcast-Ereignis. Das bedeutet, dass es von allen EventDispatcher-Objekten ausgelöst wird, die einen Listener für dieses Ereignis registriert haben. Weitere Informationen zu broadcast-Ereignissen finden Sie im Abschnitt zur DisplayObject-Klasse.
Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.
Flash Player kann den Inhalt auf eine niedrige Framerate drosseln (d.h., die Framerate wird auf einen Wert reduziert, der normalerweise zwischen 2 und 8 fps liegt). Inhalt kann gedrosselt werden, wenn der entsprechende Tab verborgen oder minimiert ist. Bei einem mobilen Gerät kann der Inhalt gedrosselt werden, wenn die Hintergrundbeleuchtung erlischt oder der Bildschirmschoner aktiviert wird. Bevor der Inhalt gedrosselt wird, wird ein ThrottleEvent mit ThrottleEvent.state=ThrottleType.THROTTLE abgesetzt. Die ThrottleEvent.targetFrameRate-Eigenschaft enthält den Wert der neuen Framerate.
Der Inhalt kann Code im Ereignis-Listener ausführen, um die Drosselung vorzubereiten. Dies ist eine Gelegenheit, um externe Inhalte zu warnen, dass der gedrosselte Inhalt sehr viel langsamer reagiert. Eine aktive FileReference.upload()- oder FileReference.download()-Methode könnte zum Beispiel abgebrochen werden. Oder, wenn Inhalt über LocalConnection mit einer anderen SWF-Datei kommuniziert, ist dies eine Gelegenheit, diese SWF-Datei über zu erwartende niedrigere Ansprechbarkeit zu informieren. Beachten Sie, dass der gedrosselte Inhalt möglicherweise asynchrone Aktionen nicht zu Ende führen kann, bevor die Drosselung in Kraft tritt. Inhalt geht in den gedrosselten Zustand über, wenn der Ereignis-Listener einen Wert zurückgibt.
Flash Player kann den Inhalt anhalten. Inhalt kann zum Beispiel angehalten werden, wenn er auf einem mobilen Gerät außerhalb des Bildschirms gescrollt wird, falls kein Audio oder Video abgespielt wird. Vor dem Anhalten des Inhalts wird ein ThrottleEvent mit ThrottleEvent.state=ThrottleType.PAUSE und ThrottleEvent.targetFrameRate=0 abgesetzt. Ähnlich wie in dem Fall, wenn der Inhalt ein ThrottleType.THROTTLE-Ereignis empfängt, kann der Inhalt Code im Ereignis-Listener ausführen, um die Pause vorzubereiten. Wenn der Ereignis-Listener einen Wert zurückgibt, tritt der Inhalt in den angehaltenen Zustand ein. Wenn der Inhalt angehalten wurde, reagiert er nicht auf Benutzeraktionen wie Mausklicks oder Tastatureingaben. ActionScript-Netzwerkereignisse können jedoch weiterhin empfangen werden.
Wenn Flash Player die Wiedergabe des Inhalts aus dem gedrosselten oder angehaltenen Zustand fortsetzt, wird ein ThrottleEvent mit ThrottleEvent.state=ThrottleType.RESUME abgesetzt. ThrottleEvent.targetFrameRate beschreibt die Framerate und entspricht normalerweise Stage.frameRate. Die Wiedergabe des Inhalts kann fortgesetzt werden, wenn ein Teil der Bühne sichtbar wird oder wenn der Benutzer die Fortsetzung der Wiedergabe anfordert.
Die folgenden Plattformen unterstützen zurzeit Drosselung und Anhalten: Flash Player Desktop Mac und Windows, AIR Mobile und Flash Player Android. Die folgenden Plattformen unterstützen das ThrottleEvent nicht automatisch, da sie Anhalten oder Drosselung noch nicht unterstützen: AIR für TV-Geräte, AIR für Desktop und Flash Player Linux Desktop.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | |
| cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | |
| eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | |
| state : String [schreibgeschützt]
Beschreibt den Zustand, in den der Player eintritt: ThrottleType.THROTTLE, ThrottleType.PAUSE oder ThrottleType.RESUME. | ThrottleEvent | ||
| target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | |
| targetFrameRate : Number [schreibgeschützt]
Die Framerate, die Flash Player oder AIR verwendet, nachdem das ThrottleEvent abgesetzt wurde. | ThrottleEvent | ||
| type : String [schreibgeschützt]
Der Ereignistyp. | Event | |
| Methode | Definiert von | ||
|---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Erstellt ein Ereignisobjekt, das Informationen über das ThrottleEvent enthält. | ThrottleEvent | ||
[override]
Erstellt eine Kopie des ThrottleEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. | ThrottleEvent | ||
|
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
[override]
Gibt einen String zurück, der alle Eigenschaften des ThrottleEvent-Objekts enthält. | ThrottleEvent | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
| Konstante | Definiert von | ||
|---|---|---|---|
| THROTTLE : String = "throttle" [statisch]
Definiert den Wert der type-Eigenschaft eines ThrottleEvent-Ereignisobjekts. | ThrottleEvent | ||
state | Eigenschaft |
targetFrameRate | Eigenschaft |
targetFrameRate:Number [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3.2 |
Die Framerate, die Flash Player oder AIR verwendet, nachdem das ThrottleEvent abgesetzt wurde.
Wenn der Inhalt zum Beispiel angehalten wurde, hat targetFrameRate den Wert 0. Wenn der Inhalt gedrosselt wird, hat targetFrameRate normalerweise einen Wert zwischen 2 und 8, je nachdem, auf welcher Plattform der Inhalt ausgeführt wird, ob Audio abgespielt wird oder andere Faktoren zutreffen. Wenn der Inhalt nach dem Anhalten oder Drosseln wieder zur erwarteten Framerate zurückkehrt, hat targetFrameRate den gleichen Wert wie Stage.frameRate.
Implementierung
public function get targetFrameRate():NumberVerwandte API-Elemente
ThrottleEvent | () | Konstruktor |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3.2 |
Erstellt ein Ereignisobjekt, das Informationen über das ThrottleEvent enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
Parametertype:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines ThrottleEvent-Ereignisses: ThrottleEvent.THROTTLE.
| |
bubbles:Boolean (default = false)bubbles auf diese Informationen zugreifen.
| |
cancelable:Boolean (default = false)cancelable auf diese Informationen zugreifen.
| |
state:String (default = null)ThrottleType.THROTTLE, ThrottleType.PAUSE oder ThrottleType.RESUME.
| |
targetFrameRate:Number (default = 0)targetFrameRate den Wert 0. Wenn der Inhalt gedrosselt wird, hat targetFrameRate normalerweise einen Wert zwischen 2 und 8, je nachdem, auf welcher Plattform der Inhalt ausgeführt wird, ob Audio abgespielt wird oder andere Faktoren zutreffen. Wenn der Inhalt nach dem Anhalten oder Drosseln wieder zur erwarteten Framerate zurückkehrt, hat targetFrameRate den gleichen Wert wie Stage.frameRate.
|
Verwandte API-Elemente
clone | () | Methode |
override public function clone():Event| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3.2 |
Erstellt eine Kopie des ThrottleEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
RückgabewerteEvent — Ein neues ThrottleEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
|
toString | () | Methode |
override public function toString():String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3.2 |
Gibt einen String zurück, der alle Eigenschaften des ThrottleEvent-Objekts enthält. Der String liegt im folgenden Format vor:
[ThrottleEvent type=Wert bubbles=Wert cancelable=Wert state=Wert targetFrameRate=Wert]
String — Eine Zeichenfolge, die alle Eigenschaften des ThrottleEvent-Objekts enthält.
|
THROTTLE | Konstante |
public static const THROTTLE:String = "throttle"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3.2 |
Definiert den Wert der type-Eigenschaft eines ThrottleEvent-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Jede DisplayObject-Instanz mit einem Listener, der für das Drosselungsereignis registriert ist. |
state | ThrottleType.THROTTLE, ThrottleType.PAUSE oder ThrottleType.RESUME. |
targetFrameRate | Gibt die Framerate an, die Flash Player oder AIR verwendet, nachdem das ThrottleEvent abgesetzt wurde. Wenn der Inhalt zum Beispiel angehalten wurde, hat targetFrameRate den Wert 0. Wenn der Inhalt gedrosselt wird, hat targetFrameRate normalerweise einen Wert zwischen 2 und 8, je nachdem, auf welcher Plattform der Inhalt ausgeführt wird, ob Audio abgespielt wird oder andere Faktoren zutreffen. Wenn der Inhalt nach dem Anhalten oder Drosseln wieder zur erwarteten Framerate zurückkehrt, hat targetFrameRate den gleichen Wert wie Stage.frameRate. |
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z