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

макрос ImageList_AddIcon (commctrl.h)

  • Статья

Добавляет значок или курсор в список изображений. ImageList_AddIcon вызывает функцию ImageList_ReplaceIcon .

Синтаксис

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

Параметры

himl

Тип: HIMAGELIST

Дескриптор списка изображений. Если этот параметр идентифицирует список замаскированных изображений, макрос копирует точечные изображения и растровые изображения значка или курсора. Если этот параметр определяет список немаскированных изображений, макрос копирует только растровое изображение.

hicon

Тип: HICON

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

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

Тип: int

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

Комментарии

Так как система не сохраняет hicon, его можно уничтожить после возврата макроса, если значок или курсор был создан функцией CreateIcon . Не нужно уничтожать hicon , если он был загружен функцией LoadIcon ; система автоматически освобождает ресурс значка, когда он больше не нужен.

Макрос ImageList_AddIcon определяется следующим образом:

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

Требования

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