ImageList_GetIcon

ImageList_GetIcon

이미지 리스트의 이미지와 마스크로부터 아이콘을 작성합니다.

HICON ImageList_GetIcon(
    HIMAGELIST himl,   // 이미지 리스트의 핸들
    int        index,  // 이미지의 인덱스
    UINT       flags   // 묘화 스타일
);

COMCTL32.DLL

인수

himl

이미지 리스트의 핸들을 지정합니다.

index

묘화 하는 이미지의 인덱스를 지정합니다.

flags

묘화 스타일을 지정합니다.묘화 스타일은 이하의 값의 편성으로 지정합니다.

치	의미
0x0000 (ILD_NORMAL)	이미지 리스트의 백그라운드 칼라를 사용해 이미지를 묘화 합니다.백그라운드 칼라가 CLR_NONE (0xFFFFFFFF) (이)라면, 이미지는 마스크를 사용해 투명하게 묘화 됩니다.
0x0001 (ILD_TRANSPARENT)	이미지 리스트의 백그라운드 칼라에 관계없이, 마스크를 사용해 투명하게 묘화 됩니다.마스크를 사용하지 않는 경우는 이 플래그는 무시됩니다.
0x0002 (ILD_BLEND25, ILD_FOCUS)	시스템의 강조 표시색을 25% 혼합하고, 이미지를 묘화 합니다.이미지 리스트가 마스크를 가지고 있지 않을 때는, 이 값은 유효하지는 않습니다.
0x0004 (ILD_BLEND50, ILD_SELECTED, ILD_BLEND)	시스템의 강조 표시색을 50% 혼합하고, 이미지를 묘화 합니다.이미지 리스트가 마스크를 가지고 있지 않을 때는, 이 값은 유효하지는 않습니다.
0x0010 (ILD_MASK)	마스크를 묘화 합니다.

반환값

성공하면, 작성된 아이콘의 핸들이 돌아갑니다.

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

해설

아이콘이 불필요하게 되면, DestroyIcon 함수를 호출해 아이콘 핸들을 파기하지 않으면 안됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.51 이후