Поделиться через

функция ImageList_Add (commctrl.h)

  • Статья

Добавляет изображение или изображения в список изображений.

Синтаксис

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

Параметры

[in] himl

Тип: HIMAGELIST

Дескриптор списка изображений.

[in] hbmImage

Тип: HBITMAP

Дескриптор растрового изображения, содержащего изображение или изображения. Количество изображений определяется на основе ширины растрового изображения.

[in, optional] hbmMask

Тип: HBITMAP

Дескриптор растрового изображения, содержащего маску. Если со списком изображений не используется маска, этот параметр игнорируется. Этот параметр может принимать значение NULL.

Возвращаемое значение

Тип: int

Возвращает индекс первого нового образа в случае успешного выполнения или значение -1 в противном случае.

Комментарии

Функция ImageList_Add копирует растровое изображение во внутреннюю структуру данных. Не забудьте использовать функцию DeleteObject для удаления hbmImage и hbmMask после возврата функции.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header commctrl.h
Библиотека Comctl32.lib
DLL Comctl32.dll