ClientToScreen 함수(winuser.h)

아티클
03/09/2024

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

구문

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

매개 변수

[in] hWnd

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

[in, out] lpPoint

변환할 클라이언트 좌표를 포함하는 POINT 구조체에 대한 포인터입니다. 함수가 성공하면 새 화면 좌표가 이 구조체로 복사됩니다.

반환 값

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

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

설명

ClientToScreen 함수는 POINT 구조의 클라이언트 영역 좌표를 화면 좌표로 바꿉니다. 화면 좌표는 화면의 왼쪽 위 모서리를 기준으로 합니다. 창의 클라이언트 영역 위에 있는 화면 좌표 지점에는 음의 y 좌표가 있습니다. 마찬가지로 클라이언트 영역 왼쪽의 화면 좌표에는 음의 x 좌표가 있습니다.

모든 좌표는 디바이스 좌표입니다.

예제

예제는 마우스 입력 사용에서 "마우스로 선 그리기"를 참조하세요.

요구 사항

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