跳至主要內容

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