AdjustWindowRectEx 函式 (winuser.h)

根據用戶端矩形所需的大小,計算視窗矩形的必要大小。 然後,視窗矩形可以傳遞至 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

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

用戶端矩形是完全括住工作區的最小矩形。 視窗矩形是完全括住視窗的最小矩形,其中包含工作區和非客戶端區域。

當功能表欄換行至兩個或多個數據列時, AdjustWindowRectEx 函式不會新增額外的空間。

AdjustWindowRectEx 函式不會將WS_VSCROLLWS_HSCROLL樣式納入考慮。 若要考慮滾動條,請使用SM_CXVSCROLLSM_CYHSCROLL呼叫 GetSystemMetrics 函式。

此 API 不是 DPI 感知,而且如果呼叫線程是每一監視器 DPI 感知,則不應該使用。 如需此 API 的 DPI 感知版本,請參閱 AdjustWindowsRectExForDPI。 如需 DPI 感知的詳細資訊,請參閱 Windows High DPI 檔。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-window-l1-1-0 (於 Windows 8)

另請參閱

AdjustWindowsRectExForDPI

概念

CreateWindowEx

其他資源

矩形

參考

Windows