CListCtrl基本用法

 

CListCtrl是列表控件类，列表控件的每一行叫做一个item，每一列叫做一个subitem。每一行和每一列都有个ID号，可以确定唯一的单元格。 最近使用了这个控件，有心得总结如下：       （Dialog模式）                                                                                                     1. 创建列表控件. 定义一个成员变量：CListCtrl *m_pListCtrl; 在初始化对话框的时候创建列表，也就是在OnInitDialog()中创建（在哪里创建没有规定，只要符合对象和资源创建的规则即可。） m_pListCtrl=new CListCtrl(); m_pListCtrl->Create(); m_pListCtrl->SetExtendedStyle(); Create函数有四个参数，DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID 。第一个参数可以是一些值的组合，用来定义列表的样式，这些值MSDN有详细说明，我只举一个简单的例子，更多的查看MSDN。例如第一个参数使用LVS_REPORT，则表示列表有标题，或者说有列头，很多其他的样式必须是和这个样式搭配使用才有效。第二个参数是列表的坐标和大小，这个矩形框就表示列表的矩形框。第三个参数表示这个列表的父类，如果列表在对话框上或者是在试图上，这个参数可以是this。第四个参数是列表的资源号。 SetExtendedStyle函数只有一个参数，是一些值的组合，用来设置列表的扩展样式，这些值MSDN有详细的说明，我只介绍两个比较常用的。 LVS_EX_GRIDLINES ：列表显示网格，只适用于LVS_REPORT 风格。LVS_EX_FULLROWSELECT：当一个item被选中时,它的所有subitems也处于被选中状态,点击任意一个subitem,则可同时选中整个行. 只适用于LVS_REPORT 风格。 2.构建列表    构建列表也就是两个操作，插入列和插入行，前面说过，一个列就是一个subitem，一行就是一个item。 m_pListCtrl->InsertColumn(0,"第一列")； 列索引从0开始，InsertColumn函数将在列表中建立一个列，如果数据有三列，就调用三次此函数，索引分别是0，1，2。 m_pListCtrl->InsertItem(0,"第一行")； 行索引也从0开始，InsertItem函数在列表中建立一行，且“第一行”的字样显示在的一列中，其他各列为空，如果要在除第一列以外的列中插入数据，调用SetItemText()函数，这个函数有三个参数，第一个参数表示要在第几行插入，第二个参数表示要在第几列插入，第三个参数表示要插入的内容。 可以设定列宽： LVCOLUMN lvcolumn; m_pListCtrl->GetColumn(0,&lvcolumn); lvcolumn.mask=LVCF_WIDTH; lvcolumn.cx=335; m_pListCtrl->SetColumn(0,&lvcolumn); 表示将列宽设定为335像素。 3.操作列表 这里主要介绍一个比较有用的函数SubItemHitTest() 当鼠标停留在列表框上时，此函数会返回鼠标所在的行号，和鼠标所在的列号。 LVHITTESTINFO linfo; DWORD dwPos   =   GetMessagePos();    CPoint point(LOWORD(dwPos),HIWORD(dwPos)); m_pListCtrl->ScreenToClient(&point); linfo.pt=point; linfo.flags=LVHT_ABOVE; int iItem=m_pListCtrl->SubItemHitTest(&linfo); 行号保存在linfo.iItem中，列号保存在linfo.iSubItem中，此时可以调用GetItemText()函数获得这个单元格的内容了。 这个方法常用在列表的NM_CLICK和NM_DBLCLK事件中。 此类消息为： ON_NOTIFY(NM_CLICK, IDC, OnFun) 函数原型： void OnFun(NMHDR *pNMHDR, LRESULT *pResult) { *pResult = 0; } 4.列表中的CheckBox 列表有多中风格，带CheckBox是其中常见的一种，设置这种风格的列表只需要在调用SetExtendedStyle函数的时候设置LVS_EX_CHECKBOXES。对CheckBox最常见的操作就是选中和取消，可能是我的知识贫乏，到目前，我还没有找到专门的消息处理这两个操作。要处理这样的操作，我使用下面的方法。 响应列表的NM_CLICK消息，在这个消息处理函数中，判断鼠标点击的位置是文本还是CheckBox，代码如下： UINT nFlag; DWORD   dwPos   =   GetMessagePos();    CPoint    point(LOWORD(dwPos),HIWORD(dwPos)); m_pList1->ScreenToClient(&point); m_pList1->HitTest ( point , &nFlag ) ; 如果nFlag==LVHT_ONITEMSTATEICON ，说明鼠标点中了CheckBox。本可以调用GetCheck函数来获得CheckBox的状态，但是很可惜，CheckBox的状态似乎是在NM_CLICK消息函数结束以后才会改变。所以，在NM_CLICK的消息处理函数中获得CheckBox的状态是没有改变之前的。 还有一点需要注意，假设现在目前CheckBox的状态是选中，那么，当你点击两下鼠标的时候，CheckBox还是选中状态，而且NM_CLICK消息处理函数被执行了两次，所以，结果是正确的。但是当你点击两下鼠标时速度比较快，那么系统会把两次单击鼠标看作一次双击，这样，NM_CLICK的消息处理函数只会执行一次，但是，注意但是，CheckBox的状态却改变了两次。因此，这个时候你看到的CheckBox的状态和程序的结果就相反了。要解决这个问题，就需要在NM_DBLCLK的消息函数中做相应的工作。CListCtrl是列表控件类，列表控件的每一行叫做一个item，每一列叫做一个subitem。每一行和每一列都有个ID号，可以确定唯一的单元格。 最近使用了这个控件，有心得总结如下：       （Dialog模式）                                                                                                     1. 创建列表控件. 定义一个成员变量：CListCtrl *m_pListCtrl; 在初始化对话框的时候创建列表，也就是在OnInitDialog()中创建（在哪里创建没有规定，只要符合对象和资源创建的规则即可。） m_pListCtrl=new CListCtrl(); m_pListCtrl->Create(); m_pListCtrl->SetExtendedStyle(); Create函数有四个参数，DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID 。第一个参数可以是一些值的组合，用来定义列表的样式，这些值MSDN有详细说明，我只举一个简单的例子，更多的查看MSDN。例如第一个参数使用LVS_REPORT，则表示列表有标题，或者说有列头，很多其他的样式必须是和这个样式搭配使用才有效。第二个参数是列表的坐标和大小，这个矩形框就表示列表的矩形框。第三个参数表示这个列表的父类，如果列表在对话框上或者是在试图上，这个参数可以是this。第四个参数是列表的资源号。 SetExtendedStyle函数只有一个参数，是一些值的组合，用来设置列表的扩展样式，这些值MSDN有详细的说明，我只介绍两个比较常用的。 LVS_EX_GRIDLINES ：列表显示网格，只适用于LVS_REPORT 风格。LVS_EX_FULLROWSELECT：当一个item被选中时,它的所有subitems也处于被选中状态,点击任意一个subitem,则可同时选中整个行. 只适用于LVS_REPORT 风格。 2.构建列表    构建列表也就是两个操作，插入列和插入行，前面说过，一个列就是一个subitem，一行就是一个item。 m_pListCtrl->InsertColumn(0,"第一列")； 列索引从0开始，InsertColumn函数将在列表中建立一个列，如果数据有三列，就调用三次此函数，索引分别是0，1，2。 m_pListCtrl->InsertItem(0,"第一行")； 行索引也从0开始，InsertItem函数在列表中建立一行，且“第一行”的字样显示在的一列中，其他各列为空，如果要在除第一列以外的列中插入数据，调用SetItemText()函数，这个函数有三个参数，第一个参数表示要在第几行插入，第二个参数表示要在第几列插入，第三个参数表示要插入的内容。 可以设定列宽： LVCOLUMN lvcolumn; m_pListCtrl->GetColumn(0,&lvcolumn); lvcolumn.mask=LVCF_WIDTH; lvcolumn.cx=335; m_pListCtrl->SetColumn(0,&lvcolumn); 表示将列宽设定为335像素。 3.操作列表 这里主要介绍一个比较有用的函数SubItemHitTest() 当鼠标停留在列表框上时，此函数会返回鼠标所在的行号，和鼠标所在的列号。 LVHITTESTINFO linfo; DWORD dwPos   =   GetMessagePos();    CPoint point(LOWORD(dwPos),HIWORD(dwPos)); m_pListCtrl->ScreenToClient(&point); linfo.pt=point; linfo.flags=LVHT_ABOVE; int iItem=m_pListCtrl->SubItemHitTest(&linfo); 行号保存在linfo.iItem中，列号保存在linfo.iSubItem中，此时可以调用GetItemText()函数获得这个单元格的内容了。 这个方法常用在列表的NM_CLICK和NM_DBLCLK事件中。 此类消息为： ON_NOTIFY(NM_CLICK, IDC, OnFun) 函数原型： void OnFun(NMHDR *pNMHDR, LRESULT *pResult) { *pResult = 0; } 4.列表中的CheckBox 列表有多中风格，带CheckBox是其中常见的一种，设置这种风格的列表只需要在调用SetExtendedStyle函数的时候设置LVS_EX_CHECKBOXES。对CheckBox最常见的操作就是选中和取消，可能是我的知识贫乏，到目前，我还没有找到专门的消息处理这两个操作。要处理这样的操作，我使用下面的方法。 响应列表的NM_CLICK消息，在这个消息处理函数中，判断鼠标点击的位置是文本还是CheckBox，代码如下： UINT nFlag; DWORD   dwPos   =   GetMessagePos();    CPoint    point(LOWORD(dwPos),HIWORD(dwPos)); m_pList1->ScreenToClient(&point); m_pList1->HitTest ( point , &nFlag ) ; 如果nFlag==LVHT_ONITEMSTATEICON ，说明鼠标点中了CheckBox。本可以调用GetCheck函数来获得CheckBox的状态，但是很可惜，CheckBox的状态似乎是在NM_CLICK消息函数结束以后才会改变。所以，在NM_CLICK的消息处理函数中获得CheckBox的状态是没有改变之前的。 还有一点需要注意，假设现在目前CheckBox的状态是选中，那么，当你点击两下鼠标的时候，CheckBox还是选中状态，而且NM_CLICK消息处理函数被执行了两次，所以，结果是正确的。但是当你点击两下鼠标时速度比较快，那么系统会把两次单击鼠标看作一次双击，这样，NM_CLICK的消息处理函数只会执行一次，但是，注意但是，CheckBox的状态却改变了两次。因此，这个时候你看到的CheckBox的状态和程序的结果就相反了。要解决这个问题，就需要在NM_DBLCLK的消息函数中做相应的工作。