ClistCtrl类用法简介

CListCtrl类封装了“列表视图控件”功能，显示每个包含图标（列表视图中）和标签的收集。除图标和标签外，每一项还能有显示在图标和标签右边列中的信息。

1.列表视图类的四种风格

列表视图控件可用四种不同方式显示其内容，称之为“视图”。
1.图标视图：每一项以全尺寸图标（32×32像素）出现，下面有一个标签。用户可在列表视图窗口拖动项到任意位置。
2.小图标：视图每一项以小图标（16×16像素）出现，右边有一个标签。用户可在列表视图窗口拖动项到任意位置。
3.列表视图：每一项以小图标出现，下面有一个标签。项按列排列，不能拖动到列表视图窗口的任何位置。
4.报表视图：每一项在本行上出现，右边有排列成列的附加信息。最左边的列包含小图标和标签，下一列包含应用指定的子项。

对应的标签为：
LVS_ICON: 为每个item显示大图标
LVS_SMALLICON: 为每个item显示小图标
LVS_LIST: 显示一列带有小图标的item
LVS_REPORT: 显示item详细资料

  直观的理解：windows资源管理器，“查看”标签下的“大图标，小图标，列表，详细资料”

2.LIstCtrl的扩展风格

  LONG lStyle;
  lStyle = GetWindowLong(m_list.m_hWnd, GWL_STYLE);//获取当前窗口style
  lStyle &= ~LVS_TYPEMASK; //清除显示方式位
  lStyle |= LVS_REPORT; //设置style
  SetWindowLong(m_list.m_hWnd, GWL_STYLE, lStyle);//设置style

  DWORD dwStyle = m_list.GetExtendedStyle();
  dwStyle |= LVS_EX_FULLROWSELECT;//选中某行使整行高亮（只适用与report风格的listctrl）
  dwStyle |= LVS_EX_GRIDLINES;//网格线（只适用与report风格的listctrl）
  dwStyle |= LVS_EX_CHECKBOXES;//item前生成checkbox控件
  m_list.SetExtendedStyle(dwStyle); //设置扩展风格

3.插入列表项

$$以报告格式显示列表视图时，一般会显示一列表项和多列子项，在初始化列表视图时，先要调用InsertColumn函数插入各列，该函数的声明为：

int InsertColumn（int nCol，const LV_COLUMN* pColumn）;

其中，参数nCol是新列的索引，参数pColumn指向一个LV_COLUMN结构，函数根据该结构来创建新的列。若插入成功，函数返回新的索引，否则返回-1.
$\quad$要删除某列应调用DeleteColumn函数，其声明为：

BOOL DeleteColumn（int nCol）;

其中LV_COLUMN结构用来描述表项的某一列，定义如下：

typedef struct _LVCOLUMN {
UINT mask;            //说明此结构中哪些成员是有效的
int fmt;           //列的对齐方式
int cx;            //列的初始宽度
LPTSTR pszText; //列的标题
int cchTextMax;   //pszText所指向的缓冲区的大小
int iSubItem;      //与列关联的子项的索引值，从0开始
int iImage;           //与列关联的图像列表中指定图像的索引值
int iOrder;           //第几列，0代表最左一列
} LVCOLUMN, FAR *LPLVCOLUMN;

顺便说一下LV_ITEM结构，该结构用来描述一个表项或子项，它包含了项的各种属性，其定义为：

typedef struct _LVITEM {
UINT   mask;        //说明LVITEM结构中哪些成员有效
int    iItem;       //项目的索引值(可以视为行号)从0开始
int    iSubItem;    //子项的索引值(可以视为列号)从0开始
UINT   state;       //子项的状态
UINT   stateMask;   //状态有效的屏蔽位
LPTSTR pszText;   //主项或子项的名称
int    cchTextMax; //pszText所指向的缓冲区大小
int    iImage;       //关联图像列表中指定图像的索引值
LPARAM lParam;    //程序定义的32位参数
int iIndent;          //表示图像位置缩进的单位
} LVITEM, FAR *LPLVITEM;

4.插入数据

要插入新的表项，应调用InsertItem函数，如果要显示图标，则应先创建一个CImageList对象并使对象包含用于显示图标的位图序列，然后调用SetImageList函数来为列表视图设置位图序列。函数的声明为：

int InsertItem（const LV_ITEM* PItem）；

参数pItem指向一个LV_ITEM结构，该结构提供了对表项的描述，若插入成功返回新表项索引，否则返回-1

CImageList* SetImageList（CImageList* pImageList，int nImageList）；
参数pImageList指向一个CImageList对象，参数nImageList用来指定图标的类型，其值为LVSIL_NORMAL,则位图序列用于显示大图标，若值为LVSIL_SMALL,则位图序列用于显示小图标，，可用该函数同时制定一套大图标和一套小图标。

5.删除和查询

调用GetItem函数和SetItem函数来查询和设置。用这两个功能强大的函数，几乎可以查询和设置指定项的所有属性，包括正文，图标及选择状态。函数声明为：

BOOL GetItem（LV_Item* pItem）const;
BOOL SetItem(const LV_ITEM* pItem);

参数pItem是指向LV_ITEM结构的指针，函数是通过该结构来查询或设置指定项，在调用函数前应该使用该结构iItem函数或isubItem函数成员有效以指定表项或子项。

CListCtrl类还提供一系列相关函数：GetItemState函数、GetItemText函数、SetItemState函数、SetItemText函数、SetItemData函数。

int GetItemText（int nItem，int nSubItem，LPTSTR lpszText，int nLen）const;
CString GetItemText(int nItem,int nSubItem)const;
BOOL SetItemText(int nItem,int nSubItem,LPTSTR lpszText);
其中参数nItem是表现的索引（行索引），参数nsubItem是子项的索引，若参数nSubItem为0，则说明函数是针对表项的。参数lpszText指向正文缓冲区，参数nLen说明缓冲区大小。

6.查询表项数目

很简单，利用GetItenCount函数即可

int GetItemCount（）;

7.搜索指定项

要搜素与指定表项相关的表项，或搜索具有某种状态的表项，应该调用GetNextItem函数，该函数的一个重要用处是搜素被选择的表现。函数声明为：

intGetNextItem（intnItem，intnFlags）const;

参数nItem返用于指定的索引，参数nFlags是一些标志，用于指定查询关系，函数将返回搜素到的表项的索引，若未找到则返回-1.

8.排列、排序和搜素表项

要对表项进行排列、排序和搜素，可分别调用Arrange、SortItems和FindItems函数完成。

下面是转自其它博客的代码例子链接

3. 插入数据

  m_list.InsertColumn( 0, "ID", LVCFMT_LEFT, 40 );//插入列
  m_list.InsertColumn( 1, "NAME", LVCFMT_LEFT, 50 );
  int nRow = m_list.InsertItem(0, “11”);//插入行
  m_list.SetItemText(nRow, 1, “jacky”);//设置数据

4. 一直选中item

选中style中的Show selection always，或者在上面第2点中设置LVS_SHOWSELALWAYS

5. 选中和取消选中一行

int nIndex = 0;
//选中
m_list.SetItemState(nIndex, LVIS_SELECTED|LVIS_FOCUSED, LVIS_SELECTED|LVIS_FOCUSED);
//取消选中
m_list.SetItemState(nIndex, 0, LVIS_SELECTED|LVIS_FOCUSED);

6. 得到listctrl中所有行的checkbox的状态

  m_list.SetExtendedStyle(LVS_EX_CHECKBOXES);
  CString str;
  for(int i=0; i<m_list.GetItemCount(); i++)
  {
       if( m_list.GetItemState(i, LVIS_SELECTED) == LVIS_SELECTED || m_list.GetCheck(i))
       {
            str.Format(_T("第%d行的checkbox为选中状态"), i);
            AfxMessageBox(str);
       }
  }

7. 得到listctrl中所有选中行的序号

  方法一：
  CString str;
  for(int i=0; i<m_list.GetItemCount(); i++)
  {
       if( m_list.GetItemState(i, LVIS_SELECTED) == LVIS_SELECTED )
       {
            str.Format(_T("选中了第%d行"), i);
            AfxMessageBox(str);
       }
  }

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

8. 得到item的信息

  TCHAR szBuf[1024];
  LVITEM lvi;
  lvi.iItem = nItemIndex;
  lvi.iSubItem = 0;
  lvi.mask = LVIF_TEXT;
  lvi.pszText = szBuf;
  lvi.cchTextMax = 1024;
  m_list.GetItem(&lvi);

  关于得到设置item的状态，还可以参考msdn文章
  Q173242: Use Masks to Set/Get Item States in CListCtrl
           http://support.microsoft.com/kb/173242/en-us

9. 得到listctrl的所有列的header字符串内容

  LVCOLUMN lvcol;
  char  str[256];
  int   nColNum;
  CString  strColumnName[4];//假如有4列

  nColNum = 0;
  lvcol.mask = LVCF_TEXT;
  lvcol.pszText = str;
  lvcol.cchTextMax = 256;
  while(m_list.GetColumn(nColNum, &lvcol))
  { 
       strColumnName[nColNum] = lvcol.pszText;
       nColNum++;
  }

10. 使listctrl中一项可见，即滚动滚动条

m_list.EnsureVisible(i, FALSE);

11. 得到listctrl列数

int nHeadNum = m_list.GetHeaderCtrl()->GetItemCount();

12. 删除所有列

  方法一：
     while ( m_list.DeleteColumn (0))
   因为你删除了第一列后，后面的列会依次向上移动。

  方法二：
  int nColumns = 4;
  for (int i=nColumns-1; i>=0; i--)
      m_list.DeleteColumn (i);

13. 得到单击的listctrl的行列号

  添加listctrl控件的NM_CLICK消息相应函数
  void CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)
  {
       // 方法一：
       /*
       DWORD dwPos = GetMessagePos();
       CPoint point( LOWORD(dwPos), HIWORD(dwPos) );

       m_list.ScreenToClient(&point);

       LVHITTESTINFO lvinfo;
       lvinfo.pt = point;
       lvinfo.flags = LVHT_ABOVE;

       int nItem = m_list.SubItemHitTest(&lvinfo);
       if(nItem != -1)
       {
            CString strtemp;
            strtemp.Format("单击的是第%d行第%d列", lvinfo.iItem, lvinfo.iSubItem);
            AfxMessageBox(strtemp);
       }
      */

      // 方法二:
      /*
       NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
       if(pNMListView->iItem != -1)
       {
            CString strtemp;
            strtemp.Format("单击的是第%d行第%d列",
                            pNMListView->iItem, pNMListView->iSubItem);
            AfxMessageBox(strtemp);
       }
      */
       *pResult = 0;
  }

14. 判断是否点击在listctrl的checkbox上

  添加listctrl控件的NM_CLICK消息相应函数
  void CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)
  {
       DWORD dwPos = GetMessagePos();
       CPoint point( LOWORD(dwPos), HIWORD(dwPos) );

       m_list.ScreenToClient(&point);

       LVHITTESTINFO lvinfo;
       lvinfo.pt = point;
       lvinfo.flags = LVHT_ABOVE;

       UINT nFlag;
       int nItem = m_list.HitTest(point, &nFlag);
       //判断是否点在checkbox上
       if(nFlag == LVHT_ONITEMSTATEICON)
       {
            AfxMessageBox("点在listctrl的checkbox上");
       } 
       *pResult = 0;
  }

15. 右键点击listctrl的item弹出菜单

  添加listctrl控件的NM_RCLICK消息相应函数
  void CTest6Dlg::OnRclickList1(NMHDR* pNMHDR, LRESULT* pResult)
  {
       NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
       if(pNMListView->iItem != -1)
       {
            DWORD dwPos = GetMessagePos();
            CPoint point( LOWORD(dwPos), HIWORD(dwPos) );

            CMenu menu;
            VERIFY( menu.LoadMenu( IDR_MENU1 ) );
            CMenu* popup = menu.GetSubMenu(0);
            ASSERT( popup != NULL );
            popup->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON, point.x, point.y, this );
       } 
       *pResult = 0;

}

16. item切换焦点时(包括用键盘和鼠标切换item时)，状态的一些变化顺序

  添加listctrl控件的LVN_ITEMCHANGED消息相应函数
  void CTest6Dlg::OnItemchangedList1(NMHDR* pNMHDR, LRESULT* pResult)
  {
       NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
       // TODO: Add your control notification handler code here

       CString sTemp;

       if((pNMListView->uOldState & LVIS_FOCUSED) == LVIS_FOCUSED && 
        (pNMListView->uNewState & LVIS_FOCUSED) == 0)
       {
            sTemp.Format("%d losted focus",pNMListView->iItem);
       }
       else if((pNMListView->uOldState & LVIS_FOCUSED) == 0 &&
           (pNMListView->uNewState & LVIS_FOCUSED) == LVIS_FOCUSED)
       {
            sTemp.Format("%d got focus",pNMListView->iItem);
       } 

       if((pNMListView->uOldState & LVIS_SELECTED) == LVIS_SELECTED &&
        (pNMListView->uNewState & LVIS_SELECTED) == 0)
       {
            sTemp.Format("%d losted selected",pNMListView->iItem);
       }
       else if((pNMListView->uOldState & LVIS_SELECTED) == 0 &&
        (pNMListView->uNewState & LVIS_SELECTED) == LVIS_SELECTED)
       {
            sTemp.Format("%d got selected",pNMListView->iItem);
       }

       *pResult = 0;
  }

17. 改变选中行的颜色

首先是添加以下消息

ON_NOTIFY( NM_CUSTOMDRAW, IDC_LIST1, OnDrawColorForMyList ) //为改变颜色添加的消息

再添加类成员函数,就OK了:

//改变 m_List 控件单行的颜色
void CSSDTDlg::OnDrawColorForMyList( NMHDR *pNmHdr, LRESULT *pResult )
{
NMLVCUSTOMDRAW* pLVCD = reinterpret_cast