ImageList_Merge

This function creates a new image by combining two existing images. ImageList_Merge also creates a new image list to store the image.

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.
  • dx and dy
    [in] Offset of the second image relative to the first image.

Return Values

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

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h   Commctrl.lib, Imgctl.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

ImageList_Create

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.