Differences

This shows you the differences between two versions of the page.

--- api:keyboard:zh [2023/10/14 17:46]
hfsr [Keyboard API] translate
+++ api:keyboard:zh [2023/11/29 14:20] (current)
hfsr [Keyboard(键盘) API]
@@ Line 1: / Line 1: @@
 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还注册了事件侦听器以持续追踪每个按键的状态。这些内部状态值可以通过下列函数查阅：
+此外，此API还注册了事件侦听器以持续追踪每个按键的状态。这些内部状态值可以通过下列函数查询：
 - `keyboard.isAltDown(): boolean`
-检查Alt键是否正在被用户按住。
+检查用户是否正按住任一Alt键。
+\\
 - `keyboard.isControl(char: number): boolean`
-检查指定字符(例如来源于键盘事件的返回值)是否为Java的`Character`类定义的控制字符。控制字符通常不可显示。
+检查指定字符（例如来源于键盘事件的返回值）是否为Java的`Character`类定义的控制字符。控制字符通常不可显示。
+\\
 - `keyboard.isControlDown(): boolean`
-检查是否有控制按键正在被用户按住。
+检查用户是否正按住任一Ctrl键。
+\\
 - `keyboard.isKeyDown(charOrCode: any): boolean`
-检查指定按键是否正在被用户按住。如果指定数字，则假定其为按键编号。如果指定字符串，则假定其为单个字符，例如键盘事件返回的字符。
+检查用户是否正按住指定按键。若指定数字，则假定其为按键编号。若指定字符串，则假定其为单个字符，如键盘事件返回的字符。
+\\
 - `keyboard.isShiftDown(): boolean`
-检查shift键是否正在被用户按住。
+检查用户是否正按住任一Shift键。
 [keyboard]: https://github.com/MightyPirates/OpenComputers/assets/opencomputers/lua/rom/lib/keyboard.lua