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 creates a new image by combining two existing images. ImageList_Mergealso creates a new image list to store the image.

Syntax 

HIMAGELIST WINAPI ImageList_Merge(
  HIMAGELIST 
himl1, 
  int 
i1, 
  HIMAGELIST 
himl2, 
  int 
i2, 
  int 
dx, 
  int 
dy 
);

Parameters

himl1

[in] Handle to the first image list.

i1

[in] Index of the first existing image.

himl2

[in] Handle to the second image list.

i2

[in] Index of the second existing image.

dxand dy

[in] Offset of the second image relative to the first image.

Return Value

The handle to the new image list indicates success. NULL indicates failure.

Remarks

The new image consists of the second existing image drawn transparently over the first. The mask for the new image is the result of performing a logical OR operation on the masks of the two existing images.

Requirements

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

See Also