ImageList_LoadImageW 함수(commctrl.h)

지정된 비트맵에서 이미지 목록을 만듭니다.

구문

HIMAGELIST ImageList_LoadImageW(
  HINSTANCE hi,
  LPCWSTR   lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

매개 변수

hi

형식: HINSTANCE

리소스를 포함하는 instance 대한 핸들입니다. 파일에서 이미지를 로드하거나 OEM 리소스를 로드하는 경우 이 매개 변수는 NULL 일 수 있습니다.

lpbmp

형식: LPCTSTR

로드할 이미지입니다.

uFlags 매개 변수에 LR_LOADFROMFILE 포함된 경우 lpbmp는 로드할 이미지가 포함된 파일의 이름을 지정하는 null로 끝나는 문자열의 주소입니다.

hi 매개 변수가 NULL이 아니고 LR_LOADFROMFILE 지정되지 않은 경우 lpbmp는 hi 모듈의 이미지 리소스 이름을 포함하는 null로 끝나는 문자열의 주소입니다.

hi가 NULL이고 LR_LOADFROMFILE 지정되지 않은 경우 이 매개 변수의 LOWORD는 로드할 OEM 이미지의 식별자여야 합니다. 이 값을 만들려면 Winuser.h에 정의된 OEM 이미지 식별자 중 하나와 함께 MAKEINTRESOURCE 매크로를 사용합니다. 이러한 식별자에는 다음 접두사가 있습니다.

값	의미
OEM 비트맵에 대한 OBM_
OEM 아이콘에 대한 OIC_
OEM 커서에 대한 OCR_

cx

형식: int

각 이미지의 너비입니다. 각 이미지의 높이와 이미지의 초기 수는 지정된 리소스의 크기로 유추됩니다.

cGrow

형식: int

시스템이 새 이미지를 위한 공간을 확보해야 할 때 이미지 목록이 증가할 수 있는 이미지 수입니다. 이 매개 변수는 크기가 조정된 이미지 목록에 포함될 수 있는 새 이미지 수를 나타냅니다.

crMask

형식: COLORREF

마스크를 생성하는 데 사용되는 색입니다. 지정된 비트맵, 커서 또는 아이콘에서 이 색의 각 픽셀이 검은색으로 변경되고 마스크의 해당 비트가 1로 설정됩니다. 이 매개 변수가 CLR_NONE 값이면 마스크가 생성되지 않습니다. 이 매개 변수가 CLR_DEFAULT 값이면 이미지의 왼쪽 위 모서리에 있는 픽셀의 색이 마스크 색으로 처리됩니다.

uType

형식: UINT

로드할 이미지의 유형을 지정하는 플래그입니다. 비트맵이 로드되고 있음을 나타내려면 이 매개 변수를 IMAGE_BITMAP 합니다.

참고ImageList_LoadImage 비트맵 파일에서만 사용됩니다. 다른 이미지 형식은 지원되지 않습니다.

 

값	의미
IMAGE_BITMAP	비트맵을 로드합니다.

uFlags

형식: UINT

이미지를 로드하는 방법을 지정하는 플래그입니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.

값	의미
LR_CREATEDIBSECTION	uType 매개 변수가 IMAGE_BITMAP 지정할 때 함수가 호환되는 비트맵이 아닌 DIB 섹션 비트맵을 반환하도록 합니다. LR_CREATEDIBSECTION 디스플레이 디바이스의 색에 매핑하지 않고 비트맵을 로드하는 데 유용합니다.
LR_DEFAULTCOLOR	디스플레이의 색 형식을 사용합니다.
LR_DEFAULTSIZE	cx 매개 변수가 0으로 설정된 경우 커서 및 아이콘에 대한 시스템 메트릭 값으로 지정된 너비 또는 높이를 사용합니다. 이 값을 지정하지 않고 cx 를 0으로 설정하면 함수는 크기를 리소스에 지정된 크기로 설정합니다. 리소스에 여러 이미지가 포함된 경우 함수는 크기를 첫 번째 이미지의 크기로 설정합니다.
LR_LOADFROMFILE	lpbmp 매개 변수로 지정된 파일에서 이미지를 로드합니다.
LR_LOADMAP3DCOLORS	색 테이블에서 이미지를 검색하고 다음 회색 음영을 해당 3차원 색으로 바꿉니다. Dk Gray: RGB(128, 128, 128)COLOR_3DSHADOW 회색: RGB(192, 192, 192)COLOR_3DFACE Lt Gray: RGB(223, 223, 223)COLOR_3DLIGHT 자세한 내용은 주의 섹션을 참조하세요.
LR_LOADTRANSPARENT	이미지에서 첫 번째 픽셀의 색 값을 검색하고 색 테이블의 해당 항목을 기본 창 색(COLOR_WINDOW 표시 색)으로 바꿉니다. 해당 색을 사용하는 이미지의 모든 픽셀은 기본 창 값 색이 됩니다. 이 값은 해당 색 테이블이 있는 이미지에만 적용됩니다. 자세한 내용은 주의 섹션을 참조하세요.
LR_MONOCHROME	이미지를 흑백으로 로드합니다.
LR_SHARED	이미지가 여러 번 로드되는 경우 이미지 핸들을 공유합니다. 로드 후 변경될 수 있는 비전통적 크기가 있는 이미지 또는 파일에서 로드된 이미지에는 이 값을 사용하지 마세요.

반환 값

형식: HIMAGELIST

성공하면 이미지 목록에 대한 핸들을 반환하고 실패하면 NULL을 반환합니다.

설명

LR_LOADTRANSPARENT 이미지를 투명하게 로드하지 않습니다. 모든 배경 픽셀이 COLOR_WINDOW 변경되었기 때문에 투명하게만 표시되는 불투명 이미지 목록을 만듭니다. 이미지가 COLOR_WINDOW 색이 아닌 배경 위에 그려지면 이미지가 제대로 그려지지 않습니다. 또한 LR_LOADTRANSPARENT 및 LR_LOADMAP3DCOLORS ImageList_LoadImage 호출되었을 때 적용된 시스템 색을 사용합니다. 이후에 시스템 색이 변경되면 애플리케이션은 이미지를 다시 로드하여 색을 다시 매핑해야 합니다.

참고

commctrl.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 ImageList_LoadImage 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	commctrl.h
라이브러리	Comctl32.lib
DLL	Comctl32.dll

추가 정보

Loadimage