名称

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もしあるならば、ポインタが存在する子ウィンドウを返します。

displayX サーバへのコネクションを指定します。

mask_returnモディファイアキーとポインタボタンの現在の状態を返します。

root_returnポインタが存在するルートウィンドウを返します。

root_x_return

root_y_return
ルートウィンドウの原点に相対するポインタ座標を返します。

wそのウィンドウを指定します。

win_x_return

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

解説

XQueryPointer 関数は、ポインタが論理的に存在するルートウィンドウおよびそのルート ウィンドウの原点に相対するポインタ座標を返します。 XQueryPointer が False を返した場合は、ポインタは、指定されたウィンドウと同じスクリーン上に 存在しません。そして、 XQueryPointer は、 None を child_return へ、0 を win_x_return および win_y_return へ返します。 XQueryPointer が、 True を返した場合は、win_x_return および win_y_return に返されたポインタ座標は指定されたウィンドウの原点に相対しています。 この場合、 XQueryPointer は、そのポインタを含む子ウィンドウがあればそれを返し、 そうでなければ None を child_return へ返します。 XQueryPointer は、 mask_return 中のキーボードボタンとモディファイアキーの現在の論理状態を返します。 XQueryPointer は、マウスボタンとモディファイアキーの現在の状態を一致させるために、 mask_return を 1 つ以上のボタンまたはモディファイアキーのビットマスクの (内包的) 論理和へ設定します。 XQueryPointer は、 BadWindow エラーを生じることがあります。

診断

BadWindow
Window 引数の値が、定義された Window を指さない。

関連事項

XGetWindowAttributes(3X11), XQueryTree(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R