Nhấn giữ một phím trên bàn phím phần cứng (:down)

Phương thức này có sẵn trong các phiên bản sau 20260805

Khai báo

thành công hay không, thông báo lỗi = đối tượng bàn phím phần cứng:down(mã phím)
thành công hay không, thông báo lỗi = đối tượng bàn phím phần cứng:down(Usage_Page, Usage_ID)

Tham số

• mã phím
  Chuỗi. Sử dụng cùng bảng ánh xạ tên phím như key.press.
• Usage Page
  Số nguyên. Các đối tượng bàn phím phần cứng hiện tại chỉ chấp nhận Trang Sử dụng của Bàn Phím/Phím Bấm 0x07.
• Usage ID
  Số nguyên. Biểu tượng vật lý của phím, không phải mã hóa ký tự.

Giá trị trả về

• thành công hay không
  Boolean. Trả về true khi phím được giữ thành công và false khi thất bại.
• thông báo lỗi
  Chuỗi. Thông báo lỗi được trả về khi gửi thất bại.

Mô tả

Nhấn giữ một phím trên bàn phím phần cứng. Gọi phương thức tương ứng :up sau đó để thả nó.

• Nếu cùng một bàn phím đang chạy một chuỗi :press hoặc :send_text, phương thức này sẽ trả về false, "hardware keyboard is busy".
• Có thể giữ tối đa sáu phím thường cùng lúc; các phím bổ trợ không được tính vào giới hạn này.
• Khi thất bại, phương thức sẽ trả về false và một thông báo lỗi. Nó không được thử lại thông qua một phương thức đầu vào khác.

Ví dụ

local keyboard = assert(key.connect_keyboard())

assert(keyboard:press(0x07, 4))       -- Bàn phím A
assert(keyboard:down(0x07, 0xE1))    -- Phím Shift trái
assert(keyboard:up(0x07, 0xE1))

assert(keyboard:disconnect())