基于MFC的CListCtrl实现虚拟列表控件

1. 在建立的工程的对话框里拖入一个ListCtrl控件，然后将控件的属性View改成“Report”，“所有者数据”改成True。如下图所示：

2. 在我们的程序中需要在ListCtrl的父窗口的类里面响应CListCtrl的跟虚拟控件相关的几个消息事件，在父窗口的消息宏里面加入下面几个宏：

ON_NOTIFY(LVN_ODCACHEHINT,IDC_LIST1, OnOwnerDataHint)
ON_NOTIFY(LVN_GETDISPINFO, IDC_LIST1, OnGetDispInfo)
ON_NOTIFY(NM_CUSTOMDRAW, IDC_LIST1, OnCustomDraw)

关于这几个消息的说明：

LVN_ODCACHEHINT：该消息在拖动ListCtrl滚动条或翻页的时候会触发，消息的参数携带了当前页的记录范围（当前页记录是从第i到第j个，其中i，j是记录的行号），用户可以在这个消息函数里完成一些比较耗时的加载数据操作，对未加载的数据（翻页时新显示的Line项）读出来放到内存进行缓冲，以便到后面要回调的时候就可以快速读内存。

LVN_GETDISPINFO：该消息的响应函数用于对每行记录的内容进行赋值，消息带的参数为一个LV_ITEM结构体：

typedef struct tagLVITEMA
{
    UINT mask;
    int iItem;
    int iSubItem;
    UINT state;
    UINT stateMask;
    LPSTR pszText;
    int cchTextMax;
    int iImage;
    LPARAM lParam;
#if (_WIN32_IE >= 0x0300)
    int iIndent;
#endif
#if (_WIN32_WINNT >= 0x0501)
    int iGroupId;
    UINT cColumns; // tile view columns
    PUINT puColumns;
#endif
#if _WIN32_WINNT >= 0x0600 // Will be unused downlevel, but sizeof(LVITEMA) must be equal to sizeof(LVITEMW)
    int* piColFmt;
    int iGroup; // readonly. only valid for owner data.
#endif
} LVITEMA, *LPLVITEMA;

上面这个结构体里面的一些成员变量意义，iItem：Line项行号；iSubItem：列号；pszTest：该列的字符串内容；iImage：图标索引；mask：跟项相关的风格属性。

在 LVN_GETDISPINFO 通知消息的处理程序中，必须检查正在请求的信息的类型。可能值是：

• LVIF_TEXT   必须填写 pszText 成员。
• LVIF_IMAGE   必须填写 iImage 成员。
• LVIF_INDENT   必须填写 iIndent 成员。
• LVIF_PARAM   必须填写 lParam 成员。
• LVIF_STATE   必须填写 state 成员。

然后应将所有请求的信息提供给框架。

NM_CUSTOMDRAW：该消息处理函数用于定义每行Line项的文字颜色和背景的颜色属性。

 

3. 实现消息处理函数，下面代码是我的例程中的实现方式：

创建列表列
m_LstCtr.InsertColumn(0, L"列1", LVCFMT_CENTER, 40);
m_LstCtr.InsertColumn(1, L"列2", LVCFMT_CENTER, 80);
m_LstCtr.InsertColumn(2, L"列3", LVCFMT_CENTER, 0);	//列宽为零, 标识隐藏该列
m_LstCtr.InsertColumn(3, L"列4", LVCFMT_CENTER, 45);
m_LstCtr.InsertColumn(4, L"列5", LVCFMT_CENTER, 40);
m_LstCtr.InsertColumn(5, L"列6", LVCFMT_CENTER, 80);
//扩展属性 LVS_EX_DOUBLEBUFFER 用来防闪烁
m_LstCtr.SetExtendedStyle(LVS_EX_GRIDLINES | LVS_EX_FLATSB | LVS_EX_FULLROWSELECT | LVS_EX_DOUBLEBUFFER );  
 
 
//--触发LVN_GETDISPINFO消息
 
//dwCount, 表示当前记录数
m_LstCtr.SetItemCountEx(dwCount, LVSICF_NOSCROLL|LVSICF_NOINVALIDATEALL);
//Invalidate必须加, 窗口失去焦点时, 不会实时显示数据
m_LstCtr.Invalidate();	
 
 
 
//--LVN_GETDISPINFO
void CSLConsoleDlg::OnLvnGetdispinfoList(NMHDR *pNMHDR, LRESULT *pResult)
{
	//--MyData我的自定义数据集, 大家可以根据实际情况取自己的数据
	NMLVDISPINFO *pDispInfo = reinterpret_cast<NMLVDISPINFO*>(pNMHDR);			
	LV_ITEM* pItem= &(pDispInfo)->item;
	
	if ( pItem->mask & LVIF_TEXT )
	{		
		//m_LstCtr.SetRedraw(FALSE);
		CString text;		
		switch (pItem->iSubItem)
		{
		case 0:
			{
				text.Format(L"%d", itemid + 1);
				lstrcpyn(pItem->pszText, text, pItem->cchTextMax);
				break;
			}
		case 1:
			{
				text = MyData[pItem->iItem].Col1;
				lstrcpyn(pItem->pszText, text, pItem->cchTextMax);
				break;
			}
		case 2:
			{
				text = text = MyData[pItem->iItem].Col1;
				lstrcpyn(pItem->pszText, text, pItem->cchTextMax);
				break;
			}
		case 3:
			{
				text.Format(L"%d", MyData[pItem->iItem].Col1;);
				lstrcpyn(pItem->pszText, text, pItem->cchTextMax);
				break;
			}
		case 4:
			{
				text = MyData[pItem->iItem].Col1;
				lstrcpyn(pItem->pszText, text, pItem->cchTextMax);
				break;
			}
		case 5:
			{
				text = MyData[pItem->iItem].Col1;
				lstrcpyn(pItem->pszText, text, pItem->cchTextMax);
				break;
			}						
		default:
			break;
		}   
	}
}

由于这种类型的列表控件 (List Control) 是提供给大的数据集的，因此建议您缓存请求的项数据以提高检索性能。框架提供缓存提示机制，通过发送LVN_ODCACHEHINT 通知消息来帮助优化缓存。但是，您必须使用一种稍有不同的方法来处理该通知。使用“属性”窗口，重写列表控件 (List Control) 对象的 OnChildNotify 函数。

在处理程序体中检查 LVN_ODCACHEHINT 消息，如果找到，则准备缓存。

NMLVCACHEHINT* pcachehint=NULL;

if (message == WM_NOTIFY)
    {
        NMHDR* phdr = (NMHDR*)lParam;

        switch(phdr->code)
        {
        case LVN_ODCACHEHINT:
            pcachehint= (NMLVCACHEHINT*) phdr;
// Load the cache with the recommended range.
            PrepCache(pcachehint->iFrom, pcachehint->iTo);
            break;
        default:
            return CListCtrl::OnChildNotify(message, wParam, lParam, pLResult);
        }
        return FALSE;
    }
    else
        return CListCtrl::OnChildNotify(message, wParam, lParam, pLResult);

当需要查找特定的列表控件项时，虚拟列表控件发送 LVN_ODFINDITEM 通知消息。列表视图 (ListView) 控件接收快捷键访问或接收LVM_FINDITEM 消息时发送该通知消息。搜索信息以 LVFINDINFO 结构的格式发送，该结构是 NMLVFINDITEM 结构的成员。通过重写列表控件 (List Control) 对象的 OnChildNotify 函数来处理该消息，并在处理程序体中检查 LVN_ODFINDITEM 消息。如果找到此消息，则执行相应的操作。

您应该准备好搜索与列表视图 (ListView) 控件给定的信息匹配的项。如果成功，则应返回项的索引；如果没有找到匹配项，则返回 -1。