KeyboardEvent  - AS3

W systemach Windows określa, czy klawisz Alt jest aktywny (true), czy nieaktywny (false); w systemach Mac OS określa, czy jest aktywny klawisz Option.

Zawiera kod znaku przypisanego do klawisza, który wciśnięto lub zwolniono. Zwracane są zawsze kody znaków dla klawiatury angielskiej. Na przykład naciśnięcie klawiszy Shift+3 powoduje ustawienie wartości charCode równej # na klawiaturze japońskiej, a klawiszy Shift+2 — wartości charCode. równej @ na klawiaturze niemieckiej (zamiast "), podobnie jak na klawiaturze angielskiej.

Uwaga: Gdy działa edytor IME (Input Method Editor), kody znaków przekazywane przez właściwość charCode są nieprawidłowe.

Określa, czy klawisz Command jest aktywny (true), czy nieaktywny (false). Obsługiwana tylko w systemach Mac OS. W systemach Mac OS właściwość commandKey ma tę samą wartość, co właściwość ctrlKey.

Określa, czy klawisz Control jest aktywny (true), czy nie (false). W systemach Windows i Linux warunek ten jest spełniony także wtedy, gdy aktywny jest klawisz Ctrl.

W systemach Windows i Linux określa, czy klawisz Ctrl jest aktywny (true), czy nieaktywny (false); w systemach Mac OS określa, czy jest aktywny klawisz Ctrl albo Command.

Kod znaku przypisanego do klawisza, który wciśnięto lub zwolniono.

Uwaga: Gdy działa edytor IME (Input Method Editor), kody klawiszy przekazywane przez właściwość keyCode są nieprawidłowe.

Powiązane elementy interfejsu API

Określa położenie klawisza na klawiaturze. Jest to przydatne do rozróżniania klawiszy, które są powielone na klawiaturze. Na podstawie wartości tej właściwości można na przykład rozróżnić lewy i prawy klawisz Shift: KeyLocation.LEFT oznacza lewy, a KeyLocation.RIGHT oznacza prawy. Inny przykład to odróżnienie klawiszy cyfr na standardowej klawiaturze (KeyLocation.STANDARD) od klawiszy na klawiaturze numerycznej (KeyLocation.NUM_PAD).

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

Tworzy obiekt Event, który zawiera określone informacje o zdarzeniach dotyczących klawiatury. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.

Powiązane elementy interfejsu API

Tworzy kopię obiektu KeyboardEvent 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 KeyboardEvent. Format ciągu znaków jest następujący:

[KeyboardEvent type=wartość bubbles=wartość cancelable=wartość ... shiftKey=wartość]

Określa, że po zakończeniu przetwarzania tego zdarzenia obraz powinien być renderowany, jeśli lista wyświetlania została zmodyfikowana.

Stała ScreenMouseEvent.KEY_DOWN definiuje wartość właściwości type obiektu zdarzenia keyDown.

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

Powiązane elementy interfejsu API

Stała ScreenMouseEvent.KEY_UP definiuje wartość właściwości type obiektu zdarzenia keyUp.

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

Powiązane elementy interfejsu API

1. Tworzy nową instancję klasy Sprite o nazwie child.
2. Deklaruje właściwości, które będą później używane do ustawienia koloru tła i rozmiaru kwadratu.
3. Korzystając z metod obiektu Sprite, rysuje jasnoniebieski kwadrat wyświetlany na stole montażowym w domyślnych współrzędnych (0,0). W tym celu wywoływana jest metoda addChild().
4. Dodaje jeden detektor zdarzeń związanych z muszą i dwa detektory zdarzeń związanych z klawiaturą:
   • click/clickHandler wywoływane, gdy użytkownik kliknie kwadrat w celu przeniesienia fokusu na ikonkę child, tak aby wykrywała ona zdarzenia związane z klawiaturą.
   • keyDown/keyDownHandler wywoływane każdorazowo po naciśnięciu dowolnego klawisza. Metoda będąca subskrybentem drukuje informacje o zdarzeniu za pomocą instrukcji trace().
   • keyUp/keyUpHandler wywoływane każdorazowo po zwolnieniu klawisza.

Podczas testowania przykładowego programu należy najpierw kliknąć kwadrat, aby zdarzenia generowane z klawiatury były wykrywane.

Ponadto, w przypadku użycia polecenia Testuj film w programie Flash, na niektóre klawisze może reagować interfejs projektowania, a nie detektory dołączone do ikonki o nazwie child.

package {
    import flash.display.Sprite;
    import flash.display.DisplayObject;
    import flash.events.*;

    public class KeyboardEventExample extends Sprite {
        private var child:Sprite = new Sprite();
        private var bgColor:uint = 0x00CCFF;
        private var size:uint = 80;

        public function KeyboardEventExample() {
            child.graphics.beginFill(bgColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            addChild(child);
            child.addEventListener(MouseEvent.CLICK, clickHandler);
            child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler);
            child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler);
            
        }

        private function clickHandler(event:MouseEvent):void {
            stage.focus = child;
        }

        private function keyDownHandler(event:KeyboardEvent):void {
            trace("keyDownHandler: " + event.keyCode);
            trace("ctrlKey: " + event.ctrlKey);
            trace("keyLocation: " + event.keyLocation);
            trace("shiftKey: " + event.shiftKey);
            trace("altKey: " + event.altKey);

        }

        private function keyUpHandler(event:KeyboardEvent):void {
            trace("keyUpHandler: " + event.keyCode);
        }
        
        
    }
}