MouseEvent  - AS3

Indica se a tecla Alt está ativa (true) ou inativa (false). Suporte apenas para Windows. Em outros sistemas operacionais, essa propriedade é sempre definida como false.

Indica se o botão do mouse principal está pressionado (true) ou não (false).

Indica se o evento mouse down é parte ou não de uma sequência de vários cliques. Esse parâmetro será zero para todos os eventos mouse diferentes de MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightMouseDown e MouseEvent.rightMouseUp. Ouvir cliques simples, duplos ou qualquer sequência de vários cliques é possível com o parâmetro clickCount. Por exemplo, um MouseEvent.mouseDown e MouseEvent.mouseUp iniciais terá um clickCount igual a 1 e o segundo MouseEvent.mouseDown e MouseEvent.mouseUp em uma sequência de clique duplo terão um clickCount igual a 2. Se o mouse se mover o suficiente ou se a sequência de vários cliques for interrompida por algum motivo, então o próximo MouseEvent.mouseDown terá uma clickCount igual a 1. O evento doubleClick continuará a ser disparado conforme esperado.

Indica se a tecla Command está ativada (só no Mac).

O valor da propriedade commandKey terá o mesmo valor que a propriedade ctrlKey no Mac. Sempre false no Windows ou no Linux.

Indica se a tecla Control está ativada no Mac e se a tecla Ctrl está ativada no Windows ou no Linux.

No Windows ou no Linux, indica se a tecla Ctrl está ativa (true) ou inativa (false). No Macintosh, indica se a tecla Control ou se a tecla Command está ativada.

Indica quantas linhas devem ser roladas para cada unidade em que o usuário gira a roda do mouse. Um valor delta positivo indica uma rolagem para cima; um valor negativo indica uma rolagem para baixo. Os valores comuns são 1 a 3, mas a rotação mais rápida pode produzir valores maiores. Esta configuração depende do dispositivo e do sistema operacional, e geralmente é configurável pelo usuário. Esta propriedade se aplica apenas ao evento MouseEvent.mouseWheel.

Se for true, a propriedade relatedObject será definida como null pelos motivos relacionados às caixas de proteção de segurança. Se o valor nominal de relatedObject for uma referência a um DisplayObject de outra caixa de proteção, a propriedade relatedObject será definida como null, a menos que haja permissão em ambas as direções do limite dessa caixa de proteção. A permissão é estabelecida chamando Security.allowDomain() de um arquivo SWF ou fornecendo um arquivo de diretivas do servidor de um arquivo de imagem e definindo a propriedade LoaderContext.checkPolicyFile quando carregar a imagem.

Elementos da API relacionados

Quando o travamento de mouse está desativado, a coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém. Desative o travamento do mouse configurando Stage.mouseLock como false.

Quando o travamento do mouse é ativado, localX e localY são 0. Use movementX e movementY para determinar as alterações da posição do mouse quando o travamento de mouse está ativado.

Elementos da API relacionados

Quando o travamento de mouse está desativado, a coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém. Desative o travamento do mouse configurando Stage.mouseLock como false.

Quando o travamento do mouse é ativado, localX e localY são 0. Use movementX e movementY para determinar as alterações da posição do mouse quando o travamento de mouse está ativado.

Elementos da API relacionados

Quando o travamento de mouse é ativado, a alteração na posição do mouse na direção X desde o último evento de mouse. Ative o travamento do mouse configurando Stage.mouseLock como true.

Quando o travamento de mouse é ativado:

• localX e localY contêm 0.
• movementX e movementY contêm valores delta.
• movementX e movementY nunca se transformam baseados na transformação de palco. Isso significa que eles sempre permanecem em coordenadas da tela.

movementX e movementY são 0 quando Stage.mouseLock é false.

Elementos da API relacionados

Quando o travamento de mouse é ativado, a alteração na posição do mouse na direção Y desde o último evento de mouse. Ative o travamento do mouse configurando Stage.mouseLock como true.

Quando o travamento de mouse é ativado:

• localX e localY contêm 0.
• movementX e movementY contêm valores delta.
• movementX e movementY nunca se transformam baseados na transformação de palco. Isso significa que eles sempre permanecem em coordenadas da tela.

movementX e movementY são 0 quando Stage.mouseLock é false.

Elementos da API relacionados

Uma referência a um objeto de lista de exibição relacionado ao evento. Por exemplo, quando ocorre um evento mouseOut, o relatedObject representa o objeto da lista de exibição para o qual o dispositivo apontador agora aponta. Essa propriedade se aplica aos eventos mouseOut, mouseOver, rollOut e rollOver.

O valor dessa propriedade pode ser null em duas situações: se não houver nenhum objeto relacionado, ou se houver um objeto relacionado, mas que esteja em uma área de segurança à qual você não tem acesso. Use a propriedade isRelatedObjectInaccessible() para determinar qual desses motivos se aplica.

Elementos da API relacionados

Indica se a tecla Shift está ativa (true) ou inativa (false).

A coordenada horizontal na qual o evento ocorreu em coordenadas globais de Palco. Esta propriedade é calculada quando a propriedade localX está definida.

A coordenada vertical na qual o evento ocorreu em coordenadas globais de Palco. Esta propriedade é calculada quando a propriedade localY está definida.

Cria um objeto Event que contém informações sobre eventos de mouse. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.

Cria uma cópia do objeto MouseEvent e define o valor de cada propriedade para corresponder ao do original.

Retorna uma string que contém todas as propriedades do objeto MouseEvent. A string está no seguinte formato:

[MouseEvent type=value bubbles=value cancelable=value ... delta=value]

Instrui o Flash Player ou Adobe AIR a aplicar acabamento após o término do processamento desse evento, se a lista de exibição tiver sido modificada.

Define o valor da propriedade type de um objeto de evento click.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

A constante MouseEvent.CONTEXT_MENU define o valor da propriedade type de um objeto de evento contextMenu.

Esse evento tem as seguintes propriedades:

Define o valor da propriedade type de um objeto de evento doubleClick. A propriedade doubleClickEnabled deve ser true para um objeto gerar o evento doubleClick.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento middleClick.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento middleMouseDown.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento middleMouseUp.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento mouseDown.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento de evento mouseMove.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

package {
    import flash.display.Sprite;
    import flash.display.Graphics;
    import flash.events.MouseEvent;

    public class MouseEvent_MOUSE_MOVEExample extends Sprite {
        private var innerRect:Sprite = new Sprite();
        
        public function MouseEvent_MOUSE_MOVEExample() {

            graphics.lineStyle(3, 0xFF0000, 1);
            stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
            stage.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);

            innerRect.graphics.lineStyle(1, 0x00FF00, 1);
            innerRect.graphics.beginFill(0xFFFFFF);
            innerRect.graphics.drawRect(10, 10, 200, 200);
            innerRect.graphics.endFill();
            innerRect.addEventListener(MouseEvent.MOUSE_DOWN, innerRectMouseDownHandler);
            innerRect.addEventListener(MouseEvent.MOUSE_UP, innerRectMouseUpHandler);
            addChild(innerRect);
        }

        private function mouseDownHandler(event:MouseEvent):void {
            graphics.moveTo(event.stageX, event.stageY);
            stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }
    
        private function mouseMoveHandler(event:MouseEvent):void {
            graphics.lineTo(event.stageX, event.stageY);
        }    
    
        private function mouseUpHandler(event:MouseEvent):void {
            stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }

        private function innerRectMouseDownHandler(event:MouseEvent):void {
            innerRect.graphics.moveTo(event.localX, event.localY);
            innerRect.addEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler);
        }
    
        private function innerRectMouseMoveHandler(event:MouseEvent):void {
            innerRect.graphics.lineTo(event.localX, event.localY);
        }    
    
        private function innerRectMouseUpHandler(event:MouseEvent):void {
            innerRect.removeEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler);
        }
    }
}

Define o valor da propriedade type de um objeto de evento mouseOut.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento mouseOver.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento select.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento mouseWheel.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento releaseOutside.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento rightClick.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento rightMouseDown.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento rightMouseUp.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento rollOut.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Define o valor da propriedade type de um objeto de evento rollOver.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

1. O exemplo declara propriedades para o tamanho (100 x 100 pixels) e a cor de plano de fundo (laranja) para uso posterior, ao desenhar o quadrado.
2. O construtor cria um novo childde objeto ChildSprite. Seu construtor primeiro desenha um quadrado laranja de 100 x 100 pixels em coordenadas (0,0) chamando o método draw() respectivo e, em seguida, adiciona ouvintes/assinantes de eventos.
   • click/clickHandler(): Despachado quando o usuário clica uma vez com o botão esquerdo do mouse sobre o quadrado.
   • doubleClick/doubleClickHandler(): Despachado quando o usuário clica duas vezes com o botão esquerdo do mouse sobre o quadrado.
   • mouseDown/mouseDownHandler(): Quando o objeto ChildSprite (o quadrado laranja) receber o clique, uma mensagem trace() será impressa na tela; em seguida, o ChildSprite.draw() é chamado, o que desenha um quadrado amarelo escuro no lugar do quadrado azul claro desenhado no mouseOverHandler(). O método mouseDownHandler() também adiciona um ouvinte de evento mouseMovee o assinante mouseMoveHandler() (descrito abaixo), que processa os movimentos do mouse. Em seguida, o método startDrag() é chamado, o que permite que o objeto Sprite seja arrastado.
   • mouseOut/mouseOutHandler(): Despachado sempre que o ponteiro deixar a área do quadrado. O método draw() é chamado para retornar o quadrado ao tamanho e à cor normais.
   • mouseOver/mouseOverHandler(): Despachado quando o ponteiro do mouse está sobre o quadrado. Este método redesenha o quadrado para que fique maior e sua cor de plano de fundo seja amarelo escuro.
   • mouseUp/mouseUpHandler(): Quando o usuário solta o botão do mouse, o ouvinte de evento mouseMove é removido e o stopDrag é chamado, o que congela o quadrado no local.
   • mouseMove/mouseMoveHandler(): Chamado como parte da função mouseDownHandler() e despachado quando o usuário está pressionando o botão esquerdo do mouse e arrastando o quadrado.
   • mouseWheel/mouseWheelHandler(): Despachado quando o usuário gira a roda do mouse sobre o quadrado.
3. A ocorrência ChildSprite child é então adicionada à lista de exibição por meio do addChild(), que prontamente desenha o quadrado laranja.

Observações:

• A classe MouseEventExample deverá ser o documento raiz.
• Alguns dos métodos de eventos listados acima declaram uma variável local sprite, que recebe a atribuição da projeção de .target para tipo Sprite.

package {
    import flash.display.Sprite;

    public class MouseEventExample extends Sprite {
        private var size:uint = 100;
        private var bgColor:uint = 0xFFCC00;

        public function MouseEventExample() {
            var child:ChildSprite = new ChildSprite();
            addChild(child);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class ChildSprite extends Sprite {
    private var size:uint = 50;
    private var overSize:uint = 60;
    private var backgroundColor:uint = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;

    public function ChildSprite() {
        draw(size, size, backgroundColor);
            doubleClickEnabled = true;
        addEventListener(MouseEvent.CLICK, clickHandler);
        addEventListener(MouseEvent.DOUBLE_CLICK, doubleClickHandler);
        addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
        addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
        addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
        addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
        addEventListener(MouseEvent.MOUSE_WHEEL, mouseWheelHandler);
    }

    private function draw(w:uint, h:uint, bgColor:uint):void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    private function clickHandler(event:MouseEvent):void {
        trace("clickHandler");
    }

    private function doubleClickHandler(event:MouseEvent):void {
        trace("doubleClickHandler");
    }

    private function mouseDownHandler(event:MouseEvent):void {
        trace("mouseDownHandler");
        draw(overSize, overSize, downColor);

        var sprite:Sprite = Sprite(event.target);
        sprite.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        sprite.startDrag();
    }

    private function mouseMoveHandler(event:MouseEvent):void {
        trace("mouseMoveHandler");
        event.updateAfterEvent();
    }

    private function mouseOutHandler(event:MouseEvent):void {
        trace("mouseOutHandler");
        draw(size, size, backgroundColor);
    }

    private function mouseOverHandler(event:MouseEvent):void {
        trace("mouseOverHandler");
        draw(overSize, overSize, overColor);
    }

    private function mouseWheelHandler(event:MouseEvent):void {
        trace("mouseWheelHandler delta: " + event.delta);
    }

    private function mouseUpHandler(event:MouseEvent):void {
        trace("mouseUpHandler");
        var sprite:Sprite = Sprite(event.target);
        sprite.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        sprite.stopDrag();
        draw(overSize, overSize, overColor);
    }
}