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 で導入)

こちらもご覧ください

ClientToScreen

座標空間と変換関数

座標スペースと変換の概要

MapWindowPoints

ポイント