XWarpPointer(3X11)

名前
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
    対象となるウィンドウか を指定。

dest_x

dest_y
    対象ウィンドウ内での x, y 座標を指定。

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

src_x

src_y

src_width

src_height
    元のウィンドウ内での長方形を指定。

src_w
    元のウィンドウあるいは を指定。

説明
引き数 dest_w が の場合、 はポインタを現在の位置から相対的にオフセット(dest_x, dest_y)だけ移動さ せる。 dest_w がウィンドウの場合、 は dest_w の原点からオフセット(dest_x, dest_y)だけポインタを移動させる。 しかし、src_w がウィンドウの場合、 移動はウィンドウ src_w 内にポインタがあり、かつ src_w 内の指定した長 方形の内部にポインタがある場合に限りポインタの移動が行われる。

src_x と src_y 座標は src_w の原点からの相対座標である。 src_height がゼロの場合、これは現在の src_w の高さから src_y を引いた 値に置き換えられる。 src_width がゼロの場合、これは現在の src_w の幅から src_x を引いた値に 置き換えられる。

この関数を利用すべきことはほとんどない。 ポインタ操作は通常はユーザに委ねられるべきである。 それにもかかわらずこの関数を使う場合、ユーザがポインタをある位置から他 の位置に瞬間的に移動させたようなイベントが生成される。 をポインタをアクティブなポインタのグラブの制限ウィンドウ(confine_to window)の外に移動させるために使うことはできない。 そのように試みても、制限ウィンドウのもっとも近い外辺にポインタが移動す るだけである。

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

返り値

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

関連項目
XSetInputFocus(3X11)
Xlib - C Language X Interface