ImageList_Merge.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

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

Defined in "commctrl.h".

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

Debug channel "imagelist".