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 |
|
Unicode and ANSI names |
LVM_SETBKIMAGEW (Unicode) and LVM_SETBKIMAGEA (ANSI) |