ImageList_Create

ImageList_Create

새로운 이미지 리스트를 작성합니다.

HIMAGELIST ImageList_Create(
    int  cx,        // 이미지의 폭
    int  cy,        // 이미지의 높이
    UINT flags,     // 이미지 리스트의 타입
    int  cInitial,  // 이미지수의 초기치
    int  cGrow      // 확장 이미지수
);

COMCTL32.DLL

인수

cx, cy

이미지 리스트에 포함한 이미지의 사이즈를 피크셀 단위로 지정합니다.

flags

작성하는 이미지 리스트의 타입을 지정합니다.

사용하는 비트 맵에 관해서, 이하의 값의1개를 지정합니다

치	의미
0x0000 (ILC_COLOR)	디폴트의 이미지 리스트를 작성합니다.통상은 ILC_COLOR4 (낡은 디스플레이 드라이버에서는 ILC_COLORDDB )(와)과 같습니다.
0x0004 (ILC_COLOR4)	이미지 리스트에 4bit (16색) DIB (디바이스 독립 비트 맵)(을)를 사용합니다.
0x0008 (ILC_COLOR8)	이미지 리스트에 8bit (256색) DIB (을)를 사용합니다.
0x0010 (ILC_COLOR16)	이미지 리스트에 16bit (HighColor) DIB (을)를 사용합니다.
0x0018 (ILC_COLOR24)	이미지 리스트에 24bit (TrueColor) DIB (을)를 사용합니다.
0x0020 (ILC_COLOR32)	이미지 리스트에 32bit (TrueColor) DIB (을)를 사용합니다.
0x00FE (ILC_COLORDDB)	이미지 리스트에 DDB (디바이스 의존 비트 맵)(을)를 사용합니다.

게다가 이하의 값을 조합해 사용할 수 있습니다.

치	의미
0x0001 (ILC_MASK)	마스크를 사용합니다.이 값이 지정되면, 이미지 리스트에는1개의 이미지에 대해 표시 이미지와 마스크 이미지의2개의 비트 맵을 가집니다.
0x2000 (ILC_MIRROR)	Version 6.00 이후： Windows (은)는, 헤브라이어나 아라비아어등의 오른쪽에서 좌향에 읽혀지는 언어를 표시하기 위해서, 미러링(RTL(right-to-left) 레이아웃의 표시)를 시킬 수 있습니다. 미러링 되고 있다 Windows 그럼, 리스트중의 이미지는 경영표시가 됩니다(뒤집어져 좌우 역방향에 표시됩니다).이 플래그는, 그러한 버젼의 Windows 그리고, 자동적으로 경영표시가 되지 않게 지정합니다.
0x8000 (ILC_PERITEMMIRROR)	Version 6.00 이후： ILC_MIRROR (을)를 사용하고 있는 이미지 리스트로, 복수의 이미지가 늘어선 비트 맵을 지정하기 위해서는, 이 플래그를 지정합니다.이 플래그가 효과를 가지기 위해서는 ILC_MIRROR 하지만 지정되어 있지 않으면 안됩니다.

cInitial

이미지 리스트가 최초로 보관 유지하고 있는 이미지의 수를 지정합니다.

cGrow

시스템이 새로운 이미지를 격납하기 위해서 리스트의 사이즈를 변경할 필요가 있을 때, 이미지 리스트를 확장할 수 있는 이미지수를 지정합니다.이 값은, 사이즈 변경된 이미지 리스트를 가질 수 있는 새로운 이미지의 수를 나타냅니다.

반환값

성공하면 작성된 이미지 리스트의 핸들이 돌아갑니다.

실패하면 0 (NULL) 하지만 돌아갑니다.

대응 정보

Windows 95 이후 / Windows NT 3.51 이후