ImageList_AddMasked

이미지 리스트에 이미지를 추가합니다.그 때에, 지정된 색으로부터 마스크 이미지를 작성합니다.

int ImageList_AddMasked(
    HIMAGELIST himl,     // 이미지 리스트의 핸들
    HBITBAP    hbmImage, // 이미지의 비트 맵 핸들
    COLORREF   crMask    // 마스크 생성에 사용하는 색
);

COMCTL32.DLL

인수

himl

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

hbmImage

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

crMask

마스크를 생성하기 위해서 사용하는 색을 지정합니다.지정된 이미지 비트 맵의 이 색에 대응하는 각 피크셀은 흑으로 변경되어 마스크 이미지 비트 맵의 대응하는 비트가 1 (이)가 됩니다.

COLORREF 형태의 값(0xBB：청 0xGG：록 0xRR：빨강 때,0x00BBGGRR 의 형태)로 지정합니다.

반환값

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

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

해설

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

대응 정보

Windows 95 이후 / Windows NT 3.51 이후