AdjustWindowRectEx

目的のクライアント矩形のサイズに基づいて、必要なウィンドウ矩形のサイズを計算する。計算結果のウィンドウ矩形は、目的のサイズのクライアント領域を持つウィンドウを作成するために CreateWindowEx 関数に渡せる。

AdjustWindowRectEx lpRect, dwStyle, bMenu, dwExStyle

lpRect : [var] 型: LPRECT 目的のクライアント領域の左上隅と右下隅の座標を含む RECT 構造体へのポインタ。関数の戻り時には、目的のクライアント領域を確保するためのウィンドウの左上隅と右下隅の座標が格納される。
dwStyle : [int] 型: DWORD 必要なサイズを計算する対象のウィンドウのウィンドウスタイル。WS_OVERLAPPED スタイルは指定できない点に注意。
bMenu : [int] 型: BOOL ウィンドウがメニューを持つかどうかを示す。
dwExStyle : [int] 型: DWORD 必要なサイズを計算する対象のウィンドウの拡張ウィンドウスタイル。

(プラグイン / モジュール : user32.dll)

解説

目的のクライアント矩形のサイズに基づいて、必要なウィンドウ矩形のサイズを計算する。計算結果のウィンドウ矩形は、目的のサイズのクライアント領域を持つウィンドウを作成するために
CreateWindowEx 関数に渡せる。

[戻り値]
型: BOOL 関数が成功した場合、戻り値は 0 以外。関数が失敗した場合、戻り値は 0。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]

クライアント矩形とは、クライアント領域を完全に内包する最小の矩形である。ウィンドウ矩形とは、クライアント領域および非クライアント領域を含むウィンドウ全体を完全に内包する最小の矩形である。AdjustWindowRectEx
関数は、メニューバーが 2 行以上に折り返される場合に余分な領域を加えない。AdjustWindowRectEx 関数は
WS_VSCROLL や WS_HSCROLL スタイルを考慮しない。スクロールバーを考慮する場合は、SM_CXVSCROLL または
SM_CYHSCROLL を指定して GetSystemMetrics 関数を呼ぶ。この API は DPI
対応ではなく、呼び出し元スレッドがモニタごとの DPI 対応である場合は使用すべきではない。DPI 対応版については
AdjustWindowsRectExForDPI を参照。DPI 対応の詳細については Windows High DPI
のドキュメントを参照。

情報