メインコンテンツまでスキップ

! グローバルハードウェアキーボードを接続する (key.connect_global_keyboard)

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

宣言​

ハードウェアキーボードオブジェクト, エラー情報 = key.connect_global_keyboard([設定プロパティ])

引数​

  • 設定プロパティ テーブル型の省略可能な引数。key.connect_keyboard と同じデフォルトプロパティと制約を使用します。

戻り値​

  • ハードウェアキーボードオブジェクト 接続に成功した場合はハードウェアキーボードオブジェクト、失敗した場合は nil を返します。
  • エラー情報 文字列型。接続に失敗した場合はエラー情報を返します。

接続に失敗した場合、戻り値の組み合わせは nil, error になります。

説明​

グローバルハードウェアキーボードを作成して接続します。接続の待機中は暗黙的に実行権を譲るため、関数が戻る前に別のスレッドが実行される場合があります。

  • 接続後は、既存の key.press、key.down、key.up、key.send_text および key(...):press/down/up による通常キーボードとテンキーのキー入力が、このオブジェクトを経由します
  • メディアキーとベンダー定義キーは従来どおりに動作します
  • グローバルハードウェアキーボードがない場合、既存インターフェースの動作は変わりません。
  • key.down と対応する key.up の組み合わせは維持されます。呼び出しの間に接続状態が変化しても、入力が重複したり、誤ってキーを解放したりすることはありません
  • 同時に接続できるグローバルハードウェアキーボードは一台だけです。接続処理中に再度呼び出した場合や、すでにグローバルハードウェアキーボードが接続されている状態で再接続した場合は失敗を返します。

使用例​

local keyboard, err = key.connect_global_keyboard({
    Product = "XXTouch Keyboard",
})
assert(keyboard, err)

key.press("A")
key.send_text("Hello")

local current = key.get_global_keyboard()
assert(current == keyboard)

assert(key.disconnect_global_keyboard())