4.8 List Ctrl

通过调用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″);

此外CListCtrl还提供了一些函数用于得到/修改控件的状态。
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

关于动态提供结点所显示的字符：首先你在项时需要指明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;

}

如何得到当前选中项位置：在列表控件中没有一个类似于ListBox中GetCurSel()的函数，但是可以通过调用GetNextItem( -1, LVNI_ALL | LVNI_SELECTED);得到选中项位置。

　　《Visual C++开发指南》 闻怡洋/文