1# @ohos.multimodalInput.keyEvent (按键输入事件)
2
3设备上报的按键事件，继承自[InputEvent](js-apis-inputevent.md)。
4
5>  **说明：**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```js
12import { Action, Key, KeyEvent } from '@kit.InputKit';
13```
14
15## Action
16
17按键事件类型。
18
19**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。
20
21**系统能力**：SystemCapability.MultimodalInput.Input.Core
22
23| 名称   | 值  | 说明     |
24| ------ | ------- | -------- |
25| CANCEL | 0    | 按键取消 |
26| DOWN   | 1    | 按键按下 |
27| UP     | 2    | 按键抬起 |
28
29## Key
30
31按键。
32
33**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。
34
35**系统能力**：SystemCapability.MultimodalInput.Input.Core
36
37| 名称        | 类型 | 可读 | 可写 | 说明           |
38| ----------- | -------- | ---- | ---- | -------------- |
39| code        | [KeyCode](js-apis-keycode.md#keycode)  | 是   | 否   | 按键码         |
40| pressedTime | number   | 是   | 否   | 按键按下时间，单位为微秒（μs） |
41| deviceId    | number   | 是   | 否   | 按键所属设备id   |
42
43## KeyEvent
44
45按键事件。
46
47**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。
48
49**系统能力**：SystemCapability.MultimodalInput.Input.Core
50
51| 名称        | 类型 | 可读 | 可写 | 说明                           |
52| ----------- | -------- | ---- | ---- | ------------------------------ |
53| action      | [Action](#action)   | 是   | 否   | 按键动作                       |
54| key         | [Key](#key)      | 是   | 否   | 当前上报的按键             |
55| unicodeChar | number   | 是   | 否   | 按键对应的uniCode字符          |
56| keys        | [Key](#key) []    | 是   | 否   | 当前处于按下状态的按键列表     |
57| ctrlKey     | boolean  | 是   | 否   | 当前ctrlKey是否处于按下状态 <br/>ture表示处于按下状态，false表示处于抬起状态。 |
58| altKey      | boolean  | 是   | 否   | 当前altKey是否处于按下状态 <br/>ture表示处于按下状态，false表示处于抬起状态。     |
59| shiftKey    | boolean  | 是   | 否   | 当前shiftKey是否处于按下状态 <br/>ture表示处于按下状态，false表示处于抬起状态。   |
60| logoKey     | boolean  | 是   | 否   | 当前logoKey是否处于按下状态 <br/>ture表示处于按下状态，false表示处于抬起状态。    |
61| fnKey       | boolean  | 是   | 否   | 当前fnKey是否处于按下状态 <br/>ture表示处于按下状态，false表示处于抬起状态。      |
62| capsLock    | boolean  | 是   | 否   | 当前capsLock是否处于激活状态 <br/>ture表示处于激活状态，false表示处于未激活状态。   |
63| numLock     | boolean  | 是   | 否   | 当前numLock是否处于激活状态 <br/>ture表示处于激活状态，false表示处于未激活状态。    |
64| scrollLock  | boolean  | 是   | 否   | 当前scrollLock是否处于激活状态 <br/>ture表示处于激活状态，false表示处于未激活状态。 |
65