虚拟列表控件

虚列表控件是有 LVS_OWNERDATA 样式的列表视图控件。 此样式允许控件支持项计数到DWORD (默认项计数只扩展到 int。) 但是，这一样式所提供的最大的优点是在任何时候都只有一部分数据项在内存中。 这允许虚拟列表视图控件将自己用于大型信息数据库中，这其中访问数据的方法已经准备就绪。

在开发虚拟列表控件时，还应意识到这里会有一些兼容性问题。 有关详细信息，请参见Windows SDK中的主题列表视图控件的兼容性问题部分 。

处理 LVN_GETDISPINFO 通知

虚拟列表控件很少维护项信息。 除选择项和专注信息，所有项信息都有控件所有者管理。 信息由框架通过 LVN_GETDISPINFO 请求通知消息。 若要提供请求信息，虚拟列表控件的所有者 (或控件本身) 必须处理此通知。 使用属性窗口这能轻松地完成 (请参见指向函数的信息映射) 提供的代码应类似于下面的示例 (其中 CMyDialog 拥有虚拟列表控件对象，且该对话框通知处理):

ON_NOTIFY(LVN_GETDISPINFO, IDC_LIST3, &CMyDialog::OnLvnGetdispinfoList3)

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

• LVIF_TEXT pszText是必须填写的成员。

• LVIF_IMAGE iImage是必须填写的成员。

• LVIF_INDENTiIndent 是必须填写的成员 。

• LVIF_PARAMlParam 是必须填写的成员。(对于子项不存在。)

• LVIF_STATE state是必须填充的成员。

您随后应提供任何回到框架的请求信息。

以下示例 (对列表控件对象，从通知处理程序主体中提取出的) 展示了一种通过为文本缓冲区和图像项提供信息的方法。

NMLVDISPINFO *pDispInfo = reinterpret_cast<NMLVDISPINFO*>(pNMHDR);
LV_ITEM* pItem = &(pDispInfo)->item;

int iItem = pItem->iItem;

if (pItem->mask & LVIF_TEXT) //valid text buffer?
{
   switch(pItem->iSubItem)
   {
      case 0: //fill in main text
         _tcscpy_s(pItem->pszText, pItem->cchTextMax,
            m_Items[iItem].m_strItemText);
         break;
      case 1: //fill in sub item 1 text
         _tcscpy_s(pItem->pszText, pItem->cchTextMax,
            m_Items[iItem].m_strSubItem1Text);
         break;
      case 2: //fill in sub item 2 text
         _tcscpy_s(pItem->pszText, pItem->cchTextMax,
            m_Items[iItem].m_strSubItem2Text);
         break;
   }
}

if (pItem->mask & LVIF_IMAGE) //valid image?
{
   pItem->iImage = m_Items[iItem].m_iImage;
}

缓存和虚拟列表控件

由于这种列表控件用于大型数据集，建议要缓存请求项检索数据来提高性能。 框架提供一个机制的缓存提示机制，通过发送 LVN_ODCACHEHINT 通知消息来帮助优化缓存。

下面的示例通过范围传递给处理程序函数来更新缓存。

void CMyDialog::OnLvnOdcachehintList3(NMHDR *pNMHDR, LRESULT *pResult)
{
   LPNMLVCACHEHINT pCacheHint = reinterpret_cast<LPNMLVCACHEHINT>(pNMHDR);

   // Update the cache with the recommended range. 
   for (int i = pCacheHint->iFrom; i <= pCacheHint->iTo; i++)
   {
      m_Items[i].m_iImage = i % 2;
      m_Items[i].m_strItemText.Format(_T("Item %d"), i);
      m_Items[i].m_strSubItem1Text = _T("Sub 1");
      m_Items[i].m_strSubItem2Text = _T("Sub 2");
   }

   *pResult = 0;
}

有关准备和维护缓存的详细信息，请参见在 Windows SDK中的 主题列表视图控件的缓存管理部门。

查找特定项

当需要寻找特定列表项控件时，LVN_ODFINDITEM 通知消息由虚拟列表控件发送。 通知消息会发送，当列表视图控件接收键快速访问时，或者接收到 LVM_FINDITEM 消息时。 搜索信息以 LVFINDINFO 结构的形式发送，其是 NMLVFINDITEM 结构的成员。 通过重写列表控件对象的OnChildNotify 函数和此消息处理程序的主体，检查LVN_ODFINDITEM 消息。 如果找到，请执行适当的操作。

您需要准备寻找与给定的列表视图控件相匹配的项。 如果找到，则返回索引值，如果没有找到匹配项则返回-1。

请参见

参考

使用 CListCtrl

概念

控件 (MFC)