ThrottleEvent

Paket	flash.events
Klasse	public class ThrottleEvent
Vererbung	ThrottleEvent Event Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 3.2

Ein ThrottleEvent wird abgesetzt, wenn Flash Player den Inhalt drosselt, anhält oder fortsetzt. Es gibt nur einen Typ eines ThrottleEvent-Ereignisses: 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

flash.display.DisplayObject
flash.display.Stage
flash.events.ThrottleType

Öffentliche Eigenschaften

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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	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
		clone():Event [override] Erstellt eine Kopie des ThrottleEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.	ThrottleEvent
		formatToString(className:String, ... arguments):String Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.	Event
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isDefaultPrevented():Boolean Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.	Event
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		preventDefault():void Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.	Event
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		stopImmediatePropagation():void Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.	Event
		stopPropagation():void Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.	Event
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String [override] Gibt einen String zurück, der alle Eigenschaften des ThrottleEvent-Objekts enthält.	ThrottleEvent
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Öffentliche Konstanten

Vererbte öffentliche Konstanten ausblenden

Vererbte öffentliche Konstanten anzeigen

	Konstante		Definiert von
		THROTTLE : String = "throttle" [statisch] Definiert den Wert der type-Eigenschaft eines ThrottleEvent-Ereignisobjekts.	ThrottleEvent

Eigenschaftendetails

state

Eigenschaft

state:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 3.2

Beschreibt den Zustand, in den der Player eintritt: ThrottleType.THROTTLE, ThrottleType.PAUSE oder ThrottleType.RESUME.

Implementierung
public function get state():String

Verwandte API-Elemente

flash.events.ThrottleType

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():Number

Verwandte API-Elemente

flash.display.Stage

Konstruktordetails

()

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.

Parameter

	`type: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`) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft `bubbles` auf diese Informationen zugreifen.

	`cancelable:Boolean` (default = `false`) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft `cancelable` auf diese Informationen zugreifen.

	`state:String` (default = `null`) — `ThrottleType.THROTTLE`, `ThrottleType.PAUSE` oder `ThrottleType.RESUME`.

	`targetFrameRate:Number` (default = `0`) — 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

flash.display.Stage

Methodendetails

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ückgabewerte

Event — 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]

Rückgabewerte

String — Eine Zeichenfolge, die alle Eigenschaften des ThrottleEvent-Objekts enthält.

Konstantendetails

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

flash.display.Stage

Rechtliche Hinweise | Onlinedatenschutzerklärung

ThrottleEvent - AS3

Klassen x

state

targetFrameRate

ThrottleEvent

clone

toString

THROTTLE