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

Remove uma imagem de uma lista de imagens.

Sintaxe

HRESULT Remove(
  [in] int i
);

Parâmetros

[in] i

Tipo: int

Um valor do tipo int que contém o índice da imagem a ser removida. Se esse parâmetro for -1, o método removerá todas as imagens.

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

Quando uma imagem é removida, os índices das imagens restantes se ajustam para que elas sempre intervalom de zero a um menor que o número de imagens na lista de imagens. Por exemplo, se você remover a imagem no índice 0, a imagem 1 se tornará a imagem 0, a imagem 2 se tornará a imagem 1 e assim por diante.

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