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

Функция ImageList_ReplaceIcon (commctrl.h)

  • Статья

Заменяет изображение значком или курсором.

Синтаксис

int ImageList_ReplaceIcon(
  [in] HIMAGELIST himl,
  [in] int        i,
  [in] HICON      hicon
);

Параметры

[in] himl

Тип: HIMAGELIST

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

[in] i

Тип: int

Индекс заменяемого образа. Если значение i равно -1, функция добавляет изображение в конец списка.

[in] hicon

Тип: HICON

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

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

Тип: int

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

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента 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)