ListView_SetBkColor macro (commctrl.h)

  • Article

Sets the background color of a list-view control. You can use this macro or send the LVM_SETBKCOLOR message explicitly.

Syntax

BOOL ListView_SetBkColor(
   HWND     hwnd,
   COLORREF clrBk
);

Parameters

hwnd

Type: HWND

A handle to the list-view control.

clrBk

Type: COLORREF

The background color to set or the CLR_NONE value for no background color. List-view controls with background colors redraw themselves significantly faster than those without background colors.

Return value

Type: BOOL

Returns TRUE if successful, or FALSE otherwise.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commctrl.h