列表控件可以看作是功能增强的ListBox，它提供了四种风格，而且可以同时显示一列的多中属性值。MFC中使用CListCtrl类来封装列表控件的各种操作。通过调用
BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );创建一个窗口，dwStyle中可以使用以下一些列表控件的专用风格：
LVS_ICON ,LVS_SMALLICON ,LVS_LIST, LVS_REPORT 这四种风格决定控件的外观，同时只可以选择其中一种，分别对应：大图标显示，小图标显示，列表显示，详细报表显示
LVS_EDITLABELS 结点的显示字符可以被编辑，对于报表风格来讲可编辑的只为第一列。
LVS_SHOWSELALWAYS 在失去焦点时也显示当前选中的结点
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)：用于删除某一项 [Page]
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。下面的代码说明如何处理这些消息：
0282 设置ListControl控件的显示风格
ListControl控件可在窗体中管理和显示列表项。可控制列表内容的显示方式，能够以图标和表格的形式显示数据。打开ListControl控件的属性窗口，在Styles选项卡中的View属性中可以设置显示风格，包括：Icon表示图标视图；Small Icon表示小图标视图；List表示列表视图；Report表示报表视图。
0283 为ListControl控件设置列标题
在使用ListControl控件Report显示风格时，需要设置列标题信息，否则不能向控件中添加数据信息，编辑列标题需要使用InsertColumn方法。该方法的语法如下：
int InsertColumn( int nCol, LPCTSTR lpszColumnHeading, int nFormat = LVCFMT_LEFT,int nWidth = -1, int nSubItem = -1 );
参数说明如下。
l nCol：标识新列的索引。
l lpszColumnHeading：标识列标题。
l nFormat：标识列的对齐方式。
l nWidth：标识列宽度。
l nSubItem：标识关联当前列的子视图项索引。
程序代码如下：
m_Grid.InsertColumn(0,"姓名",LVCFMT_LEFT,150,0);
m_Grid.InsertColumn(1,"联系电话",LVCFMT_LEFT,150,1);
0284 为ListControl控件添加行
在ListControl控件中添加信息时不能直接向控件中添加列信息，需要先为控件添加行，使用InsertItem方法，该方法用于向ListControl控件中添加行。语法如下：
int InsertItem( int nItem, LPCTSTR lpszItem );
参数说明如下。
l nItem：表示被插入的行索引。
l lpszItem：表示行文本。
程序代码如下：
m_Grid.InsertItem(0,"");
0285 为ListControl控件添加列
通过SetItemText方法可以为任意行的任意列添加数据，该方法用于设置ListControl控件中的文本。语法如下：
BOOL SetItemText( int nItem, int nSubItem, LPTSTR lpszText );
参数说明如下。
l nItem：标识行索引。
l nSubItem：标识列索引。
l lpszText：标识设置的显示文本。
程序代码如下：
m_Grid.SetItemText(0,0,"周X");
m_Grid.SetItemText(0,1,"12345XXXXXX");
0286 设置ListControl控件的扩展风格
在使用ListControl控件的Report显示风格时，需要设置一些常用的扩展风格。如图5.33所示。
图5.33 设置ListControl控件的扩展风格
程序代码如下：
m_Grid.SetExtendedStyle(
LVS_EX_FLATSB //扁平风格滚动条
|LVS_EX_FULLROWSELECT //允许整行选中
|LVS_EX_HEADERDRAGDROP //允许标题拖曳
|LVS_EX_ONECLICKACTIVATE //高亮显示
|LVS_EX_GRIDLINES //画出网格线
);
m_Grid.InsertColumn(0,"姓名",LVCFMT_LEFT,150,0);
m_Grid.InsertColumn(1,"联系电话",LVCFMT_LEFT,150,1);
m_Grid.InsertItem(0,"");
m_Grid.SetItemText(0,0,"周X");
m_Grid.SetItemText(0,1,"12345XXXXXX");
m_Grid.InsertItem(1,"");
m_Grid.SetItemText(1,0,"诸葛X");
m_Grid.SetItemText(1,1,"67890XXXXXX");
0287 设置ListControl控件数据的排列顺序
通过ListControl控件的属性窗口可以设置控件中数据的排列顺序，在Styles选项卡中的Sort属性中可以对控件中的数据进行排序，包括：None表示不进行排序；Ascending表示升序排列；Decending表示降序排列。
0288 单击ListControl控件列标题进行排序
在使用ListControl控件的Report显示风格时，要实现单击列标题进行排序需要在控件的LVN_COLUMNCLICK消息的处理函数中添加SortItems函数，SortItems函数实现了对列表项排序的功能，语法如下：
BOOL SortItems( PFNLVCOMPARE pfnCompare, DWORD dwData );
参数说明如下。
l pfnCompare：排序时所使用的回调函数，如果不进行排序就让回调函数返回-1。
l dwData：指定列表控件对象指针。
程序代码如下：
void CCompositorDlg::OnColumnclickList1(NMHDR* pNMHDR, LRESULT* pResult)
{
NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
m_Grid.SortItems(Compositor,(DWORD)reinterpret_cast<DWORD>(this));
*pResult = 0;
}
int CALLBACK CCompositorDlg::Compositor(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort)
{
CListCtrl* pListCtrl=reinterpret_cast<CListCtrl*>(lParamSort);
return 1;
}
0289 具有热点效果的视图控件
在使用列表视图控件时，如果列表视图以表格形式显示数据，并且包含有LVS_EX_TWOCLICKACTIVATE扩展风格，那么，当鼠标移动到某一行时，整行数据会出现热点效果。如何将某一个单元格设置为热点效果呢？本例实现了该功能，效果如图5.34所示。
本例是通过绘制列表视图控件实现的。首先从CListCtrl派生一个子类，然后添加ON_NOTIFY_REFLECT_EX(NM_CUSTOMDRAW,OnCustomDraw)消息映射实现CListCtrl的绘制。最后处理鼠标移动时的事件，判断鼠标在移动过程中，单元格是否发生了改变，如果发生了改变，重绘窗口。程序主要代码如下：
BOOL CCustomView::OnCustomDraw(NMHDR *pNotifyStruct, LRESULT *lResult)
{
NMLVCUSTOMDRAW * nmDraw = (NMLVCUSTOMDRAW *)pNotifyStruct;
NMCUSTOMDRAW & pDraw = nmDraw->nmcd;
UINT flag = pDraw.uItemState;
switch (pDraw.dwDrawStage)
{
case CDDS_PREPAINT :
{
*lResult =CDRF_NOTIFYITEMDRAW;
break;
}
case CDDS_ITEMPREPAINT :
{
*lResult =CDRF_NOTIFYSUBITEMDRAW ;
break;
}
case (CDDS_ITEMPREPAINT | CDDS_SUBITEM) :
{
int row = pDraw.dwItemSpec;
int col = nmDraw->iSubItem;
CPoint point;
GetCursorPos(&point);
ScreenToClient(&point);
CRect rect,secRC;
this->GetSubItemRect(row,col,LVIR_BOUNDS ,rect);
int cWidth = this->GetColumnWidth(0); //获取第一列的宽度
nmDraw->clrText = m_FontColor;
if (col !=0)
{
if (rect.PtInRect(point))
nmDraw->clrText = m_HotFontColor;
}
else
{
secRC.CopyRect(CRect(0,rect.top,cWidth,rect.bottom));
if (secRC.PtInRect(point))
nmDraw->clrText = m_HotFontColor;
}
break;
}
default:
{
*lResult = CDRF_DODEFAULT;
break;
}
}
return TRUE;
}
void CCustomView::OnMouseMove(UINT nFlags, CPoint point)
{
CListCtrl::OnMouseMove(nFlags, point);
LVHITTESTINFO pos;
pos.pt = point;
pos.flags = LVHT_ABOVE;
int curcol = -1;
int currow = -1;
if (this->SubItemHitTest(&pos)>=0)
{
curcol = pos.iSubItem;
currow = pos.iItem;
if (m_PreCol ==-1)
m_PreCol = curcol;
if (m_PreRow== -1)
m_PreRow = currow;
if (currow==0 && m_Valid == FALSE )
{
m_Valid = TRUE;
CRect rect;
GetSubItemRect(pos.iItem,pos.iSubItem,LVIR_BOUNDS ,rect);
int cWidth = rect.right;
if (curcol==0)
{
cWidth = this->GetColumnWidth(0); //获取第一列的宽度
}
RedrawWindow(CRect(rect.left,rect.top,cWidth,rect.bottom));
GetSubItemRect(m_PreRow,m_PreCol,LVIR_BOUNDS ,rect);
cWidth = rect.right;
if (m_PreCol==0)
{
cWidth = this->GetColumnWidth(0); //获取第一列的宽度
}
RedrawWindow(CRect(rect.left,rect.top,cWidth,rect.bottom));
}
else if (m_PreCol != curcol ||(m_PreRow != currow)) //用户移动鼠标时列发生了改变//或行发生了改变
{
CRect rect;
GetSubItemRect(pos.iItem,pos.iSubItem,LVIR_BOUNDS ,rect);
int cWidth = rect.right;
if (curcol==0)
{
cWidth = this->GetColumnWidth(0); //获取第一列的宽度
}
RedrawWindow(CRect(rect.left,rect.top,cWidth,rect.bottom));
GetSubItemRect(m_PreRow,m_PreCol,LVIR_BOUNDS ,rect);
cWidth = rect.right;
if (m_PreCol==0)
{
cWidth = this->GetColumnWidth(0); //获取第一列的宽度
}
RedrawWindow(CRect(rect.left,rect.top,cWidth,rect.bottom));
}
m_PreCol = curcol;
m_PreRow = currow;
}
}
0290 具有背景的列表视图控件
在使用列表视图控件时，默认情况下，列表视图控件具有白色的背景，如果能够在列表视图中以图片为背景，界面效果会好很多。本例实现了一个具有背景的列表视图控件，如图5.35所示。
图5.35 具有背景的列表视图控件
有些用户可能认为只要从CListCtrl派生一个子类，然后在WM_PAINT消息处理函数中绘制一幅图片就可以了。但是，这样会导致列表视图中的数据被背景图片覆盖。其实，实现具有背景的列表视图控件并不复杂，首先在程序初始化时调用AfxOleInit()函数初始化Com；然后调用CListCtrl的SetBkImage方法设置背景位图；最后调用SetTextBkColor方法将文本背景透明。程序主要代码如下：
m_List.SetBkImage("c:\\background2.bmp");
m_List.SetTextBkColor(CLR_NONE);
