IImageList::AddMasked 메서드(commoncontrols.h)

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

구문

HRESULT AddMasked(
  [in]  HBITMAP  hbmImage,
  [in]  COLORREF crMask,
  [out] int      *pi
);

[in] hbmImage

형식: HBITMAP

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

[in] crMask

형식: COLORREF

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

[out] pi

형식: int*

반환할 때 첫 번째 새 이미지의 인덱스가 들어 있는 int에 대한 포인터이거나, 성공하면 -1입니다.

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

참고hbmImage 에 전달된 비트맵이 수정됩니다.

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

IImageList::AddMasked를 사용하려면 매니페스트에 Comctl32.dll 버전 6을 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.