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

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

  • Статья

Заменяет изображение в списке образов новым.

Синтаксис

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

Параметры

[in] i

Тип: int

Значение типа int , содержащее индекс заменяемого изображения.

[in] hbmImage

Тип: HBITMAP

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

[in, optional] hbmMask

Тип: HBITMAP

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

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

Тип: HRESULT

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

Комментарии

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

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

Требования

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