键盘事件:KeyboardEvent
属性 | 定义方 | ||
---|---|---|---|
: 在 Windows 中,指示 Alt 键是处于活动状态 (true) 还是非活动状态 (false);在 Mac OS 中,指示 Option 键是否处于活动状态。 | KeyboardEvent | ||
: [只读 (read-only)] 指示事件是否为冒泡事件。 | |||
: [只读 (read-only)] 指示是否可以阻止与事件相关联的行为。 | |||
: 包含按下或释放的键的字符代码值。 | KeyboardEvent | ||
: 指示 Command 键是处于活动状态 (true) 还是非活动状态 (false)。 | KeyboardEvent | ||
: 对类对象或给定对象实例的构造函数的引用。 | |||
: 指示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。 | KeyboardEvent | ||
: 在 Windows 和 Linux 中,指示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false);在 Mac OS 中,指示 Ctrl 键或 Command 键是否处于活动状态。 | KeyboardEvent | ||
: [只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。 | |||
: [只读 (read-only)] 事件流中的当前阶段。 | |||
: 按下或释放的键的键控代码值。 | KeyboardEvent | ||
: 指示键在键盘上的位置。 | KeyboardEvent | ||
: [静态] 对类或函数对象的原型对象的引用。 | |||
: 指示 Shift 功能键是处于活动状态 (true) 还是非活动状态 (false)。 | KeyboardEvent | ||
: [只读 (read-only)] 事件目标。 | |||
: [只读 (read-only)] 事件的类型。 |
方法 | 定义方 | ||
---|---|---|---|
(type: , bubbles: = true, cancelable: = false, charCodeValue: = 0, keyCodeValue: = 0, keyLocationValue: = 0, ctrlKeyValue: = false, altKeyValue: = false, shiftKeyValue: = false, controlKeyValue: = false, commandKeyValue: = false) 创建一个 Event 对象,其中包含有关键盘事件的特定信息。 | KeyboardEvent | ||
(): 创建 KeyboardEvent 对象的副本,并设置每个属性的值以匹配原始属性值。 | KeyboardEvent | ||
(className: , arguments): 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | |||
(name: ): 指示对象是否已经定义了指定的属性。 | |||
(): 检查是否已对事件调用 preventDefault() 方法。 | |||
(theClass: ): 指示 Object 类的实例是否在指定为参数的对象的原型链中。 | |||
(): 如果可以取消事件的默认行为,则取消该行为。 | |||
(name: ): 指示指定的属性是否存在、是否可枚举。 | |||
(name: , isEnum: = true): 设置循环操作动态属性的可用性。 | |||
(): 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | |||
(): 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | |||
(): 返回一个字符串,其中包含 KeyboardEvent 对象的所有属性。 | KeyboardEvent | ||
(): 指示如果已修改显示列表,则应该在此事件处理完成后呈现显示结果 | KeyboardEvent | ||
(): 返回指定对象的原始值。 |
常量 | 定义方 | ||
---|---|---|---|
: = "activate" [静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。 | |||
: = "added" [静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。 | |||
: = "addedToStage" [静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。 | |||
: = "cancel" [静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。 | |||
: = "change" [静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。 | |||
: = "clear" [静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。 | |||
: = "close" [静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。 | |||
: = "closing" [静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。 | |||
: = "complete" [静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。 | |||
: = "connect" [静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。 | |||
: = "copy" [静态] 定义 copy 事件对象的 type 属性值。 | |||
: = "cut" [静态] 定义 cut 事件对象的 type 属性值。 | |||
: = "deactivate" [静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。 | |||
: = "displaying" [静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。 | |||
: = "enterFrame" [静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。 | |||
: = "exitFrame" [静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。 | |||
: = "exiting" [静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。 | |||
: = "frameConstructed" [静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。 | |||
: = "fullScreen" [静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。 | |||
: = "htmlBoundsChange" [静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。 | |||
: = "htmlDOMInitialize" [静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。 | |||
: = "htmlRender" [静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。 | |||
: = "id3" [静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。 | |||
: = "init" [静态] Event.INIT 常量定义 init 事件对象的 type 属性值。 | |||
: = "keyDown" [静态] 定义 keyDown 事件对象的 type 属性值。 | KeyboardEvent | ||
: = "keyUp" [静态] 定义 keyUp 事件对象的 type 属性值。 | KeyboardEvent | ||
: = "locationChange" [静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。 | |||
: = "mouseLeave" [静态] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。 | |||
: = "networkChange" [静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。 | |||
: = "open" [静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。 | |||
: = "paste" [静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。 | |||
: = "removed" [静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。 | |||
: = "removedFromStage" [静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。 | |||
: = "render" [静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。 | |||
: = "resize" [静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。 | |||
: = "scroll" [静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。 | |||
: = "select" [静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。 | |||
: = "selectAll" [静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。 | |||
: = "soundComplete" [静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。 | |||
: = "tabChildrenChange" [静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。 | |||
: = "tabEnabledChange" [静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。 | |||
: = "tabIndexChange" [静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。 | |||
: = "unload" [静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。 | |||
: = "userIdle" [静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。 | |||
: = "userPresent" [静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。 |
altKey | 属性 |
altKey:
[读写]
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
在 Windows 中,指示 Alt 键是处于活动状态 (true
) 还是非活动状态 (false
);在 Mac OS 中,指示 Option 键是否处于活动状态。
public function get altKey():
public function set altKey(value:):
charCode | 属性 |
charCode:
[读写]
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
包含按下或释放的键的字符代码值。字符代码值为英文键盘值。例如,如果您按 Shift+3,则 charCode
在日文键盘上将为 #,就像在英文键盘上一样。
注意:当输入法编辑器 (IME) 正在运行时,charCode
不会报告精确的字符代码。
实现
public function get charCode():
public function set charCode(value:):
另请参见
commandKey | 属性 |
commandKey:
[读写]
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
指示 Command 键是处于活动状态 (true
) 还是非活动状态 (false
)。仅 Mac OS 支持。在 Mac OS 中,commandKey
属性具有与 ctrlKey
属性相同的值。
public function get commandKey():
public function set commandKey(value:):
controlKey | 属性 |
controlKey:
[读写]
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 |
指示 Ctrl 键是处于活动状态 (true
) 还是非活动状态 (false
)。在 Windows 和 Linux 中,Ctrl 键处于活动状态时这也为 true。
public function get controlKey():
public function set controlKey(value:):
ctrlKey | 属性 |
ctrlKey:
[读写]
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
在 Windows 和 Linux 中,指示 Ctrl 键是处于活动状态 (true
) 还是非活动状态 (false
);在 Mac OS 中,指示 Ctrl 键或 Command 键是否处于活动状态。
public function get ctrlKey():
public function set ctrlKey(value:):
keyCode | 属性 |
keyCode:
[读写]
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
按下或释放的键的键控代码值。
注意:当输入法编辑器 (IME) 正在运行时,keyCode
不会报告精确的键控代码。
实现
public function get keyCode():
public function set keyCode(value:):
另请参见
keyLocation | 属性 |
keyLocation:
[读写]
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
指示键在键盘上的位置。这对于区分在键盘上多次出现的键非常有用。例如,您可以根据此属性的值来区分左 Shift 键和右 Shift 键:左 Shift 键的值为 KeyLocation.LEFT
,右 Shift 键的值为 KeyLocation.RIGHT
。另一个示例是区分标准键盘 (KeyLocation.STANDARD
) 与数字键盘 (KeyLocation.NUM_PAD
) 上按下的数字键。
public function get keyLocation():
public function set keyLocation(value:):
shiftKey | 属性 |
shiftKey:
[读写]
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
指示 Shift 功能键是处于活动状态 (true
) 还是非活动状态 (false
)。
public function get shiftKey():
public function set shiftKey(value:):
KeyboardEvent | () | 构造函数 |
public function KeyboardEvent(type:, bubbles: = true, cancelable: = false, charCodeValue: = 0, keyCodeValue: = 0, keyLocationValue: = 0, ctrlKeyValue: = false, altKeyValue: = false, shiftKeyValue: = false, controlKeyValue: = false, commandKeyValue: = false)
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
创建一个 Event 对象,其中包含有关键盘事件的特定信息。将 Event 对象作为参数传递给事件侦听器。
参数 type: — 事件的类型。可能的值为:KeyboardEvent.KEY_DOWN 和 KeyboardEvent.KEY_UP | |
bubbles: (default = true ) — 确定 Event 对象是否参与事件流的冒泡阶段。 | |
cancelable: (default = false ) — 确定是否可以取消 Event 对象。 | |
charCodeValue: (default = 0 ) — 按下或释放的键的字符代码值。返回的字符代码值为英文键盘值。例如,如果您按 Shift+3,则 getASCIICode() 方法在日文键盘上将返回 #,就像在英文键盘上一样。 | |
keyCodeValue: (default = 0 ) — 按下或释放的键的键控代码值。 | |
keyLocationValue: (default = 0 ) — 按键在键盘上的位置。 | |
ctrlKeyValue: (default = false ) — 在 Windows 中,指示是否已激活 Ctrl 键。在 Mac 中,指示是否已激活 Ctrl 键或 Command 键。 | |
altKeyValue: (default = false ) — 指示是否已激活 Alt 功能键(仅限 Windows)。 | |
shiftKeyValue: (default = false ) — 指示是否已激活 Shift 功能键。 | |
controlKeyValue: (default = false ) — 指示在 Mac 中是否已激活 Control 键,以及在 Windows 和 Linux 中是否已激活 Control 或 Ctrl 键。 | |
commandKeyValue: (default = false ) — 指示是否已激活 Command 键(仅限 Mac)。 |
另请参见
clone | () | 方法 |
override public function clone():
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
创建 KeyboardEvent 对象的副本,并设置每个属性的值以匹配原始属性值。
返回
— 其属性值与原始属性值匹配的新 KeyboardEvent 对象。 |
toString | () | 方法 |
override public function toString():
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
返回一个字符串,其中包含 KeyboardEvent 对象的所有属性。字符串的格式如下:
[KeyboardEvent type=value bubbles=value cancelable=value ... shiftKey=value ]
返回
— 一个字符串,其中包含 KeyboardEvent 对象的所有属性。 |
updateAfterEvent | () | 方法 |
public function updateAfterEvent():
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
指示如果已修改显示列表,则应该在此事件处理完成后呈现显示结果
KEY_DOWN | 常量 |
public static const KEY_DOWN: = "keyDown"
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
定义 keyDown
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | true |
cancelable | false ;没有要取消的默认行为。 |
charCode | 按下或释放的键的字符代码值。 |
commandKey | 在 Mac 中,如果 Command 键处于活动状态,则为 true 。否则为 false |
controlKey | 在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true 。在 Mac 中,如果 Control 键处于活动状态,则为 true 。否则为 false |
ctrlKey | 在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true 。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true 。否则为 false 。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 按下或释放的键的键控代码值。 |
keyLocation | 按键在键盘上的位置。 |
shiftKey | 如果 Shift 键处于活动状态,则为 true ;如果处于非活动状态,则为 false 。 |
target | 具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
另请参见
KEY_UP | 常量 |
public static const KEY_UP: = "keyUp"
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0 Flash Player 9 |
定义 keyUp
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | true |
cancelable | false ;没有要取消的默认行为。 |
charCode | 包含按下或释放的键的字符代码值。 |
commandKey | 在 Mac 中,如果 Command 键处于活动状态,则为 true 。否则为 false |
controlKey | 在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true 。在 Mac 中,如果 Control 键处于活动状态,则为 true 。否则为 false |
ctrlKey | 在 Windows 中,如果 Ctrl 键处于活动状态,则为 true 。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true 。否则为 false 。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 按下或释放的键的键控代码值。 |
keyLocation | 按键在键盘上的位置。 |
shiftKey | 如果 Shift 键处于活动状态,则为 true ;如果处于非活动状态,则为 false 。 |
target | 具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
另请参见
KeyboardEventExample
类来说明键盘事件及其侦听器函数。该示例执行下列任务: - 它创建一个新的 Sprite 实例,名称为
child
。 - 它声明了以后在设置正方形的背景颜色和大小时使用的属性。
- 使用 Sprite 的方法,它通过调用
addChild()
方法绘制一个浅蓝色正方形,其显示在舞台上的默认坐标 (0,0) 处。 - 它添加了一个鼠标事件两个键盘类型事件侦听器:
-
click
/clickHandler
,在单击正方形将焦点设置在child
sprite 上以使它可以侦听键盘事件时进行调度。 -
keyDown
/keyDownHandler
,按下任何键时将调度这两个侦听器。订阅者方法使用trace()
语句输出有关事件的信息。 -
keyUp
/keyUpHandler
,在释放某个键时进行调度。
-
在测试此示例时,需要首先单击此正方形才能让键盘事件正常工作。
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); } }}