Compartir a través de

función ImageList_Add (commctrl.h)

  • Artículo

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