GetClientRect 関数 (winuser.h)

  • [アーティクル]

ウィンドウのクライアント領域の座標を取得します。 クライアント座標は、クライアント領域の左上隅と右下隅を指定します。 クライアント座標はウィンドウのクライアント領域の左上隅を基準とするため、左上隅の座標は (0,0) になります。

構文

BOOL GetClientRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect
);

パラメーター

[in] hWnd

型: HWND

クライアント座標を取得するウィンドウのハンドル。

[out] lpRect

種類: LPRECT

クライアント座標を受け取る RECT 構造体へのポインター。 左と上のメンバーは 0 です。 右側と下部のメンバーには、ウィンドウの幅と高さが含まれます。

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

RECT 構造体の規則に準拠して、返される四角形の右下の座標は排他的です。 つまり、(右、 下) のピクセルは四角形のすぐ外側にあります。

例

たとえば、「 子ウィンドウの作成、列挙、サイズ変更」を参照してください。

要件

要件 値
サポートされている最小のクライアント 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 で導入)

関連項目

概念

GetWindowRect

その他のリソース

Rect

リファレンス

Windows