ImageList_Draw - Win32 Programmer's Reference (win32.hlp)

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
Yes
Import Library
comctl32.lib
Header File
commctrl.h
Unicode
No
Platform Notes
None

ImageList_Draw

The ImageList_Draw function draws an image list item in the specified device context.

BOOL ImageList_Draw(

HIMAGELIST himl,	// handle to the image list
int i,	// index of the image to draw
HDC hdcDst,	// handle to the destination device context
int x,	// x-coordinate to draw at
int y,	// y-coordinate to draw at
UINT fStyle	// drawing style
);

Parameters
himl

Handle to the image list.

Specifies the index of the image to draw.

hdcDst

Handle to the destination device context.

Specifies the x-coordinate at which to draw within the specified device context.

Specifies the y-coordinate at which to draw within the specified device context.

fStyle

Flag specifying the drawing style. This parameter can be one or more of the following values:

Value	Meaning
ILD_BLEND25, ILD_FOCUS	Draws the image, blending 25 percent with the system highlight color. This value has no effect if the image list does not contain a mask.
ILD_BLEND50, ILD_SELECTED, ILD_BLEND	Draws the image, blending 50 percent with the system highlight color. This value has no effect if the image list does not contain a mask.
ILD_MASK	Draws the mask.
ILD_NORMAL	Draws the image using the background color for the image list. If the background color is the CLR_NONE value, the image is drawn transparently using the mask.
ILD_TRANSPARENT	Draws the image transparently using the mask, regardless of the background color. This value has no effect if the image list does not contain a mask.

Return Values
If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

More Online Helps