commctrl.h


ImageList_AddIcon

La macro ImageList_AddIcon añade un icono o un cursor a una lista de imágenes. ImageList_AddIcon llama a la función ImageList_ReplaceIcon.

Sintaxis

int ImageList_AddIcon(
    HIMAGELIST himl,  // manipulador de lista de imágenes
    HICON hicon       // manipulador de icono o cursor
   );

Parámetros

himl
Manipulador de lista de imágenes. Si este parámetro identifica a una lista de imágenes con máscara, la macro copia tanto el mapa de bits de la imagen como el de la máscara del icono o cursor. Si este parámetro identifica a una lista de imágenes sin máscara, la macro sólo copia el mapa de bits de la imagen.
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, puede ser destruido después de que la macro regrese si el icono o el cursor fue creado por 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 se necesita.

La macro ImageList_AddIcon se define de este modo:

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