XQueryPointer(3X11)

名前
XQueryPointer - ポインタの座標の取得

書式
Bool XQueryPointer(display, w, root_return, child_return, root_x_return, root_y_return,
                     win_x_return, win_y_return, mask_return)
      Display *display;
      Window w;
      Window *root_return, *child_return;
      int *root_x_return, *root_y_return;
      int *win_x_return, *win_y_return;
      unsigned int *mask_return;

引き数

child_return
    もしポインタが子ウィンドウの内部にあれば、そのウィンドウが返される。

display
    X サーバへの接続を指定。

mask_return
    モディファイアキーとポインタのボタンの現在の状態が返される。

root_return
    ポインタを含むルートウィンドウが返される。

root_x_return

root_y_return
    ルートウィンドウの原点に対する相対座標でポインタの座標が返される。

w   ウィンドウを指定。

win_x_return

win_y_return
    指定したウィンドウに対する相対座標でポインタの座標が返される。

説明
関数 はポインタが論理的に存在するルートウィンドウおよびポインタのルートウィ ンドウの原点からの相対座標を返す。 が を返した場合、ポインタは指定したウィンドウと同じスクリーン上には存在し ない。このとき、 は child_return に をセットし、win_x_return と win_y_return にゼロをセットする。 が を返した場合、win_x_return と win_y_return に返されるポインタの座標は 指定したウィンドウの原点に対する相対座標である。 この場合、 はポインタを含む子ウィンドウがあればこれを child_return に返し、そうで なければ を child_return に返す。

はキーボードのボタンとモディファイアキーの現在の論理的状態を mask_return に返す。 この関数は mask_return にボタンやモディファイアキーのビットマスクのビッ トごとの論理和をセットし、現在のマウスボタンとモディファイアキーの状態 にマッチさせる。

はエラー を起こすことがある。

返り値

引き数 Window の値が、定義されている Window を指していない。

関連項目
XGetWindowAttributes(3X11), XQueryTree(3X11)
Xlib - C Language X Interface