ImageList_Create 함수(commctrl.h)

  • 아티클

새 이미지 목록을 만듭니다.

구문

HIMAGELIST ImageList_Create(
  int  cx,
  int  cy,
  UINT flags,
  int  cInitial,
  int  cGrow
);

매개 변수

cx

형식: int

각 이미지의 너비(픽셀)입니다.

cy

형식: int

각 이미지의 높이(픽셀)입니다.

flags

형식: UINT

만들 이미지 목록의 형식을 지정하는 비트 플래그 집합입니다. 이 매개 변수는 이미지 목록 만들기 플래그의 조합일 수 있습니다.

cInitial

형식: int

이미지 목록에 처음 포함된 이미지 수입니다.

cGrow

형식: int

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

반환 값

형식: HIMAGELIST

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

설명

이미지 목록 사용을 마치면 ImageList_Destroy 함수를 호출하여 삭제합니다.

Comctl32.dll 버전 6은 재배포할 수 없지만 Windows 이상 버전에 포함되어 있습니다. Comctl32.dll 버전 6을 사용하려면 매니페스트에 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.
 

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commctrl.h
라이브러리 Comctl32.lib
DLL Comctl32.dll
API 세트 ext-ms-win-shell-comctl32-init-l1-1-1(Windows 10 버전 10.0.14393에 도입됨)