ActionScript/Eventos

Os modos antigos de se adicionar eventos aos objetos, como on(Release), foram abandonados. O ActionScript 3 usa Event Listeners (ouvintes de eventos). São gerenciadores de eventos, que podem ser de vários tipos, desde uso de mouse e teclado até carregamento de dados externos (para criação dos famosos preloaders) e uso do objeto Timer.

A biblioteca usada nos eventos deste artigo são:

• flash.events.Event - eventos em geral;
• flash.events.KeyboardEvent - eventos de teclado;
• flash.events.MouseEvent - eventos de mouse;
• flash.events.TimerEvent - eventos de Timer;

Adicionando eventos

Eventos de mouse

Para adicionar um evento clique do botão do mouse ao Sprite desenho, basta fazer isto:

var desenho:Sprite = new Sprite();

desenho.addEventListener(MouseEvent.CLICK, girarDesenho);

function girarDesenho(evt:MouseEvent):void {
    desenho.rotation += 20;
}

Foi criado o objeto desenho, e através de addEventListener foi adicionado o evento de mouse MouseEvent.CLICK com a funçãogirarDesenhocomo administradora de ações referentes a cliques. Em outras palavras, quando se clicar em desenho serão acrescentados mais 20 graus de rotação. Esta função também poderia ser transcrita desta maneira:

var desenho1:Sprite = new Sprite();
var desenho2:Sprite = new Sprite();

desenho1.addEventListener(MouseEvent.CLICK, girarDesenho);
desenho2.addEventListener(MouseEvent.CLICK, girarDesenho);

function girarDesenho(evt:MouseEvent):void {
    evt.target.rotation += 20;
}

Neste caso, a função girarDesenho irá trabalhar para desenho1 e desenho2. Eles sofrerão rotações específicas se um deles for clicado, ou alvo do evento (representado porevt.target). Quando desenho1 for clicado, ele girará 20 graus, mas desenho2 não, pois não é o alvo (target) do clique. Repare que evt não é uma palavra reservada (pode ser qualquer nome de variável válida), mas deve ser discriminada nos parâmetros por ser um listener.

A função listener sempre retorna valor vazio (void).

Além de MouseEvent.CLICK, você também pode usarMouseEvent.MOUSE_DOWN (instante em que o botão é pressionado) e MouseEvent.MOUSE_UP(momento em que o botão deixa de ser pressionado). Há também MouseEvent.MOUSE_OVER (cursor sobre objeto), MouseEvent.MOUSE_OUT (objeto perde foco do mouse) eMouseEvent.MOUSE_WHEEL (a roda de rolagem do mouse), entre outros.

Eventos de teclado

Para reconhecer eventos de teclado, é necessário utilizar o objeto da classeKeyboardEvent. Você pode usarKeyboardEvent.KEY_DOWN (instante em que a tecla é pressionada) como KeyboardEvent.KEY_UP (tecla solta).

A função de evento tem que ter como parâmetro evt:KeyboardEvent.

// Independentemente de outros, o palco receberá o foco sobre as ações do teclado
stage.addEventListener(KeyboardEvent.KEY_DOWN, teclaPressionada);

function teclaPressionada(evt:KeyboardEvent):void 
{
    if (evt.keyCode > 0)
    {
        trace('Tecla: ', String.fromCharCode(evt.charCode), '. Em código: ', evt.charCode);
    }
}

Caso a tecla a (minúscula) seja pressionada, será exibido "Tecla: a. Em código: 97". O 97 é valor de a minúsculo na tabela w:ASCII.

Eventos de tempo (Timer)

Para utilizar tempo, é preciso criar um objeto Timer com dois parâmetros: 1 O intervalo que o Timer irá cobrir (em milissegundos) e 2) Quantas vezes será repetido (se posto 0, será infinito).

Podemos criar dois eventos, um para o evento do Timer (TimerEvent.TIMER) contando tempo e um para quando o trabalho dele se completar (TimerEvent.TIMER_COMPLETE).

O parâmetro da função deve ser um evt:Event. O objeto de Timer deve ser acionado com o método start() (tempo.start()). Para parar o relógio, acione o método tempo.stop().

// Criando o objeto...
var tempo:Timer = new Timer(1000, 3);

tempo.addEventListener(TimerEvent.TIMER, movendo);
tempo.addEventListener(TimerEvent.TIMER_COMPLETE, acabou);

// Necessário para o evento começar
tempo.start();

// A cada segundo esta função será executada...
function movendo(evt:Event):void 
{
    mc.x += 10;
}

// Quando o terceiro segundo chegar, irá realizar esta tarefa...
function acabou(evt:Event):void
{
    trace("Trabalho finalizado");
}

Eventos de frame

Utilizando o Event.ENTER_FRAME, você pode adicionar um evento que será realizada a cada passagem de um novo frame. A frequência da ação será repetida de acordo com o FPS (frames por segundo) do documento.

O parâmetro da função deve ser um evt:Event.

// mc é um MovieClip qualquer...
mc.addEventListener(Event.ENTER_FRAME, movendo);

public function movendo(evt:Event):void 
{
    evt.target.x += 10;    
}

O alvo da ação, mc, será movido mais 10 a cada entrada de frame.

Removendo eventos

A remoção de eventos se dá pela função removeEventListener(). Remover um listener pode ser necessário quando não queremos que um objeto tenha um evento, ou então quando isso não é necessário mais o coletor de lixo os remove, a fim de melhorar o gerenciamento da mesma.

var sp:Sprite = new Sprite();

sp.addEventListener(MouseEvent.CLICK, girarDesenho);

function girarDesenho(evt:MouseEvent):void {
    evt.target.rotation += 20;
    evt.target.removeEventListener(MouseEvent.CLICK, girarDesenho);
}

Da próxima vez que sp for clicado, ele não irá mais girar 20 graus, pois a linhaevt.target.removeEventListener(MouseEvent.CLICK, girarDesenho) fez com que ele perdesse a possibilidade de receber eventos referentes ao clique do mouse.

Usando listeners fracos, fase de captura e determinando a prioridade

• Para processar um evento antes que chegue ao seu alvo é necessário determinar o parâmetrouseCapture para true (o padrão é falso), terceiro do método addEventListener().
• Supondo que um objeto recebe mais de um evento MouseEvent.CLICK, você pode determinar qual será executado primeiro com o penúltimo parâmetro priority. Se não determinado, nenhuma ordem será considerada. O prioritário deve receber o valor 1, o segundo 2 e assim por diante.
• Para usar referências fracas nos eventos e assim facilitar a remoção de eventos não mais utilizados basta colocar true no último parâmetro, o useWeakReference. O padrão é false, uma conexão de listener forte. Isso deixa o Flash ajudar um pouco o desenvolvedor, em caso de projetos complexos. A ideia é que, caso o listener e a sua referência não sejam mais utilizados, ele não atrapalha o trabalho do coletor de lixo do Flash, procurando trabalhar melhor com o gerenciamento de memória.

Esses parâmetros adicionais não precisam ser configurados quando evocamos umremoveEventListener();

var sp:Sprite = new Sprite();

// Quando sp for clicado, ele executará primeiro exibeMsg (prioridade 1)
sp.addEventListener(MouseEvent.CLICK, exibeMsg, true, 1, true);
sp.addEventListener(MouseEvent.CLICK, exibeOutraMsg, false, 2, true);

function exibeMsg(evt:MouseEvent):void {
    trace("Clicado primeiro");
}

function exibeOutraMsg(evt:MouseEvent):void {
    trace("Clicado segundo");
    sp.removeEventListener(MouseEvent.CLICK, exibeMsg);
}

Estes parâmetros são poucos usados, apenas em casos muito específicos.

Criando seus próprios eventos

Basta chamar o nome da função de listener e o seu respectivo tipo de evento. No caso do exemplo abaixo, logo que o programa for executado ele irá exibir "OK", porque a última linha dispara artificialmente um clique.

stage.addEventListener(MouseEvent.CLICK, noClique);

function noClique(evt:Event):void {
    trace("OK");
}

// Dispara um clique mesmo sem o palco ter sido clicado
noClique(new MouseEvent(MouseEvent.CLICK));

Disparando eventos

Toda vez que o palco (stage) for clicado, ele irá disparar, através da linhadispatchEvent(), um evento "meu novo evento". Esse evento foi adicionado ao palco, com o função listener dispara.

stage.addEventListener(MouseEvent.CLICK, novoEvento);

function novoEvento(evt:Event):void {
    dispatchEvent(new Event("meu novo evento"));
}

stage.addEventListener("meu novo evento", dispara,false,0,true);
function dispara(evt:Event):void {
    trace("Seu evento personalizado!");
}

Todo clique no palco irá exibir "Seu evento personalizado!".

Diferenças: target e currentTarget

A diferença entre currentTarget etarget é que o primeiro lida com o abrangente e o segundo é mais específico.

var mc:MovieClip = new MovieClip();
mc.name = "Container mc";

var sp1:Sprite = new Sprite();
var sp2:Sprite = new Sprite();

sp1.name = "Azul";
sp2.name = "Verde";
sp1.graphics.beginFill(0x0000FF,1);
sp1.graphics.drawRect(10,10,100,100);
sp1.graphics.endFill();

sp2.graphics.beginFill(0x00FF00,1);
sp2.graphics.drawRect(10,120,100,100);
sp2.graphics.endFill();

mc.addEventListener(MouseEvent.CLICK, exibeInfo);

mc.addChild(sp1);
mc.addChild(sp2);

addChild(mc);

function exibeInfo(evento:MouseEvent):void {
    evento.target.startDrag();
    trace(evento.target.name);
}

Se clicar em um dos quadrados, ele irá exibir seu nome e arrastará o quadrado que for clicado. Isso se dá porque target procura dentro de mc o alvo da ação. Agora alteraremos a função exibeInfo:

function exibeInfo(evento:MouseEvent):void {
    evento.currentTarget.startDrag();
    trace(evento.currentTarget.name);
}

O método currentTarget especifica o alvo relativo ao contâiner de objetos. Se clicado, ele irá permitir o arrastamento do mc (os dois quadrados juntos) e exibe o nome dele (no caso, "Container mc").