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 值或以下值之一：

rgbFg

类型： COLORREF

图像的前景色。 此参数可以是应用程序定义的 RGB 值或以下值之一：

fStyle

类型： UINT

绘图样式和（可选）覆盖图像。 有关指定覆盖图像索引的信息，请参阅本主题末尾的注释部分。 此参数可以是覆盖图像索引和以下一个或多个值的组合：

返回值

类型： BOOL

如果成功，返回不为零的值；否则返回零。

注解

覆盖图像在 i 参数中指定的主图像上以透明方式绘制。 若要在 fStyle 参数中指定覆盖图像，请使用 INDEXTOOVERLAYMASK 宏来移动覆盖图像的基于 1 的索引。 使用 OR 运算符以逻辑方式将宏的返回值与 fStyle 参数中指定的绘图样式标志组合在一起。 必须先使用 ImageList_SetOverlayImage 函数将此图像指定为覆盖图像。

要求