---
name: "ImageList_Merge"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/ImageList_Merge"
---

# ImageList\_Merge(3w)

## NAME

**ImageList\_Merge** (COMCTL32.@)

## SYNOPSIS

HIMAGELIST ImageList\_Merge\
  (\
   HIMAGELIST *himl1*,\
   INT        *i1*,\
   HIMAGELIST *himl2*,\
   INT        *i2*,\
   INT        *dx*,\
   INT        *dy*\
  )

## DESCRIPTION

Create an image list containing a merged image from two image lists.

## PARAMS

*himl1* **\[In\]**  handle to first image list.

*i1* **\[In\]**  first image index.

*himl2* **\[In\]**  handle to second image list.

*i2* **\[In\]**  second image index.

*dx* **\[In\]**  X offset of the second image relative to the first.

*dy* **\[In\]**  Y offset of the second image relative to the first.

## RETURNS

**Success:** The newly created image list. It contains a single image consisting of the second image merged with the first.

**Failure:** **NULL**, if either *himl1* or *himl2* are invalid.

## NOTES

**-** The returned image list should be deleted by the caller using ImageList\_Destroy() when it is no longer required.

**-** If either *i1* or *i2* are not valid image indices they will be treated as a blank image.

## IMPLEMENTATION

Declared in **"commctrl.h"**.

Implemented in **"dlls/comctl32/imagelist.c"**.

Debug channel **"imagelist"**.