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 이후