列表控件可以看作是功能增强的 ListBox,它提供了四种风格,而且可以同时显示一列的多中属性值。MFC 中使用 CListCtrl 类来封装列表控件的各种操作。通过调用 BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );创建一个窗口,dwStyle 中可以使用以下一些列表控件的专用风格:
l LVS_ICON ,LVS_SMALLICON ,LVS_LIST, LVS_REPORT 这四种风格决定控件的外观,同时只可以选择其中一种,分别对应:大图标显示,小图标显示,列表显示,详细报表显示
l LVS_EDITLABELS 结点的显示字符可以被编辑,对于报表风格来讲可编辑的只为第一列。
l LVS_SHOWSELALWAYS 在失去焦点时也显示当前选中的结点
l LVS_SINGLESEL 同时只能选中列表中一项
首先你需要设置列表控件所使用的 ImageList,如果你使用大图标显示风格,你就需要以如下形式调用:
CImageList* SetImageList( CImageList* pImageList, LVSIL_NORMAL);
如果使用其它三种风格显示而不想显示图标你可以不进行任何设置,否则需要以如下形式调用:
CImageList* SetImageList( CImageList* pImageList, LVSIL_SMALL);
int InsertItem( int nItem, LPCTSTR lpszItem ); 插入行
nItem:指明插入位置
lpszItem:为显示字符。
除 LVS_REPORT 风格外其他三种风格都只需要直接调用 InsertItem 就可以了,但如果使用报表风格就必须先设置列表控件中的列信息。
int InsertColumn( int nCol, LPCTSTR lpszColumnHeading, int nFormat , int nWidth, int nSubItem); 插入列
iCol:为列的位置,从零开始
lpszColumnHeading:为显示的列名
nFormat:为显示对齐方式
nWidth:为显示宽度
nSubItem:为分配给该列的列索引。
BOOL SetItemText( int nItem, int nSubItem, LPTSTR lpszText );设置每列的显示字符
nItem:为行位置
nSubItem:为列位置
lpszText:为显示字符
下面的代码演示了如何设置多列并插入数据:
m_list.SetImageList(&m_listSmall,LVSIL_SMALL);//设置 ImageList
m_list.InsertColumn(0,"Col 1",LVCFMT_LEFT,300,0);//设置列
m_list.InsertColumn(1,"Col 2",LVCFMT_LEFT,300,1);
m_list.InsertColumn(2,"Col 3",LVCFMT_LEFT,300,2);
m_list.InsertItem(0,"Item 1_1");//插入行
m_list.SetItemText(0,1,"Item 1_2");//设置该行的不同列的显示字符
m_list.SetItemText(0,2,"Item 1_3")
COLORREF GetTextColor( )/BOOL SetTextColor( COLORREF cr ):用于得到/设置显示的字符颜色。
COLORREF GetTextBkColor( )/BOOL SetTextBkColor( COLORREF cr ):用于得到/设置显示的背景颜色。
void SetItemCount( int iCount ):用于得到添加进列表中项的数量。
BOOL DeleteItem(int nItem):用于删除某一项
BOOL DeleteAllItems( ):将删除所有项。
BOOL SetBkImage(HBITMAP hbm, BOOL fTile , int xOffsetPercent, int yOffsetPercent):用于设置背景位图。
CString GetItemText( int nItem, int nSubItem ):用于得到某项的显示字符。
列表控件的消息映射同样使用 ON_NOTIFY 宏,形式如同:ON_NOTIFY( wNotifyCode, id, memberFxn ),wNotifyCode 为通知代码,id 为产生该消息的窗口 ID,memberFxn 为处理函数,函数的原型如同 void OnXXXList(NMHDR* pNMHDR, LRESULT* pResult),其中 pNMHDR 为一数据结构,在具体使用时需要转换成其他类型的结构。对于列表控件可能取值和对应的数据结构为:
LVN_BEGINLABELEDIT 在开始某项编辑字符时发送,所用结构:NMLVDISPINFO
LVN_ENDLABELEDIT 在结束某项编辑字符时发送,所用结构:NMLVDISPINFO
LVN_GETDISPINFO 在需要得到某项信息时发送,(如得到某项的显示字符)所用结构:NMLVDISPINFO
关于 ON_NOTIFY 有很多内容,将在以后的内容中进行详细讲解。
关于动态提供结点所显示的字符:首先你在项时需要指明lpszItem参数为:
LPSTR_TEXTCALLBACK。在控件显示该结点时会通过发送 TVN_GETDISPINFO 来取得所需要的字符,在处理该消息时先将参数 pNMHDR 转换为 LPNMLVDISPINFO,然后填充其中 item.pszText。通过 item 中的 iItem,iSubItem 可以知道当前显示的为那一项。下面的代码演示了这种方法:
char szOut[8][3]={"No.1","No.2","No.3"};//添加结点
m_list.InsertItem(LPSTR_TEXTCALLBACK,...)
m_list.InsertItem(LPSTR_TEXTCALLBACK,...)//处理消息
void CParentWnd::OnGetDispInfoList(NMHDR* pNMHDR, LRESULT* pResult)
{
LV_DISPINFO* pLVDI = (LV_DISPINFO*)pNMHDR;
pLVDI->item.pszText=szOut[pTVDI->item.iItem];//通过iItem得到需要显示的字符在数组中的位置
*pResult = 0;
}
关于编辑某项的显示字符:(在报表风格中只对第一列有效)首先需要设置列表控件的LVS_EDITLABELS 风格,在开始编辑时该控件将会发送 LVN_BEGINLABELEDIT,你可以通过在处理函数中返回 TRUE 来取消接下来的编辑,在编辑完成后会发送 LVN_ENDLABELEDIT,
在处理该消息时需要将参数 pNMHDR 转换为 LPNMLVDISPINFO,然后通过其中的 item.pszText 得到编辑后的字符,并重置显示字符。如果编辑在中途中取消该变量为 NULL。下面的代码说明如何处理这些消息:
//处理消息 LVN_BEGINLABELEDIT
void CParentWnd::OnBeginEditList(NMHDR* pNMHDR, LRESULT* pResult)
{
LV_DISPINFO* pLVDI = (LV_DISPINFO*)pNMHDR;
if(pLVDI->item.iItem==0);//判断是否取消该操作
*pResult = 1;
else
*pResult = 0;
}
//处理消息 LVN_BEGINLABELEDIT
void CParentWnd::OnBeginEditList(NMHDR* pNMHDR, LRESULT* pResult)
{
LV_DISPINFO* pLVDI = (LV_DISPINFO*)pNMHDR;
if(pLVDI->item.pszText==NULL);//判断是否已经取消取消编辑
m_list.SetItemText(pLVDI->item.iItem,0,pLVDI->pszText);
//重置显示字符
*pResult = 0;
}
上面讲述的方法所进行的消息映射必须在父窗口中进行(同样 WM_NOTIFY 的所有消息都需要在父窗口中处理)。
如何得到当前选中项位置:在列表控件中没有一个类似于 ListBox 中 GetCurSel()的函数,但是可以通过调用 GetNextItem( -1, LVNI_ALL | LVNI_SELECTED);得到选中项位置。
list control 控件中的风格选项:
m_list1.SetExtendedStyle( LVS_EX_FULLROWSELECT|LVS_EX_GRIDLINES|LVS_EX_CHECKBOXES );
LVS_EX_FULLROWSELECT 表示可以点中行中的任意一个列选中这一条记录
LVS_EX_GRIDLINES 表示列之间有分隔符号
LVS_EX_CHECKBOXES 表示每一行第一列是 checkbox
LVCOLUMN:listviewcolumn
设置表头
lvColumn.mask = LVCF_SUBITEM|LVCF_TEXT|LVCF_WIDTH|LVCF_FMT; 设置表头风格
vColumn.fmt = LVCFMT_CENTER; 设置表头对齐方式
lvColumn.iSubItem = i; 表头列序
lvColumn.pszText = HeaderTxt; 表头名称
lvColumn.cx = 90; 表头宽度
m_list.InsertColumn(i,&lvColumn); 插入列