書式

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

最初に設定するバリュエータを指定する。 バリュエータには 0 から始まる番号が付けられている。

num_valuators

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

説明

XSetDeviceValuators リクエストは入力デバイスのバリュエータの現在値を設定する。 first_valuator 番目から (first_valuator + num_valuators) 番目の バリュエータに指定した値が設定される。 バリュエータの番号は 0 から付けられる。 必ずしも全ての入力デバイスがバリュエータの値の初期化に対応している わけではない。 バリュエータの初期化に対応していないデバイスにこのリクエストを送った場合は、 エラー BadMatch となる。

リクエストが成功した場合、ステータス Success が返される。 他のクライアントがそのデバイスをグラブしていた場合は、 ステータス AlreadyGrabbed が返される。

XSetDeviceValuators はエラー BadLength, BadDevice , BadMatch, BadValue を起こすことがある。

返り値

BadDevice

不正なデバイスが指定された。指定したデバイスが存在しないか、指定したデ イスがクライアントの XOpenInputDevice によってオープンされていな い。

BadMatch

このエラーは、バリュエータが無く、移動の軸を通知できないデバイスを
 XSetDeviceValuators リクエストで指定した場合か、 バリュエータの初期化に対応していないデバイスをこのリクエストで 指定した場合に起きる。

BadValue

不正な first_valuator あるいは num_valuators が返された。