AdjustWindowRectEx 関数 (winuser.h)

[アーティクル]
08/27/2023

クライアントの四角形の目的のサイズに基づいて、ウィンドウの四角形の必要なサイズを計算します。その後、ウィンドウの四角形を CreateWindowEx 関数に渡して、クライアント領域が目的のサイズのウィンドウを作成できます。

構文

BOOL AdjustWindowRectEx(
  [in, out] LPRECT lpRect,
  [in]      DWORD  dwStyle,
  [in]      BOOL   bMenu,
  [in]      DWORD  dwExStyle
);

パラメーター

[in, out] lpRect

種類: LPRECT

目的のクライアント領域の左上隅と右下隅の座標を含む RECT 構造体へのポインター。関数が戻ると、構造体には、目的のクライアント領域に合わせてウィンドウの左上隅と右下隅の座標が含まれます。

[in] dwStyle

型: DWORD

必要なサイズを計算するウィンドウのウィンドウスタイル。 WS_OVERLAPPEDスタイルは指定できないことに注意してください。

[in] bMenu

種類: BOOL

ウィンドウにメニューがあるかどうかを示します。

[in] dwExStyle

型: DWORD

必要なサイズを計算するウィンドウの拡張ウィンドウスタイル。

戻り値

種類: BOOL

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

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

解説

クライアントの四角形は、クライアント領域を完全に囲む最小の四角形です。ウィンドウの四角形は、クライアント領域と非クライアント領域を含む、ウィンドウを完全に囲む最小の四角形です。

AdjustWindowRectEx 関数は、メニューバーが 2 つ以上の行に折り返されるときに余分な領域を追加しません。

AdjustWindowRectEx 関数は、WS_VSCROLLまたはWS_HSCROLLスタイルを考慮しません。スクロールバーを考慮するには、SM_CXVSCROLLまたはSM_CYHSCROLLを使用して GetSystemMetrics 関数を呼び出します。

この API は DPI 対応ではなく、呼び出し元のスレッドがモニターごとの DPI 対応の場合は使用しないでください。この API の DPI 対応バージョンについては、「 AdjustWindowsRectExForDPI」を参照してください。 DPI 対応の詳細については、 Windows High DPI のドキュメントを参照してください。

要件

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