js-apis-keyevent.md 2.3 KB
Newer Older
S
shaoziyun 已提交
1 2
# 按键输入事件

H
hungry_feiwei 已提交
3
KeyEvent模块提供了设备可以上报的按键事件。
S
m11  
shaoziyun 已提交
4

H
HelloCrease 已提交
5 6
>  **说明:**
>
S
m11  
shaoziyun 已提交
7 8 9 10
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

## 导入模块

S
shaoziyun 已提交
11
```js
12
import {Action, Key, KeyEvent} from '@ohos.multimodalInput.keyEvent';
S
m11  
shaoziyun 已提交
13 14
```

S
shaoziyun 已提交
15
## Action
S
m11  
shaoziyun 已提交
16

H
HelloCrease 已提交
17
**系统能力**:SystemCapability.MultimodalInput.Input.Core
S
m11  
shaoziyun 已提交
18

19 20 21 22 23
| 名称   | 参数类型 | 可读 | 可写 | 描述     |
| ------ | -------- | ---- | ---- | -------- |
| CANCEL | number   | 是   | 否   | 取消按钮 |
| DOWN   | number   | 是   | 否   | 按下按钮 |
| UP     | number   | 是   | 否   | 抬起按钮 |
S
m11  
shaoziyun 已提交
24

S
shaoziyun 已提交
25
## Key
S
m11  
shaoziyun 已提交
26

H
HelloCrease 已提交
27
**系统能力**:SystemCapability.MultimodalInput.Input.Core
S
m11  
shaoziyun 已提交
28

29 30 31 32 33
| 名称        | 参数类型 | 可读 | 可写 | 描述           |
| ----------- | -------- | ---- | ---- | -------------- |
| code        | KeyCode  | 是   | 否   | 按键码         |
| pressedTime | number   | 是   | 否   | 按下持续的时间 |
| deviceId    | number   | 是   | 否   | 按键所属设备   |
S
m11  
shaoziyun 已提交
34

S
shaoziyun 已提交
35
## KeyEvent
S
m11  
shaoziyun 已提交
36

H
HelloCrease 已提交
37 38
**系统能力**:SystemCapability.MultimodalInput.Input.Core

39 40 41 42 43 44 45 46 47 48 49 50 51 52
| 名称        | 参数类型 | 可读 | 可写 | 描述                           |
| ----------- | -------- | ---- | ---- | ------------------------------ |
| action      | Action   | 是   | 否   | 按键动作                       |
| key         | Key      | 是   | 否   | 当前发生变化的按键             |
| unicodeChar | number   | 是   | 否   | 按键对应的uniCode字符          |
| keys        | Key[]    | 是   | 否   | 当前处于按下状态的按键列表     |
| ctrlKey     | boolean  | 是   | 否   | 当前ctrlKey是否处于按下状态    |
| altKey      | boolean  | 是   | 否   | 当前altKey是否处于按下状态     |
| shiftKey    | boolean  | 是   | 否   | 当前shiftKey是否处于按下状态   |
| logoKey     | boolean  | 是   | 否   | 当前logoKey是否处于按下状态    |
| fnKey       | boolean  | 是   | 否   | 当前fnKey是否处于按下状态      |
| capsLock    | boolean  | 是   | 否   | 当前capsLock是否处于激活状态   |
| numLock     | boolean  | 是   | 否   | 当前numLock是否处于激活状态    |
| scrollLock  | boolean  | 是   | 否   | 当前scrollLock是否处于激活状态 |