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

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

  • Статья

Рисует элемент списка изображений в указанном контексте устройства.

Синтаксис

BOOL ImageList_Draw(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  UINT       fStyle
);

Параметры

himl

Тип: HIMAGELIST

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

i

Тип: int

Отсчитываемый от нуля индекс рисуемого изображения.

hdcDst

Тип: HDC

Дескриптор контекста целевого устройства.

x

Тип: int

Координата X, по которой выполняется рисование в заданном контексте устройства.

y

Тип: int

Координата Y, по которой выполняется рисование в заданном контексте устройства.

fStyle

Тип: UINT

Стиль рисования и, при необходимости, изображение наложения. Сведения об указании индекса наложения изображений см. в разделе примечаний в конце этой статьи. Этот параметр может быть сочетанием индекса наложения изображения и одного или нескольких из следующих значений:

Значение Значение
ILD_BLEND
ILD_BLEND25
 Рисует изображение, смешивая 25 процентов с системным цветом выделения. Это значение не оказывает влияния, если список изображений не содержит маски.
ILD_BLEND50
 Рисует изображение, смешивая 50 процентов с системным цветом выделения. Это значение не оказывает влияния, если список изображений не содержит маски.
ILD_FOCUS
ILD_IMAGE
 Установите этот флаг, если наложение не требует рисования маски. Этот флаг заставляет ImageList_DrawEx рисовать только изображение, игнорируя маску.
ILD_MASK
 Рисует маску.
ILD_NORMAL
 Рисует изображение, используя цвет фона для списка изображений. Если цвет фона является CLR_NONE значением, изображение рисуется прозрачно с помощью маски.
ILD_SELECTED
ILD_TRANSPARENT
 Рисует изображение прозрачно с помощью маски, независимо от цвета фона. Это значение не оказывает влияния, если список изображений не содержит маски.

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

Тип: BOOL

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

Комментарии

Изображение наложения нарисовывается прозрачно поверх основного изображения, указанного в параметре i . Чтобы указать изображение наложения в параметре fStyle , используйте макрос INDEXTOOVERLAYMASK для сдвига одноуровневого индекса изображения наложения. Используйте оператор OR для логического объединения возвращаемого значения макроса с флагами стиля рисования, указанными в параметре fStyle . Сначала необходимо указать это изображение в качестве наложения с помощью функции ImageList_SetOverlayImage .

Требования

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