LoadIcon(A)

LoadIcon(A)

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

HICON LoadIconA(
    HINSTANCE hInstance,  // 인스턴스 핸들
    PCSTR     pIconName   // 자원명/자원ID
);

USER32.DLL

인수

hInstance

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

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

pIconName

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

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

치	의미
32512 (IDI_APPLICATION)	디폴트 어플리케이션 아이콘
32513 (IDI_HAND, IDI_ERROR)	스톱표의 아이콘
32514 (IDI_QUESTION)	물음표의 아이콘
32515 (IDI_EXCLAMATION, IDI_WARNING)	감탄부의 아이콘
32516 (IDI_ASTERISK, IDI_INFORMATION)	asterisk 아이콘(송풍안에 i 의 문자)
32517 (IDI_WINLOGO)	Windows 로고 아이콘 Windows XP： 디폴트 어플리케이션 아이콘

반환값

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

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

해설

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

아이콘이 불필요하게 되어도 DestroyIcon 함수등에서 아이콘을 파기 해서는 안됩니다.

이 함수는, 아이콘의 자원으로부터, 현재의 화면에 가장 적합한 아이콘을 검색합니다.아이콘 자원은, 칼라 비트 맵 또는 흑백 비트 맵으로 할 수 있습니다.아이콘의 사이즈는, GetSystemMetrics 함수로 인수로서 SM_CXCURSOR (이)나 SM_CYCURSOR (을)를 건네주었을 때에 얻을 수 있는 값이 아니면 안됩니다.그 이외의 사이즈의 아이콘을 로드하려면 , LoadImage 함수를 사용합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후