función ImageList_Replace (commctrl.h)

Reemplaza una imagen de una lista de imágenes por una nueva imagen.

Sintaxis

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

Parámetros

himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes.

i

Tipo: int

Índice de la imagen que se va a reemplazar.

hbmImage

Tipo: HBITMAP

Identificador del mapa de bits que contiene la imagen.

hbmMask

Tipo: HBITMAP

Identificador del mapa de bits que contiene la máscara. Si no se usa ninguna máscara con la lista de imágenes, este parámetro se omite.

Valor devuelto

Tipo: BOOL

Devuelve un valor distinto de cero si se ejecuta correctamente o cero en caso contrario.

Comentarios

La función ImageList_Replace copia el mapa de bits en una estructura de datos interna. Asegúrese de usar la función DeleteObject para eliminar hbmImage y hbmMask después de que la función vuelva.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h
Library	Comctl32.lib
Archivo DLL	Comctl32.dll