Compartilhar via


função ImageList_Replace (commctrl.h)

Substitui uma imagem em uma lista de imagens por uma nova imagem.

Sintaxe

BOOL ImageList_Replace(
  HIMAGELIST himl,
  int        i,
  HBITMAP    hbmImage,
  HBITMAP    hbmMask
);

Parâmetros

himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

i

Tipo: int

Um índice da imagem a ser substituída.

hbmImage

Tipo: HBITMAP

Um identificador para o bitmap que contém a imagem.

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.

Valor retornado

Tipo: BOOL

Retorna diferente de zero se tiver êxito; caso contrário, zero.

Comentários

A função ImageList_Replace 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

   
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