ScreenToClient 함수(winuser.h)

ScreenToClient 함수는 화면에서 지정된 지점의 화면 좌표를 클라이언트 영역 좌표로 변환합니다.

구문

BOOL ScreenToClient(
  [in] HWND    hWnd,
       LPPOINT lpPoint
);

[in] hWnd

변환에 클라이언트 영역을 사용할 창에 대한 핸들입니다.

lpPoint

변환할 화면 좌표를 지정하는 POINT 구조체에 대한 포인터입니다.

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

함수가 실패하면 반환 값은 0입니다.

함수는 hWnd 매개 변수로 식별된 창과 POINT 구조에 지정된 화면 좌표를 사용하여 클라이언트 좌표를 계산합니다. 그런 다음 화면 좌표를 클라이언트 좌표로 바꿉니다. 새 좌표는 지정된 창의 클라이언트 영역의 왼쪽 위 모서리를 기준으로 합니다.

ScreenToClient 함수는 지정된 점이 화면 좌표에 있다고 가정합니다.

모든 좌표는 디바이스 단위로 표시됩니다.

미러링 상황에서 왼쪽에서 오른쪽 레이아웃에서 오른쪽에서 왼쪽 레이아웃으로 변경하는 경우 ScreenToClient 를 사용하지 마세요. 대신 MapWindowPoints를 사용합니다. 자세한 내용은 창 기능의 "창 레이아웃 및 미러링"을 참조 하세요.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-window-l1-1-2(Windows 10 버전 10.0.10240에 도입됨)