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

функция ImageList_DrawEx (commctrl.h)

  • Статья

Рисует элемент списка изображений в указанном контексте устройства. Функция использует указанный стиль рисования и смешивает изображение с указанным цветом.

Синтаксис

BOOL ImageList_DrawEx(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  int        dx,
  int        dy,
  COLORREF   rgbBk,
  COLORREF   rgbFg,
  UINT       fStyle
);

Параметры

himl

Тип: HIMAGELIST

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

i

Тип: int

Индекс рисуемого изображения.

hdcDst

Тип: HDC

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

x

Тип: int

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

y

Тип: int

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

dx

Тип: int

Ширина рисуемой части изображения относительно левого верхнего угла изображения. Если значения dx и dy равны нулю, функция рисует все изображение. Функция не гарантирует допустимость параметров.

dy

Тип: int

Высота отрисовываемой части изображения относительно левого верхнего угла изображения. Если значения dx и dy равны нулю, функция рисует все изображение. Функция не гарантирует допустимость параметров.

rgbBk

Тип: COLORREF

Цвет фона изображения. Этот параметр может быть определяемым приложением значением RGB или одним из следующих значений:

Значение Значение
CLR_NONE
 Цвет фона отсутствует. Изображение рисуется прозрачно.
CLR_DEFAULT
 Цвет фона по умолчанию. Изображение рисуется с использованием цвета фона списка изображений.

rgbFg

Тип: COLORREF

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

Значение Значение
CLR_NONE
 Цвет наложения отсутствует. Изображение смешивается с цветом контекста конечного устройства.
CLR_DEFAULT
 Цвет переднего плана по умолчанию. Изображение рисуется с использованием системного цвета выделения в качестве цвета переднего плана.

fStyle

Тип: UINT

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

Значение Значение
ILD_BLEND
ILD_BLEND25
 Рисует изображение, смешивая 25 процентов с цветом, заданным rgbFg. Это значение не оказывает влияния, если список изображений не содержит маски.
ILD_BLEND50
 Рисует изображение, смешивая 50 процентов с цветом, заданным rgbFg. Это значение не оказывает влияния, если список изображений не содержит маски.
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