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

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	commctrl.h
Библиотека	Comctl32.lib
DLL	Comctl32.dll
Набор API	ext-ms-win-shell-comctl32-init-l1-1-1 (представлено в Windows 10 версии 10.0.14393)