Compartir a través de

Método IImageList::Add (commoncontrols.h)

  • Artículo

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

Sintaxis

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

Parámetros

[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.

[out] pi

Tipo: int*

Cuando este método vuelve, contiene un puntero al índice de la primera imagen nueva. Si el método no puede agregar correctamente la nueva imagen, este valor es -1.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

IImageList::Add copia el mapa de bits en una estructura de datos interna. Debe usar la función DeleteObject para eliminar hbmImage y hbmMask después de que el método devuelva.

Para usar IImageList::Add, especifique Comctl32.dll versión 6 en el manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commoncontrols.h
Archivo DLL Comctl32.dll (versión 6.0 o posterior)