ImageList_DrawEx函数在指定的设备上下文中绘制一个图像列表项。该函数使用指定的绘图样式并将图像与指定的颜色混合。
BOOL ImageList_DrawEx(
HIMAGELIST 【HIML】, | //处理图像列表 |
INT 【i】, | //绘制图像的索引 |
HDC 【hdcDst】, | //处理目标设备上下文 |
INT 【x】, | // x坐标绘制 |
INT 【y】, | // y坐标绘制 |
INT 【dx】, | //图像宽度 |
INT 【dy】, | //图像的高度 |
COLORREF 【rgbBk】, | //图像的背景颜色 |
COLORREF 【rgbFg】, | //图像的前景色 |
UINT 【fStyle】 | //绘图风格 |
); |
参数
【HIML】
处理图像列表
【i】
要绘制的图像的索引。
【hdcDst】
处理目标设备上下文。
【x】
指定在指定的设备上下文中绘制的x坐标。
【y】
指定在指定的设备上下文中绘制的y坐标。
【dx】
指定要绘制的图像部分的宽度,相对于图像的左上角。如果【dx】和【dy】为零,则该函数绘制整个图像。该函数不能保证参数有效。
【dy】
指定要绘制的图像部分的高度,相对于图像的左上角。如果【dx】和【dy】为零,则该函数绘制整个图像。该函数不能保证参数有效。
【rgbBk】
图像的背景颜色。此参数可以是应用程序定义的RGB值或以下值之一:
值 | 含义 |
CLR_NONE | 没有背景颜色。图像透明地绘制。 |
CLR_DEFAULT | 默认背景颜色。使用图像列表的背景颜色绘制图像。 |
仅当由【HIML】标识的图像列表使用ILC_MASK值创建时,才使用此参数。
【rgbFg】
图像的前景颜色。此参数可以是应用程序定义的RGB值或以下值之一:
值 | 含义 |
CLR_NONE | 无混色。图像与目标设备上下文的颜色混合。 |
CLR_DEFAULT | 默认前景色。使用系统高亮颜色作为前景颜色绘制图像。 |
仅当【fStyle】包含ILD_BLEND25或ILD_BLEND50值时,才使用此参数。
【fStyle】
指定绘图样式的标志。此参数可以是以下值中的一个或多个:
值 | 含义 |
ILD_BLEND25, ILD_FOCUS | 绘制图像,混合25%与【rgbFG】指定的混合颜色。如果图像列表不包含掩码,则此值不起作用。 |
ILD_BLEND50, ILD_SELECTED, ILD_BLEND | 绘制图像,用【rgbFG】指定的混合颜色混合50%。如果图像列表不包含掩码,则此值不起作用。 |
ILD_MASK | 画面具。 |
ILD_NORMAL | 使用图像列表的背景颜色绘制图像。如果背景颜色为CLR_NONE值,则使用掩码透明地绘制图像。 |
ILD_TRANSPARENT | 无论背景颜色如何,使用蒙版,透明地绘制图像。如果图像列表不包含掩码,则此值不起作用。 |
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。
也可以看看