ImageList_Copy function

Copies images within a given image list.

Syntax


BOOL ImageList_Copy(
   HIMAGELIST himlDst,
   int        iDst,
   HIMAGELIST himlSrc,
   int        iSrc,
   UINT       uFlags
);

Parameters

himlDst

Type: HIMAGELIST

A handle to an image list that is the target of the copy operation. In current versions of Windows, both himlDst and himlSrc must be identical.

iDst

Type: int

The zero-based index of the image to be used as the destination of the copy operation.

himlSrc

Type: HIMAGELIST

A handle to an image list that is the target of the copy operation. In current versions of Windows, both himlDst and himlSrc must be identical.

iSrc

Type: int

The zero-based index of the image to be used as the source of the copy operation.

uFlags

Type: UINT

the bit flag value that specifies the type of copy operation to be made. This parameter can be one of the following values:

ValueMeaning
ILCF_MOVE

The source image is copied to the destination image's index. This operation results in multiple instances of a given image.

ILCF_SWAP

The source and destination images exchange positions within the image list.

 

Return value

Type: BOOL

Returns nonzero if successful, or zero otherwise.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

Library

Comctl32.lib

DLL

Comctl32.dll (version 4.70 or later)

 

 

Show: