função ImageList_Add (commctrl.h)

  • Artigo

Adiciona uma imagem ou imagens a uma lista de imagens.

Sintaxe

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

Parâmetros

[in] himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

[in] hbmImage

Tipo: HBITMAP

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

[in, optional] hbmMask

Tipo: HBITMAP

Um identificador para o bitmap que contém a máscara. Se nenhuma máscara for usada com a lista de imagens, esse parâmetro será ignorado. Este parâmetro pode ser NULL.

Retornar valor

Tipo: int

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

Comentários

A função ImageList_Add copia o bitmap para uma estrutura de dados interna. Use a função DeleteObject para excluir hbmImage e hbmMask após o retorno da função.

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 commctrl.h
Biblioteca Comctl32.lib
DLL Comctl32.dll