Prev Next

ImageList_Merge info  Overview  Group

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

HIMAGELIST ImageList_Merge(

    HIMAGELIST himl1,

    int i1,

    HIMAGELIST himl2,

    int i2,

    int dx,

    int dy

   );

Parameters

himl1 
Handle to the first image list.
i1
Index of the first existing image.
himl2 
Handle to the second image list.
i2
Index of the second existing image.
dx and dy
Offset of the second image relative to the first image.

Return Values

If the function succeeds, the return value is the handle of the new image list.

If the function fails, the return value is NULL.

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.