| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
As propriedades da classe Event contêm informações básicas sobre um evento, como o tipo do evento ou se o comportamento padrão do evento pode ser cancelado. Para muitos eventos, como os representados pelas constantes de classe Evento, essas informações básicas são suficiente. Outros eventos, no entanto, podem requerer mais informações detalhadas. Eventos associados a um clique do mouse, por exemplo, precisam incluir informações adicionais sobre o local do evento click e se alguma tecla foi pressionada durante o evento click. Você pode transmitir tais informações adicionais para ouvintes de eventos ampliando a classe Evento, que é o que a classe MouseEvent faz. A API do ActionScript 3.0 define várias subclasses Event para eventos comuns que exigem informações adicionais. Eventos associados a cada uma das subclasses Event são descritos na documentação para cada classe.
Os métodos da classe Event podem ser usados em funções do ouvinte de eventos para afetar o comportamento do objeto de evento. Alguns eventos têm um comportamento padrão associado. Por exemplo, o evento doubleClick tem um comportamento padrão associado que realça a palavra sob o ponteiro do mouse no momento do evento.Seu ouvinte de eventos pode cancelar esse comportamento chamando o método preventDefault(). Você também pode tornar o ouvintes de evento atual o último a processar um evento chamando o método stopPropagation() ou o stopImmediatePropagation().
Outras fontes de informação incluem:
- Uma descrição útil da temporização de eventos, execução de códigos e renderizações no tempo de execução está no blog de Ted Patrick: Flash Player Mental Model - The Elastic Racetrack.
- Publicação no blog de Johannes Tacskovics sobre o ajuste de tempo de eventos de quadro, como ENTER_FRAME, EXIT_FRAME: The MovieClip Lifecycle.
- Um artigo por Trevor McCauley sobre a ordem de operações do ActionScript: Order of Operations in ActionScript.
- Publicação do blog de Matt Przybylski sobre criação de eventos personalizados: AS3: Custom Events.
Mais exemplos
About the Event class
Using events
Manually dispatching events
Event propagation
Event priorities
Using event subclasses
About keyboard events
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 | ||
| target : Object [somente leitura]
O destino de evento. | Event | ||
| type : String [somente leitura]
O tipo de evento. | Event | ||
| Método | Definido por | ||
|---|---|---|---|
Cria um objeto Event para transferir um parâmetro para ouvintes de eventos. | Event | ||
Duplica uma ocorrência de uma subclasse Event. | Event | ||
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 | |
Retorna uma string que contém todas as propriedades do objeto Event. | Event | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| ACTIVATE : String = "activate" [estático]
A constante ACTIVATE define o valor da propriedade type de um objeto de evento activate. | Event | ||
| ADDED : String = "added" [estático]
A constante Event.ADDED define o valor da propriedade type de um objeto de evento added. | Event | ||
| ADDED_TO_STAGE : String = "addedToStage" [estático]
A constante Event.ADDED_TO_STAGE define o valor da propriedade type de um objeto de evento addedToStage. | Event | ||
| BROWSER_ZOOM_CHANGE : String = "browserZoomChange" [estático]
A constante Event.BROWSER_ZOOM_CHANGE define o valor do tipo de propriedade de um objeto de evento browserZoomChange. | Event | ||
| CANCEL : String = "cancel" [estático]
A constante Event.CANCEL define o valor da propriedade type de um objeto de evento cancel. | Event | ||
| CHANGE : String = "change" [estático]
A constante Event.CHANGE define o valor da propriedade type de um objeto de evento change. | Event | ||
| CHANNEL_MESSAGE : String = "channelMessage" [estático]
A constante Event.CHANNEL_MESSAGE define o valor da propriedade type de um objeto de evento channelMessage. | Event | ||
| CHANNEL_STATE : String = "channelState" [estático]
A constante Event.CHANNEL_STATE define o valor da propriedade type de um objeto de evento channelState. | Event | ||
| CLEAR : String = "clear" [estático]
A constante Event.CLEAR define o valor de propriedade type de um objeto de evento clear. | Event | ||
| CLOSE : String = "close" [estático]
A constante Event.CLOSE define o valor da propriedade type de um objeto de evento close. | Event | ||
| CLOSING : String = "closing" [estático]
A constante Event.CLOSING define o valor da propriedade type de um objeto de evento closing. | Event | ||
| COMPLETE : String = "complete" [estático]
A constante Event.COMPLETE define o valor da propriedade type de um objeto de evento complete. | Event | ||
| CONNECT : String = "connect" [estático]
A constante Event.CONNECT define o valor da propriedade type de um objeto de evento connect. | Event | ||
| CONTEXT3D_CREATE : String = "context3DCreate" [estático]
A constante Event.CONTEXT3D_CREATE define o valor da propriedade de tipo de um objeto de evento context3Dcreate. | Event | ||
| COPY : String = "copy" [estático]
Define o valor da propriedade type de um objeto de evento copy. | Event | ||
| CUT : String = "cut" [estático]
Define o valor da propriedade type de um objeto de evento cut. | Event | ||
| DEACTIVATE : String = "deactivate" [estático]
A constante Event.DEACTIVATE define o valor da propriedade type de um objeto de evento deactivate. | Event | ||
| DISPLAYING : String = "displaying" [estático]
A constante Event.DISPLAYING define o valor da propriedade de tipo de um objeto de evento displaying. | Event | ||
| ENTER_FRAME : String = "enterFrame" [estático]
A constante Event.ENTER_FRAME define o valor da propriedade type de um objeto de evento enterFrame. | Event | ||
| EXIT_FRAME : String = "exitFrame" [estático]
A constante Event.EXIT define o valor da propriedade de tipo de um objeto de evento exitFrame. | Event | ||
| EXITING : String = "exiting" [estático]
A constante Event.EXITING define o valor da propriedade type de um objeto de evento exiting. | Event | ||
| FRAME_CONSTRUCTED : String = "frameConstructed" [estático]
A constante Event.FRAME_CONSTRUCTED define o valor da propriedade de tipo de um objeto de evento frameConstructed. | Event | ||
| FRAME_LABEL : String = "frameLabel" [estático]
A constante Event.FRAME_LABEL define o valor da propriedade de tipo de um objeto de evento frameLabel. | Event | ||
| FULLSCREEN : String = "fullScreen" [estático]
A constante Event.FULL_SCREEN define o valor da propriedade type de um objeto de evento fullScreen. | Event | ||
| HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [estático]
A constante Event.HTML_BOUNDS_CHANGE define o valor da propriedade type de um objeto de evento htmlBoundsChange. | Event | ||
| HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [estático]
A constante Event.HTML_DOM_INITIALIZE define o valor da propriedade type de um objeto de evento htmlDOMInitialize. | Event | ||
| HTML_RENDER : String = "htmlRender" [estático]
A constante Event.HTML_RENDER define o valor da propriedade type de um objeto de evento htmlRender. | Event | ||
| ID3 : String = "id3" [estático]
A constante Event.ID3 define o valor da propriedade type de um objeto de evento id3. | Event | ||
| INIT : String = "init" [estático]
A constante Event.INIT define o valor da propriedade type de um objeto de evento init. | Event | ||
| LOCATION_CHANGE : String = "locationChange" [estático]
A constante Event.LOCATION_CHANGE define o valor da propriedade type de um objeto de evento locationChange. | Event | ||
| MOUSE_LEAVE : String = "mouseLeave" [estático]
A constante Event.MOUSE_LEAVE define o valor da propriedade type de um objeto de evento mouseLeave. | Event | ||
| NETWORK_CHANGE : String = "networkChange" [estático]
A constante Event.NETWORK_CHANGE define o valor da propriedade type de um objeto de evento networkChange. | Event | ||
| OPEN : String = "open" [estático]
A constante Event.OPEN define o valor da propriedade type de um objeto de evento open. | Event | ||
| PASTE : String = "paste" [estático]
A constante Event.PASTE define o valor da propriedade de tipo de um objeto de evento paste. | Event | ||
| PREPARING : String = "preparing" [estático]
A constante Event.PREPARING define o valor da propriedade de tipo de um objeto de evento preparing. | Event | ||
| REMOVED : String = "removed" [estático]
A constante Event.REMOVED define o valor da propriedade type de um objeto de evento removed. | Event | ||
| REMOVED_FROM_STAGE : String = "removedFromStage" [estático]
A constante Event.REMOVED_FROM_STAGE define o valor da propriedade type de um objeto de evento removedFromStage. | Event | ||
| RENDER : String = "render" [estático]
A constante Event.RENDER define o valor da propriedade type de um objeto de evento render. | Event | ||
| RESIZE : String = "resize" [estático]
A constante Event.RESIZE define o valor da propriedade type de um objeto de evento resize. | Event | ||
| SCROLL : String = "scroll" [estático]
A constante Event.SCROLL define o valor da propriedade type de um objeto de evento scroll. | Event | ||
| SELECT : String = "select" [estático]
A constante Event.SELECT define o valor da propriedade type de um objeto de evento select. | Event | ||
| SELECT_ALL : String = "selectAll" [estático]
A constante Event.SELECT_ALL define o valor da propriedade de tipo de um objeto de evento selectAll. | Event | ||
| SOUND_COMPLETE : String = "soundComplete" [estático]
A constante Event.SOUND_COMPLETE define o valor da propriedade type de um objeto de evento soundComplete. | Event | ||
| STANDARD_ERROR_CLOSE : String = "standardErrorClose" [estático]
A constante Event.STANDARD_ERROR_CLOSE define o valor da propriedade de um objeto de evento standardErrorClose. | Event | ||
| STANDARD_INPUT_CLOSE : String = "standardInputClose" [estático]
A constante Event.STANDARD_INPUT_CLOSE define o valor da propriedade type de um objeto de evento standardInputClose. | Event | ||
| STANDARD_OUTPUT_CLOSE : String = "standardOutputClose" [estático]
A constante Event.STANDARD_OUTPUT_CLOSE define o valor da propriedade type de um objeto de evento standardOutputClose. | Event | ||
| SUSPEND : String = "suspend" [estático]
A constante Event.SUSPEND define o valor da propriedade type de um objeto de evento suspend. | Event | ||
| TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [estático]
A constante Event.TAB_CHILDREN_CHANGE define o valor da propriedade type de um objeto de evento tabChildrenChange. | Event | ||
| TAB_ENABLED_CHANGE : String = "tabEnabledChange" [estático]
A constante Event.TAB_ENABLED_CHANGE define o valor da propriedade type de um objeto de evento tabEnabledChange. | Event | ||
| TAB_INDEX_CHANGE : String = "tabIndexChange" [estático]
A constante Event.TAB_INDEX_CHANGE define o valor da propriedade type de um objeto de evento tabIndexChange. | Event | ||
| TEXT_INTERACTION_MODE_CHANGE : String = "textInteractionModeChange" [estático]
A constante Event.TEXT_INTERACTION_MODE_CHANGE define o valor da propriedade type de um objeto de evento de modo de interação. | Event | ||
| TEXTURE_READY : String = "textureReady" [estático]
A constante Event.TEXTURE_READY define o valor da propriedade type de um objeto de evento textureReady. | Event | ||
| UNLOAD : String = "unload" [estático]
A constante Event.UNLOAD define o valor da propriedade type de um objeto de evento unload. | Event | ||
| USER_IDLE : String = "userIdle" [estático]
A constante Event.USER_IDLE define o valor da propriedade type de um objeto de evento userIdle. | Event | ||
| USER_PRESENT : String = "userPresent" [estático]
A constante Event.USER_PRESENT define o valor da propriedade type de um objeto de evento userPresent. | Event | ||
| VIDEO_FRAME : String = "videoFrame" [estático]
A ocorrência Event.VIDEO_FRAME define o valor do tipo de propriedade de um objeto do evento videoFrame. | Event | ||
| WORKER_STATE : String = "workerState" [estático]
A constante Event.WORKER_STATE define o valor do tipo de propriedade de um objeto de evento workerState. | Event | ||
bubbles | propriedade |
bubbles:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica se um evento é do tipo bubbling. Se o evento puder @bubble, esse valor será true; do contrário, será false.
Quando ocorre um evento, ele se move pelas três fases do fluxo de eventos: a fase de captura, que flui da parte superior da hierarquia da lista de exibição para o nó, antes do nó-alvo; a fase de destino, que compreende o nó-alvo; e a fase de bubbling, que flui do nó subsequente ao nó-alvo de volta para a parte superior da hierarquia da lista de exibição.
Alguns eventos, como o activate e o unload, não têm uma fase de bubbling. A propriedade bubbles tem um valor false para eventos que não têm uma fase de bubbling.
Implementação
public function get bubbles():Booleancancelable | propriedade |
cancelable:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica se o comportamento associado ao evento pode ser impedido. Se o evento puder ser cancelado, esse valor será true; do contrário, será false.
Implementação
public function get cancelable():BooleanElementos da API relacionados
currentTarget | propriedade |
currentTarget:Object [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. Por exemplo, se o usuário clica em um botão OK, o nó-alvo atual pode ser o nó que contém esse botão, ou um de seus ancestrais que registrou um ouvinte de evento para esse evento.
Implementação
public function get currentTarget():ObjecteventPhase | propriedade |
eventPhase:uint [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A fase atual no fluxo de eventos. Esta propriedade pode conter os seguintes valores numéricos:
- A fase de captura (
EventPhase.CAPTURING_PHASE). - A fase de destino (
EventPhase.AT_TARGET). - A fase de bubbling (
EventPhase.BUBBLING_PHASE).
Implementação
public function get eventPhase():uinttarget | propriedade |
target:Object [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O destino de evento. Esta propriedade contém o nó-alvo. Por exemplo, se o usuário clica em um botão OK, o nó-alvo é o nó da lista de exibição que contém esse botão.
Implementação
public function get target():Objecttype | propriedade |
Event | () | Construtor |
public function Event(type:String, bubbles:Boolean = false, cancelable:Boolean = false)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria um objeto Event para transferir um parâmetro para ouvintes de eventos.
Parâmetrostype:String — O tipo do evento, acessível como Event.type.
| |
bubbles:Boolean (default = false)false.
| |
cancelable:Boolean (default = false)false.
|
clone | () | método |
public function clone():Event| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Duplica uma ocorrência de uma subclasse Event.
Retorna um novo objeto Event que é uma cópia da ocorrência original do objeto Event. Você normalmente não chama o clone(); a classe EventDispatcher chama-o automaticamente quando você reenvia um evento, ou seja, quando você chama o dispatchEvent(event) de um manipulador que está manipulando o evento.
O novo objeto Event inclui todas as propriedades do original.
Ao criar sua própria classe Event, você precisará substituir o método Event.clone() herdado para que ele duplique as propriedades de sua classe personalizada. Se você não definir todas as propriedades que adicionar à subclasse event, essas propriedades não terão os valores corretos quando ouvintes manipularem o evento redespachado.
Neste exemplo, PingEvent é uma subclasse de Event e, portanto, implementa sua própria versão de clone().
class PingEvent extends Event {
var URL:String;
public override function clone():Event {
return new PingEvent(type, bubbles, cancelable, URL);
}
}
Event — Um novo objeto Event idêntico ao original.
|
formatToString | () | método |
public function formatToString(className:String, ... arguments):String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. Substituir o método toString() é recomendado, mas não exigido.
class PingEvent extends Event {
var URL:String;
public override function toString():String {
return formatToString("PingEvent", "type", "bubbles", "cancelable", "eventPhase", "URL");
}
}
Parâmetros
className:String — O nome de sua classe Event personalizada. No exemplo anterior, o parâmetro className é PingEvent.
| |
... arguments — As propriedades da classe Event e as propriedades adicionadas à sua classe Event personalizada. No exemplo anterior, o parâmetro ...arguments inclui type, bubbles, cancelable, eventPhase e URL.
|
String — O nome de sua classe Event personalizada e o valor String de seu parâmetro ...arguments.
|
isDefaultPrevented | () | método |
public function isDefaultPrevented():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Verifica se o método preventDefault() foi chamado no evento. Se o método preventDefault() tiver sido chamado, ele retorna true; do contrário, retorna false.
Boolean — Se o preventDefault() foi chamado, ele retorna true; do contrário, retorna false.
|
Elementos da API relacionados
preventDefault | () | método |
public function preventDefault():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado.
Muitos eventos têm comportamentos associados que são realizados por padrão. Por exemplo, se o usuário digita um caractere em um campo de texto, o comportamento padrão é o caractere ser exibido no campo de texto. Como o comportamento padrão do evento TextEvent.TEXT_INPUT pode ser cancelado, você pode usar o método preventDefault() para impedir que o caractere apareça.
Um exemplo de comportamento que não é cancelável é o comportamento padrão associado ao evento Event.REMOVED, que é gerado sempre que o Flash Player está prestes a remover um objeto de exibição da lista de exibição. O comportamento padrão (remover o elemento) não pode ser cancelado, então o método preventDefault() não tem efeito sobre esse comportamento padrão.
Você pode usar a propriedade Event.cancelable para verificar se é possível impedir o comportamento padrão associado a um evento específico. Se o valor de Event.cancelable for true, o preventDefault() poderá ser usado para cancelar o evento; do contrário, o preventDefault() não terá efeito.
Elementos da API relacionados
stopImmediatePropagation | () | método |
public function stopImmediatePropagation():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. Esse método entra em vigor imediatamente e afeta ouvintes de eventos no nó atual. Ao contrário, o método stopPropagation() não entra em vigor até que o ouvintes de eventos no nó atual concluam o processamento.
Observação: Este método não cancela o comportamento associado a esse evento; consulte preventDefault() para saber quanto a essa funcionalidade.
Elementos da API relacionados
stopPropagation | () | método |
public function stopPropagation():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. Esse método não afeta nenhum ouvinte de evento no nó atual (currentTarget). Ao contrário, o método stopImmediatePropagation() impede o processamento de ouvintes de evento tanto no nó atual quanto em nós subsequentes. Chamadas adicionais para esse método não têm efeito. Esse método pode ser chamado em qualquer fase do fluxo de eventos.
Observação: Este método não cancela o comportamento associado a esse evento; consulte preventDefault() para saber quanto a essa funcionalidade.
Elementos da API relacionados
toString | () | método |
public function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna uma string que contém todas as propriedades do objeto Event. A string está no seguinte formato:
[Event type=value bubbles=value cancelable=value]
String — Uma string que contém todas as propriedades do objeto Event.
|
ACTIVATE | Constante |
public static const ACTIVATE:String = "activate"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante ACTIVATE define o valor da propriedade type de um objeto de evento activate.
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.
Dispositivos AIR for TV nunca emitem este evento automaticamente. Você pode, contudo, emiti-lo manualmente.
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 ocorrência do DisplayObject com um ouvinte registrado para o evento activate. |
Elementos da API relacionados
ADDED | Constante |
public static const ADDED:String = "added"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.ADDED define o valor da propriedade type de um objeto de evento added.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 | A ocorrência DisplayObject que está sendo adicionada à lista de exibição. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
ADDED_TO_STAGE | Constante |
public static const ADDED_TO_STAGE:String = "addedToStage"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
A constante Event.ADDED_TO_STAGE define o valor da propriedade type de um objeto de evento addedToStage.
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 | A ocorrência DisplayObject que está sendo adicionada à lista de exibição, diretamente ou por meio da adição de uma subárvore na qual a ocorrência DisplayObject está contida. Se a ocorrência DisplayObject estiver sendo diretamente adicionada, o evento adicionado ocorrerá antes desse evento. |
Elementos da API relacionados
BROWSER_ZOOM_CHANGE | Constante |
public static const BROWSER_ZOOM_CHANGE:String = "browserZoomChange"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 15, AIR 15 |
A constante Event.BROWSER_ZOOM_CHANGE define o valor do tipo de propriedade de um objeto de evento browserZoomChange.
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 | A instância do palco. |
Elementos da API relacionados
CANCEL | Constante |
public static const CANCEL:String = "cancel"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.CANCEL define o valor da propriedade type de um objeto de evento cancel.
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 | Uma referência ao objeto no qual a operação é cancelada. |
Elementos da API relacionados
CHANGE | Constante |
public static const CHANGE:String = "change"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.CHANGE define o valor da propriedade type de um objeto de evento change.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 | O objeto que tem seus respectivos valores modificados. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
CHANNEL_MESSAGE | Constante |
public static const CHANNEL_MESSAGE:String = "channelMessage"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11.4, AIR 3.4 |
A constante Event.CHANNEL_MESSAGE define o valor da propriedade type de um objeto de evento channelMessage.
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 | O objeto que despachou este evento. |
Elementos da API relacionados
CHANNEL_STATE | Constante |
public static const CHANNEL_STATE:String = "channelState"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11.4, AIR 3.4 |
A constante Event.CHANNEL_STATE define o valor da propriedade type de um objeto de evento channelState.
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 | O objeto que despachou este evento. |
Elementos da API relacionados
CLEAR | Constante |
public static const CLEAR:String = "clear"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
A constante Event.CLEAR define o valor da propriedade type de um objeto de evento clear.
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 ocorrência do InteractiveObject com um ouvinte registrado para o evento clear. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
Elementos da API relacionados
CLOSE | Constante |
public static const CLOSE:String = "close"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.CLOSE define o valor da propriedade type de um objeto de evento close.
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 | O objeto cuja conexão foi fechada. |
Elementos da API relacionados
CLOSING | Constante |
public static const CLOSING:String = "closing"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.CLOSING define o valor da propriedade type de um objeto de evento closing.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | true; cancelar esse objeto de evento para a operação de fechamento. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto cuja conexão deve ser fechada. |
Elementos da API relacionados
COMPLETE | Constante |
public static const COMPLETE:String = "complete"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.COMPLETE define o valor da propriedade type de um objeto de evento complete.
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 | O objeto de rede que concluiu o carregamento. |
Elementos da API relacionados
CONNECT | Constante |
public static const CONNECT:String = "connect"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.CONNECT define o valor da propriedade type de um objeto de evento connect.
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 | O soquete ou objeto XMLSocket que estabeleceu uma conexão de rede. |
Elementos da API relacionados
CONTEXT3D_CREATE | Constante |
public static const CONTEXT3D_CREATE:String = "context3DCreate"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3 |
A constante Event.CONTEXT3D_CREATE define o valor da propriedade type do objeto de evento context3Dcreate. Este evento é levantado só por objetos de Stage3D em resposta a um chamada para Stage3D.requestContext3D ou em resposta à redefinição acionada de um OS do Context3D vinculado ao objeto de Stage3D. Inspecione a propriedade Stage3D.context3D para obter o objeto de Context3D recentemente criado.
Elementos da API relacionados
COPY | Constante |
public static const COPY:String = "copy"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Define o valor da propriedade type de um objeto de evento copy.
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 ocorrência do DisplayObject com um ouvinte registrado para o evento copy. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
Elementos da API relacionados
CUT | Constante |
public static const CUT:String = "cut"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Define o valor da propriedade type de um objeto de evento cut.
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 ocorrência do DisplayObject com um ouvinte registrado para o evento cut. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
Elementos da API relacionados
DEACTIVATE | Constante |
public static const DEACTIVATE:String = "deactivate"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.DEACTIVATE define o valor da propriedade type de um objeto de evento deactivate.
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.
Dispositivos AIR for TV nunca emitem este evento automaticamente. Você pode, contudo, emiti-lo manualmente.
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 ocorrência do DisplayObject com um ouvinte registrado para o evento deactivate. |
Elementos da API relacionados
DISPLAYING | Constante |
public static const DISPLAYING:String = "displaying"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.DISPLAYING define o valor da propriedade type de um objeto de evento displaying.
Observação: Este evento não passa por uma "fase de captura" e é despachado diretamente ao destino, quer o destino esteja na exibição ou não.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto que está prestes a ser exibido. |
Elementos da API relacionados
ENTER_FRAME | Constante |
public static const ENTER_FRAME:String = "enterFrame"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.ENTER_FRAME define o valor da propriedade type de um objeto de evento enterFrame.
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.
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 ocorrência do DisplayObject com um ouvinte registrado para o evento enterFrame. |
Elementos da API relacionados
EXIT_FRAME | Constante |
public static const EXIT_FRAME:String = "exitFrame"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.EXIT_FRAME define o valor da propriedade type de um objeto de evento exitFrame.
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.
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 ocorrência do DisplayObject com um ouvinte registrado para o evento enterFrame. |
Elementos da API relacionados
EXITING | Constante |
public static const EXITING:String = "exiting"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.EXITING define o valor da propriedade type de um objeto de evento exiting.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | true; cancelar esse objeto de evento para a operação de saída. |
currentTarget | O objeto NativeApplication. |
target | O objeto NativeApplication. |
Elementos da API relacionados
FRAME_CONSTRUCTED | Constante |
public static const FRAME_CONSTRUCTED:String = "frameConstructed"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.FRAME_CONSTRUCTED define o valor da propriedade type de um objeto de evento frameConstructed.
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.
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 ocorrência do DisplayObject com um ouvinte registrado para o evento frameConstructed. |
Elementos da API relacionados
FRAME_LABEL | Constante |
public static const FRAME_LABEL:String = "frameLabel"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11.3, AIR 3.3 |
A constante Event.FRAME_LABEL define o valor da propriedade type de um objeto de evento frameLabel.
Observação: este evento não possui uma "fase de captura" ou uma "fase de bolha", o que significa que os ouvintes de evento deverão ser adicionados diretamente aos objetos FrameLabel.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto FrameLabel que está processando ativamente o objeto Event com um ouvinte de evento. |
target | Qualquer ocorrência do FrameLabel com um ouvinte registrado para o evento frameLabel. |
Elementos da API relacionados
FULLSCREEN | Constante |
public static const FULLSCREEN:String = "fullScreen"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.FULL_SCREEN define o valor da propriedade type de um objeto de evento fullScreen.
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 | O objeto Palco. |
Elementos da API relacionados
HTML_BOUNDS_CHANGE | Constante |
public static const HTML_BOUNDS_CHANGE:String = "htmlBoundsChange"| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.HTML_BOUNDS_CHANGE define o valor da propriedade type de um objeto de evento htmlBoundsChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto HTMLLoader. |
target | O objeto HTMLLoader. |
Elementos da API relacionados
HTML_DOM_INITIALIZE | Constante |
public static const HTML_DOM_INITIALIZE:String = "htmlDOMInitialize"| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.HTML_DOM_INITIALIZE define o valor da propriedade type de um objeto de evento htmlDOMInitialize.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto HTMLLoader. |
target | O objeto HTMLLoader. |
Elementos da API relacionados
HTML_RENDER | Constante |
public static const HTML_RENDER:String = "htmlRender"| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.HTML_RENDER define o valor da propriedade type de um objeto de evento htmlRender.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto HTMLLoader. |
target | O objeto HTMLLoader. |
Elementos da API relacionados
ID3 | Constante |
public static const ID3:String = "id3"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.ID3 define o valor da propriedade type de um objeto de evento id3.
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 | O objeto Sound que carrega o MP3 para o qual dados ID3 estão agora disponíveis. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
INIT | Constante |
public static const INIT:String = "init"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.INIT define o valor da propriedade type de um objeto de evento init.
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 | O objeto LoaderInfo associado ao arquivo SWF que está sendo carregado. |
Elementos da API relacionados
LOCATION_CHANGE | Constante |
public static const LOCATION_CHANGE:String = "locationChange"| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.LOCATION_CHANGE define o valor da propriedade type de um objeto de evento locationChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto HTMLLoader. |
target | O objeto HTMLLoader. |
Elementos da API relacionados
MOUSE_LEAVE | Constante |
public static const MOUSE_LEAVE:String = "mouseLeave"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.MOUSE_LEAVE define o valor da propriedade type de um objeto de evento mouseLeave.
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 | O objeto Palco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
NETWORK_CHANGE | Constante |
public static const NETWORK_CHANGE:String = "networkChange"| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.NETWORK_CHANGE define o valor da propriedade type de um objeto de evento networkChange.
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 | O objeto NativeApplication. |
Elementos da API relacionados
OPEN | Constante |
public static const OPEN:String = "open"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.OPEN define o valor da propriedade type de um objeto de evento open.
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 | O objeto de rede que abriu uma conexão. |
Elementos da API relacionados
PASTE | Constante |
public static const PASTE:String = "paste"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
A constante Event.PASTE define o valor da propriedade type de um objeto de evento paste.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true (false para runtime do AIR.) |
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 ocorrência do DisplayObject com um ouvinte registrado para o evento paste. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
Elementos da API relacionados
PREPARING | Constante |
public static const PREPARING:String = "preparing"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.6 |
A constante Event.PREPARING define o valor da propriedade type de um objeto de eventopreparing.
Observação: Este evento não passa por uma "fase de captura" e é despachado diretamente ao destino, quer o destino esteja na exibição ou não.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | O objeto que despachou este evento. |
target | O objeto que despachou este evento. |
Elementos da API relacionados
REMOVED | Constante |
public static const REMOVED:String = "removed"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.REMOVED define o valor da propriedade type de um objeto de evento removed.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 | A ocorrência DisplayObject a ser removida da lista de exibição. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
REMOVED_FROM_STAGE | Constante |
public static const REMOVED_FROM_STAGE:String = "removedFromStage"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
A constante Event.REMOVED_FROM_STAGE define o valor da propriedade type de um objeto de evento removedFromStage.
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 | A ocorrência DisplayObject que está sendo removida da lista de exibição no palco, diretamente ou por meio da remoção de uma subárvore na qual a ocorrência DisplayObject está contida. Se a ocorrência DisplayObject estiver sendo diretamente removida, o evento removed ocorrerá antes desse evento. |
Elementos da API relacionados
RENDER | Constante |
public static const RENDER:String = "render"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.RENDER define o valor da propriedade type de um objeto de evento render.
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.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; o comportamento padrão não pode ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | Qualquer ocorrência do DisplayObject com um ouvinte registrado para o evento render. |
Elementos da API relacionados
RESIZE | Constante |
public static const RESIZE:String = "resize"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.RESIZE define o valor da propriedade type de um objeto de evento resize.
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 | O objeto Palco. |
Elementos da API relacionados
SCROLL | Constante |
public static const SCROLL:String = "scroll"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.SCROLL define o valor da propriedade type de um objeto de evento scroll.
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 | O objeto TextField que foi rolado. A propriedade target nem sempre é o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
SELECT | Constante |
public static const SELECT:String = "select"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.SELECT define o valor da propriedade type de um objeto de evento select.
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 | O objeto no qual um item foi selecionado. |
Elementos da API relacionados
SELECT_ALL | Constante |
public static const SELECT_ALL:String = "selectAll"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
A constante Event.SELECT_ALL define o valor da propriedade type de um objeto de evento selectAll.
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 ocorrência do DisplayObject com um ouvinte registrado para o evento selectAll. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
Elementos da API relacionados
SOUND_COMPLETE | Constante |
public static const SOUND_COMPLETE:String = "soundComplete"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.SOUND_COMPLETE define o valor da propriedade type de um objeto de evento soundComplete.
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 | O objeto SoundChannel no qual um som terminou a execução. |
Elementos da API relacionados
STANDARD_ERROR_CLOSE | Constante |
public static const STANDARD_ERROR_CLOSE:String = "standardErrorClose"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Lite 4 |
A constante Event.STANDARD_ERROR_CLOSE define o valor da propriedade type de um objeto de evento standardErrorClose.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
target | O objeto NativeProcess. |
STANDARD_INPUT_CLOSE | Constante |
public static const STANDARD_INPUT_CLOSE:String = "standardInputClose"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Lite 4 |
A constante Event.STANDARD_INPUT_CLOSE define o valor da propriedade type de um objeto de evento standardInputClose.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
target | O objeto NativeProcess. |
STANDARD_OUTPUT_CLOSE | Constante |
public static const STANDARD_OUTPUT_CLOSE:String = "standardOutputClose"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Lite 4 |
A constante Event.STANDARD_OUTPUT_CLOSE define o valor da propriedade type de um objeto de evento standardOutputClose.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
target | O objeto NativeProcess. |
SUSPEND | Constante |
public static const SUSPEND:String = "suspend"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.3 |
A constante Event.SUSPEND define o valor da propriedade type de um objeto de evento suspend. Este evento é enviado apenas no AIR iOS.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto NativeApplication. |
target | O objeto NativeApplication. |
Elementos da API relacionados
TAB_CHILDREN_CHANGE | Constante |
public static const TAB_CHILDREN_CHANGE:String = "tabChildrenChange"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.TAB_CHILDREN_CHANGE define o valor da propriedade type de um objeto de evento tabChildrenChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 | O objeto cujo sinalizador tabChildren foi alterado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
TAB_ENABLED_CHANGE | Constante |
public static const TAB_ENABLED_CHANGE:String = "tabEnabledChange"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.TAB_ENABLED_CHANGE define o valor da propriedade type de um objeto de evento tabEnabledChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 | O InteractiveObject cujo sinalizador tabEnabled foi alterado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
TAB_INDEX_CHANGE | Constante |
public static const TAB_INDEX_CHANGE:String = "tabIndexChange"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.TAB_INDEX_CHANGE define o valor da propriedade type de um objeto de evento tabIndexChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 | O objeto cujo tabIndex foi alterado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
TEXT_INTERACTION_MODE_CHANGE | Constante |
public static const TEXT_INTERACTION_MODE_CHANGE:String = "textInteractionModeChange"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 11, Flash Lite 4 |
A constante Event.TEXT_INTERACTION_MODE_CHANGE define o valor da propriedade type de um objeto de evento interaction mode.
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 | O objeto TextField cuja propriedade de modo de interação é alterada. Por exemplo, no Android é possível alterar o modo de interação para SELECTION usando o menu de contexto. A propriedade target nem sempre é o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
TEXTURE_READY | Constante |
public static const TEXTURE_READY:String = "textureReady"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11.4, AIR 3.4 |
A constante Event.TEXTURE_READY define o valor da propriedade type de um objeto de evento textureReady. Este evento é enviado pelos objetos Texture e CubeTexture para sinalizar a conclusão de um upload assíncrono. Solicite um upload assíncrono usando o método uploadCompressedTextureFromByteArray() em Texture ou CubeTexture. Este evento não gera bolhas e não pode ser cancelado.
Elementos da API relacionados
CubeTexture.uploadCompressedTextureFromByteArray()
UNLOAD | Constante |
public static const UNLOAD:String = "unload"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante Event.UNLOAD define o valor da propriedade type de um objeto de evento unload.
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 | O objeto LoaderInfo associado ao arquivo SWF que está sendo descarregado ou substituído. |
Elementos da API relacionados
USER_IDLE | Constante |
public static const USER_IDLE:String = "userIdle"| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.USER_IDLE define o valor da propriedade type de um objeto de evento userIdle.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
target | O objeto NativeApplication. |
Elementos da API relacionados
USER_PRESENT | Constante |
public static const USER_PRESENT:String = "userPresent"| Versões de runtime: | AIR 1.0, Flash Lite 4 |
A constante Event.USER_PRESENT define o valor da propriedade type de um objeto de evento userPresent.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
target | O objeto NativeApplication. |
Elementos da API relacionados
VIDEO_FRAME | Constante |
public static const VIDEO_FRAME:String = "videoFrame"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11.4, AIR 3.4 |
A constante Event.VIDEO_FRAME define o valor da propriedade type do objeto de evento videoFrame.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
target | O objeto Camera que enviou esse evento. |
Elementos da API relacionados
WORKER_STATE | Constante |
public static const WORKER_STATE:String = "workerState"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11.4, AIR 3.4 |
A constante Event.WORKER_STATE define o valor do tipo de propriedade type de um objeto de evento workerState.
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 | O objeto que despachou este evento. |
Elementos da API relacionados
EventExample e a classe personalizada Square para demonstrar como gerenciar um bubbling de evento.
package {
import flash.display.Sprite;
import flash.events.Event;
import flash.events.MouseEvent;
public class EventExample extends Sprite {
public function EventExample() {
var square_0:Square = new Square(300, 0x336633);
addChild(square_0);
var square_1:Square = new Square(250, 0x669966);
square_0.addChild(square_1);
var square_2:Square = new Square(200, 0x66CC66);
square_1.addChild(square_2);
var square_3:Square = new Square(150, 0xAA0000);
square_3.shouldBubble = false;
square_2.addChild(square_3);
var square_4:Square = new Square(100, 0x66FF66);
square_3.addChild(square_4);
var square_5:Square = new Square(50, 0xCC0000);
square_5.shouldBubble = false;
square_4.addChild(square_5);
this.addEventListener(MouseEvent.CLICK, clickHandler);
}
private function clickHandler(e:Event):void {
trace(">> stage: " + e.type + " event from " + e.target.name + " called on " + this.name);
trace(">> --------------------------------------------");
}
}
}
import flash.display.Sprite;
import flash.events.Event;
import flash.events.MouseEvent;
class Square extends Sprite {
private var sideLen:int;
private var color:Number;
public var shouldBubble:Boolean = true;
public function Square(sideLen:int, color:Number) {
this.sideLen = sideLen;
this.color = color;
init();
draw();
}
private function init():void {
buttonMode = true;
this.addEventListener(MouseEvent.CLICK, firstClickHandler);
this.addEventListener(MouseEvent.CLICK, secondClickHandler);
this.addEventListener(MouseEvent.CLICK, thirdClickHandler);
}
private function draw():void {
this.graphics.beginFill(color);
this.graphics.drawRect(0, 0, sideLen, sideLen);
}
private function firstClickHandler(e:Event):void {
trace(">> 1e: " + e.type + " event from " + e.target.name + " called on " + this.name);
if(!shouldBubble) {
e.stopPropagation();
}
}
private function secondClickHandler(e:Event):void {
trace(">> 2e: " + e.type + " event from " + e.target.name + " called on " + this.name);
if(!shouldBubble) {
e.stopImmediatePropagation();
trace(">> --------------------------------------------");
}
}
private function thirdClickHandler(e:Event):void {
trace(">> 3e: " + e.type + " event from " + e.target.name + " called on " + this.name);
}
}
ADDED e ADDED_TO_STAGE, bem como a diferença entre os eventos REMOVED e REMOVED_FROM_STAGE. Clicar em um sprite o removerá do palco, bem como tudo o que estiver aninhado dentro dele. Por exemplo, clicar no sprite maior fará com que o evento REMOVED, bem como três eventos REMOVED_FROM_STAGE sejam disparados.
package {
import flash.display.Sprite;
import flash.events.*;
public class EventExample2 extends Sprite {
public function EventExample2():void {
var parentSprite:Sprite = createSprite("parentSprite",200);
var childSprite:Sprite = createSprite("childSprite",100);
var childOfChildSprite:Sprite = createSprite("childOfChildSprite",50);
trace(":: Adding to Stage ::");
this.addChild(parentSprite);
trace(":: Adding to Stage ::");
parentSprite.addChild(childSprite);
trace(":: Adding to Stage ::");
childSprite.addChild(childOfChildSprite);
}
private function createSprite(name:String,size:uint):Sprite {
trace(":: Creating Sprite ::");
var newSprite:Sprite = new Sprite();
newSprite.name = name;
newSprite.graphics.beginFill(0xFFFFFF * Math.random(),1);
newSprite.graphics.drawRect(0,0,size,size);
newSprite.graphics.endFill();
newSprite.addEventListener(Event.ADDED, spriteAdded);
newSprite.addEventListener(Event.ADDED_TO_STAGE, spriteAddedToStage);
newSprite.addEventListener(Event.REMOVED, spriteRemoved);
newSprite.addEventListener(Event.REMOVED_FROM_STAGE, spriteRemovedFromStage);
newSprite.addEventListener(MouseEvent.CLICK, remove);
return newSprite;
}
private function remove(event:Event) {
if(event.target == event.currentTarget) {
trace(":: Removing Clicked Sprite ::");
var target:Sprite = Sprite(event.target);
target.parent.removeChild(target);
}
}
private function spriteRemovedFromStage(event:Event):void {
trace("REMOVED_FROM_STAGE: " + event.target.name + " : " + event.currentTarget.name);
}
private function spriteRemoved(event:Event):void {
trace("REMOVED: " + event.target.name + " from " + event.currentTarget.name);
}
private function spriteAddedToStage(event:Event):void {
trace("ADDED_TO_STAGE: " + event.target.name + " : " + event.currentTarget.name);
}
private function spriteAdded(event:Event):void {
trace("ADDED: " + event.target.name + " within " + event.currentTarget.name);
}
}
}
Wed Jun 13 2018, 11:10 AM Z