名称

XWarpPointer - ポインタを移動する

形式

XWarpPointer(display, src_w, dest_w, src_x, src_y, src_width, src_height, dest_x,
                dest_y)
        Display ∗display;
        Window src_w, dest_w;
        int src_x, src_y;
        unsigned int src_width, src_height;
        int dest_x, dest_y;

引数

dest_wデスティネーションウィンドウ、または、 None を指定します。

dest_x

dest_yデスティネーションウィンドウ内の x と y 座標を指定します。

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

src_x

src_y

src_width

src_heightソースウィンドウ内の矩形を指定します。

src_wソースウィンドウ、または、 None を指定します。

解説

dest_w が None の場合、 XWarpPointer は、ポインタの現在の位置からの相対アドレス (dest_x, dest_y) に、ポイ ンタを移動します。 dest_w が、ウィンドウの場合は、 XWarpPointer は、そのウィンドウの相対アドレス (dest_x, dest_y) へ、ポインタを移動 します。 ただし、src_w がウィンドウの場合は、その移動は、 src_w ウィンドウがポインタを含んでいる場合か、 そのポインタが指定された矩形 src_w に含まれる場合にだけ、行われます。 src_x と src_y 座標は、src_w 上の相対アドレスです。 src_height が 0 の場合、 それは、src_w の高さから src_y を引いたものに置換されます。 src_width が 0 の場合、 それは、src_w の幅から src_x を引いたものに置換されます。 この関数は、あまり使われません。 ポインタは、通常ユーザが自由に動かします。 ただし、この関数を使用した場合は、ユーザが即時にポインタを、ある 場所から別の場所へ、移動したかのようなイベントが発生します。 なお、 XWarpPointer を使用して、 アクティブなポインタを、グラブする制限付きのウィンドウの外に、ポイン タを移動することは、できないことに注意してください。 これを実行しても、ポインタは、そのウィンドウのエッジのすれすれのとこ ろまで移動するだけです。 XWarpPointer は、 BadWindow エラーを生じることがあります。

診断

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

関連事項

XSetInputFocus(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R