| 패키지 | flash.events |
| 클래스 | public class KeyboardEvent |
| 상속 | KeyboardEvent Event Object |
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
KeyboardEvent.KEY_DOWN 유형과 KeyboardEvent.KEY_UP 유형이 있습니다.
키와 특정 문자 간의 매핑은 장치 및 운영 체제에 따라 다르므로 문자 입력 처리에는 TextEvent 이벤트 유형을 사용해야 합니다.
키 이벤트를 전역적으로 수신하려면 스테이지에서 캡처 단계 및 대상 또는 버블링 단계를 수신합니다.
참고 사항
| 속성 | 다음에 의해 정의됨 | ||
|---|---|---|---|
| altKey : Boolean
Alt 키가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.
| KeyboardEvent | ||
![]() | bubbles : Boolean
[read-only]
이벤트가 버블링 이벤트인지 여부를 나타냅니다.
| Event | |
![]() | cancelable : Boolean
[read-only]
해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다.
| Event | |
| charCode : uint
누르거나 놓은 키의 문자 코드 값이 포함되어 있습니다.
| KeyboardEvent | ||
![]() | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
| Object | |
| ctrlKey : Boolean
Control 키가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.
| KeyboardEvent | ||
![]() | currentTarget : Object
[read-only]
현재 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
| Event | |
![]() | eventPhase : uint
[read-only]
이벤트 흐름에서 현재 단계입니다.
| Event | |
| keyCode : uint
누르거나 놓은 키의 키 코드 값입니다.
| KeyboardEvent | ||
| keyLocation : uint
키보드에서 키의 위치를 나타냅니다.
| KeyboardEvent | ||
![]() | prototype : Object
[static]
클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
| Object | |
| shiftKey : Boolean
Shift 키 수정자가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.
| KeyboardEvent | ||
![]() | target : Object
[read-only]
이벤트 대상입니다.
| Event | |
![]() | type : String
[read-only]
이벤트 유형입니다.
| Event | |
| 메서드 | 다음에 의해 정의됨 | ||
|---|---|---|---|
|
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 객체를 만듭니다.
| KeyboardEvent | ||
|
KeyboardEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다.
| KeyboardEvent | ||
![]() |
사용자 정의 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다.
| Event | |
![]() |
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
| Object | |
![]() |
이벤트에서 preventDefault()가 호출되었는지 여부를 확인합니다.
| Event | |
![]() |
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
| Object | |
![]() |
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다.
| Event | |
![]() |
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
| Object | |
![]() |
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
| Object | |
![]() |
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
| Event | |
![]() |
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
| Event | |
|
KeyboardEvent 객체의 속성이 모두 포함된 문자열을 반환합니다.
| KeyboardEvent | ||
|
표시 목록이 수정된 경우, 이 이벤트의 처리가 완료된 후 렌더링하도록 Flash Player에 지시합니다.
| KeyboardEvent | ||
![]() |
지정된 객체의 프리미티브 값을 반환합니다.
| Object | |
| 상수 | 다음에 의해 정의됨 | ||
|---|---|---|---|
![]() | ACTIVATE : String = "activate" [static]
activate 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | ADDED : String = "added" [static]
added 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | ADDED_TO_STAGE : String = "addedToStage" [static]
addedToStage 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | CANCEL : String = "cancel" [static]
cancel 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | CHANGE : String = "change" [static]
change 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | CLOSE : String = "close" [static]
close 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | COMPLETE : String = "complete" [static]
complete 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | CONNECT : String = "connect" [static]
connect 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | DEACTIVATE : String = "deactivate" [static]
deactivate 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | ENTER_FRAME : String = "enterFrame" [static]
enterFrame 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | FULLSCREEN : String = "fullScreen" [static]
fullScreen 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | ID3 : String = "id3" [static]
id3 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | INIT : String = "init" [static]
init 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
| KEY_DOWN : String = "keyDown" [static]
keyDown 이벤트 객체의 type 속성 값을 정의합니다.
| KeyboardEvent | ||
| KEY_UP : String = "keyUp" [static]
keyUp 이벤트 객체의 type 속성 값을 정의합니다.
| KeyboardEvent | ||
![]() | MOUSE_LEAVE : String = "mouseLeave" [static]
mouseLeave 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | OPEN : String = "open" [static]
open 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | REMOVED : String = "removed" [static]
removed 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | REMOVED_FROM_STAGE : String = "removedFromStage" [static]
removedFromStage 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | RENDER : String = "render" [static]
render 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | RESIZE : String = "resize" [static]
resize 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | SCROLL : String = "scroll" [static]
scroll 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | SELECT : String = "select" [static]
select 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | SOUND_COMPLETE : String = "soundComplete" [static]
soundComplete 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [static]
tabChildrenChange 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | TAB_ENABLED_CHANGE : String = "tabEnabledChange" [static]
tabEnabledChange 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | TAB_INDEX_CHANGE : String = "tabIndexChange" [static]
tabIndexChange 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
![]() | UNLOAD : String = "unload" [static]
unload 이벤트 객체의 type 속성 값을 정의합니다.
| Event | |
| altKey | 속성 |
altKey:Boolean [read-write]
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
Alt 키가 활성(true)인지 비활성(false)인지를 나타냅니다. Windows 운영 체제만 지원합니다.
public function get altKey():Boolean
public function set altKey(value:Boolean):void
| charCode | 속성 |
charCode:uint [read-write]
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
누르거나 놓은 키의 문자 코드 값이 포함되어 있습니다. 문자 코드 값은 영어 키보드 값입니다. 예를 들어, Shift+3을 누르면 charCode는 영어 키보드와 마찬가지로 일본어 키보드에서도 #입니다.
참고: IME(Input Method Editor)가 실행 중인 경우 charCode가 정확한 문자 코드를 보고하지 않습니다.
public function get charCode():uint
public function set charCode(value:uint):void
참고 사항
| ctrlKey | 속성 |
ctrlKey:Boolean [read-write]
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
Control 키가 활성(true)인지 비활성(false)인지를 나타냅니다.
참고: Macintosh 시스템의 Command 키 수정자는 이 키 수정자를 사용하여 표시되어야 합니다.
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void
| keyCode | 속성 |
keyCode:uint [read-write]
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
누르거나 놓은 키의 키 코드 값입니다.
참고: IME(Input Method Editor)가 실행 중인 경우 keyCode가 정확한 키 코드를 보고하지 않습니다.
public function get keyCode():uint
public function set keyCode(value:uint):void
참고 사항
| keyLocation | 속성 |
keyLocation:uint [read-write]
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
키보드에서 키의 위치를 나타냅니다. 이는 키보드에 두 번 이상 표시되는 키를 구분할 때 유용합니다. 예를 들어, 왼쪽 키에 KeyLocation.LEFT 속성 값, 오른쪽 키에 KeyLocation.RIGHT 속성 값을 사용하여 왼쪽 Shift 키와 오른쪽 Shift 키를 구분할 수 있습니다. 다른 예로, 표준 키보드에서 누른 숫자 키(KeyLocation.STANDARD)와 숫자 키 패드에서 누른 숫자 키(KeyLocation.NUM_PAD)를 구분할 수도 있습니다.
public function get keyLocation():uint
public function set keyLocation(value:uint):void
| shiftKey | 속성 |
shiftKey:Boolean [read-write]
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
Shift 키 수정자가 활성(true)인지 비활성(false)인지를 나타냅니다.
public function get shiftKey():Boolean
public function set shiftKey(value:Boolean):void
| KeyboardEvent | () | 생성자 |
public function 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)
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
키보드 이벤트에 대한 특정 정보가 포함된 Event 객체를 만듭니다. Event 객체는 매개 변수로 이벤트 리스너에 전달됩니다.
매개 변수type:String — 이벤트 유형입니다. 사용할 수 있는 값은 KeyboardEvent.KEY_DOWN 및 KeyboardEvent.KEY_UP입니다.
|
|
bubbles:Boolean (default = true) — Event 객체가 이벤트 흐름의 버블링 단계에 참여하는지 여부를 결정합니다.
|
|
cancelable:Boolean (default = false) — Event 객체를 취소할 수 있는지 여부를 결정합니다.
|
|
charCode:uint (default = 0) — 누르거나 놓은 키의 문자 코드 값입니다. 반환된 문자 코드 값은 영어 키보드 값입니다. 예를 들어, Shift+3을 누르면 getASCIICode() 메서드는 영어 키보드와 마찬가지로 일본어 키보드에서도 #을 반환합니다.
|
|
keyCode:uint (default = 0) — 누르거나 놓은 키의 키 코드 값입니다.
|
|
keyLocation:uint (default = 0) — 키보드에서 키의 위치입니다.
|
|
ctrlKey:Boolean (default = false) — Control 키 수정자가 활성화되었는지 여부를 나타냅니다.
|
|
altKey:Boolean (default = false) — Alt 키 수정자의 활성화 여부를 나타냅니다(Windows용).
|
|
shiftKey:Boolean (default = false) — Shift 키 수정자가 활성화되었는지 여부를 나타냅니다.
|
참고 사항
| clone | () | 메서드 |
public override function clone():Event
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
KeyboardEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다.
반환값Event — 원본과 동일한 속성 값을 갖는 새 KeyboardEvent 객체입니다.
|
| toString | () | 메서드 |
public override function toString():String
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
KeyboardEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. 문자열의 형식은 다음과 같습니다.
[KeyboardEvent type= value bubbles= value cancelable= value ... shiftKey= value ]
String — KeyboardEvent 객체의 속성이 모두 포함된 문자열입니다.
|
| updateAfterEvent | () | 메서드 |
public function updateAfterEvent():void
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
표시 목록이 수정된 경우, 이 이벤트의 처리가 완료된 후 렌더링하도록 Flash Player에 지시합니다.
| KEY_DOWN | 상수 |
public static const KEY_DOWN:String = "keyDown"
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
keyDown 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | true |
cancelable | false; 취소할 기본 비헤이비어가 없습니다. |
charCode | 누르거나 놓은 키의 문자 코드 값입니다. |
ctrlKey | true이면 Control 키가 활성 상태이고, false이면 비활성 상태입니다. |
currentTarget | 현재 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
keyCode | 누르거나 놓은 키의 키 코드 값입니다. |
keyLocation | 키보드에서 키의 위치입니다. |
shiftKey | true이면 Shift 키가 활성 상태이고, false이면 비활성 상태입니다. |
target | 포커스가 있는 InteractiveObject 인스턴스입니다. target은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
참고 사항
| KEY_UP | 상수 |
public static const KEY_UP:String = "keyUp"
| 언어 버전 : | ActionScript 3.0 |
| Player 버전 : | Flash Player 9 |
keyUp 이벤트 객체의 type 속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles | true |
cancelable | false; 취소할 기본 비헤이비어가 없습니다. |
charCode | 누르거나 놓은 키의 문자 코드 값이 포함되어 있습니다. |
ctrlKey | true이면 Control 키가 활성 상태이고, false이면 비활성 상태입니다. |
currentTarget | 현재 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
keyCode | 누르거나 놓은 키의 키 코드 값입니다. |
keyLocation | 키보드에서 키의 위치입니다. |
shiftKey | true이면 Shift 키가 활성 상태이고, false이면 비활성 상태입니다. |
target | 포커스가 있는 InteractiveObject 인스턴스입니다. target은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
참고 사항
KeyboardEventExample 클래스를 사용하여 키보드 이벤트와 해당하는 리스너 함수를 보여 줍니다. 이는 다음 단계로 이루어집니다.
child라는 새 Sprite 인스턴스를 만듭니다.addChild() 메서드를 호출했을 때 기본 좌표 (0,0)으로 스테이지에 표시됩니다.keyDown / keyDownHandler: 임의의 키를 누르면 전달됩니다. 구독자 메서드에서 trace() 문을 사용하여 이벤트에 대한 정보를 출력합니다.keyUp / keyUpHandler: 임의의 키를 놓으면 전달됩니다.일부 인스턴스에서는 키보드 이벤트가 작동하도록 스테이지를 클릭해야 할 수 있습니다.
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://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/flash/events/KeyboardEvent.html