名称

XSetDeviceValuators − 拡張入力デバイス上のバリュエータを初期化する

形式

XSetDeviceValuators(display, device, valuators, first_valuator, num_valuators)
      Display ∗display;
      XDevice ∗device;
      int ∗valuators;
      int first_valuator;
      int num_valuators;

引数

display X サーバとの接続を指定する。

device 初期化するバリュエータのデバイスを指定する。

valuators デバイスバリュエータを初期化するために使用する 整数値列へのポインタを指定する。

first_valuator
設定する最初のバリュエータを指定する。 バリュエータはゼロからナンバリングされます。

num_valuators
設定するバリュエータの数を指定する。

解説

XSetDeviceValuators リクエストは入力デバイスのバリュエータの カレントの値を設定します。 first_valuator から (first_valuator + num_valuators) の範囲のバリュエータは指定の値に設定されます。 バリュエータはゼロからナンバリングされます。 全ての入力デバイスがバリュエータの値の 初期化をサポートしているわけではありません。 このリクエストがバリュエータ初期化をサポートしていない デバイスに対して実行されると、 BadMatch エラーとなります。

リクエストが成功した場合、 成功のステータスが返されます。 別のクライアントがグラブされたデバイスを持つ場合、 AlreadyGrabbed (既にグラブ済み）のステータスが返されます。

XSetDeviceValuators は BadLength、BadDevice、BadMatch または BadValue エラーを生成します。

自己診断

BadDevice 無効デバイスが指定された。 指定デバイスが存在しない、 または XOpenInputDevice 経由にてクライアントから オープンされていない。

BadMatch バリュエータを持たないまたは動作の軸を報告しない デバイスを指定することで XSetDeviceValuators リクエスト が実行される場合、 またはそのようなリクエストがバリュエータ初期化を サポートしないデバイスを指定することで実行されるような 場合このエラーが発生します。

BadValue 無効な first_valuator または num_valuators の値が指定された。

関連事項

Programming with Xlib

NEWS-OSRelease 4.2.1R