commctrl.h

Macro ListView_SetImageList

Asigna una lista de imágenes a un control list-view. Se puede usar esta macro o enviar el mensaje LVM_SETIMAGELIST explícitamente.

Definición

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

Descripción

hwnd
Un manipulador del control list-view.
himl
Un manipulador de lista de imágenes a asignar.
iImageList

El tipo de lista de imágenes. Este parámetro puede ser uno de los siguientes valores:

ValorSignificado
LVSIL_NORMALLista de imágenes con iconos grandes.
LVSIL_SMALLLista de imágenes con iconos pequeños.
LVSIL_STATELista de imágenes con imágenes de estado.
LVSIL_GROUPHEADERLista de imágenes para cabecera de grupo.

Valor de retorno

Devuelve el manipulador de lista de imágenes previamente asociado con el control si tiene e´xito, o NULL en caso contrario.

Observaciones

La lista de imágenes actual será destruida cuando el control list-view sea destruido, a no ser que tenga asignado el estilo LVS_SHAREIMAGELISTS. Si se usa este mensaje para reemplazar una lista de imágenes con otra, la aplicación debe destruir explícitamente todas las listas de imágenes salvo la actualmente asignada al control.