IMAGELISTDRAWPARAMS structure

Contains information about an image list draw operation and is used with the IImageList::Draw function.

Syntax


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;
  DWORD      crEffect;
} IMAGELISTDRAWPARAMS;

Members

cbSize

Type: DWORD

The size of this structure, in bytes.

himl

Type: HIMAGELIST

A handle to the image list that contains the image to be drawn.

i

Type: int

The zero-based index of the image to be drawn.

hdcDst

Type: HDC

A handle to the destination device context.

x

Type: int

The x-coordinate that specifies where the image is drawn.

y

Type: int

The y-coordinate that specifies where the image is drawn.

cx

Type: int

A value that specifies the number of pixels to draw, relative to the upper-left corner of the drawing operation as specified by xBitmap and yBitmap. If cx and cy are zero, then Draw draws the entire valid section. The method does not ensure that the parameters are valid.

cy

Type: int

A value that specifies the number of pixels to draw, relative to the upper-left corner of the drawing operation as specified by xBitmap and yBitmap. If cx and cy are zero, then Draw draws the entire valid section. The method does not ensure that the parameters are valid.

xBitmap

Type: int

The x-coordinate that specifies the upper-left corner of the drawing operation in reference to the image itself. Pixels of the image that are to the left of xBitmap and above yBitmap do not appear.

yBitmap

Type: int

The y-coordinate that specifies the upper-left corner of the drawing operation in reference to the image itself. Pixels of the image that are to the left of xBitmap and above yBitmap do not appear.

rgbBk

Type: COLORREF

The image background color. This parameter can be an application-defined RGB value or one of the following values.

ValueMeaning
CLR_DEFAULT

The default background color. The image is drawn using the image list background color.

CLR_NONE

No background color. The image is drawn transparently.

 

rgbFg

Type: COLORREF

The image foreground color. This member is used only if fStyle includes the ILD_BLEND25 or ILD_BLEND50 flag. This parameter can be an application-defined RGB value or one of the following values:

ValueMeaning
CLR_DEFAULT

The default foreground color. The image is drawn using the system highlight color as the foreground color.

CLR_NONE

No blend color. The image is blended with the color of the destination device context.

 

fStyle

Type: UINT

A flag specifying the drawing style and, optionally, the overlay image. See the comments section at the end of this topic for information on the overlay image. This member can contain one or more image list drawing flags.

dwRop

Type: DWORD

A value specifying a raster operation code. These codes define how the color data for the source rectangle will be combined with the color data for the destination rectangle to achieve the final color. This member is ignored if fStyle does not include the ILD_ROP flag. Some common raster operation codes include:

ValueMeaning
BLACKNESS

Fills the destination rectangle using the color associated with index zero in the physical palette. (This color is black for the default physical palette.)

DSTINVERT

Inverts the destination rectangle.

MERGECOPY

Merges the source rectangle colors with the specified pattern by using the Boolean AND operator.

MERGEPAINT

Merges the inverted source rectangle colors with the destination rectangle colors by using the Boolean OR operator.

NOTSRCCOPY

Copies the inverted source rectangle to the destination.

NOTSRCERASE

Combines the source and destination rectangle colors by using the Boolean OR operator. Inverts the resultant color.

PATCOPY

Copies the specified pattern into the destination bitmap.

PATINVERT

Combines the specified pattern colors with the destination rectangle colors by using the Boolean XOR operator.

PATPAINT

Combines the pattern colors with the inverted source rectangle colors and combines the result with the destination rectangle colors by using the Boolean OR operator.

SRCAND

Combines the source and destination rectangle colors by using the Boolean AND operator.

SRCCOPY

Copies the source rectangle directly to the destination rectangle.

SRCERASE

Combines the destination rectangle's inverted colors with the source rectangle colors by using the Boolean AND operator.

SRCINVERT

Combines the source and destination rectangle colors by using the Boolean XOR operator.

SRCPAINT

Combines the source and destination rectangle colors by using the Boolean OR operator.

WHITENESS

Fills the destination rectangle using the color associated with index one in the physical palette. This color is white for the default physical palette.

 

fState

Type: DWORD

A flag that specifies the drawing state. This member can contain one or more image list state flags. You must use comctl32.dll version 6 to use this member. See the Remarks.

Frame

Type: DWORD

Used with the alpha blending effect.

When used with ILS_ALPHA, this member holds the value for the alpha channel. This value can be from 0 to 255, with 0 being completely transparent, and 255 being completely opaque.

You must use comctl32.dll version 6 to use this member. See the Remarks.

crEffect

Type: DWORD

A color used for the glow and shadow effects. You must use comctl32.dll version 6 to use this member. See the Remarks.

Remarks

An overlay image is an image that is drawn on top of the primary image specified in the i member of this structure. To specify an overlay image, use the bitwise OR operator to combine fStyle with the INDEXTOOVERLAYMASK macro, passing the one-based index of the overlay image in the macro. This image must have been previously specified as an overlay image using the ImageList_SetOverlayImage API.

To extract the overlay image from the fStyle, use the bitwise AND operator to mask fStyle with the ILD_OVERLAYMASK value.

Comctl32.dll version 6 is not redistributable, but it is included with Windows XP or later. To use Comctl32.dll version 6, you must specify it in a manifest. For more information on manifests, see Enabling Visual Styles.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft