Share via

ImageList_Replace

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function replaces an image in an image list with a new image.

Syntax

BOOL WINAPI ImageList_Replace(
  HIMAGELIST himl, 
  int i, 
  HBITMAP hbmImage, 
  HBITMAP hbmMask 
);

Parameters

  • himl
    [in] Handle to the image list.
  • i
    [in] Index of the image to replace.
  • hbmImage
    [in] Handle to the bitmap that contains the image.
  • hbmMask
    [in] Handle to the bitmap that contains the mask. If no mask is used with the image list, this parameter is ignored.

Return Value

Nonzero indicates success. Zero indicates failure.

Remarks

The ImageList_Replace function copies the bitmap to an internal data structure. Be sure to use the DeleteObject function to delete hbmImage and hbmMask after the function returns.

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

Reference

DeleteObject