GetWindowRect 関数 (winuser.h)
指定したウィンドウの外接する四角形の寸法を取得します。 寸法は、画面の左上隅を基準とした画面座標で指定されます。
構文
BOOL GetWindowRect(
[in] HWND hWnd,
[out] LPRECT lpRect
);
パラメーター
[in] hWnd
型: HWND
ウィンドウへのハンドル。
[out] lpRect
型: LPRECT
ウィンドウの左上隅と右下隅の画面座標を受け取る RECT 構造体へのポインター。
戻り値
種類: BOOL
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
RECT 構造体の規則に準拠して、返される四角形の右下の座標は排他的です。 つまり、(右、 下) のピクセルは四角形のすぐ外側にあります。
GetWindowRect は DPI 用に仮想化されます。
Windows Vista 以降では、Window Rect にドロップ シャドウによって占有される領域が含まれるようになりました。
GetWindowRect を呼び出すと、ウィンドウが表示されたかどうかによって動作が異なります。 ウィンドウが表示されていない場合、GetWindowRect にはドロップ シャドウの領域は含まれません。
ドロップ シャドウを除くウィンドウ境界を取得するには、 DwmGetWindowAttribute を使用 して、DWMWA_EXTENDED_FRAME_BOUNDSを指定します。 Window Rect とは異なり、DWM 拡張フレーム境界は DPI に合わせて調整されないことに注意してください。 拡張フレーム境界の取得は、ウィンドウが少なくとも 1 回表示された後にのみ実行できます。
例
例については、「 ダイアログ ボックスの初期化」を参照してください。
要件
| サポートされている最小のクライアント | 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-0 (Windows 8 で導入) |
関連項目
概念
リファレンス