Função ImageList_AddMasked (commctrl.h)

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