Compartilhar via

Função ImageList_AddMasked (commctrl.h)

  • Artigo

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

Sintaxe

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

Parâmetros

himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

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.

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.

Valor retornado

Tipo: int

Retorna o índice da primeira nova imagem se tiver êxito ou -1 caso contrário.

Comentários

A função ImageList_AddMasked copia o bitmap para uma estrutura de dados interna. Não há suporte para bitmaps com profundidade de cor maior que 8bpp. Use a função DeleteObject para excluir hbmImage após o retorno da função.

Requisitos

   
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 commctrl.h
Biblioteca Comctl32.lib
DLL Comctl32.dll
Conjunto de APIs ext-ms-win-shell-comctl32-init-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)