Compartilhar via

Função ImageList_ReplaceIcon (commctrl.h)

  • Artigo

Substitui uma imagem por um ícone ou cursor.

Sintaxe

int ImageList_ReplaceIcon(
  [in] HIMAGELIST himl,
  [in] int        i,
  [in] HICON      hicon
);

Parâmetros

[in] himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

[in] i

Tipo: int

O índice da imagem a ser substituída. Se i for -1, a função acrescentará a imagem ao final da lista.

[in] hicon

Tipo: HICON

O 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 função 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.

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
Conjunto de APIs ext-ms-win-shell-comctl32-init-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)