Edit

IMAGELISTDRAWFLAGS

  • Article

Passed to the IImageList::Draw method in the fStyle member of IMAGELISTDRAWPARAMS.

Constant/value Description
ILD_NORMAL
0x00000000
 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
0x00000001
 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.
ILD_BLEND25
0x00000002
 Draws the image, blending 25 percent with the blend color specified by rgbFg. This value has no effect if the image list does not contain a mask.
ILD_FOCUS
0x00000002
 Same as ILD_BLEND25.
ILD_BLEND50
0x00000004
 Draws the image, blending 50 percent with the blend color specified by rgbFg. This value has no effect if the image list does not contain a mask.
ILD_SELECTED
0x00000004
 Same as ILD_BLEND50.
ILD_BLEND
0x00000004
 Same as ILD_BLEND50.
ILD_MASK
0x00000010
 Draws the mask.
ILD_IMAGE
0x00000020
 If the overlay does not require a mask to be drawn, set this flag.
ILD_ROP
0x00000040
 Draws the image using the raster operation code specified by the dwRop member.
ILD_OVERLAYMASK
0x00000F00
 To extract the overlay image from the fStyle member, use the logical AND to combine fStyle with the ILD_OVERLAYMASK value.
ILD_PRESERVEALPHA
0x00001000
 Preserves the alpha channel in the destination.
ILD_SCALE
0x00002000
 Causes the image to be scaled to cx, cy instead of being clipped.
ILD_DPISCALE
0x00004000
 Scales the image to the current dpi of the display.
ILD_ASYNC
0x00008000
 Windows Vista and later. Draw the image if it is available in the cache. Do not extract it automatically. The called draw method returns E_PENDING to the calling component, which should then take an alternative action, such as, provide another image and queue a background task to force the image to be loaded via ForceImagePresent using the ILFIP_ALWAYS flag. The ILD_ASYNC flag then prevents the extraction operation from blocking the current thread and is especially important if a draw method is called from the user interface (UI) thread.

Requirements

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
Header
Commctrl.h