包 | flash.events |
类 | public class KeyboardEvent |
继承 | KeyboardEvent Event Object |
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9 |
KeyboardEvent.KEY_DOWN
和 KeyboardEvent.KEY_UP
由于按键与特定字符之间的映射因设备和操作系统而异,因此请使用 TextEvent 事件类型来处理字符输入。
若要以全局方式侦听按键事件,请在舞台上侦听捕获阶段、目标阶段或冒泡阶段。
另请参见
属性 | 定义方 | ||
---|---|---|---|
altKey : Boolean
保留以供将来使用。
| KeyboardEvent | ||
bubbles : Boolean
[read-only]
指示事件是否为冒泡事件。
| Event | ||
cancelable : Boolean
[read-only]
指示是否可以阻止与事件相关联的行为。
| Event | ||
charCode : uint
包含按下或释放的键的字符代码值。
| KeyboardEvent | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。
| Object | ||
ctrlKey : Boolean
指示 Ctrl 键是处于活动状态 (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 |
保留以供将来使用。 此属性当前不受支持。
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) 正在运行时,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 |
指示 Ctrl 键是处于活动状态 (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) 正在运行时,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 |
指示键在键盘上的位置。 这对于区分在键盘上多次出现的键非常有用。 例如,您可以根据此属性的值来区分左 Shift 键和右 Shift 键:左 Shift 键的值为 KeyLocation.LEFT
,右 Shift 键的值为 KeyLocation.RIGHT
。 另一个示例是区分标准键盘 (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 ) — 指示是否已激活 Ctrl 功能键。
|
|
altKey:Boolean (default = false ) — 保留以供将来使用(当前不受支持)。
|
|
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 | 如果 Ctrl 键处于活动状态,则为 true ;如果处于非活动状态,则为 false 。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 按下或释放的键的键控代码值。 |
keyLocation | 按键在键盘上的位置。 |
shiftKey | 如果 Shift 键处于活动状态,则为 true ;如果处于非活动状态,则为 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 | 如果 Ctrl 键处于活动状态,则为 true ;如果处于非活动状态,则为 false 。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 按下或释放的键的键控代码值。 |
keyLocation | 按键在键盘上的位置。 |
shiftKey | 如果 Shift 键处于活动状态,则为 true ;如果处于非活动状态,则为 false 。 |
target | 具有焦点的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
另请参见
KeyboardEventExample
类来说明键盘事件及其侦听器函数。 该示例执行下列任务:
child
。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_cn/ActionScriptLangRefV3/flash/events/KeyboardEvent.html