CListCtrl::SetBkColor

Sets the background color of the list view control.

BOOL SetBkColor( 
   COLORREF cr  
);

Parameters

  • cr
    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. For information, see COLORREF in the Windows SDK.

Return Value

Nonzero if successful; otherwise zero.

Example

// Use the 3D button face color for the background.
        COLORREF crBkColor = ::GetSysColor(COLOR_3DFACE);
        m_myListCtrl.SetBkColor(crBkColor);
        ASSERT(m_myListCtrl.GetBkColor() == crBkColor);

Requirements

Header: afxcmn.h

See Also

Reference

CListCtrl Class

Hierarchy Chart

CListCtrl::GetBkColor