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

Adiciona uma imagem ou imagens a uma lista de imagens.

Sintaxe

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

Parâmetros

[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.

[out] pi

Tipo: int*

Quando esse método retorna, contém um ponteiro para o índice da primeira nova imagem. Se o método não adicionar com êxito a nova imagem, esse valor será -1.

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::Add copia o bitmap para uma estrutura de dados interna. Você deve usar a função DeleteObject para excluir hbmImage e hbmMask depois que o método retornar.

Para usar IImageList::Add, 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 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commoncontrols.h
DLL	Comctl32.dll (versão 6.0 ou posterior)