Indica se il tasto Alt è attivo (true) o inattivo (false). Supportato solo per il sistema operativo Windows.

Indica se il pulsante principale del mouse è premuto (true) o no (false).

Indica se il tasto Ctrl è attivo (true) o inattivo (false). Sui computer Macintosh è necessario utilizzare questa proprietà per rappresentare il tasto Comando.

Indica il numero di righe da scorrere per ogni unità di rotazione della rotella del mouse. Un valore delta positivo indica uno scorrimento verso l'alto; un valore negativo indica uno scorrimento verso il basso. I valori tipici sono compresi tra 1 e 3, ma una rotazione più veloce può generare valori più grandi. Questa impostazione dipende dal dispositivo e dal sistema operativo e generalmente può essere configurata dall'utente. Questa proprietà si applica solo all'evento MouseEvent.mouseWheel.

La coordinata orizzontale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene.

La coordinata verticale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene.

Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. Ad esempio, quando si verifica un evento mouseOut, relatedObject rappresenta l'oggetto dell'elenco di visualizzazione a cui punta ora il dispositivo di puntamento. Questa proprietà si applica solo agli eventi mouseOut e mouseOver.

Indica se il tasto Maiusc è attivo (true) o inattivo (false).

La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. Questa proprietà viene calcolata quando viene impostata la proprietà localX.

La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. Questa proprietà viene calcolata quando viene impostata la proprietà localY.

Crea un oggetto Event contenente informazioni relative agli eventi associati al mouse. Gli oggetti evento vengono passati ai listener di eventi come parametri.

Crea una copia dell'oggetto MouseEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.

Restituisce una stringa che contiene tutte le proprietà dell'oggetto MouseEvent. La stringa ha il seguente formato:

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

Indica a Flash Player di eseguire il rendering al termine dell'elaborazione dell'evento se l'elenco di visualizzazione è stato modificato.

Definisce il valore della proprietà type di un oggetto evento click.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento doubleClick.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento mouseDown.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento mouseMove.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento mouseOut.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento mouseOver.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento mouseUp.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento mouseWheel.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento rollOut.

Questo evento ha le seguenti proprietà:

Vedere anche

Definisce il valore della proprietà type di un oggetto evento rollOver.

Questo evento ha le seguenti proprietà:

Vedere anche

1. Nell'esempio vengono dichiarate le proprietà per le dimensioni (100 x 100 pixel) e il colore di sfondo (arancione) da utilizzare successivamente durante il disegno del quadrato.
2. La funzione di costruzione crea un nuovo oggetto ChildSprite child. La relativa funzione di costruzione disegna innanzitutto un quadrato arancione di 100 x 100 pixel in corrispondenza delle coordinate (0,0) chiamando il relativo metodo draw() e aggiungendo quindi sette listener/subscriber di eventi.
   • click / clickHandler(): inviato quando si fa clic con il pulsante sinistro del mouse sul quadrato.
   • doubleClick / doubleClickHandler(): inviato quando si fa doppio clic con il pulsante sinistro del mouse sul quadrato.
   • mouseDown / mouseDownHandler(): quando si fa clic sull'oggetto ChildSprite (il quadrato arancione), viene visualizzato un messaggio trace() sullo schermo, quindi viene chiamato ChildSprite.draw(), che disegna un quadrato giallo scuro al posto di quello blu chiaro disegnato in mouseOverHandler(). Il metodo mouseDownHandler() aggiunge inoltre un listener di eventi mouseMove e il subscriber di mouseMoveHandler() (descritto di seguito), che elabora i movimenti del mouse. Viene quindi chiamato il metodo startDrag(), che consente di trascinare l'oggetto Sprite.
   • mouseOut / mouseOutHandler(): inviato ogni volta che il puntatore esce dall'area del quadrato. Il metodo draw() viene chiamato per ripristinare le dimensioni e il colore normali del quadrato.
   • mouseOver / mouseOverHandler(): inviato quando il puntatore del mouse si trova sopra il quadrato. Questo metodo ridisegna il quadrato, che diventa più grande e con il colore di sfondo giallo scuro.
   • mouseUp / mouseUpHandler(): quando l'utente rilascia il pulsante del mouse, il listener di eventi mouseMove viene rimosso e viene chiamato stopDrag, che blocca il quadrato in posizione.
   • mouseMove / mouseMoveHandler(): fintanto che l'utente tiene premuto il pulsante sinistro del mouse, questo metodo indica a Flash Player di ridisegnare continuamente il quadrato arancione.
   • mouseWheel / mouseWheelHandler(): inviato quando viene azionata la rotella del mouse sopra il quadrato.
3. L'istanza ChildSprite child viene quindi aggiunta all'elenco di visualizzazione tramite addChild(), che disegna immediatamente il quadrato arancione.

Note:

• La classe MouseEventExample deve essere al livello principale del documento.
• Alcuni dei metodi di eventi sopra elencati dichiarano una variabile sprite locale, a cui viene assegnato l'inserimento di event.target nel 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);
        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);
    }
}