[作者]鐵觀音
[鏈接地址]http://www.shnenglu.com/microli/articles/11499.html

ListCtrl在工作中，常常用到，也常常看到大家發帖問怎么用這個控件，

故總結了一下自己的使用經驗，以供參考使用。

　　先注明一下，這里，我們用m_listctrl來表示一個CListCtrl的類對象，

然后這里我們的ListCtrl都是report形式，至于其他的如什么大圖標，小圖標

的暫時不講，畢竟report是大眾話的使用。其次，我們這里用條款一，條款二

來描述第一點，第二點，這個是參照《Effective C++》的叫法，俺覺得這么

叫比較COOL :)

　條款一：設置ListCtrl的風格

　在CSDN上常常看到有人問怎么設置風格的，他們ListCtrl的樣子是一個列表

，有橫條和豎條分界線，然后選中一行，要整一行都選中，而不是只有某一列

被選中，等等，這里給一個比較全面的設置方法。

//獲得原有風格
 DWORD dwStyle = ::GetWindowLong(m_listctrl.m_hWnd, GWL_STYLE);
 dwStyle &= ~(LVS_TYPEMASK);
 dwStyle &= ~(LVS_EDITLABELS);

 //設置新風格
    SetWindowLong(m_listctrl.m_hWnd, GWL_STYLE,

dwStyle,|LVS_REPORT|LVS_NOLABELWRAP|LVS_SHOWSELALWAYS);

 //設置擴展風格
 DWORD styles =

LVS_EX_FULLROWSELECT|LVS_EX_GRIDLINES|LVS_EX_CHECKBOXES;

 ListView_SetExtendedListViewStyleEx(m_listctrl.m_hWnd, styles,

styles );

其中LVS_EX_FULLROWSELECT　就是前面說得整行選中

LVS_EX_GRIDLINES　網格線（只適用與report風格的listctrl）

LVS_EX_CHECKBOXES　前面加個checkbox

pListCtrl->SetExtendedStyle(  m_listctrl.GetExtendedStyle()

|LVS_EX_SUBITEMIMAGES);

這也是一個很重要的屬性，這樣的話，可以在列表中加ICON，記得windows的

任務管理器嗎，你想做得那樣，這個屬性也要加哦，這個我以后會講的～

條款二：加入列頭

　　這是一個比較實質的東西，給列表框分列，然后加上列頭

　　代碼說話，來了

　　TCHAR rgtsz[2][10] = {_T("列頭1"), _T("列頭2")};
 
 LV_COLUMN lvcolumn;
 CRect rect;
 m_listctrl.GetWindowRect(&rect);
 for(int i=0;i<2;i++)
 {
  　lvcolumn.mask = LVCF_FMT | LVCF_SUBITEM | LVCF_TEXT
     　　　　　　　　 | LVCF_WIDTH | LVCF_ORDER;
  　lvcolumn.fmt = LVCFMT_LEFT;
  　lvcolumn.pszText = rgtsz[i];
 　 lvcolumn.iSubItem = i;
  　lvcolumn.iOrder = i;
 　 if(i==0)
  　{
   　　　lvcolumn.cx = rect.Width()*3/5 ;
 　 }
 　 else
   　　lvcolumn.cx = rect.Width()*2/5;
  　　　　

　　　m_listctrl.InsertColumn(i, &lvcolumn);
 　}

這是插入兩列的做法，你要插入20列？？隨便你，依樣畫葫蘆～～

　lvcolumn.mask 中那個mask可以有各種屬性，具體去看msdn吧，

 

條款三：把記錄，插入列表框中

　int nIndex = m_listctrl.GetItemCount();

  LV_ITEM   lvitemAdd = {0};
  lvitemAdd.mask = LVIF_TEXT;
  lvitemAdd.iItem = nIndex ;
  lvitemAdd.iSubItem = 0;
  lvitemAdd.pszText =_T("毛毛1");;

  if (m_listctrl.InsertItem(&lvitemAdd) != -1)
  {
   LV_ITEM lvitem = {0};
   lvitem.mask = LVIF_TEXT;
   lvitem.iItem = nIndex ;
   lvitem.iSubItem = 1;
 
   lvitem.pszText =_T("毛毛2");
   m_listctrl.SetItem(&lvitem);
  
  }

nIndex 是當前的行數，然后把新的一行，插在最下面，

 

條款四：給列表中插入圖標

　在report格式中，也能插入圖標

　繼續代碼說話

　m_image是個CImageList對象

　m_image.Create(16,16, TRUE|ILC_COLOR24, 3, 1);

 m_listctrl.SetImageList(&m_image,LVSIL_SMALL);

然后調用CImageList的成員函數int CImageList::Add( HICON hIcon );

把ICON插入到imagelist，

　然后在插入記錄的時候

　lvitemAdd.mask = LVIF_TEXT;　－》　lvitemAdd.mask =

LVIF_TEXT|LVIF_IMAGE

　然后添加一個lvitemAdd.iImage = n;

　這個n是imagelist中的序號，表示是具體的哪一個圖標，list么，呵呵

 

條款五：　插入記錄時使用額外的信息，lParam 的使用

　　　有時候，你想對于某一行，加入一些額外的信息，那么就可以使用這個

lParam

　　ｍｓｄｎ是這么描述的Specifies the 32-bit value of the item

　　我上次是為了在某一行加入一個信息，窗口句柄，然后是這么加的，

　　int nIndex = m_listctrl.GetItemCount();

  LV_ITEM   lvitemAdd = {0};
  lvitemAdd.mask = LVIF_TEXT|LVIF_IMAGE|LVIF_PARAM;
  lvitemAdd.iItem = nIndex ;
  lvitemAdd.iSubItem = 0;
  lvitemAdd.pszText =_T("毛毛1");;

  lvitemAdd.iImage = n;
  lvitemAdd.lParam = (LPARAM)hwnd;(某個窗口的窗口句柄)

  if (m_listctrl.InsertItem(&lvitemAdd) != -1)
  {
   LV_ITEM lvitem = {0};
   lvitem.mask = LVIF_TEXT;
   lvitem.iItem = nIndex ;
   lvitem.iSubItem = 1;
 
   lvitem.pszText =_T("毛毛2");
   m_listctrl.SetItem(&lvitem);
  
  }

ok，這是一個比較全的例子的，又插ICON，又使用PARAM的

條款六　：　點擊列表框，獲取選中行信息

　　響應NM_CLICK消息，如果你有MSDN，可以看到，有專門關于listview的

NM_CLICK的介紹

void CMyDlg::OnItemClick(NMHDR* pNMHDR, LRESULT* pResult)
{
 // TODO: Add your control notification handler code here
 int nItem = -1;
 
 LPNMITEMACTIVATE lpNMItemActivate = (LPNMITEMACTIVATE)pNMHDR;

 if(lpNMItemActivate != NULL)
 {
     nItem = lpNMItemActivate->iItem;
 }

}

現在nItem就是點擊選中那行的index了，有了index，獲取那行的信息還難嗎

？

懶漢說：難，因為你還沒講，暈，那就繼續說

 

條款七：　根據行的index，獲取該行的信息

　直接上代碼吧

　LV_ITEM lvitem = {0};
   lvitem.iItem = nIndex;
   lvitem.iSubItem = 0;
   lvitem.mask = LVIF_TEXT|LVIF_IMAGE|LVIF_PARAM;

m_listctrl.GetItem(&lvitem)

這樣，就把nindex,第一列的信息取出來了，包括剛才我們加入的ICON,和那個

額外信息（窗口句柄），

比如我要獲取窗口句柄，就可以hwnd = (HWND)lvitem.lParam;

mask 用來指明你想獲取那些信息

具體可以查msdn中LVITEM Structure的定義和CListCtrl::GetItem

 

條款八：用程序選中某一行，使之選中

選中之　

m_listctrl.SetItemState

(nIndex,LVIS_SELECTED|LVIS_FOCUSED,LVIS_SELECTED|LVIS_FOCUSED);

不選中，取消選中之

m_listctrl.SetItemState(nIndex,0,LVIS_SELECTED|LVIS_FOCUSED);

 

條款九：獲取當前所有選中的行（多選）

　　這個，俺就比較懶了，抄msdn的代碼吧，反正很簡單

　　

Example
// CListCtrl* pListCtrl = (CListCtrl*) GetDlgItem

(IDC_YOURLISTCONTROL);
ASSERT(pListCtrl != NULL);

POSITION pos = pList->GetFirstSelectedItemPosition();
if (pos == NULL)
   TRACE0("No items were selected!\n");
else
{
  while (pos)
  {
     int nItem = pList->GetNextSelectedItem(pos);
     TRACE1("Item %d was selected!\n", nItem);
     // you could do your own processing on nItem here
  }
}

 

條款十：刪除條款九中選中的行

　　這個相對前面九個條款是比較麻煩的，因為如果你要刪除多行的話。往往要出錯

　　比如，我現在要刪除第0行和第1行（列表的行序列是從0開始的）

　　那么好啊。我來刪了

　　m_listctrl.DeleteItem(0)

        m_listctrl.DeleteItem(1)

　　恭喜你，錯了，我好開心啊　：）

　　因為你刪除第0行以后，下面的行會往上移，那么原來的第1行就變成了第0行，那么你再 m_listctrl.DeleteItem(1)，那么刪除的是原來的第２行，真麻煩，

　　　所以，只有從下往上刪，才是安全的，先刪的，不會影響后面的操作，

　　　　m_listctrl.DeleteItem(1)

        m_listctrl.DeleteItem(0)

　　但有時候，我們也不知道要刪除哪些行，只知道要刪除選中的那些行，像條款九中的那些

　　　如果我們還是用

　　　

POSITION pos = m_listctrl.GetFirstSelectedItemPosition();
if (pos == NULL)
   TRACE0("No items were selected!\n");
else
{
  while (pos)
  {
     int nItem = m_listctrl.GetNextSelectedItem(pos);
    

　m_listctrl.DeleteItem(nItem );

  }
}

你就等著收尸吧

這時候我們就要B4微軟了，為蝦米木有GetLastselectedItemPosition 和GetPrevSelectedItem

多寫一對成員函數會死啊　:(

　沒辦法，辦法自己想，這里有個笨辦法

　POSITION  sSelPos = NULL;

 while(sSelPos = m_listctrl.GetFirstSelectedItemPosition())
 {
        int nSelItem = -1;
         nSelItem = m_listctrl.GetNextSelectedItem(sSelPos);

         if(nSelItem >= 0 && nSelItem<m_listctrl.GetItemCount())
       {

             好了，這個nSelItem 就是我們要的DD

      }

}

GetNextSelectedItem這個函數，看msdn的用法，其實是返回第一個的index，然后走到下一個選中的行去，所以這么做也是安全的，在實際中，俺也是這么做的，測試也通過，沒問題的

當然，還有個辦法，先通過GetFirstSelectedItemPosition和GetNextSelectedItem

來獲取所有的選中行的index，然后把這些index放到一個數組里，然后再從下往上刪

唉真麻煩啊，還要不定數組，不說用new在堆上開吧，那么一個vector總是要的吧，麻煩啊

所以我暫時是用上述的辦法來刪除，也供大家參考，希望能找到更好的辦法。

 

好了，今天就暫時先整理上述十點。listctrl其他高級的用法，網上資料也很多，我也暫時不總結，以后有機會再說吧。

搞了好長時間啊，要睡覺去了，累死了　：）