書式

Bool XTranslateCoordinates(display, src_w, dest_w, src_x, src_y, dest_x_return,

                            dest_y_return, child_return)

      Display *display;

      Window src_w, dest_w;

      int src_x, src_y;

      int *dest_x_return, *dest_y_return;

      Window *child_return;

引き数

child_return

座標が対象ウィンドウのマップされている子ウィンドウに含まれる場合、その 子ウィンドウが返される。

dest_w

対象ウィンドウを指定する。

dest_x_return

dest_y_return

対象ウィンドウ内部での x, y 座標が返される。

display

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

src_w

ソースウィンドウを指定する。

src_x

src_y

ソースウィンドウ内部での x, y 座標を指定する。

説明

XTranslateCoordinates が True を返した場合、この関数はソースウィンドウの原点に対する src_x, src_y 座標を受け取り、この座標を対象ウィンドウの原点に対する dest_x_return, dest_y_return として返す。 XTranslateCoordinates が False を返した場合、src_w と dest_w は異なるウィンドウ上にあり、 dest_x_return と dest_y_return には 0 が設定される。 もし、座標が ウィンドウ dest_w のマップされている子ウィンドウに含まれ ている場合、その子ウィンドウが chile_return に返される。 そうでなければ chile_return には None が設定される。

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

返り値

BadWindow

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