Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function copies images within a specified image list.

Syntax 

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

Parameters

himlDstand himlSrc

[in] Handle to an image list that is the target of the copy operation. Both parameters must be identical.

iDst

[in] Zero-based index of the image to be used as the destination of the copy operation.

iSrc

[in] Zero-based index of the image to be used as the source of the copy operation.

uFlags

[in] Bit flag value that specifies the type of copy operation to be made. This parameter can be one of the following values.

Value Description

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

Nonzero indicates success. Zero indicates failure.

Requirements

Header commctrl.h
Library commctrl.lib, Imgctl.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later