SetCursorPos 함수(winuser.h)

아티클
03/04/2024

커서를 지정된 화면 좌표로 이동합니다. 새 좌표가 가장 최근 ClipCursor 함수 호출에 의해 설정된 화면 사각형 내에 없는 경우 시스템은 커서가 사각형 내에 유지되도록 좌표를 자동으로 조정합니다.

구문

BOOL SetCursorPos(
  [in] int X,
  [in] int Y
);

매개 변수

[in] X

형식: int

화면 좌표에서 커서의 새 x 좌표입니다.

[in] Y

형식: int

화면 좌표에서 커서의 새 y 좌표입니다.

반환 값

형식: BOOL

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

커서는 공유 리소스입니다. 창은 커서가 창의 클라이언트 영역에 있는 경우에만 커서를 이동해야 합니다.

호출 프로세스에는 창 스테이션에 대한 WINSTA_WRITEATTRIBUTES 액세스 권한이 있어야 합니다.

SetCursorPos를 호출할 때 입력 데스크톱은 현재 데스크톱이어야 합니다. OpenInputDesktop을 호출하여 현재 데스크톱이 입력 데스크톱인지 여부를 확인합니다. 그렇지 않은 경우 OpenInputDesktop에서 반환된 HDESK를 사용하여 SetThreadDesktop을 호출하여 해당 데스크톱으로 전환합니다.

예제

예제는 키보드를 사용하여 커서 이동을 참조하세요.

요구 사항

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