グローバルハードウェアキーボードを切断する (key.disconnect_global_keyboard)

この関数は 20260805 以降のバージョンでのみ使用できます

宣言

成功したかどうか, エラーメッセージ = key.disconnect_global_keyboard()

戻り値

• 成功したかどうか ブール値。切断に成功した場合、または現在グローバルハードウェアキーボードがない場合は true、失敗した場合は false を返します。
• エラーメッセージ 文字列。切断に失敗した場合にエラーメッセージを返します。

説明

すべてのキーを解放し、現在のグローバルハードウェアキーボードを切断します。切断後、既存のキーインターフェースは接続前の動作に戻ります。

• この関数は繰り返し呼び出すことができ、現在グローバルハードウェアキーボードがない場合も成功を返します。
• グローバルハードウェアキーボードが :press または :send_text シーケンスを実行している場合、切断すると false, "hardware keyboard is busy" を返します。
• key.down ですでに押されているキーは切断時に解放されます。その後、対応する key.up が入力を再送信することはありません。

例

local success, err = key.disconnect_global_keyboard()
assert(success, err)