ImageList_Add

ImageList_Add

이미지 리스트에 이미지를 추가합니다.

int ImageList_Add(
    HIMAGELIST himl,     // 이미지 리스트의 핸들
    HBITBAP    hbmImage, // 이미지의 비트 맵 핸들
    HBITMAP    hbmMask   // 마스크의 비트 맵 핸들
);

COMCTL32.DLL

인수

himl

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

hbmImage

이미지 리스트에 추가하는 이미지의 비트 맵의 핸들을 지정합니다.추가되는 이미지의 수는, 비트 맵의 폭으로부터 계산됩니다.

hbmMask

이미지 리스트에 추가하는 이미지의 마스크로서 사용하는 비트 맵의 핸들을 지정합니다.이미지 리스트에 마스크를 사용하지 않는 경우는, 이 인수는 무시됩니다.

반환값

성공하면, 추가된 이미지 중(안)에서 최초의 이미지의 인덱스가 돌아갑니다.

실패하면 -1 하지만 돌아갑니다.

해설

이 함수는 hbmImage 파라미터 및 hbmMask 파라미터의 비트 맵을 내부의 데이터 구조체에 카피합니다.이러한 비트 맵을 그 밖에 필요로 하지 않는다면, 이 함수의 호출 후에 DeleteObject 함수에 의해서 삭제하지 않으면 안됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.51 이후