commctrl.h


ImageList_ReplaceIcon

The ImageList_ReplaceIcon function replaces an image with an icon or cursor.

Sintaxis

int ImageList_ReplaceIcon(
    HIMAGELIST himl, 	
    int i, 	
    HICON hicon	
   );

Parámetros

himl
Manipulador de lista de imágenes.
i
Índice de la imagen a reemplazar.
hicon
Manipulador del icono o cursor que contiene el mapa de bits y la máscara para la nueva imagen.

Valor de retorno

Si la macro tiene éxito, el valor de retorno es el índice de la nueva imagen.

Si la función falla, el valor de retorno es -1.

Observaciones

ya que el sistema no guarda hicon, se puede destruir después de que la función regrese si el icono o el cursor fue creado por la función CreateIcon. No se necesita destruir hicon si fue cargado por la función LoadIcon; el sistema libera automáticamente un recurso de icono cuando ya no se necesita.