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


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

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

Синтаксис

BOOL ImageList_SetOverlayImage(
  [in] HIMAGELIST himl,
  [in] int        iImage,
  [in] int        iOverlay
);

Параметры

[in] himl

Тип: HIMAGELIST

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

[in] iImage

Тип: int

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

[in] iOverlay

Тип: int

Одноуровневый индекс маски наложения.

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

Тип: BOOL

Возвращает ненулевое значение в случае успешного выполнения или ноль в противном случае.

Комментарии

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

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

Требования

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