| Pacote | flash.events |
| Classe | public class ThrottleEvent |
| Herança | ThrottleEvent  Event Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE.
Esse é um evento de transmissão, ou seja, ele é despachado por todos os objetos EventDispatcher com um ouvinte registrado para esse evento. Para obter mais informações sobre eventos de transmissão, consulte a classe DisplayObject.
Observação: Esse evento não tem uma "fase de captura" nem "fase de bubble", significando que os ouvintes de evento precisam ser adicionados diretamente a qualquer destino possível que esteja ou não na lista de exibição.
O Flash Player pode limitar o conteúdo a uma taxa de quadros baixa (isto é, a taxa de quadros é reduzida a um valor normalmente entre 2 e 8 fps). O conteúdo pode ser limitado quando sua guia está oculta ou minimizada. Em um dispositivo móvel, o conteúdo pode ser limitado quando a luz de fundo se apaga ou quando o modo de proteção de tela é ativado. Antes de limitar o conteúdo, um ThrottleEvent é despachado com ThrottleEvent.state=ThrottleType.THROTTLE. A propriedade ThrottleEvent.targetFrameRate contém o valor da nova taxa de quadros de destino.
O conteúdo pode executar o código no ouvinte de evento para preparar-se para a limitação. Essa é uma oportunidade de alertar o conteúdo externo de que o conteúdo limitado terá uma capacidade de resposta muito menor. Por exemplo, um método FileReference.upload() ou FileReference.download() ativo pode ser cancelado. Se o conteúdo estiver se comunicando via LocalConnection com outro SWF, essa será uma oportunidade de informar esse SWF que espere uma capacidade de resposta menor. Observe que o conteúdo limitado pode não ser capaz de concluir ações assíncronas antes da entrada da limitação. O conteúdo insere o estado limitado quando o ouvinte do evento retornar.
O Flash Player pode pausar o conteúdo. Por exemplo, o conteúdo pode ser pausado quando é rolado fora da tela em um dispositivo móvel no momento em que nenhum áudio ou o vídeo estiver sendo reproduzido. Antes de pausar o conteúdo, um ThrottleEvent é despachado com ThrottleEvent.state=ThrottleType.PAUSE e ThrottleEvent.targetFrameRate=0. Semelhante a quando o conteúdo recebe um evento ThrottleType.THROTTLE, o conteúdo pode executar o código no ouvinte de evento para se preparar para a pausa. Quando o ouvinte de evento retorna, o conteúdo insere o estado pausado. Enquanto estiver em pausa, o conteúdo não responderá a interações de usuários, como entradas de teclado ou cliques do mouse. No entanto, os eventos de rede do ActionScript ainda podem ser recebidos.
Quando o Flash Player retoma o conteúdo de um estado limitado ou pausado, um ThrottleEvent é despachado com ThrottleEvent.state=ThrottleType. RESUME. ThrottleEvent.targetFrameRate descreve a taxa de quadros e é normalmente igual a Stage.frameRate. O conteúdo pode ser retomado quando qualquer parte do palco fica visível ou quando o usuário faz um pedido para que o conteúdo seja retomado.
No momento, as plataformas que oferecem suporte a limitação e pausa são as seguintes: Flash Player Desktop Mac e Windows, AIR Mobile e Flash Player Android. As seguintes plataformas não despacham o ThrottleEvent automaticamente porque ainda não suportam pausa ou limitação: AIR para aparelhos de TV, AIR para desktop e Flash Player Linux Desktop.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | |
| cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | |
| constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | |
| eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | |
| state : String [somente leitura]
Descreve o estado que o reprodutoR está inserindo: ThrottleType.THROTTLE, ThrottleType.PAUSE ou ThrottleType.RESUME. | ThrottleEvent | ||
| target : Object [somente leitura]
O destino de evento. | Event | |
| targetFrameRate : Number [somente leitura]
A taxa de quadros de destino do Flash Player ou do AIR depois que o ThrottleEvent for despachado. | ThrottleEvent | ||
| type : String [somente leitura]
O tipo de evento. | Event | |
| Método | Definido por | ||
|---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Cria um objeto Event que contém informações sobre o ThrottleEvent. | ThrottleEvent | ||
[substituir]
Cria uma cópia do objeto ThrottleEvent e define o valor de cada propriedade de modo a corresponder ao original. | ThrottleEvent | ||
|
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Verifica se o método preventDefault() foi chamado no evento. | Event | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | |
|
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
[substituir]
Retorna uma string que contém todas as propriedades do objeto ThrottleEvent. | ThrottleEvent | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| THROTTLE : String = "throttle" [estático]
Define o valor da propriedade type de um objeto de evento ThrottleEvent. | ThrottleEvent | ||
state | propriedade |
state:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3.2 |
Descreve o estado em que o player é inserido: ThrottleType.THROTTLE, ThrottleType.PAUSE ou ThrottleType.RESUME.
Implementação
public function get state():StringElementos da API relacionados
targetFrameRate | propriedade |
targetFrameRate:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3.2 |
A taxa de quadros de destino do Flash Player ou do AIR depois que o ThrottleEvent for despachado.
Por exemplo, se o conteúdo estiver sendo pausado, targetFrameRate será 0. Se o conteúdo estiver sendo limitado, targetFrameRate normalmente ficará entre 2 e 8, dependendo da plataforma em que o conteúdo está sendo executado, de se áudio está sendo reproduzido, além de outros fatores. Se o conteúdo for retornado à taxa de quadros esperada depois de ser pausado ou limitado, targetFrameRate será igual a Stage.frameRate.
Implementação
public function get targetFrameRate():NumberElementos da API relacionados
ThrottleEvent | () | Construtor |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3.2 |
Cria um objeto Event que contém informações sobre o ThrottleEvent. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.
Parâmetrostype:String — O tipo de evento. Ouvintes de eventos podem acessar essas informações por meio da propriedade type herdada. Só existe um tipo de evento ThrottleEvent: ThrottleEvent.THROTTLE.
| |
bubbles:Boolean (default = false)bubbles herdada.
| |
cancelable:Boolean (default = false)cancelable herdada.
| |
state:String (default = null)ThrottleType.THROTTLE, ThrottleType.PAUSE ou ThrottleType.RESUME.
| |
targetFrameRate:Number (default = 0)targetFrameRate será 0. Se o conteúdo estiver sendo limitado, targetFrameRate normalmente ficará entre 2 e 8, dependendo da plataforma em que o conteúdo está sendo executado, de se áudio está sendo reproduzido, além de outros fatores. Se o conteúdo for retornado à taxa de quadros esperada depois de ser pausado ou limitado, targetFrameRate será igual a Stage.frameRate.
|
Elementos da API relacionados
clone | () | método |
override public function clone():Event| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3.2 |
Cria uma cópia do objeto ThrottleEvent e define o valor de cada propriedade de modo a corresponder ao original.
RetornaEvent — Um novo objeto ThrottleEvent com valores de propriedade que correspondem aos do original.
|
toString | () | método |
override public function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3.2 |
Retorna uma string que contém todas as propriedades do objeto ThrottleEvent. A string está no seguinte formato:
[tipo de ThrottleEvent=valor bolhas=valor cancelável=valor estado=valor targetFrameRate=valor]
String — Uma string que contém todas as propriedades do objeto ThrottleEvent.
|
THROTTLE | Constante |
public static const THROTTLE:String = "throttle"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3.2 |
Define o valor da propriedade type de um objeto de evento ThrottleEvent.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | Qualquer instância de DisplayObject com um ouvinte registrado para o evento throttle. |
estado | ThrottleType.THROTTLE, ThrottleType.PAUSE ou ThrottleType.RESUME. |
targetFrameRate | Descreve a taxa de quadros que o Flash Player ou o AIR almejarão depois que o evento ThrottleEvent is for despachado. Por exemplo, se o conteúdo estiver sendo pausado, targetFrameRate será 0. Se o conteúdo estiver sendo limitado, targetFrameRate normalmente ficará entre 2 e 8, dependendo da plataforma em que o conteúdo está sendo executado, de se o áudio está sendo reproduzido, bem como de outros fatores. Se o conteúdo for retornado à taxa de quadros esperada depois de ser pausado ou limitado, targetFrameRate será igual a Stage.frameRate. |
Elementos da API relacionados
Wed Jun 13 2018, 11:10 AM Z