macro ImageList_AddIcon (commctrl.h)

Adiciona um ícone ou cursor a uma lista de imagens. ImageList_AddIcon chama a função ImageList_ReplaceIcon .

Sintaxe

void ImageList_AddIcon(
   himl,
   hicon
);

Parâmetros

himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens. Se esse parâmetro identificar uma lista de imagens mascaradas, a macro copiará os bitmaps de imagem e máscara do ícone ou cursor. Se esse parâmetro identificar uma lista de imagens não máscaras, a macro copiará apenas o bitmap de imagem.

hicon

Tipo: HICON

Um identificador para o ícone ou cursor que contém o bitmap e a máscara para a nova imagem.

Retornar valor

Tipo: int

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

Comentários

Como o sistema não salva hicon, você pode destruí-lo depois que a macro retornar se o ícone ou cursor tiver sido criado pela função CreateIcon . Você não precisará destruir hicon se ele tiver sido carregado pela função LoadIcon ; o sistema libera automaticamente um recurso de ícone quando ele não é mais necessário.

A macro ImageList_AddIcon é definida da seguinte maneira:

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

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