función ImageList_Add (commctrl.h)

Agrega una imagen o imágenes a una lista de imágenes.

Sintaxis

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

Parámetros

[in] himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes.

[in] hbmImage

Tipo: HBITMAP

Identificador del mapa de bits que contiene la imagen o las imágenes. El número de imágenes se deduce del ancho del mapa de bits.

[in, optional] hbmMask

Tipo: HBITMAP

Identificador del mapa de bits que contiene la máscara. Si no se usa ninguna máscara con la lista de imágenes, este parámetro se omite. Este parámetro puede ser NULL.

Valor devuelto

Tipo: int

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

Comentarios

La función ImageList_Add copia el mapa de bits en una estructura de datos interna. Asegúrese de usar la función DeleteObject para eliminar hbmImage y hbmMask después de que la función devuelva.

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