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

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

  • Статья

Добавляет указанное изображение в список изображений, используемых в качестве масок наложения. Список изображений может содержать до четырех масок наложения в Common Controls версии 4.70 и более ранних и до 15 в версии 4.71 или более поздней. Метод назначает индекс маски наложения указанному изображению.

Синтаксис

HRESULT SetOverlayImage(
  [in] int iImage,
  [in] int iOverlay
);

Параметры

[in] iImage

Тип: int

Значение типа int , содержащее отсчитываемый от нуля индекс изображения в списке изображений. Этот индекс идентифицирует изображение, используемое в качестве маски наложения.

[in] iOverlay

Тип: int

Значение типа int , содержащее одноуровневый индекс маски наложения.

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

Тип: HRESULT

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

Комментарии

Маска наложения — это изображение, нарисованное прозрачно поверх другого изображения. Чтобы нарисовать маску наложения на изображение, вызовите IImageList::D raw. Параметр fStyle этих функций может использовать макрос INDEXTOOVERLAYMASK для указания индекса маски наложения.

Вызов этого метода завершается сбоем и возвращает E_INVALIDARG, если список изображений не создан с помощью маски.

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

Требования

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