MouseEvent  - AS3

Określa, czy klawisz Alt jest aktywny (true), czy nieaktywny (false). Obsługiwana tylko w systemie Windows. W innych systemach operacyjnych ta właściwość jest zawsze ustawiona na wartość false.

Określa, czy główny przycisk myszy jest naciśnięty (true), czy nie (false).

Określa, czy dane naciśnięcie przycisku myszy należy do sekwencji wielu kliknięć. Ten parametr ma wartość zero dla wszystkich zdarzeń innych niż MouseEvent.mouseDown, MouseEvent.mouseUp, MouseEvent.middleMouseDown, MouseEvent.middleMouseUp, MouseEvent.rightMouseDown i MouseEvent.rightMouseUp. Wykrywanie jednokrotnych kliknięć, dwukrotnych kliknięć lub dowolnych sekwencji wielu kliknięć umożliwia parametr clickCount. Na przykład w pierwszych zdarzeniach MouseEvent.mouseDown i MouseEvent.mouseUp właściwość clickCount będzie równa 1, a w drugiej parze zdarzeń MouseEvent.mouseDown i MouseEvent.mouseUp, należącej do sekwencji dwukrotnego kliknięcia, właściwość clickCount będzie równa 2. Jeśli mysz zostanie przemieszczona na odpowiednio dużą odległość lub z jakiegoś powodu sekwencja wielu kliknięć zostanie przerwana, następne zdarzenie MouseEvent.mouseDown będzie miało właściwość clickCount równą 1. Zdarzenia doubleClick zostanie mimo to wygenerowane zgodnie z oczekiwaniami.

Określa, czy klawisz Command jest aktywny (tylko w systemach Mac).

W systemach Mac właściwość commandKey będzie miała tę samą wartość, co właściwość ctrlKey. Zawsze false w systemach Windows lub Linux.

Określa, czy klawisz Control jest aktywny w systemie Mac lub czy klawisz Ctrl jest aktywny w systemie Windows lub Linux.

W systemach Windows lub Linux określa, czy klawisz Ctrl jest aktywny (true), czy nieaktywny (false). W systemie Macintosh określa, czy aktywny jest klawisz Control albo Command.

Określa liczbę wierszy przewijanych w odpowiedzi na elementarny ruch pokrętłem myszy. Dodatnia wartość delta oznacza przewijanie w górę; wartość ujemna oznacza przewijanie w dół. Typowe wartości należą do przedziału od 1 do 3, ale przy szybkim obracaniu wartości mogą być większe. To ustawienie zależy od urządzenia i systemu operacyjnego. Zwykle użytkownik może je konfigurować. Ta właściwość ma zastosowanie tylko do zdarzenia MouseEvent.mouseWheel.

Jeśli wartość to true, właściwość relatedObject zostanie ustawiona na wartość null z przyczyn związanych z bezpiecznymi obszarami izolowanymi. Jeśli nominalną wartością właściwości relatedObject jest odwołanie do obiektu DisplayObject w innym obszarze izolowanym, właściwość relatedObject zostanie ustawiona na wartość null, chyba że ustanowiono uprawnienia w obu kierunkach przez granice obszaru izolowanego. Uprawnienie ustanawiane jest przez wywołanie metody Security.allowDomain() z pliku SWF lub przez dostarczenie pliku reguł z serwera pliku obrazu i ustawianie właściwości LoaderContext.checkPolicyFile podczas ładowania obrazu.

Powiązane elementy interfejsu API

Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), gdy jest wyłączone blokowanie myszy. Ustawienie właściwości Stage.mouseLock na wartość false pozwala wyłączyć blokowanie myszy.

Gdy jest włączone blokowanie myszy, właściwości localX i localY mają wartości 0. Właściwości movementX i movementY pozwalają określić zmiany pozycji myszy, gdy jest włączone blokowanie myszy.

Powiązane elementy interfejsu API

Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), gdy jest wyłączone blokowanie myszy. Ustawienie właściwości Stage.mouseLock na wartość false pozwala wyłączyć blokowanie myszy.

Gdy jest włączone blokowanie myszy, właściwości localX i localY mają wartości 0. Właściwości movementX i movementY pozwalają określić zmiany pozycji myszy, gdy jest włączone blokowanie myszy.

Powiązane elementy interfejsu API

Zmiana pozycji myszy w kierunku X od ostatniego zdarzenia myszy, gdy jest włączone blokowanie myszy. Ustawienie właściwości Stage.mouseLock na wartość true pozwala właczyć blokowanie myszy.

Gdy jest włączone blokowanie myszy:

• Właściwości localX i localY mają wartość 0.
• Właściwości movementX i movementY zawierają wartości różnic.
• Właściwości movementX i movementY są przekształcane zgodnie ze zmianami na stole montażowym. Oznacza to, że zawsze pozostają w obrębie układu współrzędnych.

Właściwości movementX i movementY mają wartość 0, gdy właściwość Stage.mouseLock ma wartość false.

Powiązane elementy interfejsu API

Zmiana pozycji myszy w kierunku Y od ostatniego zdarzenia myszy, gdy jest włączone blokowanie myszy. Ustawienie właściwości Stage.mouseLock na wartość true pozwala właczyć blokowanie myszy.

Gdy jest włączone blokowanie myszy:

• Właściwości localX i localY mają wartość 0.
• Właściwości movementX i movementY zawierają wartości różnic.
• Właściwości movementX i movementY są przekształcane zgodnie ze zmianami na stole montażowym. Oznacza to, że zawsze pozostają w obrębie układu współrzędnych.

Właściwości movementX i movementY mają wartość 0, gdy właściwość Stage.mouseLock ma wartość false.

Powiązane elementy interfejsu API

Odwołanie do listy powiązanej ze zdarzeniem. Na przykład gdy zajdzie zdarzenie mouseOut, właściwość relatedObject reprezentuje obiekt listy wyświetlania wskazywany teraz przez urządzenie wskazujące. Ta właściwość dotyczy zdarzeń mouseOut, mouseOver, rollOut i rollOver.

Wartością tej właściwości może być null w dwóch przypadkach: jeśli nie istnieje powiązany obiekt lub istnieje powiązany obiekt, ale obiekt ten znajduje się w bezpiecznym obszarze izolowanym, do którego programista nie ma dostępu. Aby wskazać, który z tych powodów znajduje zastosowanie, należy użyć właściwości isRelatedObjectInaccessible().

Powiązane elementy interfejsu API

Określa, czy klawisz Shift jest aktywny (true), czy nieaktywny (false).

Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). Ta właściwość jest obliczana po ustawieniu wartości właściwości localX.

Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). Ta właściwość jest obliczana po ustawieniu wartości właściwości localY.

Tworzy obiekt Event, który zawiera informacje o zdarzeniach związanych z myszą. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.

Tworzy kopię obiektu MouseEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.

Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu MouseEvent. Format ciągu znaków jest następujący:

[MouseEvent type=wartość bubbles=wartość cancelable=wartość ... delta=wartość]

Powoduje, że po zakończeniu przetwarzania tego zdarzenia program Flash Player lub środowisko wykonawcze Adobe AIR renderuje obraz, jeśli lista wyświetlania została zmodyfikowana.

Definiuje wartość właściwości type obiektu zdarzenia click.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Stała MouseEvent.CONTEXT_MENU definiuje wartość właściwości type obiektu zdarzenia contextMenu.

To zdarzenie ma następujące właściwości:

Definiuje wartość właściwości type obiektu zdarzenia doubleClick. Aby obiekt generował zdarzenie doubleClick, właściwość doubleClickEnabled musi być ustawiona na true.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia middleClick.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia middleMouseDown.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia middleMouseUp.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia a mouseDown.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia mouseMove.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

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);
        }
    }
}

Definiuje wartość właściwości type obiektu zdarzenia mouseOut.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia mouseOver.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia mouseUp.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia mouseWheel.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia releaseOutside.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia rightClick.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia rightMouseDown.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia rightMouseUp.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia rollOut.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type obiektu zdarzenia rollOver.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

1. Przykładowy kod deklaruje właściwości rozmiary (100 x 100 pikseli) i koloru tła (pomarańczowy), które zostaną później wykorzystane do rysowania kwadratu.
2. Konstruktor tworzy nowy obiekt ChildSprite o nazwie child. Jego konstruktor rysuje pomarańczowy kwadrat o rozmiarze 100 x 100 pikseli we współrzędnych (0,0), wywołując metodę draw() obiektu, a następnie dodaje siedem detektorów/subskrybentów zdarzeń.
   • click/clickHandler(): wywoływane, gdy użytkownik jednokrotnie kliknie lewym przyciskiem myszy nad kwadratem.
   • doubleClick/doubleClickHandler(): wywoływane, gdy użytkownik kliknie dwukrotnie lewym przyciskiem myszy nad kwadratem.
   • mouseDown/mouseDownHandler(): po kliknięciu obiektu ChildSprite (pomarańczowego kwadratu) na ekranie drukowany jest komunikat trace(), a następnie wywoływana jest metoda ChildSprite.draw(), która rysuje ciemnożółty prostokąt w miejsce jasnoniebieskiego narysowanego w metodzie mouseOverHandler(). Metoda mouseDownHandler() dodaje także detektor zdarzeń mouseMoveoraz metodę będącą subskrybentem o nazwie mouseMoveHandler() (opisaną poniżej), która przetwarza ruchy myszy. Następnie wywoływana jest metoda startDrag(), która umożliwia przeciąganie obiektu Sprite.
   • mouseOut/mouseOutHandler(): wywoływane, gdy wskaźnik wychodzi poza obszar kwadratu. Wywoływana jest metoda draw() w celu przywrócenia normalnego rozmiaru i koloru kwadratu.
   • mouseOver/mouseOverHandler(): wywoływane, gdy wskaźnik znajduje się nad kwadratem. Ta metoda rysuje nowy kwadrat — większy i z ciemnożółtym tłem.
   • mouseUp/mouseUpHandler(): gdy użytkownik zwolni przycisk myszy, detektor zdarzeń mouseMove jest usuwany i wywoływana jest metoda stopDrag, która unieruchamia kwadrat.
   • mouseMove/mouseMoveHandler(): wywoływane w ramach funkcji mouseDownHandler(), gdy użytkownik naciska lewy przycisk myszy i przeciąga kwadrat.
   • mouseWheel/mouseWheelHandler(): wywoływane, gdy użytkownik obraca pokrętło myszy nad kwadratem.
3. Następnie do listy wyświetlania dodawana jest instancja klasy ChildSprite o nazwie child. W tym celu wywoływana jest metoda addChild(), co powoduje niezwłoczne narysowanie pomarańczowego kwadratu.

Uwagi:

• Klasa MouseEventExample powinna być klasą główną dokumentu.
• Niektóre wymienione powyżej metody obsługi zdarzeń deklarują zmienną lokalną sprite, której przypisywany jest obiekt event.target rzutowany na typ 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);
    }
}