다음을 통해 공유


ImageList_AddMasked 함수(commctrl.h)

이미지 목록에 하나의 이미지 또는 여러 이미지를 추가하여 지정된 비트맵에서 마스크를 생성합니다.

구문

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

매개 변수

himl

형식: HIMAGELIST

이미지 목록에 대한 핸들입니다.

hbmImage

형식: HBITMAP

하나 이상의 이미지를 포함하는 비트맵에 대한 핸들입니다. 이미지 수는 비트맵의 너비에서 유추됩니다.

crMask

형식: COLORREF

마스크를 생성하는 데 사용되는 색입니다. 지정된 비트맵에서 이 색의 각 픽셀은 검은색으로 변경되고 마스크의 해당 비트는 1로 설정됩니다. 이 매개 변수가 CLR_DEFAULT 경우 (0,0)의 픽셀 색이 마스크로 사용됩니다.

반환 값

형식: int

성공하면 첫 번째 새 이미지의 인덱스를 반환하고 그렇지 않으면 -1을 반환합니다.

설명

ImageList_AddMasked 함수는 비트맵을 내부 데이터 구조에 복사합니다. 색 깊이가 8bpp보다 큰 비트맵은 지원되지 않습니다. 함수가 반환된 후 DeleteObject 함수를 사용하여 hbmImage 를 삭제해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commctrl.h
라이브러리 Comctl32.lib
DLL Comctl32.dll
API 세트 ext-ms-win-shell-comctl32-init-l1-1-1(Windows 10 버전 10.0.14393에 도입됨)