LoadImage

아이콘, 커서 또는 비트맵을 로드 하는 LoadImage 함수.

핸들 LoadImage ( HINSTANCE  hinst, / / 인스턴스 핸들에 이미지를 포함 하LPCTSTRlpszName, / / 이미지의 식별자 나 이름UINTuType, / / 이미지의 유형intcxDesired, / / 폭을 원하는 intcyDesired, / / 높이 원하는UINTfuLoad / / 로드 플래그);
 

매개 변수

hinst

로드할 이미지가 포함 된 모듈의 인스턴스를 처리 합니다. OEM 이미지를 로드 하려면이 매개 변수를 0으로 설정.

lpszName

로드 이미지 처리.

LpszName hinst 모듈에서 이미지 리소스의 이름을 포함 하는 null로 끝나는 문자열에 대 한 포인터는 hinst 매개 변수가 NULL이 아닌 경우 fuLoad 매개 변수 LR_LOADFROMFILE 포함 되지 않습니다.

Hinst NULL 이면 LR_LOADFROMFILE을 지정 하지 않으면,이 매개 변수의 낮은 순서 단어를 로드할 OEM 이미지의 식별자 여야 합니다. OEM 이미지 식별자는 WINUSER에 정의 됩니다.H와 다음 접두사:

접두사	의미
OBM_	OEM 비트맵
OIC_	OEM 아이콘
OCR_	OEM 커서

LpszName 는 이미지를 포함 하는 파일의 이름을 fuLoad 매개 변수에 LR_LOADFROMFILE 값을 포함 하는 경우.

uType

로드할 이미지의 유형을 지정 합니다. 이 매개 변수는 다음 값 중 하나가 될 수 있습니다.:

값	의미
IMAGE_BITMAP	비트맵 로드.
IMAGE_CURSOR	커서를 로드.
IMAGE_ICON	아이콘 로드.

cxDesired

아이콘이 나 커서의 픽셀 단위로 너비를 지정합니다. 이 매개 변수는 0 하는 경우 fuLoad 매개 변수는 LR_DEFAULTSIZE는 함수는 SM_CXICON 또는 SM_CXCURSOR 시스템 메트릭 값을 사용 하 여 너비를 설정 합니다. 함수에 실제 자원 너비 사용 하 여이 매개 변수는 0 LR_DEFAULTSIZE 사용 하지 않는 경우.

cyDesired

아이콘이 나 커서의 픽셀에서 높이 지정합니다. 이 매개 변수는 0 하는 경우 fuLoad 매개 변수는 LR_DEFAULTSIZE 함수는 SM_CYICON 또는 SM_CYCURSOR 시스템 메트릭 값을 사용 하 여 높이 설정. 이 매개 변수는 0 LR_DEFAULTSIZE 사용 하지 않는 경우 함수 사용 실제 자원 높이.

fuLoad

다음 값의 조합 지정:

값	의미
LR_DEFAULTCOLOR	기본 플래그; 그것은 아무것도 하지 않는다. 그것은 의미 다 "LR_MONOCHROME".
LR_CREATEDIBSECTION	사용자 매개 변수 IMAGE_BITMAP를 지정 하면 호환 비트맵 보다는 DIB 섹션 비트맵을 반환 하는 함수. 이 플래그는 디스플레이 장치의 색 매핑 없이 비트맵을 로드 하는 데 유용.
LR_DEFAULTSIZE	CxDesired 또는 cyDesired 값을 0으로 설정 하는 경우 너비 또는 커서 또는 아이콘의 시스템 미터법 값에 의해 지정 된 높이 사용 합니다. 이 플래그를 지정 하지 않으면 cxDesired 및 cyDesired 를 0으로 설정 하는 경우이 함수는 실제 리소스 크기를 사용 합니다. 함수에 첫 번째 이미지의 크기를 사용 하 여 리소스를 여러 개의 이미지를 포함 하는 경우.
LR_LOADFROMFILE	LpszName 매개 변수에 의해 지정 된 파일에서 이미지를 로드 합니다. 이 플래그를 지정 하는 경우 lpszName 은 리소스의 이름.
LR_LOADMAP3DCOLORS	이미지에 대 한 색상표를 검색 하 고 해당 하는 3D 색 다음 회색 음영을 바꿉니다.:

	색	으로 대체
	Dk 회색 RGB(128,128,128)	COLOR_3DSHADOW
	회색, RGB(192,192,192)	COLOR_3DFACE
	Lt 회색 RGB(223,223,223)	COLOR_3DLIGHT

LR_LOADTRANSPARENT	이미지의 첫 번째 픽셀의 색상 값을 검색 하 고 기본 창 색 (COLOR_WINDOW) 색 테이블에 상응 하는 항목을 바꿉니다. 해당 항목을 사용 하는 이미지의 모든 픽셀에 기본 창 색 된다. 이 값은 해당 색 테이블에 있는 이미지에만 적용 됩니다. LR_LOADTRANSPARENT 및 LR_LOADMAP3DCOLORS 값을 포함 하는 fuLoad , LRLOADTRANSPARENT이 우선 합니다. 그러나, 색 테이블 항목은 바뀝니다 COLOR_WINDOW 보다는 COLOR_3DFACE.
LR_MONOCHROME	흑인과 백인 이미지 로드.
LR_SHARED	이미지를 여러 번 로드 하는 경우 이미지 핸들을 공유 합니다. LoadImage 동일한 리소스에 대 한 두 번째 호출에서 이미지를 다시 로드 되며 다른 핸들을 반환 LR_SHARED 설정 되지 않은 경우. 이미지를 로드 한 후 변경 될 수 있는 표준 크기 LR_SHARED를 사용 하지 마십시오 또는 파일에서 로드 되는. Windows 95 및 Windows 98: 함수 요청 크기에 관계 없이 캐시에서 요청한 리소스 이름의 첫 번째 이미지를 찾습니다.
LR_VGACOLOR	진정한 VGA 색상을 사용 하 여.

반환 값

함수가 성공 하면 반환 값은 새로 로드 된 이미지의 핸들.

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

주의

다음 표에 함수 중 하나를 호출 하 여 연결 된 메모리를 해제할 수 있게 비트맵, 커서 또는 아이콘을 사용 하 여 작업을 마쳤으면.

그러나 만든 프로세스를 종료 하는 경우 시스템이 자동으로 이러한 리소스 삭제 됩니다, 그리고, 적절 한 함수 호출 저장 메모리 프로세스의 작업 집합의 크기를 줄입니다.

Windows CE: CxDesired 및 cyDesired 매개 변수는 IMAGE_BITMAP에 대 한 0 이어야 합니다.

스트레칭과 축소 아이콘의 Windows CE 지원 하지 않습니다.

FuLoad 매개 변수 (LR_DEFAULTCOLOR =) 0 이어야 합니다.

마우스 커서를 지원 하지 않는 플랫폼을 타겟팅 하는 경우 cxDesired 및 cyDesired 매개 변수에서 SM_CXCURSOR 및 SM_CYCURSOR 값을 지정할 수 없습니다. 및 사용자 매개 변수 IMAGE_CURSOR을 지정할 수 없습니다.

마우스 커서를 지 원하는 플랫폼을 타겟팅 하는 경우 지정할 수 있습니다 SM_CXCURSOR 및 SM_CYCURSOR cxDesired 및 cyDesired 매개 변수를 IMAGE_CURSOR에서 사용자 매개 변수.

QuickInfo

nbsp;?Windows &NT: 버전 4.0 이상이 필요 합니다.
Windows:Windows 95 이상이 필요합니다.
Windows CE:버전 1.0 이상이 필요합니다.
헤더:Winuser.h에서 선언합니다.
가져오기 라이브러리:User32.lib를 사용 합니다.
유니코드:Windows NT에서 유니코드와 ANSI 버전으로 구현.

참고 항목

리소스 개요, 자원 기능, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

Index