ScreenToClient 関数 (winuser.h)
ScreenToClient 関数は、画面上の指定したポイントの画面座標をクライアント領域の座標に変換します。
構文
BOOL ScreenToClient(
[in] HWND hWnd,
LPPOINT lpPoint
);
パラメーター
[in] hWnd
変換にクライアント領域が使用されるウィンドウへのハンドル。
lpPoint
変換する画面座標を指定する POINT 構造体へのポインター。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。
注釈
関数は、 hWnd パラメーターで識別されるウィンドウと POINT 構造体で指定された画面座標を使用して、クライアント座標を計算します。 次に、画面座標をクライアント座標に置き換えます。 新しい座標は、指定したウィンドウのクライアント領域の左上隅を基準にしています。
ScreenToClient 関数は、指定したポイントが画面座標内にあると見なします。
すべての座標はデバイス単位です。
ミラーリングの状況では ScreenToClient を使用しないでください。つまり、左から右のレイアウトから右から左へのレイアウトに変更する場合は使用しないでください。 代わりに、 MapWindowPoints を使用します。 詳細については、「ウィンドウ の機能」の「ウィンドウ レイアウトとミラーリング」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-window-l1-1-2 (Windows 10 バージョン 10.0.10240 で導入) |