ClipCursor 함수(winuser.h)

커서를 화면의 사각형 영역으로 제한합니다. SetCursorPos 함수 또는 마우스로 설정된 후속 커서 위치가 사각형 외부에 있는 경우 시스템은 사각형 영역 내부에 커서를 유지하도록 위치를 자동으로 조정합니다.

구문

BOOL ClipCursor(
  [in, optional] const RECT *lpRect
);

[in, optional] lpRect

형식: const RECT*

제한된 사각형의 왼쪽 위와 오른쪽 아래 모서리의 화면 좌표를 포함하는 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 커서가 화면의 아무 곳이나 자유롭게 이동할 수 있습니다.

형식: BOOL

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

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

커서는 공유 리소스입니다. 애플리케이션이 커서를 제한하는 경우 컨트롤을 다른 애플리케이션에 포기하기 전에 ClipCursor 를 사용하여 커서를 해제해야 합니다.

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

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll