名称

XChangeKeyboardControl, XGetKeyboardControl, XAutoRepeatOn, XAutoRepeatOff, XBell, XQueryKeymap, XKeyboardControl − キーボードの設定と制御構造を 操作する

形式

XChangeKeyboardControl(display, value_mask, values)
      Display ∗display;
      unsigned long value_mask;
      XKeyboardControl ∗values; XGetKeyboardControl(display, values_return)
      Display ∗display;
      XKeyboardState ∗values_return; XAutoRepeatOn(display)
      Display ∗display; XAutoRepeatOff(display)
      Display ∗display; XBell(display, percent)
      Display ∗display;
      int percent; XQueryKeymap(display, keys_return)
      Display ∗display;
      char keys_return[32];

引数

displayX サーバへのコネクションを指定します。

keys_returnどのキーが押されたかを示すバイト配列を返します。 各ビットは、キーボードの１キーを表します。

percentベルの音量 (−100 〜 100) を指定します。

valuesマスク内で１に設定されたビットに対応する制御値を指定します。

value_maskどの制御を変更するかを指定します。 このマスクは、有効な制御マスクのビット単位の（内包的）論理和です。

values_return
指定された XKeyboardState 構造体に現在のキーボード制御値を返します。

解説

XChangeKeyboardControl 関数は、 XKeyboardControl 構造体で定義されたキーボード特性を制御します。 value_mask 引数は、どの値を変更するかを指定します。 XChangeKeyboardControl の返しうるエラーは、 BadMatch および BadValue です。 XGetKeyboardControl 関数は、 XKeyboardState 構造体にキーボードの現在の制御値を返します。 XAutoRepeatOn 関数は、指定されたディスプレイでキーボードのオートリピートを オンにします。 XAutoRepeatOff 関数は、指定されたディスプレイでキーボードのオートリピートを オフにします。 XBell 関数は、可能であれば指定されたディスプレイでキーボードのベルを 鳴らします。 指定された音量は、キーボードの基本音量に対する相対値です。 percent 引数の値が −100 〜 100 の範囲になければ、 BadValue エラーが生じます。 percent 引数が負数以外のときのベルの音量は、下式で表します。

基本音量 − [(基本音量 ∗ percent) / 100] + percent percent 引数が負数のときのベルの音量は、下式で表します。

基本音量 + [(基本音量 ∗ percent) / 100] ベルの基本音量を変更するには、 XChangeKeyboardControl を使用します。 XBell の返しうるエラーは、 BadValue です。 XQueryKeymap 関数は、キーボードの論理状態をビットベクトルで返します。 ここで 1 に設定された各ビットは、現在それに対応するキーが 押されていることを表します。 ベクトルは、32 バイトで表します。 バイト N (0 から) は、キー 8N 〜 8N + 7 に対応するビットを含んでおり、 バイトの最下位ビットは、キー 8N を表します。 なお、デバイスの論理状態（クライアントアプリケーションから見た）は、 デバイスのイベント処理がフリーズされている場合、物理状態に遅れを 生じうることに注意してください。

診断

BadMatch ある引数またはひと組の引数の型と範囲は正しいが、リクエストにより 要求されたその他のなにかが一致しない。

BadValue ある数値が許容範囲を超えた。 引数の値の範囲が明示されない限り、引数の型によって決まる最大の範囲まで 指定可能です。 選択形式の引数も、このエラーを生じることがあります。

関連事項

XChangeKeyboardMapping(3X11), XSetPointerMapping(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.1C