GetWindowRect 함수(winuser.h)

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

문법

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

매개 변수

[in] hWnd

형식: HWND

창에 대한 핸들입니다.

[out] lpRect

형식: LPRECT

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

반환 값

형식: BOOL

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

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

비고

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

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

Windows Vista 이상에서는 이제 창 사각형에 보이지 않는 크기 조정 테두리가 포함될 수 있습니다.

보이지 않는 크기 조정 테두리를 포함하지 않고 표시되는 창 범위를 얻으려면 DwmGetWindowAttribute를 사용하여 DWMWA_EXTENDED_FRAME_BOUNDS 지정합니다. 창 사각형과 달리 DWM 확장 프레임 범위는 DPI에 대해 조정되지 않습니다.

예시

예를 들어 대화 상자 초기화를 참조하세요.

요구 사항

참고하십시오

개념적인

GetClientRect

참조

ScreenToClient

SetWindowPos

Windows