Help Center
/
Help Center›AfxNova›CListView Class

CListView.SetBkImagemethod

Sets the background image in a list-view control.

WindowsmethodCListView.incdocumented

Syntax

FUNCTION SetBkImage (BYVAL hListView AS HWND, BYVAL pvbki AS LVBKIMAGE PTR) AS BOOLEAN
FUNCTION SetBkImage (BYVAL hListView AS HWND, BYREF vbki AS LVBKIMAGE) AS BOOLEAN

Parameters

NameDescription
hListViewHandle to the ListView control.
pvbkiA pointer to an LVBKIMAGE structure that contains the new background image information.
vbkiAn 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.

Description

Sets the background image in a list-view control.

Remarks

Because the list-view control uses OLE COM to manipulate the background images, the calling application must call CoInitialize or OleInitialize before using this method. 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.

Reference

  • Include file CListView.inc
  • Defined in AfxNova/CListView.inc:1440
  • Documented in Windows/WIndows Controls/CListView Class.md
  • Topic: CListView Class