Función ImageList_ReplaceIcon (commctrl.h)

Reemplaza una imagen por un icono o cursor.

Sintaxis

int ImageList_ReplaceIcon(
  [in] HIMAGELIST himl,
  [in] int        i,
  [in] HICON      hicon
);

Parámetros

[in] himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes.

[in] i

Tipo: int

Índice de la imagen que se va a reemplazar. Si i es -1, la función anexa la imagen al final de la lista.

[in] hicon

Tipo: HICON

Identificador del icono o cursor que contiene el mapa de bits y la máscara de la nueva imagen.

Valor devuelto

Tipo: int

Devuelve el índice de la imagen si se ejecuta correctamente o -1 de lo contrario.

Comentarios

Dado que el sistema no guarda hicon, puede destruirlo después de que la función devuelva si el icono o el cursor se creó mediante la función CreateIcon . No es necesario destruir hicon si fue cargado por la función LoadIcon ; el sistema libera automáticamente un recurso de icono cuando ya no es necesario.

Requisitos

Requisito	Value
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
Conjunto de API	ext-ms-win-shell-comctl32-init-l1-1-1 (introducido en Windows 10, versión 10.0.14393)