SetSystemCursor 함수(winuser.h)

아티클
03/13/2024

애플리케이션에서 시스템 커서를 사용자 지정할 수 있습니다. id 매개 변수로 지정된 시스템 커서의 내용을 hcur 매개 변수로 지정된 커서의 내용으로 바꾼 다음 hcur를 삭제합니다.

구문

BOOL SetSystemCursor(
  [in] HCURSOR hcur,
  [in] DWORD   id
);

매개 변수

[in] hcur

형식: HCURSOR

커서에 대한 핸들입니다. 함수는 ID 로 지정된 시스템 커서의 내용을 hcur에서 처리하는 커서의 내용으로 바꿉니다.

시스템은 DestroyCursor 함수를 호출하여 hcur를 삭제합니다. 따라서 hcur 는 LoadCursor 함수를 사용하여 로드된 커서일 수 없습니다. 리소스에서 로드된 커서를 지정하려면 CopyCursor 함수를 사용하여 커서를 복사한 다음 , 복사본을 SetSystemCursor에 전달합니다.

[in] id

형식:DWORD

을 hcur의 내용으로 바꿀 시스템 커서입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
OCR_NORMAL `32512`	일반 선택
OCR_IBEAM `32513`	텍스트 선택
OCR_WAIT `32514`	사용 중
OCR_CROSS `32515`	정밀도 선택
OCR_UP `32516`	대체 선택
OCR_SIZENWSE `32642`	대각선 크기 조정 1
OCR_SIZENESW `32643`	대각선 크기 조정 2
OCR_SIZEWE `32644`	가로 크기 조정
OCR_SIZENS `32645`	세로 크기 조정
OCR_SIZEALL `32646`	이동
OCR_NO `32648`	Unavailable
OCR_HAND `32649`	링크 선택
OCR_APPSTARTING `32650`	백그라운드에서 작업

반환 값

형식: BOOL

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

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

설명

애플리케이션에서 OCR_ 상수를 사용하려면 Windows.h 헤더 파일이 포함되기 전에 상수 OEMRESOURCE 를 정의해야 합니다.

요구 사항

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