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

関連項目

概念

GetClientRect

リファレンス

ScreenToClient

Setwindowpos

Windows