This page was saved using jaction on 2006-09-04 8:33:49.
Address: http://flexdocs.kr/docs/flex2/langref/flash/events/KeyboardEvent.html
Title: flash.events.KeyboardEvent (Flex™ 2 레퍼런스 가이드)  •  Size: 66895
Packageflash.events
Classpublic class KeyboardEvent
InheritanceKeyboardEvent Inheritance Event Inheritance Object

Flash® Player 는, 키보드로부터의 유저 입력에 대해서 KeyboardEvent object를 dispatch합니다. 다음의 2 종류의 키보드 이벤트가 있습니다. KeyboardEvent.KEY_DOWNKeyboardEvent.KEY_UP

키와 특정의 캐릭터의 매핑은 디바이스나 operating system 마다 다르기 (위해)때문에, 입력된 캐릭터의 처리에는 TextEvent event 타입을 사용해 주세요.

키 이벤트를 글로벌하게 리스닝 하려면 , capther 단계, 타겟 단계 또는 바브 링 단계에 도착해 Stage 로 리스닝 합니다.

View the examples

See also

KEY_DOWN
KEY_UP
KeyLocation
키보드 이벤트에 대해
키보드 이벤트의 처리
keyCode property와 charCode property에 대해
KeyboardEvent 의 우선도에 대해


Public property
 property정의
  altKey : Boolean
장래의 사용을 위해서(때문에) 예약되고 있습니다.
KeyboardEvent
 Inheritedbubbles : Boolean
이벤트가 바브 링 이벤트인 가 어떤가를 나타냅니다.
Event
 Inheritedcancelable : Boolean
이벤트에 관련지을 수 있었던 행동을 회피할 수 있을지 어떨지를 나타냅니다.
Event
  charCode : uint
누른 키 또는 떼어 놓은 키의 문자 코드치를 포함합니다.
KeyboardEvent
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  ctrlKey : Boolean
Ctrl 키가 액티브 (true)가 되어 있을까 비액티브 (false)가 되어 있는지를 나타냅니다.
KeyboardEvent
 InheritedcurrentTarget : Object
event listener로 Event object를 액티브하게 처리하고 있는 object입니다.
Event
 InheritedeventPhase : uint
event 플로우(flow)의 현재의 단계입니다.
Event
  keyCode : uint
누른 키 또는 떼어 놓은 키의 키코드치입니다.
KeyboardEvent
  keyLocation : uint
키보드의 키의 장소를 나타냅니다.
KeyboardEvent
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  shiftKey : Boolean
Shift 키모디파이아가 액티브 (true)가 되어 있을까 비액티브 (false)가 되어 있는지를 나타냅니다.
KeyboardEvent
 Inheritedtarget : Object
event 타겟입니다.
Event
 Inheritedtype : String
이벤트의 형태입니다.
Event
Public Methods
 Methods정의
  KeyboardEvent (type:String , bubbles:Boolean = true, cancelable:Boolean = false, charCode:uint = 0, keyCode:uint = 0, keyLocation:uint = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)
키보드 이벤트에 관한 특정의 정보를 포함한 Event object를 작성합니다.
KeyboardEvent
  clone ():Event
KeyboardEvent object의 복사를 작성해, 각 property의 값을 원의 property의 값과 일치하도록(듯이) 설정합니다.
KeyboardEvent
 InheritedformatToString (className:String , ... arguments):String
custom Event 클래스에 toString() Methods를 Implements하기 위한 유틸리티 함수입니다.
Event
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisDefaultPrevented ():Boolean
이벤트로 preventDefault() 가 불려 갔는지 어떠했는지를 체크합니다.
Event
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedpreventDefault ():void
이벤트의 디폴트 행동을 캔슬할 수 있는 경우에, 그 행동을 캔슬합니다.
Event
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedstopImmediatePropagation ():void
event 플로우(flow)의 현재의 노드 및 후속 하는 노드로, event listener가 처리되지 않게 합니다.
Event
 InheritedstopPropagation ():void
event 플로우(flow)의 현재의 노드에 후속 하는 노드로, event listener가 처리되지 않게 합니다.
Event
  toString ():String
KeyboardEvent object의 모든 property를 포함한 string를 돌려줍니다.
KeyboardEvent
  updateAfterEvent ():void
표시 리스트가 변경되고 있는 경우는, 이 event 종료 처리의 뒤에 렌더링 하도록(듯이) Flash Player 에 지시합니다.
KeyboardEvent
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
Public 정수
 정수정의
 InheritedACTIVATE : String = "activate"
[static] activate event object의 type property의 값을 정의합니다.
Event
 InheritedADDED : String = "added"
[static] added event object의 type property의 값을 정의합니다.
Event
 InheritedCANCEL : String = "cancel"
[static] cancelevent object의 type property의 값을 정의합니다.
Event
 InheritedCHANGE : String = "change"
[static] change event object의 type property의 값을 정의합니다.
Event
 InheritedCLOSE : String = "close"
[static] close event object의 type property의 값을 정의합니다.
Event
 InheritedCOMPLETE : String = "complete"
[static] complete event object의 type property의 값을 정의합니다.
Event
 InheritedCONNECT : String = "connect"
[static] connect event object의 type property의 값을 정의합니다.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] deactivate event object의 type property의 값을 정의합니다.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] enterFrame event object의 type property의 값을 정의합니다.
Event
 InheritedID3 : String = "id3"
[static] id3 event object의 type property의 값을 정의합니다.
Event
 InheritedINIT : String = "init"
[static] init event object의 type property의 값을 정의합니다.
Event
  KEY_DOWN : String = "keyDown"
[static] keyDown event object의 type property의 값을 정의합니다.
KeyboardEvent
  KEY_UP : String = "keyUp"
[static] keyUp event object의 type property의 값을 정의합니다.
KeyboardEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] mouseLeave event object의 type property의 값을 정의합니다.
Event
 InheritedOPEN : String = "open"
[static] open event object의 type property의 값을 정의합니다.
Event
 InheritedREMOVED : String = "removed"
[static] removed event object의 type property의 값을 정의합니다.
Event
 InheritedRENDER : String = "render"
[static] render event object의 type property의 값을 정의합니다.
Event
 InheritedRESIZE : String = "resize"
[static] resize event object의 type property의 값을 정의합니다.
Event
 InheritedSCROLL : String = "scroll"
[static] scroll event object의 type property의 값을 정의합니다.
Event
 InheritedSELECT : String = "select"
[static] select event object의 type property의 값을 정의합니다.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] soundComplete event object의 type property의 값을 정의합니다.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] tabChildrenChange event object의 type property의 값을 정의합니다.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] tabEnabledChange event object의 type property의 값을 정의합니다.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] tabIndexChange event object의 type property의 값을 정의합니다.
Event
 InheritedUNLOAD : String = "unload"
[static] unload event object의 type property의 값을 정의합니다.
Event
property의 상세
altKeyproperty
altKey:Boolean   [read-write]

장래의 사용을 위해서(때문에) 예약되고 있습니다. 이 property는 현재 지원(support)되고 있지 않습니다.

Implements
    public function get altKey():Boolean
    public function set altKey(value:Boolean ):void
charCodeproperty 
charCode:uint   [read-write]

누른 키 또는 떼어 놓은 키의 문자 코드치를 포함합니다. 문자 코드치는 영어 키보드의 값입니다. 예를 들어, Shift + 3 이 밀리면,charCode 는 일본어의 키보드에서도 영어의 키보드와 같이 # 를 돌려줍니다.

메모 :입력 Methods 에디터 (IME)가 실행하고 있을 때는,charCode 에서는 정확한 문자 코드가 보고되지 않습니다.

Implements
    public function get charCode():uint
    public function set charCode(value:uint ):void

See also

ctrlKeyproperty 
ctrlKey:Boolean   [read-write]

Ctrl 키가 액티브 (true)가 되어 있을까 비액티브 (false)가 되어 있는지를 나타냅니다.

메모 :Macintosh 시스템의 Command 키모디파이아는, 이 키모디파이아를 사용해 나타낼 필요가 있습니다.

Implements
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean ):void
keyCodeproperty 
keyCode:uint   [read-write]

누른 키 또는 떼어 놓은 키의 키코드치입니다.

메모 :입력 Methods 에디터 (IME)가 실행하고 있을 때는,keyCode 에서는 정확한 키코드가 보고되지 않습니다.

Implements
    public function get keyCode():uint
    public function set keyCode(value:uint ):void

See also

keyLocationproperty 
keyLocation:uint   [read-write]

키보드의 키의 장소를 나타냅니다. 이것은, 키보드에 다수 있는 키를 구별할 경우에 도움이 됩니다. 예를 들어, 왼쪽의 Shift 키와 오른쪽의 Shift 키를 이 property의 값으로 구별할 수가 있습니다. 왼쪽은 KeyLocation.LEFT, 오른쪽은 KeyLocation.RIGHT 입니다. 또, 표준 키보드의 숫자 키 (KeyLocation.STANDARD)와 숫자 패드의 숫자 키 (KeyLocation.NUM_PAD)의 어느 쪽이 밀렸는지를 구별할 수도 있습니다.

Implements
    public function get keyLocation():uint
    public function set keyLocation(value:uint ):void
shiftKeyproperty 
shiftKey:Boolean   [read-write]

Shift 키모디파이아가 액티브 (true)가 되어 있을까 비액티브 (false)가 되어 있는지를 나타냅니다.

Implements
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean ):void
constructor    의 상세
KeyboardEvent()constructor   
public 함수 KeyboardEvent(type:String , bubbles:Boolean = true, cancelable:Boolean = false, charCode:uint = 0, keyCode:uint = 0, keyLocation:uint = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)

키보드 이벤트에 관한 특정의 정보를 포함한 Event object를 작성합니다. event listener에게는 Event object가 Parameters로서 건네받습니다.

Parameters
type:String — 이벤트의 타입입니다. 유효한 값은 다음과 같습니다. KeyboardEvent.KEY_DOWNKeyboardEvent.KEY_UP
 
bubbles:Boolean (default = true) — Event object가 event 플로우(flow)의 바브 링 단계에서 처리될지 어떨지를 판단합니다.
 
cancelable:Boolean (default = false) — Event object가 캔슬 가능한가 어떤가를 판단합니다.
 
charCode:uint (default = 0) — 누른 키 또는 떼어 놓은 키의 문자 코드치입니다. 문자 코드의 반환값은 영어 키보드의 값입니다. 예를 들어, Shift + 3 이 밀리면,getASCIICode() Methods는 일본어의 키보드에서도 영어의 키보드와 같이 # 를 돌려줍니다.
 
keyCode:uint (default = 0) — 누른 키 또는 떼어 놓은 키의 키코드치입니다.
 
keyLocation:uint (default = 0) — 키보드의 키의 장소입니다.
 
ctrlKey:Boolean (default = false) — Ctrl 키모디파이아가 액티브하게 되어 있는지 어떤지를 나타냅니다.
 
altKey:Boolean (default = false) — 장래의 사용을 위해서(때문에) 예약되고 있습니다 (현재 지원(support)되고 있지 않습니다).
 
shiftKey:Boolean (default = false) — Shift 키모디파이아가 액티브하게 되어 있는지 어떤지를 나타냅니다.

See also

Methods의 상세
clone()Methods
public override function clone():Event

KeyboardEvent object의 복사를 작성해, 각 property의 값을 원의 property의 값과 일치하도록(듯이) 설정합니다.

반환값
Event — 원의 object와 같은 property치를 포함한 새로운 KeyboardEvent object입니다.
toString()Methods 
public override function toString():String

KeyboardEvent object의 모든 property를 포함한 string를 돌려줍니다. string는 다음의 형식입니다.

[KeyboardEvent type=value bubbles=value cancelable=value ... shiftKey=value]

반환값
String — KeyboardEvent object의 모든 property를 포함한 string입니다.
updateAfterEvent()Methods 
public function updateAfterEvent():void

표시 리스트가 변경되고 있는 경우는, 이 event 종료 처리의 뒤에 렌더링 하도록(듯이) Flash Player 에 지시합니다.

정수의 상세
KEY_DOWN정수
public static const KEY_DOWN:String = "keyDown"

keyDown event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

PropertyValue
bubblestrue
cancelablefalse 는, 캔슬하는 디폴트의 동작이 없는 것을 나타냅니다.
charCode누른 키 또는 떼어 놓은 키의 문자 코드치입니다.
ctrlKeyCtrl 키가 액티브하게 되어 있는 경우는 true, 비액티브하게 되어 있는 경우는 false 입니다.
currentTargetevent listener로 Event object를 액티브하게 처리하고 있는 object입니다.
keyCode누른 키 또는 떼어 놓은 키의 키코드치입니다.
keyLocation키보드의 키의 장소입니다.
shiftKeyShift 키가 액티브하게 되어 있는 경우는 true, 비액티브하게 되어 있는 경우는 false 입니다.
target포커스를 가지고 있는 InteractiveObject 인스턴스입니다. target 는, 반드시 event listener를 등록한 표시 리스트내의 object라고는 할 수 없습니다. 현재 이벤트를 처리하고 있는 표시 리스트내의 object에 액세스 하려면 ,currentTarget property를 사용합니다.

See also

KEY_UP정수 
public static const KEY_UP:String = "keyUp"

keyUp event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

PropertyValue
bubblestrue
cancelablefalse 는, 캔슬하는 디폴트의 동작이 없는 것을 나타냅니다.
charCode누른 키 또는 떼어 놓은 키의 문자 코드치를 포함합니다.
ctrlKeyCtrl 키가 액티브하게 되어 있는 경우는 true, 비액티브하게 되어 있는 경우는 false 입니다.
currentTargetevent listener로 Event object를 액티브하게 처리하고 있는 object입니다.
keyCode누른 키 또는 떼어 놓은 키의 키코드치입니다.
keyLocation키보드의 키의 장소입니다.
shiftKeyShift 키가 액티브하게 되어 있는 경우는 true, 비액티브하게 되어 있는 경우는 false 입니다.
target포커스를 가지고 있는 InteractiveObject 인스턴스입니다. target 는, 반드시 event listener를 등록한 표시 리스트내의 object라고는 할 수 없습니다. 현재 이벤트를 처리하고 있는 표시 리스트내의 object에 액세스 하려면 ,currentTarget property를 사용합니다.

See also

Examples

다음의 예에서는,KeyboardEventExample 클래스를 사용해, 키보드 이벤트와 그 listener 함수를 표시하는 방법을 나타냅니다. 이 예에서는, 다음의 처리를 실행합니다.
  1. 사각형의 배경색과 크기의 설정에 다음에 사용하는 property를 선언합니다.
  2. child 라는 이름의 새로운 Sprite 인스턴스를 작성합니다.
  3. Sprite 의 Methods를 사용해,addChild() Methods를 호출해, 밝은 청색의 사각형을 묘화 해 스테이지상의 디폴트의 좌표 위치 (0,0)에 표시합니다.
  4. 다음의 2 개의 키보드 타입의 event listener를 추가합니다.
    • keyDown/keyDownHandler: 임의의 키를 눌렀을 때에 dispatch됩니다. 이 subscribers메솟드는,trace() 명령문(statement)를 사용해, 이벤트에 관한 정보를 출력합니다.
    • keyUp/keyUpHandler: 키를 떼어 놓으면 dispatch됩니다.

일부의 인스턴스에서는, 스테이지를 클릭하지 않으면 키보드 이벤트가 실행되지 않는 경우가 있습니다.

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

    public class KeyBoardEventExample extends Sprite {
        private var bgColor:uint = 0x00CCFF;
        private var size:uint = 80;

        public function KeyBoardEventExample() {
            var child:Sprite = new Sprite();
            child.graphics.beginFill(bgColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            addChild(child);
            stage.focus = child;
            child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler);
            child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler);
        }

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






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/flash/events/KeyboardEvent.html