XSetDeviceValuators(3X11)

名前
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 となる。

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

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

返り値

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

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

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

関連項目
Programming with Xlib