LoadCursor(A)

LoadCursor(A)

어플리케이션 인스턴스에 관련지을 수 있었던 실행 가능 파일로부터, 지정된 커서 자원을 로드합니다.이 함수는, LoadImage 함수에 교체되었습니다만, 아직 사용할 수 있습니다.

HCURSOR LoadCursorA(
    HINSTANCE hInstance,   // 인스턴스 핸들
    PCSTR     pCursorName  // 자원명/자원ID
);

USER32.DLL

인수

hInstance

실행 가능 파일에 커서 자원이 들어가 있는 모듈의 인스턴스 핸들을 지정합니다.

Windows시스템 정의의 아이콘을 로드할 때는 0 (NULL) (을)를 지정합니다.

pCursorName

hInstance 파라미터에 0 (NULL) 이외의 값을 지정했을 경우는, 로드하는 커서 자원명에의 포인터를 지정합니다.또는 상위 워드에 0 (을)를, 하위 워드에 자원ID(을)를 넣은 값을 지정합니다.

hInstance 파라미터에 0 (NULL) (을)를 지정했을 경우는, 이하의 값의 어느쪽이든을 지정합니다.

치	의미
32512 (IDC_ARROW)	표준 화살표 커서
32513 (IDC_IBEAM)	아이빔(I Beam) (종선) 커서
32514 (IDC_WAIT)	모래시계 커서
32515 (IDC_CROSS)	십자 커서
32516 (IDC_UPARROW)	수직의 화살표 커서
32640 (IDC_SIZE)	현재는 사용되지 않습니다
32641 (IDC_ICON)	현재는 사용되지 않습니다
32642 (IDC_SIZENWSE)	기울기 오른쪽 밑의 양방향 화살표 커서
32643 (IDC_SIZENESW)	기울기 좌하 꾸중의 양방향 화살표 커서
32644 (IDC_SIZEWE)	좌우 양방향 화살표 커서
32645 (IDC_SIZENS)	상하 양방향 화살표 커서
32646 (IDC_SIZEALL)	4 방향 화살표 커서
32648 (IDC_NO)	금지 커서
32649 (IDC_HAND)	Windows 98/Me/2000/XP：핸드 커서
32650 (IDC_APPSTARTING)	모래시계 화살표 커서
32651 (IDC_HELP)	의문 부호 화살표 커서

반환값

성공했을 경우는 로드 된 커서의 핸들이 돌아갑니다.

실패했을 경우는 0 (NULL) 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

이 함수는, 커서의 자원이 아직 로드 되어 있지 않은 경우에만, 자원을 로드합니다.벌써 로드 되고 있는 경우는, 기존의 자원의 핸들을 돌려줍니다.

커서가 불필요하게 되어도 DestroyCursor 함수등에서 커서를 파기 해서는 안됩니다.

이 함수는, 커서의 자원으로부터, 현재의 화면에 가장 적합한 아이콘을 검색합니다.커서 자원은, 칼라 비트 맵 또는 흑백 비트 맵으로 할 수 있습니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후