Export (0) Print
Expand All

IImageList::Draw method

Draws an image list item in the specified device context.

Syntax


HRESULT Draw(
  [in]  IMAGELISTDRAWPARAMS *pimldp
);

Parameters

pimldp [in]

Type: IMAGELISTDRAWPARAMS*

A pointer to an IMAGELISTDRAWPARAMS structure that contains the drawing parameters.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Overlay images draw transparently over the primary image specified in the i parameter of IMAGELISTDRAWPARAMS. You specify an overlay image in the fStyle, parameter of IMAGELISTDRAWPARAMS using the INDEXTOOVERLAYMASK macro to shift the one-based index of the overlay image. Use the OR operator to combine the macro's return value with the drawing style flags specified in fStyle. You must first specify this image as an overlay image by using IImageList::SetOverlayImage.

To use IImageList::Draw, specify Comctl32.dll version 6 in the manifest. For more information on manifests, see Enabling Visual Styles.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

CommonControls.h

IDL

CommonControls.idl

DLL

Comctl32.dll (version 6.0 or later)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft