跳到主要内容

松开硬件键盘按键 (:up)

该方法在 20260805 以后版本方可使用

声明​

是否成功, 错误信息 = 硬件键盘对象:up(按键码)
是否成功, 错误信息 = 硬件键盘对象:up(Usage_Page, Usage_ID)

参数​

  • 按键码 文本型，与 key.press 使用同一份按键名称映射。
  • Usage Page 整数型，当前硬件键盘对象只接受 Keyboard/Keypad Usage Page 0x07。
  • Usage ID 整数型，物理按键编号，不是字符编码。

返回值​

  • 是否成功 布尔型，发送成功时返回 true，失败时返回 false。
  • 错误信息 文本型，发送失败时返回错误信息。

说明​

松开一个之前由 :down 按下的硬件键盘按键。

同一键盘正在执行 :press 或 :send_text 序列时，本方法返回 false, "hardware keyboard is busy"。发送失败时不会自动改用其它输入方式重试。

示例​

local keyboard = assert(key.connect_keyboard())

assert(keyboard:down("LEFTSHIFT"))
assert(keyboard:up("LEFTSHIFT"))

assert(keyboard:disconnect())