Структура IMAGELISTDRAWPARAMS (commctrl.h)

Содержит сведения об операции рисования списка изображений и используется с функцией IImageList::D raw .

Синтаксис

typedef struct _IMAGELISTDRAWPARAMS {
  DWORD      cbSize;
  HIMAGELIST himl;
  int        i;
  HDC        hdcDst;
  int        x;
  int        y;
  int        cx;
  int        cy;
  int        xBitmap;
  int        yBitmap;
  COLORREF   rgbBk;
  COLORREF   rgbFg;
  UINT       fStyle;
  DWORD      dwRop;
  DWORD      fState;
  DWORD      Frame;
  COLORREF   crEffect;
} IMAGELISTDRAWPARAMS, *LPIMAGELISTDRAWPARAMS;

Члены

cbSize

Тип: DWORD

Размер этой структуры в байтах.

himl

Тип: HIMAGELIST

Дескриптор списка изображений, который содержит изображение для рисования.

i

Тип: int

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

hdcDst

Тип: HDC

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

x

Тип: int

Координата X, указывающая место рисования изображения.

y

Тип: int

Координата Y, указывающая место рисования изображения.

cx

Тип: int

Значение типа , указывающее количество пикселей для рисования относительно левого верхнего угла операции рисования в соответствии с параметрами xBitmap и yBitmap. Если значения cx и cy равны нулю, то Draw рисует весь допустимый раздел. Метод не гарантирует допустимость параметров.

cy

Тип: int

Значение типа , указывающее количество пикселей для рисования относительно левого верхнего угла операции рисования в соответствии с параметрами xBitmap и yBitmap. Если значения cx и cy равны нулю, то Draw рисует весь допустимый раздел. Метод не гарантирует допустимость параметров.

xBitmap

Тип: int

Координата X, указывающая левый верхний угол операции рисования в ссылке на само изображение. Пиксели изображения, которые находятся слева от xBitmap и выше yBitmap , не отображаются.

yBitmap

Тип: int

Координата Y, указывающая левый верхний угол операции рисования в ссылке на само изображение. Пиксели изображения, которые находятся слева от xBitmap и выше yBitmap , не отображаются.

rgbBk

Тип: COLORREF

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

rgbFg

Тип: COLORREF

Цвет переднего плана изображения. Этот элемент используется только в том случае, если fStyle содержит флаг ILD_BLEND25 или ILD_BLEND50 . Этот параметр может быть определяемым приложением rgb-значением или одним из следующих значений:

fStyle

Тип: UINT

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

dwRop

Тип: DWORD

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

fState

Тип: DWORD

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

Frame

Тип: DWORD

Используется с эффектом альфа-смешивания .

При использовании с ILS_ALPHA этот элемент содержит значение альфа-канала. Это значение может быть от 0 до 255, при этом значение 0 является полностью прозрачным, а 255 — полностью непрозрачным.

Для использования этого элемента необходимо использовать comctl32.dll версии 6. См. примечания.

crEffect

Тип: DWORD

Цвет, используемый для эффектов свечения и тени . Для использования этого элемента необходимо использовать comctl32.dll версии 6. См. примечания.

Комментарии

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

Чтобы извлечь изображение наложения из fStyle, используйте побитовый оператор AND , чтобы маскировать fStyle со значением ILD_OVERLAYMASK .

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

Требования