commctrl.h


ImageList_AddMasked

La función ImageList_AddMasked añade una imagen o imágenes a una lista de imágenes, generando una máscara desde el mapa de bits especificado.

Sintaxis

int ImageList_AddMasked(
    HIMAGELIST himl,  // manipulador de la lista de imágenes
    HBITMAP hbmImage, // manipulador del mapa de bits
    COLORREF crMask   // color usado para generar la máscara
   );

Parámetros

himl
Manipulador de lista de imágenes.
hbmImage
Manipulador del mapa de bits que contiene una o más imágenes. El número de imágenes se calcula a partir de la anchura del mapa de bits.
crMask
Color usado para generar la máscara. Cada pixel de este color en el mapa de bits especificado se cambia a negro, y el bit en la máscara se asigna a uno.

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

La función ImageList_AddMasked copia el mapa de bits a una estructura de datos interna. Hay que asegurarse de usar la función DeleteObject para borrar hbmImage y crMask después de que la función regrese.