flash.events
public class KeyboardEvent
继承KeyboardEvent Inheritance Event Inheritance Object

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

在响应用户的键盘输入操作时,Flash® Player 将调度 KeyboardEvent 对象。 有两种类型的键盘事件:KeyboardEvent.KEY_DOWNKeyboardEvent.KEY_UP

由于按键与特定字符之间的映射因设备和操作系统而异,因此请使用 TextEvent 事件类型来处理字符输入。

若要以全局方式侦听按键事件,请在舞台上侦听捕获阶段、目标阶段或冒泡阶段。

查看示例

另请参见

KEY_DOWN
KEY_UP
KeyLocation



公共 属性
 属性定义方
  altKey : Boolean
保留以供将来使用。
KeyboardEvent
 Inheritedbubbles : Boolean
[read-only] 指示事件是否为冒泡事件。
Event
 Inheritedcancelable : Boolean
[read-only] 指示是否可以阻止与事件相关联的行为。
Event
  charCode : uint
包含按下或释放的键的字符代码值。
KeyboardEvent
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  ctrlKey : Boolean
指示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。
KeyboardEvent
 InheritedcurrentTarget : Object
[read-only] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
 InheritedeventPhase : uint
[read-only] 事件流中的当前阶段。
Event
  keyCode : uint
按下或释放的键的键控代码值。
KeyboardEvent
  keyLocation : uint
指示键在键盘上的位置。
KeyboardEvent
 Inheritedprototype : Object
[static] 对类或函数对象的原型对象的引用。
Object
  shiftKey : Boolean
指示 Shift 功能键是处于活动状态 (true) 还是非活动状态 (false)。
KeyboardEvent
 Inheritedtarget : Object
[read-only] 事件目标。
Event
 Inheritedtype : 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
 Inherited
formatToString(className:String, ... arguments):String
在自定义 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
检查是否已对事件调用 preventDefault()。
Event
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
如果可以取消事件的默认行为,则取消该行为。
Event
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
 Inherited
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
  
返回一个字符串,其中包含 KeyboardEvent 对象的所有属性。
KeyboardEvent
  
如果已修改显示列表,则此事件处理完成后将指示 Flash Player 呈现结果。
KeyboardEvent
 Inherited
返回指定对象的原始值。
Object
公共 常量
 常量定义方
 InheritedACTIVATE : String = "activate"
[static] 定义 activate 事件对象的 type 属性值。
Event
 InheritedADDED : String = "added"
[static] 定义 added 事件对象的 type 属性值。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] 定义 addedToStage 事件对象的 type 属性值。
Event
 InheritedCANCEL : String = "cancel"
[static] 定义 cancel 事件对象的 type 属性值。
Event
 InheritedCHANGE : String = "change"
[static] 定义 change 事件对象的 type 属性值。
Event
 InheritedCLOSE : String = "close"
[static] 定义 close 事件对象的 type 属性值。
Event
 InheritedCOMPLETE : String = "complete"
[static] 定义 complete 事件对象的 type 属性值。
Event
 InheritedCONNECT : String = "connect"
[static] 定义 connect 事件对象的 type 属性值。
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] 定义 deactivate 事件对象的 type 属性值。
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] 定义 enterFrame 事件对象的 type 属性值。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] 定义 fullScreen 事件对象的 type 属性值。
Event
 InheritedID3 : String = "id3"
[static] 定义 id3 事件对象的 type 属性值。
Event
 InheritedINIT : String = "init"
[static] 定义 init 事件对象的 type 属性值。
Event
  KEY_DOWN : String = "keyDown"
[static] 定义 keyDown 事件对象的 type 属性值。
KeyboardEvent
  KEY_UP : String = "keyUp"
[static] 定义 keyUp 事件对象的 type 属性值。
KeyboardEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] 定义 mouseLeave 事件对象的 type 属性值。
Event
 InheritedOPEN : String = "open"
[static] 定义 open 事件对象的 type 属性值。
Event
 InheritedREMOVED : String = "removed"
[static] 定义 removed 事件对象的 type 属性值。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] 定义 removedFromStage 事件对象的 type 属性值。
Event
 InheritedRENDER : String = "render"
[static] 定义 render 事件对象的 type 属性值。
Event
 InheritedRESIZE : String = "resize"
[static] 定义 resize 事件对象的 type 属性值。
Event
 InheritedSCROLL : String = "scroll"
[static] 定义 scroll 事件对象的 type 属性值。
Event
 InheritedSELECT : String = "select"
[static] 定义 select 事件对象的 type 属性值。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] 定义 soundComplete 事件对象的 type 属性值。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] 定义 tabChildrenChange 事件对象的 type 属性值。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] 定义 tabEnabledChange 事件对象的 type 属性值。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] 定义 tabIndexChange 事件对象的 type 属性值。
Event
 InheritedUNLOAD : 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_DOWNKeyboardEvent.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 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
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 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelablefalse;没有要取消的默认行为。
charCode包含按下或释放的键的字符代码值。
ctrlKey如果 Ctrl 键处于活动状态,则为 true;如果处于非活动状态,则为 false
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
keyCode按下或释放的键的键控代码值。
keyLocation按键在键盘上的位置。
shiftKey如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
target具有焦点的 InteractiveObject 实例。 target 不一定是显示列表中注册此事件侦听器的对象。 请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。

另请参见

示例 如何使用示例

以下示例使用 KeyboardEventExample 类来说明键盘事件及其侦听器函数。 该示例执行下列任务:
  1. 它声明了以后在设置正方形的背景颜色和大小时使用的属性。
  2. 它创建一个新的 Sprite 实例,名称为 child
  3. 使用 Sprite 的方法,它通过调用 addChild() 方法绘制一个浅蓝色正方形,其显示在舞台上的默认坐标 (0,0) 处。
  4. 它添加了两个键盘类型事件侦听器:

在某些情况下,您可能需要单击舞台,键盘事件才能工作。

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