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


Метод IImageList::Add (commoncontrols.h)

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

Синтаксис

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

Параметры

[in] hbmImage

Тип: HBITMAP

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

[in, optional] hbmMask

Тип: HBITMAP

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

[out] pi

Тип: int*

При возврате этого метода содержит указатель на индекс первого нового образа. Если методу не удается успешно добавить новый образ, это значение равно -1.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

IImageList::Add копирует растровое изображение во внутреннюю структуру данных. Для удаления hbmImage и hbmMask после возврата метода необходимо использовать функцию DeleteObject.

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

Требования

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