macro ImageList_AddIcon (commctrl.h)
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 enmascaradas, la macro copia tanto la imagen como los mapas de bits de 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
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.
Observaciones
Dado que el sistema no guarda hicon, puede destruirlo después de que la macro devuelva si el icono o el cursor se creó mediante la función CreateIcon. No es necesario destruir hicon si lo cargó la función LoadIcon; 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 | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de | Windows |
| encabezado de | commctrl.h |