鸿蒙OS KeyEvent

KeyEvent

java.lang.Object

|—ohos.multimodalinput.event.MultimodalEvent

|—|—ohos.multimodalinput.event.KeyEvent

public abstract class KeyEvent
extends MultimodalEvent

定义所有关键事件。

此类扩展了 MultimodalEvent 类。 它定义了各种键事件的 keycode 和方法。

keycode 如下：

• -1：未知 keycode，默认值
• 1 到 1000：常用键的 keycode
• 1001 到 1999：内部密钥设备的密钥代码
• 2000 到 3000：外部按键设备的 keycode（主要是外部键盘）
• 10001 到 NOW_MAX_KEY 指定的值：车辆钥匙的钥匙代码

Since:

1

嵌套类摘要

字段摘要

构造函数摘要

方法总结

字段详细信息

KEY_0

public static final int KEY_0

keycode 常量：“0”键

Since:

1

KEY_1

public static final int KEY_1

keycode 常量：“1”键

Since:

1

KEY_2

public static final int KEY_2

keycode 常量：“2”键

Since:

1

KEY_3

public static final int KEY_3

keycode 常量：“3”键

Since:

1

KEY_4

public static final int KEY_4

keycode 常量：“4”键

Since:

1

KEY_5

public static final int KEY_5

keycode 常量：“5”键

Since:

1

KEY_6

public static final int KEY_6

keycode 常量：“6”键

Since:

1

KEY_7

public static final int KEY_7

keycode 常量：“7”键

Since:

1

KEY_8

public static final int KEY_8

keycode 常量：’8′ 键

Since:

1

KEY_9

public static final int KEY_9

keycode 常量：’9′ 键

Since:

1

KEY_A

public static final int KEY_A

keycode 常量：“A”键

Since:

1

KEY_ALT_LEFT

public static final int KEY_ALT_LEFT

keycode 常量：左 Alt 修饰键

Since:

1

KEY_ALT_RIGHT

public static final int KEY_ALT_RIGHT

keycode 常量：右 Alt 修饰键

Since:

1

KEY_APOSTROPHE

public static final int KEY_APOSTROPHE

keycode 常量：”’键（撇号键）

Since:

1

KEY_AT

public static final int KEY_AT

keycode 常量：’@’ 键

Since:

1

KEY_B

public static final int KEY_B

keycode 常量：“B”键

Since:

1

KEY_BACK

public static final int KEY_BACK

keycode 常量：返回键

Since:

1

KEY_BACKSLASH

public static final int KEY_BACKSLASH

keycode 常量：”键

Since:

1

KEY_BREAK

public static final int KEY_BREAK

keycode 常量：中断/暂停键

Since:

1

KEY_BRIGHTNESS_DOWN

public static final int KEY_BRIGHTNESS_DOWN

亮度降低键

Since:

1

KEY_BRIGHTNESS_UP

public static final int KEY_BRIGHTNESS_UP

亮度UP键

Since:

1

KEY_C

public static final int KEY_C

keycode 常量：“C”键

Since:

1

KEY_CALL

public static final int KEY_CALL

keycode 常量：调用键

Since:

1

KEY_CAMERA

public static final int KEY_CAMERA

按下相机键。

它用于启动相机或拍照。

Since:

1

KEY_CAPS_LOCK

public static final int KEY_CAPS_LOCK

keycode 常量：Caps Lock 键

Since:

1

KEY_CLEAR

public static final int KEY_CLEAR

keycode 常量：清除键

Since:

1

KEY_COMMA

public static final int KEY_COMMA

keycode 常量：’,’ 键

Since:

1

KEY_CTRL_LEFT

public static final int KEY_CTRL_LEFT

keycode 常量：左控制修饰键

Since:

1

KEY_CTRL_RIGHT

public static final int KEY_CTRL_RIGHT

keycode 常量：右控制修饰键

Since:

1

KEY_CUSTOM1

public static final int KEY_CUSTOM1

自定义键 1

映射到自定义键的操作是用户定义的。 键值 521-529 为自定义键保留。

Since:

1

KEY_D

public static final int KEY_D

keycode 常量：“D”键

Since:

1

KEY_DEL

public static final int KEY_DEL

keycode 常量：退格键

与 KEY_FORWARD_DEL 不同，此键用于删除插入点之前的字符。

Since:

1

KEY_DPAD_CENTER

public static final int KEY_DPAD_CENTER

keycode 常量：方向键中心键

密钥也可以从轨迹球运动中合成。

Since:

1

KEY_DPAD_DOWN

public static final int KEY_DPAD_DOWN

keycode 常量：方向键向下键

密钥也可以从轨迹球运动中合成。

Since:

1

KEY_DPAD_LEFT

public static final int KEY_DPAD_LEFT

keycode 常量：方向键左键

密钥也可以从轨迹球运动中合成。

Since:

1

KEY_DPAD_RIGHT

public static final int KEY_DPAD_RIGHT

keycode 常量：方向键右键

密钥也可以从轨迹球运动中合成。

Since:

1

KEY_DPAD_UP

public static final int KEY_DPAD_UP

keycode 常量：方向键向上键

密钥也可以从轨迹球运动中合成。

Since:

1

KEY_E

public static final int KEY_E

keycode 常量：“E”键

Since:

1

KEY_ENDCALL

public static final int KEY_ENDCALL

keycode 常量：结束通话键

Since:

1

KEY_ENTER

public static final int KEY_ENTER

keycode 常量：输入键

Since:

1

KEY_ENVELOPE

public static final int KEY_ENVELOPE

Keycode 常量：电子邮件功能键

此键用于启动电子邮件应用程序。

Since:

1

KEY_EQUALS

public static final int KEY_EQUALS

keycode 常量：’=’ 键

Since:

1

KEY_ESCAPE

public static final int KEY_ESCAPE

keycode 常量：退出键

Since:

1

KEY_EXPLORER

public static final int KEY_EXPLORER

Keycode 常量：Explorer 功能键

此键用于启动浏览器应用程序。

Since:

1

KEY_F

public static final int KEY_F

keycode 常量：“F”键

Since:

1

KEY_F1

public static final int KEY_F1

keycode 常量：F1 键

Since:

1

KEY_F10

public static final int KEY_F10

keycode 常量：F10 键

Since:

1

KEY_F11

public static final int KEY_F11

keycode 常量：F11 键

Since:

1

KEY_F12

public static final int KEY_F12

keycode 常量：F12 键

Since:

1

KEY_F2

public static final int KEY_F2

keycode 常量：F2 键

Since:

1

KEY_F3

public static final int KEY_F3

keycode 常量：F3 键

Since:

1

KEY_F4

public static final int KEY_F4

keycode 常量：F4 键

Since:

1

KEY_F5

public static final int KEY_F5

keycode 常量：F5 键

Since:

1

KEY_F6

public static final int KEY_F6

keycode 常量：F6 键

Since:

1

KEY_F7

public static final int KEY_F7

keycode 常量：F7 键

Since:

1

KEY_F8

public static final int KEY_F8

keycode 常量：F8 键

Since:

1

KEY_F9

public static final int KEY_F9

keycode 常量：F9 键

Since:

1

KEY_FOCUS

public static final int KEY_FOCUS

keycode 常量：相机对焦键

此键用于启用相机对焦。

Since:

1

KEY_FORWARD

public static final int KEY_FORWARD

keycode 常量：前进键

该键用于在历史堆栈中向前导航。 它是 KEY_BACK 的补充。

Since:

1

KEY_FORWARD_DEL

public static final int KEY_FORWARD_DEL

keycode 常量：向前删除键

与 KEY_DEL 不同，此键用于删除插入点之前的字符。

Since:

1

KEY_FUNCTION

public static final int KEY_FUNCTION

Keycode 常量：功能修饰键

Since:

1

KEY_G

public static final int KEY_G

keycode 常量：“G”键

Since:

1

KEY_GRAVE

public static final int KEY_GRAVE

keycode 常量：’`’ 键（反引号键）

Since:

1

KEY_H

public static final int KEY_H

keycode 常量：“H”键

Since:

1

KEY_HEADSETHOOK

public static final int KEY_HEADSETHOOK

keycode 常量：耳机挂钩键

该键用于结束通话和停止媒体。

Since:

1

KEY_HOME

public static final int KEY_HOME

keycode 常量：Home 键

此密钥由框架处理，永远不会发送到应用程序。

Since:

1

KEY_I

public static final int KEY_I

keycode 常量：“I”键

Since:

1

KEY_INSERT

public static final int KEY_INSERT

keycode 常量：插入键

该键用于切换插入或覆盖编辑模式。

Since:

1

KEY_J

public static final int KEY_J

keycode 常量：“J”键

Since:

1

KEY_K

public static final int KEY_K

keycode 常量：“K”键

Since:

1

KEY_L

public static final int KEY_L

keycode 常量：“L”键

Since:

1

KEY_LAUNCHER_MENU

public static final int KEY_LAUNCHER_MENU

菜单键

按此键将显示启动器页面。

Since:

1

KEY_LEFT_BRACKET

public static final int KEY_LEFT_BRACKET

keycode 常量：'[‘键

Since:

1

KEY_LEFT_KNOB

public static final int KEY_LEFT_KNOB

左旋钮

按下旋钮将激活其调节功能。

Since:

1

KEY_LEFT_KNOB_ROLL_DOWN

public static final int KEY_LEFT_KNOB_ROLL_DOWN

左旋钮向下滚动

与 KEY_LEFT_KNOB_ROLL_UP 不同，它意味着向下滚动左侧旋钮。 旋钮功能是针对特定场景的，例如降低音量或空调温度。

Since:

1

KEY_LEFT_KNOB_ROLL_UP

public static final int KEY_LEFT_KNOB_ROLL_UP

左旋钮卷起

与 KEY_LEFT_KNOB_ROLL_DOWN 不同，它意味着向上滚动左侧旋钮。 旋钮功能是针对特定场景的，例如增加音量或空调温度。

Since:

1

KEY_M

public static final int KEY_M

keycode 常量：“M”键

Since:

1

KEY_MEDIA_CLOSE

public static final int KEY_MEDIA_CLOSE

Keycode 常量：关闭媒体键

例如，此键可用于关闭 CD 托盘。

Since:

1

KEY_MEDIA_EJECT

public static final int KEY_MEDIA_EJECT

Keycode 常量：弹出媒体密钥

例如，此键可用于弹出 CD 托盘。

Since:

1

KEY_MEDIA_FAST_FORWARD

public static final int KEY_MEDIA_FAST_FORWARD

keycode 常量：快进媒体键

Since:

1

KEY_MEDIA_NEXT

public static final int KEY_MEDIA_NEXT

keycode 常量：播放下一个媒体键

Since:

1

KEY_MEDIA_PAUSE

public static final int KEY_MEDIA_PAUSE

Keycode 常量：暂停媒体键

Since:

1

KEY_MEDIA_PLAY

public static final int KEY_MEDIA_PLAY

Keycode 常量：播放媒体键

Since:

1

KEY_MEDIA_PLAY_PAUSE

public static final int KEY_MEDIA_PLAY_PAUSE

keycode 常量：播放/暂停媒体键

Since:

1

KEY_MEDIA_PREVIOUS

public static final int KEY_MEDIA_PREVIOUS

keycode 常量：播放上一个媒体键

Since:

1

KEY_MEDIA_RECORD

public static final int KEY_MEDIA_RECORD

Keycode 常量：记录媒体密钥

Since:

1

KEY_MEDIA_REWIND

public static final int KEY_MEDIA_REWIND

keycode 常量：倒带媒体键

Since:

1

KEY_MEDIA_STOP

public static final int KEY_MEDIA_STOP

Keycode 常量：停止媒体键

Since:

1

KEY_MENU

public static final int KEY_MENU

keycode 常量：菜单键

Since:

1

KEY_META_LEFT

public static final int KEY_META_LEFT

keycode 常量：Left Meta 修饰键

Since:

1

KEY_META_RIGHT

public static final int KEY_META_RIGHT

Keycode 常量：右 Meta 修饰键

Since:

1

KEY_MINUS

public static final int KEY_MINUS

keycode 常量：’-‘ 键

Since:

1

KEY_MOVE_END

public static final int KEY_MOVE_END

keycode 常量：结束移动键

此键用于滚动或移动光标到行尾或列表底部。

Since:

1

KEY_MOVE_HOME

public static final int KEY_MOVE_HOME

keycode 常量：Home Movement 键

此键用于滚动或移动光标到行首或列表顶部。

Since:

1

KEY_N

public static final int KEY_N

keycode 常量：“N”键

Since:

1

KEY_NOTIFICATION

public static final int KEY_NOTIFICATION

keycode 常量：通知键

Since:

1

KEY_NUMPAD_0

public static final int KEY_NUMPAD_0

keycode 常量：数字键盘上的“0”键

Since:

1

KEY_NUMPAD_1

public static final int KEY_NUMPAD_1

keycode 常量：数字键盘上的“1”键

Since:

1

KEY_NUMPAD_2

public static final int KEY_NUMPAD_2

keycode 常量：数字键盘上的“2”键

Since:

1

KEY_NUMPAD_3

public static final int KEY_NUMPAD_3

keycode 常量：数字键盘上的“3”键

Since:

1

KEY_NUMPAD_4

public static final int KEY_NUMPAD_4

keycode 常量：数字键盘上的“4”键

Since:

1

KEY_NUMPAD_5

public static final int KEY_NUMPAD_5

keycode 常量：数字键盘上的“5”键

Since:

1

KEY_NUMPAD_6

public static final int KEY_NUMPAD_6

keycode 常量：数字键盘上的“6”键

Since:

1

KEY_NUMPAD_7

public static final int KEY_NUMPAD_7

keycode 常量：数字键盘上的“7”键

Since:

1

KEY_NUMPAD_8

public static final int KEY_NUMPAD_8

keycode 常量：数字键盘上的“8”键

Since:

1

KEY_NUMPAD_9

public static final int KEY_NUMPAD_9

keycode 常量：数字键盘上的“9”键

Since:

1

KEY_NUMPAD_ADD

public static final int KEY_NUMPAD_ADD

keycode 常量：数字键盘上的“+”键（用于加法）

Since:

1

KEY_NUMPAD_COMMA

public static final int KEY_NUMPAD_COMMA

keycode 常量：数字键盘上的“,”键（用于小数或数字分组）

Since:

1

KEY_NUMPAD_DIVIDE

public static final int KEY_NUMPAD_DIVIDE

keycode 常量：数字键盘上的“/”键（用于除法）

Since:

1

KEY_NUMPAD_DOT

public static final int KEY_NUMPAD_DOT

keycode 常量：’.’ 数字键盘上的键（用于小数或数字分组）

Since:

1

KEY_NUMPAD_ENTER

public static final int KEY_NUMPAD_ENTER

Keycode 常量：数字键盘上的 Enter 键

Since:

1

KEY_NUMPAD_EQUALS

public static final int KEY_NUMPAD_EQUALS

keycode 常量：数字键盘上的“=”键

Since:

1

KEY_NUMPAD_LEFT_PAREN

public static final int KEY_NUMPAD_LEFT_PAREN

keycode 常量：数字键盘上的“（”键

Since:

1

KEY_NUMPAD_MULTIPLY

public static final int KEY_NUMPAD_MULTIPLY

keycode 常量：数字键盘上的“*”键（用于乘法）

Since:

1

KEY_NUMPAD_RIGHT_PAREN

public static final int KEY_NUMPAD_RIGHT_PAREN

keycode 常量：数字小键盘上的“)”键

Since:

1

KEY_NUMPAD_SUBTRACT

public static final int KEY_NUMPAD_SUBTRACT

keycode 常量：数字键盘上的“-”键（用于减法）

Since:

1

KEY_NUM_LOCK

public static final int KEY_NUM_LOCK

keycode 常量：Num Lock 键

此键用于更改数字小键盘上其他键的行为。

Since:

1

KEY_O

public static final int KEY_O

keycode 常量：“O”键

Since:

1

KEY_P

public static final int KEY_P

keycode 常量：“P”键

Since:

1

KEY_PAGE_DOWN

public static final int KEY_PAGE_DOWN

keycode 常量：Page Down 键

Since:

1

KEY_PAGE_UP

public static final int KEY_PAGE_UP

keycode 常量：Page Up 键

Since:

1

KEY_PERIOD

public static final int KEY_PERIOD

keycode 常量：’.’ 钥匙

Since:

1

KEY_PLUS

public static final int KEY_PLUS

keycode 常量：’+’ 键

Since:

1

KEY_POUND

public static final int KEY_POUND

keycode 常量：’#’ 键

Since:

1

KEY_POWER

public static final int KEY_POWER

按下电源按钮。

Since:

1

KEY_PRESSED

public static final int KEY_PRESSED

表示正在按下该键。

Since:

4

KEY_Q

public static final int KEY_Q

keycode 常量：“Q”键

Since:

1

KEY_R

public static final int KEY_R

keycode 常量：“R”键

Since:

1

KEY_RELEASED

public static final int KEY_RELEASED

表示正在释放密钥。

Since:

4

KEY_RIGHT_BRACKET

public static final int KEY_RIGHT_BRACKET

keycode 常量：’]’ 键

Since:

1

KEY_RIGHT_KNOB

public static final int KEY_RIGHT_KNOB

右旋钮

按下旋钮将激活其调节功能。

Since:

1

KEY_RIGHT_KNOB_ROLL_DOWN

public static final int KEY_RIGHT_KNOB_ROLL_DOWN

右旋钮向下滚动

与 KEY_RIGHT_KNOB_ROLL_UP 不同，它意味着向下滚动右侧旋钮。 旋钮功能是针对特定场景的，例如降低音量或空调温度。

Since:

1

KEY_RIGHT_KNOB_ROLL_UP

public static final int KEY_RIGHT_KNOB_ROLL_UP

右旋钮卷起

与 KEY_RIGHT_KNOB_ROLL_DOWN 不同，它意味着向上滚动右侧旋钮。 旋钮功能是针对特定场景的，例如增加音量或空调温度。

Since:

1

KEY_S

public static final int KEY_S

keycode 常量：“S”键

Since:

1

KEY_SCROLL_LOCK

public static final int KEY_SCROLL_LOCK

keycode 常量：Scroll Lock 键

Since:

1

KEY_SEARCH

public static final int KEY_SEARCH

keycode 常量：搜索键

Since:

1

KEY_SEMICOLON

public static final int KEY_SEMICOLON

keycode 常量：’;’ 键

Since:

1

KEY_SHIFT_LEFT

public static final int KEY_SHIFT_LEFT

keycode 常量：左 Shift 修饰键

Since:

1

KEY_SHIFT_RIGHT

public static final int KEY_SHIFT_RIGHT

keycode 常量：右 Shift 修饰键

Since:

1

KEY_SLASH

public static final int KEY_SLASH

keycode 常量：’/’ 键

Since:

1

KEY_SPACE

public static final int KEY_SPACE

keycode 常量：空格键

Since:

1

KEY_STAR

public static final int KEY_STAR

keycode 常量：’*’ 键

Since:

1

KEY_SYM

public static final int KEY_SYM

Keycode 常量：符号修饰键

该键用于输入替代符号。

Since:

1

KEY_SYSRQ

public static final int KEY_SYSRQ

keycode 常量：系统请求/打印屏幕键

Since:

1

KEY_T

public static final int KEY_T

keycode 常量：“T”键

Since:

1

KEY_TAB

public static final int KEY_TAB

keycode 常量：Tab 键

Since:

1

KEY_U

public static final int KEY_U

keycode 常量：“U”键

Since:

1

KEY_UNKNOWN

public static final int KEY_UNKNOWN

keycode 常量：未知 keycode

密钥代码未知。

Since:

1

KEY_V

public static final int KEY_V

keycode 常量：“V”键

Since:

1

KEY_VOICE_ASSISTANT

public static final int KEY_VOICE_ASSISTANT

语音助手键

该键用于唤醒语音助手。

Since:

1

KEY_VOICE_SOURCE_SWITCH

public static final int KEY_VOICE_SOURCE_SWITCH

音源切换按钮

按此按钮将启用音频源。 根据实际场景，也可能表示蓝牙通话控制按钮被按下。

Since:

1

KEY_VOLUME_DOWN

public static final int KEY_VOLUME_DOWN

调低音量。

Since:

1

KEY_VOLUME_MUTE

public static final int KEY_VOLUME_MUTE

表示音量已静音。

Since:

7

KEY_VOLUME_UP

public static final int KEY_VOLUME_UP

调高音量。

Since:

1

KEY_W

public static final int KEY_W

keycode 常量：“W”键

Since:

1

KEY_WEAR_1

public static final int KEY_WEAR_1

表示可穿戴设备上的通用键 1

Since:

3

KEY_X

public static final int KEY_X

keycode 常量：“X”键

Since:

1

KEY_Y

public static final int KEY_Y

keycode 常量：“Y”键

Since:

1

KEY_Z

public static final int KEY_Z

keycode 常量：“Z”键

Since:

1

NOW_MAX_KEY

public static final int NOW_MAX_KEY

keycode 常量：最大 keycode

如果添加到 KeyEvent 的新 keycode 大于最大 keycode ，则相应地更新最大 keycode 。

Since:

1

构造函数详细信息

KeyEvent

public KeyEvent()

方法详情

getMaxKeyCode

public static int getMaxKeyCode()

获取当前按键事件的最大 keycode。

返回:

返回当前键事件的最大 keycode。

Since:

1

isKeyDown

public abstract boolean isKeyDown()

获取当前按键的按下状态。

返回:

如果当前键被按下，则返回 true； 否则返回 false。

Since:

1

getKeyCode

public abstract int getKeyCode()

获取当前按键事件的keycode。

返回:

返回事件的 keycode； 如果无法获取 keycode，则返回 KEY_UNKNOWN。

Since:

1

getKeyDownDuration

public abstract long getKeyDownDuration()

获取调用此方法之前按下当前键的持续时间。

返回:

返回当前键被按下的持续时间（以毫秒为单位）； 如果当前键没有被按下，则返回 0。

Since:

1