| Pakket | flash.events |
| Klasse | public class ThrottleEvent |
| Overerving | ThrottleEvent  Event Object |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE.
Deze gebeurtenis is een uitzendgebeurtenis, wat betekent dat deze wordt verzonden door alle objecten EventDispatcher met een listener die is ingesteld voor deze gebeurtenis. Zie de klasse DisplayObject voor meer informatie over uitzendgebeurtenissen.
Opmerking: Deze gebeurtenis heeft geen 'vastlegfase' en geen 'bubbelfase', wat betekent dat gebeurtenislisteners rechtstreeks aan mogelijke doelen moeten worden toegevoegd, ongeacht of het doel voorkomt in de weergavelijst.
Flash Player kan de snelheid van de inhoud vertragen naar een lagere framesnelheid (de framesnelheid wordt verminderd naar een waarde die meestal tussen 2 en 8 fps ligt). De inhoud kan worden vertraagd wanneer de tab van de inhoud verborgen of geminimaliseerd is. U kunt de snelheid van de inhoud op een mobiel apparaat vertragen wanneer de achtergrondverlichting wordt uitgeschakeld of de schermbeveiliging wordt ingeschakeld. Voordat de inhoud wordt vertraagd, wordt een ThrottleEvent verzonden met ThrottleEvent.state=ThrottleType.THROTTLE. De eigenschap ThrottleEvent.targetFrameRate bevat de waarde van de nieuwe doelframesnelheid.
De inhoud voert mogelijk code uit in de gebeurtenislistener ter voorbereiding op de vertraging. Dit is een gelegenheid om externe inhoud te waarschuwen dat de vertraagde inhoud minder snel zal reageren. Een actieve FileReference.upload()- of FileReference.download()-methode bijvoorbeeld kan mogelijk worden geannuleerd. Of als de inhoud via LocalConnection communiceert met een ander SWF-bestand, is dit een gelegenheid om het SWF-bestand te informeren dat het reactievermogen mogelijk minder snel zal zijn. Houd ermee rekening dat de inhoud door de vertraagde snelheid mogelijk geen asynchrone acties zal kunnen voltooien voordat de vertraging wordt ingevoerd. De inhoud wordt vertraagd wanneer de gebeurtenislistener wordt geretourneerd.
Flash Player kan inhoud mogelijk pauzeren. Inhoud kan bijvoorbeeld mogelijk worden gepauzeerd wanneer deze van het scherm van een mobiel apparaat wordt geschoven op een moment dat geen audio of video wordt afgespeeld. Voordat de inhoud wordt gepauzeerd, wordt een ThrottleEvent verzonden met ThrottleEvent.state=ThrottleType.PAUSE en ThrottleEvent.targetFrameRate=0. Net als wanneer de inhoud een ThrottleType.THROTTLE-gebeurtenis ontvangt, kan de inhoud code uitvoeren in de gebeurtenislistener ter voorbereiding op het pauzeren. Wanneer de gebeurtenislistener wordt geretourneerd, wordt de inhoud gepauzeerd. Tijdens het pauzeren zal de inhoud niet reageren op gebruikersinteractie, zoals muisklikken of toetsenbordinvoer. ActionScript-netwerkgebeurtenissen worden echter nog wel ontvangen.
Wanneer Flash Player de inhoud hervat na het vertragen of na het pauzeren, wordt een ThrottleEvent verzonden met ThrottleEvent.state=ThrottleType.RESUME. ThrottleEvent.targetFrameRate beschrijft de framesnelheid en is normaal gesproken gelijk aan Stage.frameRate. De inhoud kan worden hervat wanneer een deel van het werkgebied zichtbaar wordt of wanneer de gebruiker een aanvraag verstuurt voor het hervatten van de inhoud.
De platformen die vertragen en pauzeren ondersteunen, zijn momenteel de volgende: Flash Player Desktop Mac en Windows, AIR Mobile en Flash Player Android. De volgende platformen verzenden de ThrottleEvent niet automatisch omdat deze nog geen ondersteuning bieden voor pauzeren of vertragen: AIR for TV-apparaten, AIR for Desktop en Flash Player Linux Desktop.
Verwante API-elementen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
 | bubbles : Boolean [alleen-lezen]
Geeft aan of een gebeurtenis een terugkoppelgebeurtenis is. | Event | |
| cancelable : Boolean [alleen-lezen]
Geeft aan of het gedrag dat aan deze gebeurtenis is gekoppeld, kan worden voorkomen. | Event | |
| constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| currentTarget : Object [alleen-lezen]
Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. | Event | |
| eventPhase : uint [alleen-lezen]
De huidige fase in de gebeurtenisstroom. | Event | |
| state : String [alleen-lezen]
Beschrijft de toestand die wordt ingeschakeld van de speler: ThrottleType.THROTTLE, ThrottleType.PAUSE of ThrottleType.RESUME. | ThrottleEvent | ||
| target : Object [alleen-lezen]
Doel van gebeurtenis. | Event | |
| targetFrameRate : Number [alleen-lezen]
De framesnelheid die Flash Player of AIR als doel zullen hebben nadat de ThrottleEvent is verzonden. | ThrottleEvent | ||
| type : String [alleen-lezen]
Het type gebeurtenis. | Event | |
| Methode | Gedefinieerd door | ||
|---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Hiermee wordt een Event-object gemaakt dat informatie over de ThrottleEvent bevat. | ThrottleEvent | ||
[overschrijven]
Maakt een kopie van het ThrottleEvent-object en stelt de waarde van elke eigenschap in zodat deze overeenkomt met die van het origineel. | ThrottleEvent | ||
|
Een hulpprogrammafunctie voor de implementatie van de methode toString() in aangepaste ActionScript 3.0-Event-klassen. | Event | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Controleert of de methode preventDefault() is aangeroepen voor de gebeurtenis. | Event | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Annuleert het standaardgedrag van een gebeurtenis wanneer dat gedrag kan worden geannuleerd. | Event | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Voorkomt het verwerken van gebeurtenislisteners in het huidige knooppunt en volgende knooppunten in de gebeurtenisstroom. | Event | |
|
Voorkomt het verwerken van gebeurtenislisteners in knooppunten die volgen op het huidige knooppunt in de gebeurtenisstroom. | Event | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
[overschrijven]
Retourneert een tekenreeks die alle eigenschappen van het ThrottleEvent-object bevat. | ThrottleEvent | ||
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
| Constante | Gedefinieerd door | ||
|---|---|---|---|
| THROTTLE : String = "throttle" [statisch]
Definieert de waarde van de eigenschap type van een ThrottleEvent-gebeurtenisobject. | ThrottleEvent | ||
state | eigenschap |
targetFrameRate | eigenschap |
targetFrameRate:Number [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3.2 |
De framesnelheid die Flash Player of AIR als doel zullen hebben nadat de ThrottleEvent is verzonden.
Als de inhoud bijvoorbeeld wordt gepauzeerd, zal de targetFrameRate 0 zijn. Als de inhoud wordt vertraagd, zal de targetFrameRate normaal tussen 2 en 8 liggen, afhankelijk van het platform waarop de inhoud wordt uitgevoerd, of audio wordt afgespeeld en andere factoren. Als de verwachte framesnelheid wordt hersteld na het pauzeren of vertragen van de inhoud, zal targetFrameRate gelijk zijn aan Stage.frameRate.
Implementatie
public function get targetFrameRate():NumberVerwante API-elementen
ThrottleEvent | () | Constructor |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3.2 |
Hiermee wordt een Event-object gemaakt dat informatie over de ThrottleEvent bevat. Gebeurtenisobjecten worden als parameters aan gebeurtenislisteners doorgegeven.
Parameterstype:String — Het type gebeurtenis. Gebeurtenislisteners hebben toegang tot deze informatie via de overerfde eigenschap type. Er is slechts één type ThrottleEvent-gebeurtenis: ThrottleEvent.THROTTLE.
| |
bubbles:Boolean (default = false)bubbles.
| |
cancelable:Boolean (default = false)cancelable.
| |
state:String (default = null)ThrottleType.THROTTLE, ThrottleType.PAUSE of ThrottleType.RESUME.
| |
targetFrameRate:Number (default = 0)targetFrameRate 0 zijn. Als de inhoud wordt vertraagd, zal de targetFrameRate normaal tussen 2 en 8 liggen, afhankelijk van het platform waarop de inhoud wordt uitgevoerd, of audio wordt afgespeeld en andere factoren. Als de verwachte framesnelheid wordt hersteld na het pauzeren of vertragen van de inhoud, zal targetFrameRate gelijk zijn aan Stage.frameRate.
|
Verwante API-elementen
clone | () | methode |
override public function clone():Event| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3.2 |
Maakt een kopie van het ThrottleEvent-object en stelt de waarde van elke eigenschap in zodat deze overeenkomt met die van het origineel.
Geretourneerde waardeEvent — Een nieuw ThrottleEvent-object met de eigenschapwaarden die overeenkomen met het origineel.
|
toString | () | methode |
override public function toString():String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3.2 |
Retourneert een tekenreeks die alle eigenschappen van het ThrottleEvent-object bevat. De tekenreeks heeft de volgende indeling:
[ThrottleEvent-type=waarde bubbles=waarde cancelable=waarde state=waarde targetFrameRate=waarde]
String — Een tekenreeks die alle eigenschappen van het ThrottleEvent-object bevat.
|
THROTTLE | Constante |
public static const THROTTLE:String = "throttle"| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3.2 |
Definieert de waarde van de eigenschap type van een ThrottleEvent-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
| Eigenschap | Waarde |
|---|---|
bubbles | false |
cancelable | false; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Elke DisplayObject-instantie met een listener die is geregistreerd voor de vertragingsgebeurtenis. |
state | ThrottleType.THROTTLE, ThrottleType.PAUSE of ThrottleType.RESUME. |
targetFrameRate | Beschrijft de framesnelheid die Flash Player of AIR als doel zullen hebben nadat de ThrottleEvent is verzonden. Als de inhoud bijvoorbeeld wordt gepauzeerd, zal de targetFrameRate 0 zijn. Als de inhoud wordt vertraagd, zal de targetFrameRate normaal tussen 2 en 8 liggen, afhankelijk van het platform waarop de inhoud wordt uitgevoerd, of audio wordt afgespeeld en andere factoren. Als de inhoud na het pauzeren of vertragen weer op de verwachte framesnelheid wordt afgespeeld, zal targetFrameRate gelijk zijn aan Stage.frameRate. |
Verwante API-elementen
Wed Jun 13 2018, 11:42 AM Z