AdjustWindowRectEx 함수(winuser.h)

아티클
03/15/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 함수는 추가 공간을 추가하지 않습니다.

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 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-window-l1-1-0(Windows 8 도입)