Compartir a través de

macro ImageList_AddIcon (commctrl.h)

  • Artículo

Agrega un icono o cursor a una lista de imágenes. ImageList_AddIcon llama a la función ImageList_ReplaceIcon .

Sintaxis

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

Parámetros

himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes. Si este parámetro identifica una lista de imágenes enmascarada, la macro copia los mapas de bits de imagen y máscara del icono o cursor. Si este parámetro identifica una lista de imágenes sin máscara, la macro copia solo el mapa de bits de imagen.

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 macro devuelva si la función CreateIcon creó el icono o el cursor. No es necesario destruir hicon si la función LoadIcon la cargó; el sistema libera automáticamente un recurso de icono cuando ya no es necesario.

La macro ImageList_AddIcon se define de la siguiente manera:

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

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