Compartilhar via


função ImageList_Remove (commctrl.h)

Remove uma imagem de uma lista de imagens.

Sintaxe

BOOL ImageList_Remove(
  HIMAGELIST himl,
  int        i
);

Parâmetros

himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

i

Tipo: int

O índice da imagem a ser removida. Se esse parâmetro for -1, a função removerá todas as imagens.

Valor retornado

Tipo: BOOL

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

Comentários

Quando uma imagem é removida, os índices das imagens restantes são ajustados para que os índices de imagem sempre variam de zero a um a menos do 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.

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

Confira também

ImageList_RemoveAll