GetClientRect 함수(winuser.h)

  • 아티클

창 클라이언트 영역의 좌표를 검색합니다. 클라이언트 좌표는 클라이언트 영역의 왼쪽 위와 오른쪽 아래 모서리를 지정합니다. 클라이언트 좌표는 창 클라이언트 영역의 왼쪽 위 모서리를 기준으로 하기 때문에 왼쪽 위 모서리의 좌표는 (0,0)입니다.

구문

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

매개 변수

[in] hWnd

형식: HWND

클라이언트 좌표를 검색할 창에 대한 핸들입니다.

[out] lpRect

형식: LPRECT

클라이언트 좌표를 수신하는 RECT 구조체에 대한 포인터입니다. 왼쪽 및 위쪽 멤버는 0입니다. 오른쪽 및 아래쪽 멤버에는 창의 너비와 높이가 포함됩니다.

반환 값

형식: BOOL

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

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

설명

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

예제

예를 들어 자식 창 만들기, 열거 및 크기 조정을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 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 도입)

추가 정보

개념

GetWindowRect

기타 리소스

RECT

참조

Windows