GetWindowRect 함수(winuser.h)

아티클
08/27/2023

지정된 창의 경계 사각형의 차원을 검색합니다. 차원은 화면의 왼쪽 위 모서리를 기준으로 하는 화면 좌표로 제공됩니다.

구문

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

매개 변수

[in] hWnd

형식: HWND

창에 대한 핸들입니다.

[out] lpRect

형식: LPRECT

창의 왼쪽 위와 오른쪽 아래 모서리의 화면 좌표를 받는 RECT 구조체에 대한 포인터입니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

RECT 구조체에 대한 규칙에 따라 반환된 사각형의 오른쪽 아래 좌표는 배타적입니다. 즉, (오른쪽, 아래쪽)의 픽셀은 사각형 바로 바깥쪽에 있습니다.

GetWindowRect는 DPI용으로 가상화됩니다.

Windows Vista 이상에서는 이제 창 사각형에 그림자가 차지하는 영역이 포함됩니다.

GetWindowRect를 호출하면 창이 표시되었는지 여부에 따라 다른 동작이 있습니다. 이전에 창이 표시되지 않은 경우 GetWindowRect에는 그림자 영역이 포함되지 않습니다.

그림자를 제외한 창 범위를 얻으려면 DwmGetWindowAttribute를 사용하여 DWMWA_EXTENDED_FRAME_BOUNDS 지정합니다. 창 사각형과 달리 DWM 확장 프레임 범위는 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에서 도입)