Método IImageList::AddMasked (commoncontrols.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

HRESULT AddMasked(
  [in]  HBITMAP  hbmImage,
  [in]  COLORREF crMask,
  [out] int      *pi
);

Parámetros

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

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

[out] pi

Tipo: int*

Puntero a un valor int que contiene el índice de la primera imagen nueva cuando devuelve, si se ejecuta correctamente o -1 de lo contrario.

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

Nota Se modificará el mapa de bits pasado en hbmImage .

 

IImageList::AddMasked copia el mapa de bits en una estructura de datos interna. No se admiten mapas de bits con una profundidad de color superior a 8bpp. Debe usar la función DeleteObject para eliminar hbmImage y crMask después de que el método devuelva.

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

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	commoncontrols.h
Archivo DLL	Comctl32.dll (versión 6.0 o posterior)