Метод 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 копирует растровое изображение во внутреннюю структуру данных. Точечные изображения с глубиной цвета больше 8 бит/с не поддерживаются. Для удаления hbmImage и crMask после возврата метода необходимо использовать функцию DeleteObject.

Чтобы использовать IImageList::AddMasked, укажите в манифесте Comctl32.dll версии 6. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	commoncontrols.h
DLL	Comctl32.dll (версия 6.0 или более поздняя)