LoadIcon

LoadIcon 함수 실행 파일에서 지정 된 아이콘 리소스를 로드 (.응용 프로그램 인스턴스를 연관 된 EXE) 파일. 이 함수는 LoadImage 함수에 의해 대체 되었습니다.

HICON LoadIcon ( HINSTANCE  hInstance, / / 응용 프로그램 인스턴스에 대 한 핸들LPCTSTRlpIconName / / 아이콘 이름 문자열 또는 아이콘 리소스 / / 식별자);
 

매개 변수

hInstance

누구의 실행 파일 로드할 아이콘을 포함 하는 모듈의 인스턴스를 처리 합니다. 표준 아이콘을 로드 하는 경우이 매개 변수가 NULL 이어야 합니다.

lpIconName

로드할 아이콘 리소스의 이름을 포함 하는 null로 끝나는 문자열 포인터입니다. 또는,이 매개 변수는 낮은 순서 단어에서 리소스 식별자와 높은 순서 단어에 0를 포함할 수 있습니다. MAKEINTRESOURCE 매크로 사용 하 여이 값을 만들.

미리 정의 된 아이콘 중 하나를 사용 하려면 NULL 및 lpIconName 매개 변수는 다음 값 중 하나를 hInstance 매개 변수 설정:

값	설명
IDI_APPLICATION	기본 응용 프로그램 아이콘.
IDI_ASTERISK	IDI_INFORMATION와 같은.
IDI_ERROR	손 모양의 아이콘.
IDI_EXCLAMATION	IDI_WARNING와 같은.
IDI_HAND	IDI_ERROR와 같은.
IDI_INFORMATION	별표 아이콘.
IDI_QUESTION	물음표 표시 아이콘.
IDI_WARNING	느낌표 아이콘.
IDI_WINLOGO	Windows 로고 아이콘.

반환 값

함수가 성공 하면 반환 값은 새로 로드 된 아이콘에 대 한 핸들.

함수가 실패 하면 반환 값은 NULL입니다. 확장 된 오류 정보를 얻을 하려면 GetLastError.

주의

그것은 로드 되지 않은; 하는 경우에 LoadIcon 아이콘 리소스를 로드 그렇지 않으면, 그것은 기존 리소스에 대 한 핸들을 검색합니다. 현재 디스플레이에 가장 적합 한 아이콘을 위한 아이콘 리소스를 검색 하는 함수. 아이콘 리소스를 수 색 또는 단색 비트맵.

LoadIcon 크기 SM_CXICON 및 SM_CYICON 시스템 메트릭 값에 맞는 아이콘을 로드할만 수 있습니다. LoadImage 함수를 사용 하 여 다른 크기의 아이콘을 로드.

Windows CE: 미리 정의 된 아이콘 (IDI_ *)는 지원 되지 않습니다.

Windows CE 1.0에서 아이콘 아이콘 (.ic2) 픽셀 당 2 비트 또는 단색 아이콘 이어야 합니다.

참고 항목

개요 아이콘 아이콘 기능, CreateIcon, LoadImage, MAKEINTRESOURCE

Index