虛擬清單控制項

發行項
06/10/2015

虛擬清單控制項是具有 LVS_OWNERDATA 的樣式清單檢視控制項。此模式可讓控制項支援項目計數由 DWORD (預設項目計數只延伸到 int)。不過，這個樣式提供最大的好處是能夠隨時只有資料項目的子集在記憶體中。這可讓虛擬清單檢視控制項本身為與資訊大型資料庫的使用，存取特定資料的方法已經準備就緒。

注意事項
除了提供 CListCtrl中的虛擬清單功能之外， MFC 也提供了 CListView 類別的相同功能。

您必須知道，在開發虛擬清單控制項時的一些相容性問題。如需詳細資訊，請參閱相容性發行清單檢視控制項主題的部分以 Windows SDK為單位。

處理 LVN_GETDISPINFO 通知

虛擬清單控制項維護很少項目資訊。除了項目選取範圍和焦點資訊，所有項目控制識別項的擁有者處理。資訊由架構要求傳遞 LVN_GETDISPINFO 通知訊息。若要提供所要求的資訊，虛擬清單控制項的擁有人 (或控制項) 必須處理這個告知。這可以輕鬆地使用屬性視窗 (請參閱此函式之對應訊息)。產生的程式碼應該看起來會像下列範例 (其中 CMyDialog 擁有虛擬清單控制項物件，對話處理告知):

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

在 LVN_GETDISPINFO 通知訊息的處理常式，您必須檢查何種資訊要求。可能的值為：

必須填入LVIF_TEXT pszText 成員。
必須填入LVIF_IMAGE iImage 成員。
必須填入LVIF_INDENT 這個 iIndent 成員。
必須填入LVIF_PARAM lParam 成員。(子項目的不存在)
必須填入LVIF_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，如果找不到相符的項目。

共用方式為

虛擬清單控制項

處理 LVN_GETDISPINFO 通知

快取和虛擬清單控制項

尋找特定項目

請參閱

參考

概念

其他資源