| Pacchetto | flash.events |
| Classe | public class ThrottleEvent |
| Ereditarietà | ThrottleEvent  Event Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE.
Questo è un evento di trasmissione e ciò significa che viene inviato da tutti gli oggetti EventDispatcher con un listener registrato per questo evento. Per ulteriori informazioni sugli eventi di trasmissione, vedete la classe DisplayObject.
Nota: questo evento non dispone di una "fase di cattura" né di una "fase di bubbling"; ciò significa che i listener di eventi devono essere aggiunti direttamente a qualsiasi target potenziale, sia che il target si trovi o meno nell'elenco di visualizzazione.
Flash Player può rallentare la riproduzione del contenuto a una frequenza fotogrammi bassa (ovvero, la frequenza dei fotogrammi viene ridotta a un valore generalmente compreso tra 2 e 8 fps). Il contenuto può essere rallentato quando la relativa scheda viene nascosta o ridotta a icona. Su un dispositivo mobile, il contenuto può essere rallentato quando la retroilluminazione viene disattivata oppure viene attivato lo screensaver. Prima di rallentare il contenuto, viene inviato un evento ThrottleEvent con ThrottleEvent.state=ThrottleType.THROTTLE. La proprietà ThrottleEvent.targetFrameRate contiene il valore della nuova frequenza di fotogrammi di destinazione.
Il contenuto può eseguire del codice nel listener di eventi per prepararsi al rallentamento. Questa è un'opportunità per avvisare contenuto esterno che il contenuto rallentato risulterà meno reattivo. Ad esempio, un metodo FileReference.upload() o FileReference.download() attivo potrebbe essere annullato. Oppure, se il contenuto comunica mediante LocalConnection con un altro SWF, è possibile informare tale SWF di attendersi una reattività minore. Tenete presente che il contenuto rallentato potrebbe non essere in grado di portare a termine azioni asincrone prima di entrare nello stato di rallentamento. Il contenuto entrerà nello stato di rallentamento quando il listener di eventi ritorna.
Flash Player può mettere in pausa il contenuto. Ad esempio, il contenuto può essere messo in pausa se viene fatto scorrere fuori dallo schermo su un dispositivo mobile in un momento in cui non viene riprodotto alcun video o audio. Prima della messa in pausa del contenuto, viene inviato un evento ThrottleEvent con ThrottleEvent.state=ThrottleType.PAUSE e ThrottleEvent.targetFrameRate=0. Come accade quando il contenuto riceve un evento ThrottleType.THROTTLE, il contenuto può eseguire del codice nel listener di eventi per prepararsi alla pausa. Quando il listener di eventi ritorna, il contenuto entra nello stato di pausa. Mentre è in pausa, il contenuto non risponde alle interazioni dell'utente, quali clic del mouse o inserimenti da tastiera. Gli eventi di rete ActionScript possono invece essere ricevuti.
Quando Flash Player ripristina il contenuto dallo stato di rallentamento o pausa, viene inviato un evento ThrottleEvent con ThrottleEvent.state=ThrottleType.RESUME. ThrottleEvent.targetFrameRate descrive la frequenza fotogrammi, che generalmente corrisponde a Stage.frameRate. Il contenuto può essere ripristinato quando una qualsiasi parte dello stage diventa visibile o quando l'utente richiede che il contenuto venga ripristinato.
Le piattaforme che supportano limitazione e pausa sono al momento le seguenti: Flash Player Desktop Mac e Windows, AIR Mobile e Flash Player Android. Le seguenti piattaforme non inviano automaticamente ThrottleEvent in quanto non supportano ancora la pausa e la limitazione: dispositivi AIR for TV, AIR for desktop e Flash Player Linux Desktop.
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | |
| cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | |
| constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | |
| eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | |
| state : String [sola lettura]
Descrive lo stato in cui il lettore sta entrando: ThrottleType.THROTTLE, ThrottleType.PAUSE o ThrottleType.RESUME. | ThrottleEvent | ||
| target : Object [sola lettura]
Il target dell'evento. | Event | |
| targetFrameRate : Number [sola lettura]
La frequenza fotogrammi a cui Flash Player o AIR mirano dopo l'invio dell'evento ThrottleEvent. | ThrottleEvent | ||
| type : String [sola lettura]
Il tipo di evento. | Event | |
| Metodo | Definito da | ||
|---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Crea un oggetto Event contenente informazioni relative a ThrottleEvent. | ThrottleEvent | ||
[override]
Crea una copia dell'oggetto ThrottleEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale. | ThrottleEvent | ||
|
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato. | Event | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. | Event | |
|
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. | Event | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
[override]
Restituisce una stringa che contiene tutte le proprietà dell'oggetto ThrottleEvent. | ThrottleEvent | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
| Costante | Definito da | ||
|---|---|---|---|
| THROTTLE : String = "throttle" [statico]
Definisce il valore della proprietà type di un oggetto evento ThrottleEvent. | ThrottleEvent | ||
state | proprietà |
targetFrameRate | proprietà |
targetFrameRate:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3.2 |
La frequenza fotogrammi a cui Flash Player o AIR mirano dopo l'invio dell'evento ThrottleEvent.
Ad esempio, se il contenuto viene messo in pausa, targetFrameRate è 0. Se il contenuto viene rallentato, targetFrameRate è generalmente compreso tra 2 e 8, a seconda della piattaforma sulla quale il contenuto viene eseguito, se viene riprodotto o meno l'audio e in base ad altri fattori. Se il contenuto viene riportato alla frequenza fotogrammi prevista dopo una pausa o un rallentamento, targetFrameRate corrisponde a Stage.frameRate.
Implementazione
public function get targetFrameRate():NumberElementi API correlati
ThrottleEvent | () | Funzione di costruzione |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3.2 |
Crea un oggetto Event contenente informazioni relative a ThrottleEvent. Gli oggetti evento vengono passati ai listener di eventi come parametri.
Parametritype:String — Il tipo di evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata type. Esiste un solo tipo di evento ThrottleEvent: ThrottleEvent.THROTTLE.
| |
bubbles:Boolean (default = false)bubbles.
| |
cancelable:Boolean (default = false)cancelable.
| |
state:String (default = null)ThrottleType.THROTTLE, ThrottleType.PAUSE o ThrottleType.RESUME.
| |
targetFrameRate:Number (default = 0)targetFrameRate è 0. Se il contenuto viene rallentato, targetFrameRate è generalmente compreso tra 2 e 8, a seconda della piattaforma sulla quale il contenuto viene eseguito, se viene riprodotto o meno l'audio e in base ad altri fattori. Se il contenuto viene riportato alla frequenza fotogrammi prevista dopo una pausa o un rallentamento, targetFrameRate corrisponde a Stage.frameRate.
|
Elementi API correlati
clone | () | metodo |
override public function clone():Event| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3.2 |
Crea una copia dell'oggetto ThrottleEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
RestituisceEvent — Un nuovo oggetto ThrottleEvent con proprietà dai valori identici a quelli dell'originale.
|
toString | () | metodo |
override public function toString():String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3.2 |
Restituisce una stringa che contiene tutte le proprietà dell'oggetto ThrottleEvent. La stringa ha il seguente formato:
[ThrottleEvent type=value bubbles=value cancelable=value state=value targetFrameRate=value]
String — Una stringa che contiene tutte le proprietà dell'oggetto ThrottleEvent.
|
THROTTLE | Costante |
public static const THROTTLE:String = "throttle"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3.2 |
Definisce il valore della proprietà type di un oggetto evento ThrottleEvent.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | Qualunque istanza DisplayObject con un listener registrato per l'evento ThrottleEvent. |
state | ThrottleType.THROTTLE, ThrottleType.PAUSE o ThrottleType.RESUME. |
targetFrameRate | Descrive la frequenza fotogrammi a cui Flash Player o AIR mirano dopo l'invio dell'evento ThrottleEvent. Ad esempio, se il contenuto viene messo in pausa, targetFrameRate corrisponderà a 0. Se il contenuto viene rallentato, targetFrameRate sarà generalmente compreso tra 2 e 8, a seconda della piattaforma sulla quale il contenuto viene eseguito, se viene riprodotto o meno l'audio e in base ad altri fattori. Se il contenuto viene riportato alla frequenza fotogrammi prevista dopo una pausa o un rallentamento, targetFrameRate corrisponde a Stage.frameRate. |
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z