Compartilhar via


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

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

Sintaxe

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

Parâmetros

[in] i

Tipo: int

Um valor do tipo int que contém o índice da imagem a ser substituída.

[in] hbmImage

Tipo: HBITMAP

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

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

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::Replace copia o bitmap para uma estrutura de dados interna. Você deve usar DeleteObject para excluir hbmImage e hbmMask após o retorno do método.

Para usar IImageList::Replace, 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)