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

Adiciona uma imagem ou imagens a uma lista de imagens, gerando uma máscara do bitmap especificado.

Sintaxe

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

Parâmetros

[in] hbmImage

Tipo: HBITMAP

Um identificador para o bitmap que contém uma ou mais imagens. O número de imagens é inferido da largura do bitmap.

[in] crMask

Tipo: COLORREF

A cor usada para gerar a máscara. Cada pixel dessa cor no bitmap especificado é alterado para preto e o bit correspondente na máscara é definido como 1. Se esse parâmetro for CLR_DEFAULT, a cor do pixel em (0,0) será usada como máscara.

[out] pi

Tipo: int*

Um ponteiro para um int que contém o índice da primeira imagem nova quando retorna, se tiver êxito, ou -1 caso contrário.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

IImageList::AddMasked copia o bitmap para uma estrutura de dados interna. Não há suporte para bitmaps com profundidade de cor maior que 8bpp. Você deve usar a função DeleteObject para excluir hbmImage e crMask depois que o método retornar.

Para usar IImageList::AddMasked, especifique Comctl32.dll versão 6 no manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commoncontrols.h
DLL	Comctl32.dll (versão 6.0 ou posterior)