跳至主要內容

按下硬體鍵盤按鍵 (:down)

該方法在 20260805 以後版本方可使用

聲明​

是否成功, 錯誤資訊 = 硬體鍵盤物件:down(按鍵碼)
是否成功, 錯誤資訊 = 硬體鍵盤物件:down(Usage_Page, Usage_ID)

參數​

  • 按鍵碼
    文字型，與 key.press 使用同一份按鍵名稱映射。
  • Usage Page
    整數型，目前硬體鍵盤物件只接受 Keyboard/Keypad Usage Page 0x07。
  • Usage ID
    整數型，物理按鍵編號，不是字元編碼。

回傳值​

  • 是否成功
    布林型，發送成功時返回 true，失敗時返回 false。
  • 錯誤資訊
    文字型，發送失敗時返回錯誤資訊。

說明​

按下一個硬體鍵盤按鍵。按下後應呼叫對應的 :up 釋放按鍵。

  • 同一鍵盤正在執行 :press 或 :send_text 序列時，本方法返回 false, "hardware keyboard is busy"。
  • 同一時間最多按住 6 個普通按鍵，修飾鍵不計入；超過限制時目標系統無法識別具體按鍵。
  • 發送失敗時返回 false 和錯誤資訊，不會自動改用其它輸入方式重試。

範例​

local keyboard = assert(key.connect_keyboard())

assert(keyboard:press(0x07, 4))       -- Keyboard A
assert(keyboard:down(0x07, 0xE1))    -- Left Shift
assert(keyboard:up(0x07, 0xE1))

assert(keyboard:disconnect())