commctrl.h

Macro ListView_SetBkImage

Asigna la imagen de fondo en un control list-view. Se puede usar esta macro o enviar el mensaje LVM_SETBKIMAGE explícitamente.

Definición

int ListView_SetBkImage(
    HWND hwnd,
    LPLVBKIMAGE plvbki
);

Descripción

hwnd
Un manipulador del control list-view.
plvbki
Un puntero a una estructura LVBKIMAGE que contiene la información sobre la nueva imagen de fondo.

Valor de retorno

Devuelve un valor distinto de cero si tiene éxito, o cero en caso contrario. Devuelve cero si el miembro ulFlags de la estructura LVBKIMAGE es LVBKIF_SOURCE_NONE.

Observaciones

Ya que el control list-view usa OLE COM para manipular las imágenes de fondo, la aplicación que llama debe invocar a CoInitialize o OleInitialize antes de usar esta macro. Es mejor invocar una de esas funciones cuando la aplicación se inicia e invocar CoUninitialize o OleUninitialize cuando la aplicación termine.