Paket | flash.events |
Klass | public class ThrottleEvent |
Arv | ThrottleEvent Event Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE
.
Den här händelsen är en utsändningshändelse, vilket innebär att den skickas av alla EventDispatcher-objekt med en avlyssnare registrerad för den här händelsen. Mer information om utsändningshändelser finns i klassen DisplayObject.
Obs! Den här händelsen har varken hämtnings- eller bubblingsfas, vilket innebär att händelseavlyssnaren måste läggas till direkt i eventuella mål, oavsett om målet finns i visningslistan eller inte.
Flash Player kan strypa innehållet till en låg bildrutehastighet (vilket betyder att bildrutehastigheten minskas till ett värde som vanligtvis ligger mellan 2 och 8 bildrutor i sekunden). Innehåll kan strypas när dess flik är dold eller minimerad. På en mobilenhet kan innehåll strypas när bakgrundsbelysningen släcks eller när skärmsläckaren aktiveras. Innan innehållet stryps skickas en ThrottleEvent med ThrottleEvent.state=ThrottleType.THROTTLE
. Egenskapen ThrottleEvent.targetFrameRate
innehåller värdet på den nya bildrutehastigheten.
Innehållet kan köra kod i händelseavlyssnaren för att förbereda strypningen. Detta erbjuder en möjlighet att varna externt innehåll om att det strypta innehållet kanske inte svarar. En aktiv FileReference.upload()
- eller FileReference.download()
-metod kan till exempel avbrytas. Om innehållet kommunicerar med en annan SWF-fil via LocalConnection är detta också ett tillfälle att informera om att längre svarstider kan förväntas för denna SWF-fil. Tänk på att det strypta innehållet kanske inte kan slutföra asynkrona åtgärder innan strypningen inträffar. Innehåll försätts i det strypta läget när händelseavlyssnaren återställs.
Flash Player kan pausa innehåll. Innehållet kan till exempel pausas när det rullas utanför skärmen på en mobilenhet och varken ljud eller video spelas upp. Innan innehållet pausas skickas en ThrottleEvent med ThrottleEvent.state=ThrottleType.PAUSE
och ThrottleEvent.targetFrameRate=0
. På ungefär samma sätt som när innehållet tar emot en ThrottleType.THROTTLE
-händelse, kan innehållet köra kod i händelseavlyssnaren för att förbereda pausningen. När händelseavlyssnaren återställs pausas innehållet. Under tiden innehållet är pausat svarar det inte på användaråtgärder, till exempel musklickningar eller tangentbordsinmatningar. ActionScript-nätverkshändelser kan emellertid fortfarande tas emot.
När Flash Player återupptar innehållet från ett strypt eller pausat läge skickas en ThrottleEvent med ThrottleEvent.state=ThrottleType.RESUME
. ThrottleEvent.targetFrameRate
beskriver bildrutehastigheten och är vanligtvis lika med Stage.frameRate
. Innehållet kan återupptas när någon del av scenen blir synlig eller när användaren begär att innehållet ska återupptas.
De plattformar som har stöd för att strypa och pausa är för närvarande följande: Flash Player Desktop för Mac och Windows, AIR Mobile och Flash Player Android. Följande plattformar skickar inte ThrottleEvent automatiskt, eftersom de ännu inte har stöd för att strypa och pausa: AIR for TV-enheter, AIR för skrivbordsprogram och Flash Player Linux Desktop.
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
bubbles : Boolean [skrivskyddad]
indikerar om händelsen är en bubblande händelse. | Event | ||
cancelable : Boolean [skrivskyddad]
Indikerar om beteendet som är kopplat till händelsen kan förhindras. | Event | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
currentTarget : Object [skrivskyddad]
Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. | Event | ||
eventPhase : uint [skrivskyddad]
Den nuvarande fasen i händelseflödet. | Event | ||
state : String [skrivskyddad]
Beskriver läget som spelaren försätts i: ThrottleType.THROTTLE, ThrottleType.PAUSE eller ThrottleType.RESUME. | ThrottleEvent | ||
target : Object [skrivskyddad]
Händelsens mål. | Event | ||
targetFrameRate : Number [skrivskyddad]
Den bildrutehastighet som Flash Player eller AIR har som mål efter att ThrottleEvent har skickats. | ThrottleEvent | ||
type : String [skrivskyddad]
Händelsens typ. | Event |
Metod | Definieras med | ||
---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Skapar ett händelseobjekt som innehåller information om ThrottleEvent. | ThrottleEvent | ||
[åsidosätt]
Skapar en kopia av ThrottleEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper. | ThrottleEvent | ||
Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0. | Event | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Kontrollerar om preventDefault()-metoden har anropats för händelsen. | Event | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Avbryter en händelses standardbeteende om det beteendet kan avbrytas. | Event | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet. | Event | ||
Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet. | Event | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
[åsidosätt]
Returnerar en sträng som innehåller alla egenskaper i ThrottleEvent-objektet. | ThrottleEvent | ||
Returnerar det angivna objektets primitiva värde. | Object |
Konstant | Definieras med | ||
---|---|---|---|
THROTTLE : String = "throttle" [statisk]
Definierar värdet på egenskapen type för ett ThrottleEvent-händelseobjekt. | ThrottleEvent |
state | egenskap |
targetFrameRate | egenskap |
targetFrameRate:Number
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3.2 |
Den bildrutehastighet som Flash Player eller AIR har som mål efter att ThrottleEvent har skickats.
Om innehållet till exempel pausas är targetFrameRate
lika med 0. Om innehållet stryps ligger targetFrameRate
oftast mellan 2 och 8, beroende på vilken plattform som innehållet körs på, om ljud spelas upp och andra faktorer. Om innehållet återställs till den förväntade bildrutehastigheten efter att det pausats eller strypts är targetFrameRate
lika med Stage.frameRate
.
Implementering
public function get targetFrameRate():Number
Relaterade API-element
ThrottleEvent | () | Konstruktor |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3.2 |
Skapar ett händelseobjekt som innehåller information om ThrottleEvent. Event-objekt skickas som parametrar till händelseavlyssnare.
Parametrartype:String — Händelsens typ. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen type . Det finns bara en slags ThrottleEvent-händelse: ThrottleEvent.THROTTLE .
| |
bubbles:Boolean (default = false ) — Bestämmer om Event-objektet deltar i bubblingssteget av händelseflödet. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen bubbles .
| |
cancelable:Boolean (default = false ) — Avgör om Event-objektet kan avbrytas. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen cancelable .
| |
state:String (default = null ) — ThrottleType.THROTTLE , ThrottleType.PAUSE eller ThrottleType.RESUME .
| |
targetFrameRate:Number (default = 0 ) — Beskriver den bildrutehastighet som Flash Player eller AIR har som mål efter att ThrottleEvent har skickats. Om innehållet till exempel pausas är targetFrameRate lika med 0. Om innehållet stryps ligger targetFrameRate oftast mellan 2 och 8, beroende på vilken plattform som innehållet körs på, om ljud spelas upp och andra faktorer. Om innehållet återställs till den förväntade bildrutehastigheten efter att det pausats eller strypts är targetFrameRate lika med Stage.frameRate .
|
Relaterade API-element
clone | () | metod |
override public function clone():Event
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3.2 |
Skapar en kopia av ThrottleEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper.
ReturnerarEvent — Ett nytt ThrottleEvent-objekt med egenskapsvärden som matchar originalet.
|
toString | () | metod |
override public function toString():String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3.2 |
Returnerar en sträng som innehåller alla egenskaper i ThrottleEvent-objektet. Strängen är i följande format:
[ThrottleEvent type=value bubbles=värde cancelable=värde state=värde targetFrameRate=värde]
String — En sträng som innehåller alla egenskaper i ThrottleEvent-objektet.
|
THROTTLE | Konstant |
public static const THROTTLE:String = "throttle"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3.2 |
Definierar värdet på egenskapen type
för ett ThrottleEvent
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Alla DisplayObject-instanser med en avlyssnare registrerad för hastighetsändringshändelsen. |
läge | ThrottleType.THROTTLE, ThrottleType.PAUSE eller ThrottleType.RESUME. |
targetFrameRate | Beskriver den bildrutehastighet som Flash Player eller AIR kommer att rikta sig mot sedan ThrottleEvent har skickats. Om till exempel innehållet är pausat kommer targetFrameRate att vara 0. Om hastigheten ändras kommer targetFrameRate vanligtvis att ligga mellan 2 och 8, beroende på vilken plattform som innehållet körs på, om det är ljud som spelas och på andra faktorer. Om innehållet återställs till den förväntade bildrutehastigheten efter att det pausats eller strypts är targetFrameRate lika med Stage.frameRate. |
Relaterade API-element
Tue Jun 12 2018, 01:40 PM Z