ListControl常用操作汇总

本文根据本人在项目中的应用，来谈谈CListCtrl的部分用法及技巧。当初学习时，查了很多资料，零零碎碎的作了些记录，现在主要是来做个总结，方便以后查阅。主要包括以下十三点内容：基本操作、获取选中行的行号、复选框操作、动态设置选中行的字体颜色、设置选中行的背景颜色、禁止拖动表头、让第一列居中显示、设置行高与字体、虚拟列表技术、点击表头时进行归类、向上与向下移动、动态调整大小问题、避免闪烁问题。

分为两篇来进行总结。本篇重点总结：基本操作、获取选中行的行号、复选框操作、动态设置选中行的字体颜色、设置选中行的背景颜色

1、基本操作

分别从下面四点来介绍CListCtrl的基本操作：

①设置列表视图显示方式

Ⅰ. CListCtrl有四种样式：LVS_ICON、LVS_SMALLICON、LVS_LIST、LSV_REPORT，可通过控件属性来设置。本文所述均为LSV_REPORT属性。

Ⅱ. 扩展样式：

常用的扩展样式有三种：LVS_EX_FULLROWSELECT、LVS_EX_GRIDLINES、LVS_EX_CHECKBOXES，分别对应作用 选中某行时使正行高亮、设置网格线、item前生成Ckeckbox控件。

使用SetExtendedStyle(style)函数设置扩展样式，使用GetExtendedStyle()函数获取样式，如：

m_listInfo.SetExtendedStyle(LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);
       Ⅲ. 使用CListView时，需要在PreCreateWindow()函数中添加  cs.style | =  LVS_REPORT;

来将其设置为LVS_REPORT风格，否则插入无效。还用另一种方法来设置风格，即在OnInitialUpate()中获取CListCtrl控制权，然后修改风格，如下所示：

CListCtrl &theCtrl =GetListCtrl();

theCtrl.ModifyStyle(0, LVS_REPORT);

   ②插入操作

        先插入列：

                      
int InsertColumn( int nCol, LPCTSTR
lpszColumnHeading, int nFormat, int nWidth, int nSubItem)

插入列时，可指明列号、列名称、列名称显示样式，列宽等信息。对于列号为0的那一列，始终是靠左显示，后面会有修改使其剧中显示的方法，其他列通过设置nFormat属性可以居中显示。

        插入行：

                      
int InsertItem( int nItem, LPCTSTRlpszItem )

直接插入一行，nItem指明行号，lpszItem指明该行第0列的信息。

       设置信息：

                      
BOOL SetItemText(int nItem,  int nSubItem, LPCTSTR lpszText )

设置第nItem行nSubItem列的信息（nItem:0,1,2,3……； nSubItem:1,2,3……）

  ③删除操作

有三个操作函数：

BOOL DeleteAllItems()  -------删除所有的行

BOOL DeleteItem(nItem) --------删除某一行

BOOL DeleteColumn(nCol) -----删除某一列

④获取/设置属性函数

      有很多函数了，就不一一介绍了。常用的有

int GetItemCount() -------- 获取已插入信息的行数

BOOL SetItemState(int iLink, UINTstate, UINTstateMask ) ---------设置行状态，如高亮显示等

等等

2、获取选中行的行号

获取选中行的行号，然后对该行进行相关处理，这点在编程中用的非常多。

当鼠标单击item时，控件向父窗口发送NM_CLICK消息，其响应函数为OnNMClickXXXX(NMHDR *pNMHDR, LRESULT *pResult)，在该函数下来编写代码获取鼠标点击的行号。

有两种方法来获取行号：第一种是使用GetFirstSelectedItemPosition和GetNextSelectedItem配合来获取；第二种是先获取鼠标位置信息，然后调用HitTest函数来找出行号。示例分别如下：

第一种方法，该示例截自MSDN，可作修改后使用。

1. POSITION pos = pList->GetFirstSelectedItemPosition();
2. if (pos == NULL)
3. TRACE0("No items were selected!\n");
4. else
5. {
6. while (pos)
7. {
8. int nItem = pList->GetNextSelectedItem(pos);
9. TRACE1("Item %d was selected!\n", nItem);
10. // you could do your own processing on nItem here
11. }
12. }

第二种方法，该示例来自我的项目，可作修改后使用。

1. //获取单击所在的行号
2. //找出鼠标位置
3. DWORD dwPos = GetMessagePos();
4. CPoint point( LOWORD(dwPos), HIWORD(dwPos) );
5. m_listCtrl.ScreenToClient(&point);
6. //定义结构体
7. LVHITTESTINFO lvinfo;
8. lvinfo.pt = point;
9. //获取行号信息
10. int nItem = m_listCtrl.HitTest(&lvinfo);
11. if(nItem != -1)
12. m_itemSel = lvinfo.iItem;   //当前行号

对于LVHITTESTINFO 结构体，其有四个成员，在上述HitTest调用中，其第一个成员作为输入，另外三个作为输出。具体变量含义可查看MSDN。

1. typedef struct _LVHITTESTINFO {
2. POINT pt;
3. UINT flags;
4. int iItem;
5. int iSubItem;
6. } LVHITTESTINFO, *LPLVHITTESTINFO;

3、复选框操作

有时需要在item前面添加一个CheckBox，供用户选择，然后对所有选中项进行处理。

这里涉及到两个问题：第一个，如何添加CheckBox风格；第二个，如何判断某一行的CheckBox状态是否发生改变。

对于第一个问题，在基本操作里已经有所阐述了，即通过SetExtendedStyle函数添加LVS_EX_CHECKBOXES扩展风格。

这里重点探讨第二个问题，首先，操作复选框状态的有两个函数：

BOOL GetCheck(int nItem)-------获取复选框状态

BOOL SetCheck( int nItem, BOOL fCheck = TRUE )-------设置复选框状态

其次，我们要搞清楚以下四点：

① 当列表的项item改变时，控件会向父窗口发送LVN_ITEMCHANGED消息，因此可以在LVN_ITEMCHANGED消息的响应函数中对复选框的状态进行处理（查询或设置）。

② 鼠标点击CheckBox时，消息的顺序是 NM_CLICK —> LVN_ITEMCHANGED，即CheckBox的状态是在 NM_CLICK消息函数结束后才会发生变化，在NM_CLICK中使用GetCheck无效。

③ 鼠标点击Item（非CheckBox区域）时，消息的顺序是 LVN_ITEMCHANGED —> NM_CLICK。

④ 调用InsertItem
函数时，也会产生LVN_ITEMCHANGED消息。鉴于此，通常会自定义一个BOOL型变量m_bHit
来判断是点击操作还是插入操作，该变量初始赋FALSE，当有鼠标点击item时赋TRUE,
检测完是否有CheckBox被点击后重新复位为FALSE。

示例如下所示：

1. void CXXXX::OnNMClickXXXX(NMHDR *pNMHDR, LRESULT *pResult)
2. {
3. //获取单击所在的行号
4. //找出鼠标位置
5. DWORD dwPos = GetMessagePos();
6. CPoint point( LOWORD(dwPos), HIWORD(dwPos) );
7. m_listCtrl.ScreenToClient(&point);
8. //定义结构体
9. LVHITTESTINFO lvinfo;
10. lvinfo.pt = point;
11. //获取行号信息
12. int nItem = m_listCtrl.HitTest(&lvinfo);
13. if(nItem != -1)
14. m_itemSel = lvinfo.iItem;   //当前行号
15. //判断是否点击在CheckBox上
16. if(lvinfo.flags == LVHT_ONITEMSTATEICON)
17. m_bHit = TRUE;
18. *pResult = 0;
19. }
20. void CXXXX::OnLvnItemchangedXXXX(NMHDR *pNMHDR, LRESULT *pResult)
21. {
22. LPNMLISTVIEW pNMLV = reinterpret_cast<LPNMLISTVIEW>(pNMHDR);
23. //判断m_bHit，即是否点击了CheckBox
24. if(m_bHit)
25. {
26. m_bHit = FALSE;     //复位
27. if(m_listCtrl.GetCheck(m_itemSel))
28. {       //CheckBox被选中
29. //do your own processing
30. }
31. else
32. {      //CheckBox取消选择
33. //do your own processing
34. }
35. }
36. *pResult = 0;
37. }

4、动态设置选中行的字体颜色

有时可能需要设置某行的文字为特殊颜色，以表示某种特殊含义，比如正在下载的信息用绿色，暂停下载的用灰色。

首先，给出一个CodeProject的链接，这篇文章讲的非常好，主要是利用Custom Draw。http://www.codeproject.com/Articles/79/Neat-Stuff-to-Do-in-List-Controls-Using-Custom-Dra

然后，来谈谈我的方法，这里主要谈对选中行的字体颜色进行动态修改，当然也是我通过上面文章和自己实践结合得出的。

我们需要搞清楚以下几点（可以结合下面修改某一行的字体颜色的方法来看）：

① 当控件绘制时，会发送NM_CUSTOMDRAW 消息，该消息的消息响应函数为

1. void CXXXX::OnNMCustomdrawXXXX(NMHDR *pNMHDR, LRESULT *pResult)
2. {
3. LPNMLVCUSTOMDRAW pLVCD = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);
4. // TODO: Add your control notification handler code here
5. *pResult = CDRF_DODEFAULT;
6. //………………
7. }

②其中，pNMHDR为输入参数，其指向NMLVCUSTOMDRAW结构体，该结构包含了很多信息，包括字体颜色、背景等等，特别是第一个成员，为NMCUSTOMDRAW结构体变量，其包含了Current drawing stage（不知道怎么编译比较好），其可能的值如下图（截自MSDN）所示

③ pResult为输出参数，该参数决定了接下来向windows发送什么消息（与绘制有关的），通过发送该消息我们可以进入下一步需要的处理阶段。具体输出哪个值取决于Current drawing stage，其可能的值如下图（截自MSDN）所示

④ 有一点必须注意(英文的，我觉得看起来比翻译过来更精确)：

One thing to keep in mind is you must always check the draw stage before doing anything else, because your handler will receive many messages, and the draw stage determines what action your code takes.

下面我们来看看如何修改某一行的字体颜色：

①  首先，我们应该明白要修改字体颜色，应该在pre-paint 阶段来完成

② 因此，在消息响应函数中，我们首先判断是否处于pre-paint stage（即pLVCD->nmcd.dwDrawStage
== CDDS_PREPAINT），然后通过修改输出值pResult 的值来通知windows我们需要处理每个item的消息（即设置
*pResult = CDRF_NOTIFYITEMDRAW）。

③ 再次进入消息响应函数时，我们判断是否处于Item的pre-paint stage（即pLVCD->nmcd.dwDrawStage == CDDS_ITEMPREPAINT），如果是则进行相关处理，即修改字体颜色等等。

④ 处理完了后重新设置 *pResult = CDRF_DODEFAULT，表示我们不再需要其他特殊的消息了，默认执行即可。

示例如下：

1. void CXXXX::OnNMCustomdrawXXXX(NMHDR *pNMHDR, LRESULT *pResult)
2. {
3. LPNMLVCUSTOMDRAW pLVCD = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);
4. *pResult = CDRF_DODEFAULT;
5. // First thing - check the draw stage. If it's the control's pre-paint stage,
6. // then tell Windows we want messages for every item.
7. if ( CDDS_PREPAINT == pLVCD->nmcd.dwDrawStage )
8. {
9. *pResult = CDRF_NOTIFYITEMDRAW;
10. }
11. else if ( CDDS_ITEMPREPAINT == pLVCD->nmcd.dwDrawStage )
12. {
13. // This is the notification message for an item.
14. //处理，将item改变背景颜色
15. if( /*符合条件*/ )
16. pLVCD->clrText = RGB(255,0,255);
17. *pResult = CDRF_DODEFAULT;
18. }
19. }

上面谈的方法主要用于设置静态字体颜色，当然，如果你的列表的信息在不断变化（即用SetItemText不断修改），那么也就实现了动态改变了，否则需要在合适的地方调用重绘函数：

BOOL RedrawItems( int nFirst, int nLast )

表示在nFirst和nLast之间的行需要进行重绘。

5、设置选中行的背景颜色

设置选中行的背景颜色，可以将选中行以特殊颜色显示，容易明白当前处理的是哪一行。尽管有高亮，但是高亮是基于焦点的，如果你选中了某一行，然后焦点转移了，这是就无法判断你选的是哪一行了。

设置选中行的背景颜色的方法和第四节中讲的修改字体颜色的方法是相似的，都是利用Custom Draw。这里涉及到设置当前选中行为特殊颜色，同时要恢复前一次选中行的颜色，否则就乱了。因此需要记录前一次选中行、当前选中行的行号，相信通过前面的总结，这点并不难实现。然后在当前选中行和前一次选中行之间进行重绘即可。

示例如下：

1. void CXXXX::OnNMClickXXXX(NMHDR *pNMHDR, LRESULT *pResult)
2. {
3. //…………
4. //重绘item，更改背景颜色
5. int nFirst = min(m_itemSel,m_itemForeSel);
6. int nLast = max(m_itemSel,m_itemForeSel);
7. m_listCtrl.RedrawItems(nFirst, nLast);  //在前一次选中的item和当前选中的Item之间进行重绘
8. *pResult = 0;
9. }
10. void CXXXX::OnNMCustomdrawXXXX(NMHDR *pNMHDR, LRESULT *pResult)
11. {
12. LPNMLVCUSTOMDRAW pLVCD = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);
13. *pResult = CDRF_DODEFAULT;
14. // First thing - check the draw stage. If it's the control's prepaint
15. // stage, then tell Windows we want messages for every item.
16. if ( CDDS_PREPAINT == pLVCD->nmcd.dwDrawStage )
17. {
18. *pResult = CDRF_NOTIFYITEMDRAW;
19. }
20. else if ( CDDS_ITEMPREPAINT == pLVCD->nmcd.dwDrawStage )
21. {
22. // This is the notification message for an item.
23. //处理，将item改变背景颜色
24. if(m_itemSel == pLVCD->nmcd.dwItemSpec)
25. {   //当前选中的item
26. pLVCD->clrTextBk = RGB(255,0,0);
27. }
28. else if(m_itemForeSel == pLVCD->nmcd.dwItemSpec)
29. {   //前一次选中的item，恢复为白色
30. pLVCD->clrTextBk = RGB(255,255,255);
31. }
32. *pResult = CDRF_DODEFAULT;
33. }
34. }