다음을 통해 공유


SetCursor 함수(winuser.h)

커서 셰이프를 설정합니다.

구문

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

매개 변수

[in, optional] hCursor

형식: HCURSOR

커서에 대한 핸들입니다.

커서는 CreateCursor 또는 CreateIconIndirect 함수에서 만들거나 LoadCursor 또는 LoadImage 함수에 의해 로드되어야 합니다.

이 매개 변수가 NULL이면 화면에서 커서가 제거됩니다.

반환 값

형식: HCURSOR

반환 값은 이전 커서에 대한 핸들입니다(있는 경우).

이전 커서가 없는 경우 반환 값은 NULL입니다.

설명

커서는 새 커서가 이전 커서와 다른 경우에만 설정됩니다. 그렇지 않으면 함수가 즉시 반환됩니다.

커서는 공유 리소스입니다. 창은 커서가 클라이언트 영역에 있거나 창이 마우스 입력을 캡처하는 경우에만 커서 셰이프를 설정해야 합니다. 마우스가 없는 시스템에서는 커서가 클라이언트 영역을 벗어나거나 컨트롤을 다른 창으로 포기하기 전에 창이 이전 커서를 복원해야 합니다.

애플리케이션이 창에 있는 동안 커서를 설정해야 하는 경우 지정된 창의 클래스에 대한 클래스 커서가 NULL로 설정되어 있는지 확인합니다. 클래스 커서가 NULL이 아닌 경우 시스템은 마우스를 이동할 때마다 클래스 커서를 복원합니다.

내부 커서 표시 수가 0보다 작은 경우 커서가 화면에 표시되지 않습니다. 이는 애플리케이션이 ShowCursor 함수를 사용하여 커서를 표시하는 것보다 커서를 더 많이 숨기는 경우에 발생합니다.

예제

예제는 커서 표시를 참조하세요.

요구 사항

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

추가 정보

개념

커서

커서 만들기

CreateCursor

CreateIconIndirect

GetCursor

GetSystemMetrics

LoadCursor

Loadimage

참조

SetCursorPos

ShowCursor