lvm-setbkimage.md

title	description	ms.assetid	keywords	topic_type	api_name	api_location	api_type	ms.topic	ms.date
LVM_SETBKIMAGE message (Commctrl.h)	Sets the background image in a list-view control. You can send this message explicitly or by using the ListView\_SetBkImage macro.	8fdd363c-ac12-498b-80b7-aaa5741cfd76	LVM_SETBKIMAGE message Windows Controls	apiref	LVM_SETBKIMAGE LVM_SETBKIMAGEA LVM_SETBKIMAGEW	Commctrl.h	HeaderDef	reference	05/31/2018

LVM_SETBKIMAGE message

Sets the background image in a list-view control. You can send this message explicitly or by using the ListView_SetBkImage macro.

Parameters

wParam

Must be zero.

lParam

Pointer to a LVBKIMAGE structure that contains the new background image information.

Return value

Returns nonzero if successful, or zero otherwise. Returns zero if the ulFlags member of the LVBKIMAGE structure is LVBKIF_SOURCE_NONE.

Remarks

Because the list-view control uses OLE COM to manipulate the background images, the calling application must call CoInitialize or OleInitialize before sending this message. It is best to call one of these functions when the application is initialized and call either CoUninitialize or OleUninitialize when the application is terminating.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Commctrl.h
Unicode and ANSI names	LVM_SETBKIMAGEW (Unicode) and LVM_SETBKIMAGEA (ANSI)

See also

LVM_GETBKIMAGE