관리 메뉴

ㄴrㅎnㅂrㄹrㄱi

LoadCursor(A) 본문

API 관련/Win32 API 함수

LoadCursor(A)

님투 2007. 11. 8. 23:01
반응형

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 이후

반응형

'API 관련 > Win32 API 함수' 카테고리의 다른 글

LoadIcon(A)  (0) 2007.11.08
LoadCursorFromFile(A)  (0) 2007.11.08
keybd_event  (1) 2007.11.08
InitCommonControlsEx  (0) 2007.11.08
InitCommonControls  (0) 2007.11.08
Comments