Función ImageList_AddMasked (commctrl.h)

Agrega una imagen o imágenes a una lista de imágenes, lo que genera una máscara a partir del mapa de bits especificado.

Sintaxis

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

Parámetros

himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes.

hbmImage

Tipo: HBITMAP

Identificador del mapa de bits que contiene una o varias imágenes. El número de imágenes se deduce del ancho del mapa de bits.

crMask

Tipo: COLORREF

Color usado para generar la máscara. Cada píxel de este color en el mapa de bits especificado se cambia a negro y el bit correspondiente de la máscara se establece en 1. Si este parámetro es CLR_DEFAULT, el color del píxel en (0,0) se usa como máscara.

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_AddMasked copia el mapa de bits en una estructura de datos interna. No se admiten mapas de bits con profundidad de color superior a 8bpp. Asegúrese de usar la función DeleteObject para eliminar hbmImage después de que la función devuelva.

Requisitos

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
Conjunto de API	ext-ms-win-shell-comctl32-init-l1-1-1 (introducido en Windows 10, versión 10.0.14393)