SetCursor

SetCursor

마우스 커서의 형상을 설정합니다.

HCURSOR SetCursor(
    HCURSOR hCoursor    // 커서 핸들
);

USER32.DLL

인수

hCoursor

마우스 커서의 핸들을 지정합니다.이 핸들은 CreateCursor 함수로 작성된 커서인가, LoadCursor 함수 또는 LoadImage 함수로 로드 된 커서의 핸들이 아니면 안됩니다.이 파라미터에 0 (NULL) (을)를 지정하면, 마우스 커서는 스크린으로부터 삭제됩니다.

Windows 95/98/Me： 커서의 폭 및 높이는, SM_CXCURSOR 및 SM_CYCURSOR (을)를 지정해 GetSystemMetrics 함수를 호출했을 때의 반환값과 같지 않으면 안됩니다. Windows 95 그럼, 커서의 비트 심도가 디스플레이의 비트 심도와 같은가, 혹은, 커서가 흑백이 아니면 안됩니다. Windows 98/Me 그럼, 커서의 비트 심도와 디스플레이의 비트 심도가 같지 않은 경우는, 커서가 4bpp VGA 칼라에 변환됩니다.

반환값

이전의 마우스 커서의 핸들이 돌아갑니다.

이전에 마우스 커서가 존재하지 않을 때는,0 (NULL) 하지만 돌아갑니다.

해설

지정된 커서가 이전의 커서와 다른 경우에게만, 커서를 변경합니다.그렇지 않은 경우는, 함수는 곧바로 제어를 돌려줍니다.

커서가 윈도우상에 있는 동안 쭉 표시되도록(듯이) 커서를 설정하는 경우에는, 지정된 윈도우의 윈도우 클래스에서 설정되는 클래스 커서가 0 (NULL) (이)가 되도록(듯이) 합니다.클래스 커서가 0 (NULL) (이)가 아닌 경우, 시스템은 커서가 작동될 때마다 클래스 커서에 되돌립니다.클래스 커서를 변경하려면 SetClassLong 함수 또는 SetClassLongPtr 함수 (을)를 사용합니다.

내부의 커서 표시 카운터가 0 미만의 경우는, 커서는 스크린상에 표시되지 않습니다.표시 카운터는 ShowCursor 함수에 의해서 변경됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후