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

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

  • Статья

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

Синтаксис

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

Параметры

[in] i

Тип: int

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

[in] hicon

Тип: HICON

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

[out] pi

Тип: int*

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

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

Тип: HRESULT

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

Комментарии

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

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

Требования

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