CMFCListCtrl Class

Article
01/08/2013

The CMFCListCtrl class extends the functionality of CListCtrl Class class by supporting the advanced header control functionality of the CMFCHeaderCtrl Class.

class CMFCListCtrl : public CListCtrl

Members

Public Methods

Name	Description
CMFCListCtrl::EnableMarkSortedColumn	Enables the ability to mark a sorted column with a different background color.
CMFCListCtrl::EnableMultipleSort	Enables multiple sort mode.
CMFCListCtrl::GetHeaderCtrl	Returns a reference to the underlined header control.
CMFCListCtrl::IsMultipleSort	Checks if the list control is in multiple sort mode.
CMFCListCtrl::OnCompareItems	Called by the framework when it must compare two list control items.
CMFCListCtrl::OnGetCellBkColor	Called by the framework when it must determine the background color of an individual cell.
CMFCListCtrl::OnGetCellFont	Called by the framework when it must obtain the font for the cell being drawn.
CMFCListCtrl::OnGetCellTextColor	Called by the framework when it must determine the text color of an individual cell.
CMFCListCtrl::RemoveSortColumn	Removes a sort column from the list of sorted columns.
CMFCListCtrl::SetSortColumn	Sets the current sorted column and the sort order.
CMFCListCtrl::Sort	Sorts the list control.

Remarks

CMFCListCtrl offers two enhancements to CListCtrl Class class. First, it indicates that column sorting is an available option by automatically drawing a sort arrow on the header. Second, it supports data sorting on multiple columns at the same time.

Example

The following example demonstrates how to use various methods in the CMFCListCtrl class. The example shows how to create a list control, insert columns, insert items, set the text of an item, and set the font of the list control. This code snippet is part of the Visual Studio Demo sample.

    CMFCListCtrl m_wndWatch;


...


    // DWORD dwStyle 
    // CRect rectDummy
    m_wndWatch.Create(dwStyle, rectDummy, this, ID_LIST_1);
    m_wndWatch.SendMessage(LVM_SETEXTENDEDLISTVIEWSTYLE, 0, LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);
    m_wndWatch.InsertColumn(0, _T("Variable"), LVCFMT_LEFT, 100);
    m_wndWatch.InsertColumn(1, _T("Value"), LVCFMT_LEFT, 100);

    m_wndWatch.InsertItem(0, _T("m_nCount"));
    m_wndWatch.SetItemText(0, 1, _T("100"));

    m_wndWatch.SetFont(&m_Font);