Nhập Văn bản (key.input_text)

Hàm này có sẵn trong các phiên bản sau 20260816

Khai báo

success, error = key.input_text(text [, press_enter_when_done ])

Tham số

• text Chuỗi. Văn bản UTF-8 để nhập. Nó có thể trống. Mỗi "\b" thực hiện một hành động Backspace.
• press_enter_when_done Boolean. Có nhấn Enter sau khi nhập văn bản hay không. Mặc định: false.

Giá trị trả về

• success Boolean. Trả về true khi thao tác nhập giả lập được gửi, hoặc false khi thất bại.
• error Chuỗi. Lý do lỗi khi thao tác thất bại.

Mô tả

Nhập văn bản vào trường tập trung của ứng dụng ở phía trước bằng cách mô phỏng cách một phương thức nhập văn bản xác nhận văn bản đã chọn.

Hàm này không đọc hoặc sửa đổi bảng dán chung của hệ thống.

Hàm này không thể nhập văn bản vào trường mật khẩu. Sử dụng sys.input_text cho trường mật khẩu.

Giá trị trả về true chỉ có nghĩa là thao tác nhập giả lập đã được gửi; nó không đảm bảo rằng trường mục tiêu đã chấp nhận văn bản.

Ví dụ

local ok, err = key.input_text("Hello, XXTouch 🙂")
assert(ok, err)
--
local ok, err = key.input_text("hello!\b", true)
assert(ok, err)