CListCtrl 虚拟列表（Virtual List）数据量分析

源码资源网

## CListCtrl 虚拟列表（Virtual List）数据量分析

### OnGetdispinfo 机制说明

`OnGetdispinfoListFiles` 是 **虚拟列表控件（Virtual List Control）** 的回调函数，用于按需获取显示数据。

---

### 理论最大数据量

| 限制因素 | 最大值 |
|----------|--------|
| **CListCtrl 项目数** | 约 **1 亿条**（100,000,000） |
| **32位程序内存限制** | 约 2GB |
| **64位程序内存限制** | 取决于系统内存 |
| **实际建议值** | **1000万条** 以内流畅 |

---

### 虚拟列表 vs 普通列表

| 特性 | 普通列表 | 虚拟列表 (LVS_OWNERDATA) |
|------|----------|-------------------------|
| 数据存储 | 控件内部存储 | 外部数据源 |
| 内存占用 | 高（每项都存储） | 低（只显示可见项） |
| 最大数据量 | 约 10万条 | 约 1亿条 |
| 加载速度 | 慢 | 快 |

---

### 虚拟列表实现示例

```cpp
#pragma once

#include <vector>
#include <afxcmn.h>

// 数据结构
struct FileInfo {
    CString strFileName;
    CString strFilePath;
    CString strFileSize;
    CString strModifyTime;
    int nStatus;
};

class CDlgUploadCP03 : public CDialogEx
{
public:
    CDlgUploadCP03(CWnd* pParent = nullptr);

protected:
    CListCtrl m_listFiles;
    std::vector<FileInfo> m_vecFiles;  // 外部数据源

    virtual BOOL OnInitDialog();
    afx_msg void OnGetdispinfoListFiles(NMHDR* pNMHDR, LRESULT* pResult);
    afx_msg void OnOdfinditemListFiles(NMHDR* pNMHDR, LRESULT* pResult);
    afx_msg void OnOdcachehintListFiles(NMHDR* pNMHDR, LRESULT* pResult);

    DECLARE_MESSAGE_MAP()
};
```

```cpp
#include "stdafx.h"
#include "DlgUploadCP03.h"

BEGIN_MESSAGE_MAP(CDlgUploadCP03, CDialogEx)
    ON_NOTIFY(LVN_GETDISPINFO, IDC_LIST_FILES, &CDlgUploadCP03::OnGetdispinfoListFiles)
    ON_NOTIFY(LVN_ODFINDITEM, IDC_LIST_FILES, &CDlgUploadCP03::OnOdfinditemListFiles)
    ON_NOTIFY(LVN_ODCACHEHINT, IDC_LIST_FILES, &CDlgUploadCP03::OnOdcachehintListFiles)
END_MESSAGE_MAP()

BOOL CDlgUploadCP03::OnInitDialog()
{
    CDialogEx::OnInitDialog();

    // 设置为虚拟列表样式
    m_listFiles.ModifyStyle(0, LVS_OWNERDATA | LVS_REPORT);

    // 设置扩展样式
    m_listFiles.SetExtendedStyle(
        LVS_EX_FULLROWSELECT |
        LVS_EX_GRIDLINES |
        LVS_EX_DOUBLEBUFFER);  // 双缓冲减少闪烁

    // 添加列
    m_listFiles.InsertColumn(0, _T("文件名"), LVCFMT_LEFT, 200);
    m_listFiles.InsertColumn(1, _T("路径"), LVCFMT_LEFT, 300);
    m_listFiles.InsertColumn(2, _T("大小"), LVCFMT_RIGHT, 100);
    m_listFiles.InsertColumn(3, _T("修改时间"), LVCFMT_LEFT, 150);
    m_listFiles.InsertColumn(4, _T("状态"), LVCFMT_CENTER, 80);

    // 模拟加载大量数据（100万条）
    LoadData(1000000);

    return TRUE;
}

void CDlgUploadCP03:oadData(int nCount)
{
    // 预分配空间
    m_vecFiles.reserve(nCount);
    m_vecFiles.clear();

    for (int i = 0; i < nCount; i++) {
        FileInfo info;
        info.strFileName.Format(_T("File_%07d.txt"), i);
        info.strFilePath.Format(_T("C:\\Data\\Folder%d\\File_%07d.txt"), i / 1000, i);
        info.strFileSize.Format(_T("%d KB"), (i % 10000) + 1);
        info.strModifyTime.Format(_T("2025-01-01 %02d:%02d:%02d"),
                                   (i / 3600) % 24, (i / 60) % 60, i % 60);
        info.nStatus = i % 3;  // 0=待上传, 1=上传中, 2=已完成
        m_vecFiles.push_back(info);
    }

    // 设置虚拟列表的项目数量
    m_listFiles.SetItemCountEx((int)m_vecFiles.size(), LVSICF_NOSCROLL);
}

// ==================== 核心回调：获取显示数据 ====================
void CDlgUploadCP03::OnGetdispinfoListFiles(NMHDR* pNMHDR, LRESULT* pResult)
{
    NMLVDISPINFO* pDispInfo = reinterpret_cast<NMLVDISPINFO*>(pNMHDR);
    LV_ITEM* pItem = &(pDispInfo->item);

    int nIndex = pItem->iItem;
    int nSubItem = pItem->iSubItem;

    // 边界检查
    if (nIndex < 0 || nIndex >= (int)m_vecFiles.size()) {
        *pResult = 0;
        return;
    }

    const FileInfo& info = m_vecFiles[nIndex];

    // 文本请求
    if (pItem->mask & LVIF_TEXT) {
        CString strText;
        switch (nSubItem) {
        case 0:
            strText = info.strFileName;
            break;
        case 1:
            strText = info.strFilePath;
            break;
        case 2:
            strText = info.strFileSize;
            break;
        case 3:
            strText = info.strModifyTime;
            break;
        case 4:
            switch (info.nStatus) {
            case 0: strText = _T("待上传"); break;
            case 1: strText = _T("上传中"); break;
            case 2: strText = _T("已完成"); break;
            default: strText = _T("未知"); break;
            }
            break;
        }
        // 复制到缓冲区（注意长度限制）
        _tcsncpy_s(pItem->pszText, pItem->cchTextMax, strText, _TRUNCATE);
    }

    // 图标请求
    if (pItem->mask & LVIF_IMAGE) {
        pItem->iImage = info.nStatus;  // 根据状态显示不同图标
    }

    *pResult = 0;
}

// ==================== 缓存提示（可选优化） ====================
void CDlgUploadCP03::OnOdcachehintListFiles(NMHDR* pNMHDR, LRESULT* pResult)
{
    NMLVCACHEHINT* pCacheHint = reinterpret_cast<NMLVCACHEHINT*>(pNMHDR);

    // 系统告知即将显示的范围，可以预加载数据
    int nFrom = pCacheHint->iFrom;
    int nTo = pCacheHint->iTo;

    // 如果数据来自数据库或网络，可以在这里预加载
    // PreloadData(nFrom, nTo);

    *pResult = 0;
}

// ==================== 查找项目（用于键盘导航） ====================
void CDlgUploadCP03::OnOdfinditemListFiles(NMHDR* pNMHDR, LRESULT* pResult)
{
    NMLVFINDITEM* pFindInfo = reinterpret_cast<NMLVFINDITEM*>(pNMHDR);

    *pResult = -1;  // 默认未找到

    if (pFindInfo->lvfi.flags & LVFI_STRING) {
        CString strFind = pFindInfo->lvfi.psz;
        int nStart = pFindInfo->iStart;

        // 从指定位置开始查找
        for (int i = nStart; i < (int)m_vecFiles.size(); i++) {
            if (m_vecFiles[i].strFileName.Find(strFind) == 0) {
                *pResult = i;
                return;
            }
        }

        // 循环查找（从头开始）
        for (int i = 0; i < nStart; i++) {
            if (m_vecFiles[i].strFileName.Find(strFind) == 0) {
                *pResult = i;
                return;
            }
        }
    }
}
```

---

### 性能优化建议

```cpp
// 1. 使用双缓冲减少闪烁
m_listFiles.SetExtendedStyle(LVS_EX_DOUBLEBUFFER);

// 2. 批量更新时禁用重绘
m_listFiles.SetRedraw(FALSE);
// ... 批量操作 ...
m_listFiles.SetRedraw(TRUE);
m_listFiles.Invalidate();

// 3. 使用 SetItemCountEx 的标志
m_listFiles.SetItemCountEx(nCount, LVSICF_NOINVALIDATEALL);

// 4. 字符串缓存（避免频繁格式化）
// 在 FileInfo 中预先格式化好字符串

// 5. 分页加载（超大数据量）
void LoadPage(int nPage, int nPageSize) {
    int nStart = nPage * nPageSize;
    int nEnd = min(nStart + nPageSize, nTotalCount);
    // 从数据库加载 nStart 到 nEnd 的数据
}
```

---

### 数据量与性能对照表

| 数据量 | 内存占用（估算） | 加载时间 | 滚动流畅度 |
|--------|------------------|----------|------------|
| 1万条 | ~10 MB | < 0.1s | 极流畅 |
| 10万条 | ~100 MB | < 0.5s | 流畅 |
| 100万条 | ~1 GB | < 2s | 流畅 |
| 1000万条 | ~10 GB | < 10s | 较流畅 |
| 1亿条 | ~100 GB | 需分页 | 需优化 |

---

### 结论

| 问题 | 答案 |
|------|------|
| 最大支持数据量 | 理论 **1亿条**，实际建议 **1000万条** |
| 关键技术 | `LVS_OWNERDATA` 虚拟列表 |
| 核心回调 | `LVN_GETDISPINFO` |
| 性能瓶颈 | 数据源访问速度、内存 |