CListCtrl控件使用详解

1.CListCtrl控件 CListCtrl控件在数据库编程中是用得比较多的控件之一，也是Window控件中较难掌握的一个控件。他可以有四显示方式，Report、List、Icon、SmallIcon。Report报告式列表视图方式在数据库开发中是最常用的一种方式。在控件"properties"的Styles选项卡中在View项可以选择Report方式。Report方式中列表控件的显示方式是有行和列的，行又叫做Item，但有多列是我们只能操作每一行的第零列，也就是最前列。 2.与CListCtrl控件相关的数据类型 (1)LV_COLUMN结构 该结构仅用于报告式列表视图，用来描述表项的某一列。要想向表项中插入新的一列，需要用到该结构。 LV_COLUMN结构定义如下： typedef struct_LV_COLUMN{ UINT mask; //屏蔽位的组合，表明哪些成员是有效的 int fmt; //该列的表头和子项的标题显示格式(LVCF_FMT) int cx; //以象素为单位的列的宽度(LVCF_FMT) LPTSTR pszText; //指向存放列表头标题正文的缓冲区(LVCF_TEXT) int cchTextMax; //标题正文缓冲区的长度(LVCF_TEXT) int iSubItem; //说明该列的索引(LVCF_SUBITEM) }LVCOLUMN; (2)LV_ITEM结构 该结构用来描述一个表项或一个子项，它包含了项的各种属性，定义为： typedef struct_LV_ITEM{ UINT mask; //屏蔽位的组合，表明哪些成员是有效的 int iItem; //从0开始编号的表项索引(行索引) int iSubItem; //从1开始编号的子项索引(列索引)，因为编号0的列使用InsertItem时已经写入数据 UINT state; //项的状态(LVIF_STATE) UINT stateMask; //项的状态屏蔽 LPTSTR pszText; //指向存放项的正文的索引区(LVIF_TEXT) int cchTextMax; //标题正文缓冲区的长度(LVCF_TEXT) int iImage; //图标的索引(LVIF_IMAGE) LPARAM lParam; //32位的附加数据(LV_PARAM) }LV_ITEM; 3.CListCtrl类的成员函数 (1)列的插入和删除项 在初始化列表视图时，先要调用InsertColumn插入各个列，该函数的声明为： int InsertColumn(int nCol,const LV_COLUMN *pColumn); 其中参数nCol是新列的索引，参数pColumn指向一个LV_COLUMN结构，函数根据该结构来创建新的列。若插入成功，函数返回新的索引；否则返回-1。 要删除某列，应调用DeleteColumn()函数，其声明为： BOOL DeleteColumn(int nCol); (2)表项的插入 要插入新的表项，应调用InsertItem。如果要显示图标，则应该创建一个CImageList对象并使该对象包含用作显示图标的位图序列，然后调用 SetImageList为列表视图设置位图序列。函数的声明为： int InsertItem(const LV_ITEM *pItem); 或者 int InsertItem( int nItem, LPCTSTR lpszItem); int InsertItem( int nItem, LPCTSTR lpszItem, int nImage ); 使用的时候多用第二种和第三种。因此省去了定义并初始化LV_ITEM数据类型这一步。 参数pItem指向一个LV_ITEM结构，该结构提供了对表项的描述。若插入成功，返回新表项的索引；否则返回-1。 参数nItem是表项的索引(行索引，从0开始);参数lpszItem为控件头的名字。 (3)函数GetItemText()和函数SetItemText()用于查询和设置表项以及子项显示的正文。 SetItemText()函数的一个重要用途就是对子项进行初始化。函数声明为： int GetItemText(int nItem,int nSubItem,LTPSTR 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说明缓冲区的大小。 4.例1：在一个对话框中初始化列表框 在对话框的初始化函数中添加对CListCtr控件的初始化代码 BOOL CDlgall::OnInitDialog() { CDialog::OnInitDialog(); LV_COLUMN lvc; //定义一个LV_COLUMN数据类型用来描述一个列 char *display[4]={"学号","姓名","性别","出生日期"}; lvc.mask = LVCF_FMT|LVCF_TEXT|LVCF_SUBITEM|LVCF_WIDTH; lvc.fmt = LVCFMT_LEFT; //设置对齐方式 lvc.cx = 80; //设置各列的宽度为80象素 for(int i = 0; i < 4; i++) //插入各列的表头 { lvc.iSubItem = i; lvc.pszText = display[i]; m_List.InsertColumn(i,&lvc); //设置的是第i列的表头,具体样式以定义的lvc的属性为准 //上句等价于m_List.InsertColumn(i,display[i],LVCF_LEFT,80); 即设置各列表头的样式 } m_List.SetExtendedStyle(m_List.GetExtendedStyle()|LVS_EX_FULLROWSELECT); //改变列表控件的显示风格为全部选中状态 CDlgall::OnLoadAll(); return TRUE; // return TRUE unless you set the focus to a control // EXCEPTION: OCX Property Pages should return FALSE } 例2：从数据源中读取数据并在列表控件中进行显示 void CDlgall::OnLoadAll() { char buffer[256]; m_List.DeleteAllItems(); //清空所有条目 if(!pset->IsOpen()) //判断记录集是否打开。如果关闭就打开记录集 pset->Open(); CString str1; pset->MoveFirst(); //将游标指向记录集的第一条记录 for(int i = 0;!pset->IsEOF();i++) //插入表项 { m_List.InsertItem(i,LPCTSTR(pset->m_number)); //InsertItem向CListCtr控件申请一行用来存放数据，同时写入一行的头名称(即编号为0列的数据) //以后各列使用SetItemText()函数来存放数据。 m_List.SetItemText(i,1,LPCTSTR(pset->m_name)); //设置第i行第1列的的数据为数据源中读取的当前记录某个字段的值 m_List.SetItemText(i,2,LPCTSTR(pset->m_sex)); //以下类似 str1 = pset->m_date.Format("%x"); m_List.SetItemText(i,3,str1); pset->MoveNext(); //游标下移 } SetDlgItemText(IDC_EDIT2,itoa(pset->GetRecordCount(),buffer,10)); //获取总的记录数并在控件IDC_EDIT2中进行显示 pset->Close(); } 例3.点击列表控件的列时实现自动排序 (1)首先在对话框的头文件中加入自定义排序函数SortList(CString &str)的函数声明。 (2)然后定义SortList()函数 void CDlgall::SortList(CString &str) { m_list.DeleteAllItems(); //清空所有条目 pset->m_strSort = str; //设定要排序的字段 CDlgall::OnLoadAll(); //显示所有记录 return; } 说明：成员m_strSort是CRecordset类的公共成员数据，用于指定排序。m_strSort实际上包含了ORDER BY子句的内容，但它不含ORDER BY关键字。m_strSort的一个例子为： m_pSet->m_strSort=“name DESC”; //按CourseID的降序排列记录 m_pSet->Open(); (3)为列表控件的LV_COLUMNCLICK消息添加消息响应函数 void CDlgall::OnColumnclickList1(NMHDR* pNMHDR, LRESULT* pResult) { NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR; //根据列字段进行排序 switch(pNMListView->iSubItem) { case 0: Sortlist(CString("number")); break; case 1: Sortlist(CString("[name]")); break; case 2: Sortlist(CString("[date]")); break; case 3: Sortlist(CString("[sex]")); break; case 4: Sortlist(CString("[age]")); break; } *pResult = 0; } 例4 双击CListCtrl中的某条记录进行修改 void CDlgall::OnDblclkList1(NMHDR* pNMHDR, LRESULT* pResult) { CDlgall::OnModify(); //双击某条记录则表示要修改记录 *pResult = 0; } 例5 根据输入的字段进行查询 void CDlgall::OnFind() { m_List.DeleteAllItems(); //清空列表以显示查询到的记录 UpdateData(true); //对m_number进行字符处理，根据检查号位数在检查号前加零 int len = strlen(m_number); char temp[10]; switch(len) { case 1: strcpy(temp,"00000");break; case 2: strcpy(temp,"0000");break; case 3: strcpy(temp,"000");break; case 4: strcpy(temp,"00");break; case 5: strcpy(temp,"0");break; default: strcpy(temp,""); } strcat(temp,m_number); m_number =temp; //查找对应的参数 CSetdata*pset = new CSetdata(); pset->m_strFilter = "number=?"; //设定过滤记录集的参数 pset->Open(); pset->number = m_number; pset->Requery(); //查询到符合条件的所有记录，并存放在记录集中 //在列表控件中显示记录 CString str1; if(!pset->IsEOF()) { //以下插入单条记录 char buffer[256]; LV_ITEM lvi; lvi.mask = LVIF_TEXT; lvi.iSubItem = 0; int i = 0; m_List.InsertItem(i,LPCTSTR(pset->m_number),0); m_List.SetItemText(i,1,LPCTSTR(pset->m_name)); str1 = pset->m_date.Format("%x"); m_List.SetItemText(i,2,str1); m_List.SetItemText(i,3,LPCTSTR(pset->m_sex)); m_List.SetItemText(i,4,LPCTSTR(ltoa(pset->m_age,buffer,10))); m_List.SetItemText(i,5,LPCTSTR(pset->m_zy)); m_List.SetItemText(i,6,LPCTSTR(pset->m_mode)); m_List.SetItemText(i,7,LPCTSTR(pset->m_bl)); pset->Close(); } else { CDlgall::OnLoadAll(); //如果没有找到相关记录，显示所有的记录 AfxMessageBox("对不起，没有相关记录!"); } }