ListView_SetImageList macro (commctrl.h)

Atribui uma lista de imagens a um controle de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_SETIMAGELIST explicitamente.

Sintaxe

HIMAGELIST ListView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   int        iImageList
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para o controle de exibição de lista.

himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens a ser atribuída.

iImageList

Tipo: int

O tipo de lista de imagens. Esse parâmetro pode ser um dos seguintes valores:

Valor Significado
LVSIL_NORMAL
Lista de imagens com ícones grandes.
LVSIL_SMALL
Lista de imagens com ícones pequenos.
LVSIL_STATE
Lista de imagens com imagens de estado.
LVSIL_GROUPHEADER
Lista de imagens para cabeçalho de grupo.

Valor de retorno

Tipo: HIMAGELIST

Retorna o identificador para a lista de imagens anteriormente associada ao controle se tiver êxito ou NULL caso contrário.

Observações

A lista de imagens atual será destruída quando o controle de exibição de lista for destruído, a menos que o estilo LVS_SHAREIMAGELISTS esteja definido. Se você usar essa mensagem para substituir uma lista de imagens por outra, seu aplicativo deverá destruir explicitamente todas as listas de imagens diferentes da atual.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h