名称

XChangePointerDevice − X ポインタであるデバイスを変更する

形式

Status XChangePointerDevice(display, device xaxis, yaxis)
      Display ∗display;
      XDevice ∗device;
      int xaxis;
      int yaxis;

引数

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

device X ポインタとして使用するデバイスを指定する。

xaxis X ポインタの x 軸として使用するデバイスの軸を指定する。

yaxis X ポインタの y 軸として使用するデバイスの軸を指定する。

解説

XChangePointerDevice は X ポインタとして指定のデバイスを サーバが使うようにします。 リクエストを行うクライアントは XOpenDevice を使って あらかじめこのデバイスをオープンしておく必要があります。 そうでなければ、 BadDevice エラーが発生します。 デバイスは入力クラス Valuators をサポートしていなければなりません。 そうでなければ、 BadMatch エラーが発生します。 サーバインプリメンテーションが X ポインタとして指定デバイスの使用を サポートしていない場合、 BadDevice エラーが発生します。

指定したデバイスが別のクライアントにグラブされている場合、 AlreadyGrabbed が返されます。 指定デバイスが別のデバイス上のグラブによってフリーズされている場合、 GrabFrozen が返されます。 リクエストが成功した場合、 Success が返されます。

リクエストが成功した場合、 ChangeDeviceNotify イベントが このイベントを選択した全てのクライアントに対して、 送られます。 リクエストに対する MappingNotify 即ち MappingPointer イベントが全てのクライアントに送られます。 指定デバイスが X ポインタになり、 以前の X ポインタはインプット エクステンション プロトコル リクエストに よってアクセス可能になります。

XChangePointerDevice は BadDevice または BadMatch エラーを生成します。

診断

BadDevice 無効デバイスが指定された。 指定したデバイスが存在しない、 まだクライアントによって XOpenInputDevice でオープンされてない、 または 指定されたデバイスはすでに コア X インプット デバイス （ポインタまたは キーボード）の一つである。 サーバインプリメンテーションが指定した デバイスを X ポインターとして使用することを サポートしていない場合にも、このエラーが発生することがあります。

BadMatch XChangePointerDevice リクエストで２つ未満の バリュエータしか持たないデバイスを指定したとき、 またはデバイスがサポートする範囲を超えた バリュエータインデックスを指定した場合、 このエラーが発生することがありあます。

関連事項

XChangeKeyboardDevice(3XI)
Programming With Xlib

NEWS-OSRelease 4.2.1R