MapWindowPoints

MapWindowPoints 関数は点のセットをあるウィンドウの座標空間から別のウィンドウの座標空間に変換する。

MapWindowPoints hWndFrom, hWndTo, lpPoints, cPoints

hWndFrom : [intptr] 点を変換する元のウィンドウへのハンドル。NULL または HWND_DESKTOP の場合、点はスクリーン座標とみなされる。
hWndTo : [intptr] 点を変換する先のウィンドウへのハンドル。NULL または HWND_DESKTOP の場合、点はスクリーン座標に変換される。
lpPoints : [var] 変換する点のセットを含む POINT 構造体の配列へのポインタ。点はデバイス単位。RECT 構造体を指すこともでき、その場合 cPoints は 2 に設定する。
cPoints : [int] lpPoints が指す配列内の POINT 構造体の数。

(プラグイン / モジュール : user32.dll)

解説

MapWindowPoints 関数は点のセットをあるウィンドウの座標空間から別のウィンドウの座標空間に変換する。

[戻り値]

関数が成功した場合、戻り値の下位ワードは各ソース点の水平座標に加算されるピクセル数。上位ワードは垂直座標に加算されるピクセル数。関数が失敗した場合、戻り値は
0。

[備考]
hWndFrom または hWndTo(あるいは両方)がミラー化ウィンドウ(WS_EX_LAYOUTRTL 拡張スタイル)で、正確に 2
点が lpPoints に渡された場合、MapWindowPoints はそれらを RECT として解釈し、left が right
より大きくならないよう自動的に入れ替える可能性がある。

情報