Compartilhar via


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

Substitui uma imagem por um ícone ou cursor.

Sintaxe

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

Parâmetros

[in] i

Tipo: int

Um valor do tipo int que contém o índice da imagem a ser substituída. Se i for -1, a função adicionará a imagem ao final da lista.

[in] hicon

Tipo: HICON

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

[out] pi

Tipo: int*

Um ponteiro para um int que conterá o índice da imagem no retorno se tiver êxito ou -1 caso contrário.

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

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

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