LoadImageA 함수(winuser.h)
아이콘, 커서, 애니메이션 커서 또는 비트맵을 로드합니다.
통사론
HANDLE LoadImageA(
[in, optional] HINSTANCE hInst,
[in] LPCSTR name,
[in] UINT type,
[in] int cx,
[in] int cy,
[in] UINT fuLoad
);
매개 변수
[in, optional] hInst
형식: HINSTANCE
로드할 이미지를 포함하는 DLL 또는 실행 파일(.exe)의 모듈에 대한 핸들입니다. 자세한 내용은 GetModuleHandle
미리 정의된 이미지 또는 독립 실행형 리소스(아이콘, 커서 또는 비트맵 파일)를 로드하려면 이 매개 변수를 NULL
[in] name
형식: LPCTSTR
로드할 이미지입니다.
hInst 매개 변수가 비NULL이고 fuLoad 매개 변수가 LR_LOADFROMFILE생략하면 이름hInst 모듈에서 이미지 리소스를 지정합니다.
이미지 리소스를 모듈에서 이름으로 로드할 경우 이름 매개 변수는 이미지 리소스의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
이미지 리소스를 모듈에서 서수로 로드하는 경우 MAKEINTRESOURCE 매크로를 사용하여 이미지 서수가 LoadImage 함수에 전달될 수 있는 형식으로 변환합니다.
미리 정의된 이미지 식별자는 Winuser.h 정의되며 다음 접두사를 갖습니다.
| 접두사 | 의미 |
|---|---|
| OBM_ | OEM 비트맵. MAKEINTRESOURCE 매크로를 사용하여 전달합니다. |
| OIC_ | OEM 아이콘 MAKEINTRESOURCE 매크로를 사용하여 전달합니다. |
| OCR_ | OEM 커서입니다. MAKEINTRESOURCE 매크로를 사용하여 전달합니다. |
| IDI_ | 표준 아이콘 |
| IDC_ | 표준 커서 |
OEM 이미지 식별자 상수는 LoadImage 함수에 전달하려면 MAKEINTRESOURCE 매크로를 사용합니다. 예를 들어
자세한 내용은 아래 설명 섹션을 참조하세요.
[in] type
형식: UINT
로드할 이미지의 형식입니다.
이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
| IMAGE_BITMAP | 비트맵을 로드합니다. |
| IMAGE_CURSOR | 커서를 로드합니다. |
| IMAGE_ICON | 아이콘을 로드합니다. |
[in] cx
형식: int
아이콘 또는 커서의 너비(픽셀)입니다. 이 매개 변수가 0이고 fuLoad 매개 변수가 LR_DEFAULTSIZE경우 함수는 SM_CXICON 또는 SM_CXCURSOR 시스템 메트릭 값을 사용하여 너비를 설정합니다. 이 매개 변수가 0이고 LR_DEFAULTSIZE 사용되지 않는 경우 함수는 실제 리소스 너비를 사용합니다.
[in] cy
형식: int
아이콘 또는 커서의 높이(픽셀)입니다. 이 매개 변수가 0이고 fuLoad 매개 변수가 LR_DEFAULTSIZE경우 함수는 SM_CYICON 또는 SM_CYCURSOR 시스템 메트릭 값을 사용하여 높이를 설정합니다. 이 매개 변수가 0이고 LR_DEFAULTSIZE 사용되지 않는 경우 함수는 실제 리소스 높이를 사용합니다.
[in] fuLoad
형식: UINT
이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.
반환 값
형식: HANDLE
함수가 성공하면 반환 값은 새로 로드된 이미지의 핸들입니다.
함수가 실패하면 반환 값은 NULL
발언
LR_SHARED 플래그를 지정하지 않고 로드한 비트맵, 커서 또는 아이콘 사용을 마치면 다음 표의 함수 중 하나를 호출하여 연결된 메모리를 해제할 수 있습니다.
| 자원 | 릴리스 함수 |
|---|---|
| 비트맵 |
DeleteObject |
| 커서 | DestroyCursor |
| 아이콘 | DestroyIcon |
생성한 프로세스가 종료되면 시스템에서 이러한 리소스를 자동으로 삭제합니다. 그러나 적절한 함수를 호출하면 메모리가 절약되고 프로세스의 작업 집합 크기가 줄어듭니다.
예제
예제는 창 클래스 사용참조하세요.
메모
winuser.h 헤더는 LOADImage를 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 집합 | ext-ms-win-ntuser-gui-l1-1-0(Windows 8에서 도입) |
참고 항목
개념
copyImage
GetSystemMetrics
LoadBitmap
LoadCursor
LoadIcon
기타 리소스
참조