松開硬體鍵盤按鍵 (: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())