This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | |||
api:keyboard:zh [2023/10/14 17:46] hfsr [Keyboard API] translate |
api:keyboard:zh [2023/11/29 14:20] hfsr [Keyboard(键盘) API] |
||
---|---|---|---|
Line 1: | Line 1: | ||
Keyboard(键盘) API | Keyboard(键盘) API | ||
=========== | =========== | ||
- | 此API提供了利用`keyboard.keys`表以按键名查找按键编码的功能。此表可双向查询。例如,`keyboard.keys.numpad0`的值为`0x52`,而`keyboard.keys[0x52]`的值为字符串`numpad0`。 | + | 此API提供了利用`keyboard.keys`表以按键名查找按键编码的功能。 |
+ | 此表可双向查询。例如,`keyboard.keys.numpad0`的值为`0x52`,而`keyboard.keys[0x52]`的值为字符串`numpad0`。 | ||
请查阅[包含此API实现的Lua文件](https://github.com/MightyPirates/OpenComputers/blob/master-MC1.7.10/src/main/resources/assets/opencomputers/loot/openos/lib/keyboard.lua)以获取可用键名的列表。 | 请查阅[包含此API实现的Lua文件](https://github.com/MightyPirates/OpenComputers/blob/master-MC1.7.10/src/main/resources/assets/opencomputers/loot/openos/lib/keyboard.lua)以获取可用键名的列表。 | ||
- | 此外,此API还注册了事件侦听器以持续追踪每个按键的状态。这些内部状态值可以通过下列函数查阅: | + | 此外,此API还注册了事件侦听器以持续追踪每个按键的状态。这些内部状态值可以通过下列函数查询: |
- `keyboard.isAltDown(): boolean` | - `keyboard.isAltDown(): boolean` | ||
- | 检查Alt键是否正在被用户按住。 | + | 检查用户是否正按住任一Alt键。 |
+ | \\ | ||
- `keyboard.isControl(char: number): boolean` | - `keyboard.isControl(char: number): boolean` | ||
- | 检查指定字符(例如来源于键盘事件的返回值)是否为Java的`Character`类定义的控制字符。控制字符通常不可显示。 | + | 检查指定字符(例如来源于键盘事件的返回值)是否为Java的`Character`类定义的控制字符。控制字符通常不可显示。 |
+ | \\ | ||
- `keyboard.isControlDown(): boolean` | - `keyboard.isControlDown(): boolean` | ||
- | 检查是否有控制按键正在被用户按住。 | + | 检查用户是否正按住任一Ctrl键。 |
+ | \\ | ||
- `keyboard.isKeyDown(charOrCode: any): boolean` | - `keyboard.isKeyDown(charOrCode: any): boolean` | ||
- | 检查指定按键是否正在被用户按住。如果指定数字,则假定其为按键编号。如果指定字符串,则假定其为单个字符,例如键盘事件返回的字符。 | + | 检查用户是否正按住指定按键。若指定数字,则假定其为按键编号。若指定字符串,则假定其为单个字符,如键盘事件返回的字符。 |
+ | \\ | ||
- `keyboard.isShiftDown(): boolean` | - `keyboard.isShiftDown(): boolean` | ||
- | 检查shift键是否正在被用户按住。 | + | 检查用户是否正按住任一Shift键。 |
[keyboard]: https://github.com/MightyPirates/OpenComputers/assets/opencomputers/lua/rom/lib/keyboard.lua | [keyboard]: https://github.com/MightyPirates/OpenComputers/assets/opencomputers/lua/rom/lib/keyboard.lua |