Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This macro sets the background image in a list-view control. You can use this macro or send the LVM_SETBKIMAGEmessage explicitly.

Syntax 

BOOL ListView_SetBkImage(
   HWND 
hwndLV,
   LPLVBKIMAGE 
plvbki
);

Parameters

hwndLV

Handle to the list-view control.

plvbki

Pointer to an LVBKIMAGEstructure that contains the new background image information.

Return Value

Returns nonzero if successful, or zero otherwise.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also