ListCtrl控件的使用

1、CListCtrl介紹列表控件可以看作是功能增強(qiáng)的ListBox，它提供了四種風(fēng)格，而且可以同時(shí)顯示一列的多中屬性值。LVS_ICON ,LVS_SMALLICON ,LVS_LIST, LVS_REPORT 這四種風(fēng)格決定控件的外觀，同時(shí)只可以選擇其中一種，分別對(duì)應(yīng)：大圖標(biāo)顯示，小圖標(biāo)顯示，列表顯示，詳細(xì)報(bào)表顯示。一、常用函數(shù)1.創(chuàng)建BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID ); dwStyle 列表控件的風(fēng)格LVS_EDITLABELS 結(jié)點(diǎn)的顯示字符可以被編輯，對(duì)于報(bào)表風(fēng)格來(lái)講

2、可編輯的只為第一列。 LVS_SHOWSELALWAYS 在失去焦點(diǎn)時(shí)也顯示當(dāng)前選中的結(jié)點(diǎn)LVS_SINGLESEL 同時(shí)只能選中列表中一項(xiàng)2.首先你需要設(shè)置列表控件所使用的ImageList，如果你使用大圖標(biāo)顯示風(fēng)格，你就需要以如下形式調(diào)用：CImageList* SetImageList( CImageList* pImageList, LVSIL_NORMAL);3.如果使用其它三種風(fēng)格顯示而不想顯示圖標(biāo)你可以不進(jìn)行任何設(shè)置，否則需要以如下形式調(diào)用：CImageList* SetImageList( CImageList* pImageList, LVSIL_SMALL);4.插入列除L

3、VS_REPORT風(fēng)格外其他三種風(fēng)格都只需要直接調(diào)用InsertItem就可以了，但如果使用報(bào)表風(fēng)格就必須先設(shè)置列表控件中的列信息。int InsertColumn( int nCol, LPCTSTR lpszColumnHeading, int nFormat , int nWidth, int nSubItem);iCol：為列的位置，從零開(kāi)始lpszColumnHeading：為顯示的列名nFormat：為顯示對(duì)齊方式nWidth：為顯示寬度nSubItem：為分配給該列的列索引。例如:m_list.InsertColumn(0,"列頭1");m_list.Inse

4、rtColumn(1,"列頭2");m_list.InsertColumn(2,"列頭3");m_list.InsertColumn(3,"列頭4");5.設(shè)置列寬CRect rect4;m_list.GetClientRect(rect4); /獲得當(dāng)前客戶(hù)區(qū)信息m_list.SetColumnWidth(0,rect4.Width()/4); /設(shè)置列的寬度。m_list.SetColumnWidth(1,rect4.Width()/5);m_list.SetColumnWidth(2,rect4.Width()/5);m_lis

5、t.SetColumnWidth(3,rect4.Width()*8/20);這部分初始化操作，最好放在對(duì)話(huà)框類(lèi)的OnInitDialog()函數(shù)里，自動(dòng)初始化。6.插入行int InsertItem( int nItem, LPCTSTR lpszItem );nItem：指明插入位置lpszItem：為顯示字符。m_list.InsertItem(0,"數(shù)據(jù)一"); /插入第一個(gè)數(shù)據(jù)，即第0條數(shù)據(jù)。先插入，然后在修改其他的信息。m_list.SetItemText(0,1,"數(shù)據(jù)二"); /修改第0條數(shù)據(jù)的其他信息。m_list.SetItemTex

6、t(0,2,"數(shù)據(jù)三");m_list.SetItemText(0,3,"數(shù)據(jù)四");7.刪除所有行m_list.DeleteAllItems();8.設(shè)置每列的顯示字符BOOL SetItemText( int nItem, int nSubItem, LPTSTR lpszText );nItem：為行位置nSubItem：為列位置lpszText：為顯示字符9.其它COLORREF GetTextColor( )/BOOL SetTextColor( COLORREF cr )：用于得到/設(shè)置顯示的字符顏色。COLORREF GetTextBkCo

7、lor( )/BOOL SetTextBkColor( COLORREF cr )：用于得到/設(shè)置顯示的背景顏色。void SetItemCount( int iCount )：用于設(shè)置添加進(jìn)列表中項(xiàng)的數(shù)量，當(dāng)要添加的數(shù)據(jù)量已明確時(shí)使用。BOOL DeleteItem(int nItem)：用于刪除某一項(xiàng)BOOL SetBkImage(HBITMAP hbm, BOOL fTile , int xOffsetPercent, int yOffsetPercent)：用于設(shè)置背景位圖。CString GetItemText( int nItem, int nSubItem )：用于得到某項(xiàng)的顯示

8、字符。下面的代碼演示了如何設(shè)置多列并插入數(shù)據(jù)：m_list.InsertColumn(0,"Col 1",LVCFMT_LEFT,300,0); /設(shè)置列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");/設(shè)置該

9、行的不同列的顯示字符m_list.SetItemText(0,2,"Item 1_3")二、列表控件的消息映射列表控件的消息映射同樣使用ON_NOTIFY宏，形式如同：ON_NOTIFY( wNotifyCode, id, memberFxn )，wNotifyCode為通知代碼，id為產(chǎn)生該消息的窗口ID，memberFxn為處理函數(shù)，函數(shù)的原型如同void OnXXXList(NMHDR* pNMHDR, LRESULT* pResult)，其中pNMHDR為一數(shù)據(jù)結(jié)構(gòu)，在具體使用時(shí)需要轉(zhuǎn)換成其他類(lèi)型的結(jié)構(gòu)。對(duì)于列表控件可能取值和對(duì)應(yīng)的數(shù)據(jù)結(jié)構(gòu)為：LVN_BEGINLA

10、BELEDIT 在開(kāi)始某項(xiàng)編輯字符時(shí)發(fā)送，所用結(jié)構(gòu)：NMLVDISPINFOLVN_ENDLABELEDIT 在結(jié)束某項(xiàng)編輯字符時(shí)發(fā)送，所用結(jié)構(gòu)：NMLVDISPINFOLVN_GETDISPINFO 在需要得到某項(xiàng)信息時(shí)發(fā)送,(如得到某項(xiàng)的顯示字符)所用結(jié)構(gòu)：NMLVDISPINFO關(guān)于ON_NOTIFY有很多內(nèi)容，將在以后的內(nèi)容中進(jìn)行詳細(xì)講解。關(guān)于動(dòng)態(tài)提供結(jié)點(diǎn)所顯示的字符：首先你在項(xiàng)時(shí)需要指明lpszItem參數(shù)為：LPSTR_TEXTCALLBACK。在控件顯示該結(jié)點(diǎn)時(shí)會(huì)通過(guò)發(fā)送TVN_GETDISPINFO來(lái)取得所需要的字符，在處理該消息時(shí)先將參數(shù)pNMHDR轉(zhuǎn)換為L(zhǎng)PNMLVDISP

11、INFO，然后填充其中item.pszText。通過(guò)item中的iItem,iSubItem可以知道當(dāng)前顯示的為那一項(xiàng)。下面的代碼演示了這種方法：char szOut83="No.1","No.2","No.3"/添加結(jié)點(diǎn)m_list.InsertItem(LPSTR_TEXTCALLBACK,.)m_list.InsertItem(LPSTR_TEXTCALLBACK,.)/處理消息void CParentWnd:OnGetDispInfoList(NMHDR* pNMHDR, LRESULT* pResult)LV_DISPINF

12、O* pLVDI = (LV_DISPINFO*)pNMHDR;pLVDI->item.pszText=szOutpTVDI->item.iItem;/通過(guò)iItem得到需要顯示的字符在數(shù)組中的位置*pResult = 0;關(guān)于編輯某項(xiàng)的顯示字符：（在報(bào)表風(fēng)格中只對(duì)第一列有效）首先需要設(shè)置列表控件的LVS_EDITLABELS風(fēng)格，在開(kāi)始編輯時(shí)該控件將會(huì)發(fā)送LVN_BEGINLABELEDIT，你可以通過(guò)在處理函數(shù)中返回TRUE來(lái)取消接下來(lái)的編輯，在編輯完成后會(huì)發(fā)送LVN_ENDLABELEDIT，在處理該消息時(shí)需要將參數(shù)pNMHDR轉(zhuǎn)換為L(zhǎng)PNMLVDISPINFO，然后通過(guò)其中

13、的item.pszText得到編輯后的字符，并重置顯示字符。如果編輯在中途中取消該變量為NULL。下面的代碼說(shuō)明如何處理這些消息： /處理消息 LVN_BEGINLABELEDITvoid CParentWnd:OnBeginEditList(NMHDR* pNMHDR, LRESULT* pResult)LV_DISPINFO* pLVDI = (LV_DISPINFO*)pNMHDR;if(pLVDI->item.iItem=0);/判斷是否取消該操作*pResult = 1;else*pResult = 0;/處理消息 LVN_BEGINLABELEDITvoid CParentW

14、nd:OnBeginEditList(NMHDR* pNMHDR, LRESULT* pResult)LV_DISPINFO* pLVDI = (LV_DISPINFO*)pNMHDR;if(pLVDI->item.pszText=NULL);/判斷是否已經(jīng)取消取消編輯m_list.SetItemText(pLVDI->item.iItem,0,pLVDI->pszText);/重置顯示字符*pResult = 0;上面講述的方法所進(jìn)行的消息映射必須在父窗口中進(jìn)行（同樣WM_NOTIFY的所有消息都需要在父窗口中處理）。如何得到當(dāng)前選中項(xiàng)位置：在列表控件中沒(méi)有一個(gè)類(lèi)似于Lis

15、tBox中GetCurSel()的函數(shù)，但是可以通過(guò)調(diào)用GetNextItem( -1, LVNI_ALL | LVNI_SELECTED);得到選中項(xiàng)位置。 list control控件中的風(fēng)格選項(xiàng)：m_list1.SetExtendedStyle( LVS_EX_FULLROWSELECT|LVS_EX_GRIDLINES|LVS_EX_CHECKBOXES );LVS_EX_FULLROWSELECT表示可以點(diǎn)中行中的任意一個(gè)列選中這一條記錄LVS_EX_GRIDLINES表示列之間有分隔符號(hào)LVS_EX_CHECKBOXES 表示每一行第一列是checkboxLVCOLUMN:list

16、viewcolumn設(shè)置表頭lvColumn.mask = LVCF_SUBITEM|LVCF_TEXT|LVCF_WIDTH|LVCF_FMT; 設(shè)置表頭風(fēng)格 lvColumn.fmt = LVCFMT_CENTER; 設(shè)置表頭對(duì)齊方式lvColumn.iSubItem = i; 表頭列序lvColumn.pszText = HeaderTxti; 表頭名稱(chēng)lvColumn.cx = 90; 表頭寬度m_list.InsertColumn(i,&lvColumn); 插入列三、列表控制的數(shù)據(jù)結(jié)構(gòu)列表控制中包含兩個(gè)非常重要的數(shù)據(jù)結(jié)構(gòu)LV_ITEM和LV_COLUMN。LV_ITEM用于

17、定義列表控制的一個(gè)表項(xiàng)，LV_COLUMN用于定義列表控制的一個(gè)表列，其定義格式分別為：typedef struct _LV_ITEM UINT mask; /結(jié)構(gòu)成員屏蔽位int iItem; /表項(xiàng)索引號(hào)int iSubItem; /子表項(xiàng)索引號(hào)UINT state; /表項(xiàng)狀態(tài)UINT stateMask; /狀態(tài)有效性屏蔽位LPTSTR pszText; /表項(xiàng)名文本int cchTextMax; /表項(xiàng)名最大長(zhǎng)度int iImage; /表項(xiàng)圖標(biāo)的索引號(hào)LPARAM lParam; /與表項(xiàng)相關(guān)的32位數(shù)LV_ITEM;typedef struct _LV_COLUMN UINT m

18、ask; /結(jié)構(gòu)成員有效性屏蔽位int fmt; /表列對(duì)齊方式int cx; /表列的象素寬度LPTSTR pszText; /表列的表頭名int cchTextMax; /表列名的文本長(zhǎng)度int iSubItem; /與表列關(guān)聯(lián)的子表項(xiàng)索引號(hào)LV_COLUMN;其中fmt可以取如下值：LVCFMT_CENTER 表列居中對(duì)齊LVCFMT_LEFT 表列左對(duì)齊四、列表控制的應(yīng)用示例下面給出具體實(shí)例演示列表控制及前面的表頭控制和圖像列表的應(yīng)用技巧。步驟如下：1、使用VS2005新建一個(gè)工程CCLCTest,在建立過(guò)程中選擇基于對(duì)話(huà)框(Dialog based)的應(yīng)用;將對(duì)話(huà)框中的默認(rèn)控件刪除.

19、2、導(dǎo)入幾個(gè)圖標(biāo)IDI_ICON1-IDI_ICON8,用來(lái)裝載到LVS_ICON ,LVS_SMALLICON風(fēng)格的CListCtrl中.3、在對(duì)話(huà)框的最右邊加入一個(gè)CListCtrl,代碼中會(huì)實(shí)現(xiàn)該控件的風(fēng)格切換.4、在對(duì)話(huà)框窗口中設(shè)計(jì)組合框(Group Box),組合框中設(shè)置四個(gè)無(wú)線按鈕(Radio),分別用來(lái)切換"大圖標(biāo)、小圖標(biāo)、列表、報(bào)表"風(fēng)格,在設(shè)置無(wú)線按鈕時(shí),需要注意的是只有大圖標(biāo)的Group屬性為選中狀態(tài),而其它無(wú)線按鈕的狀態(tài)均為默認(rèn)值.5、在Resource.h中添加資源ID#define IDC_LIST2 103#define IDC_LIST3 10

20、4#define IDC_LIST4 105#define IDC_LIST5 1066、在程序增加下列代碼:void CCLCTestDlg:DoDataExchange(CDataExchange* pDX)/ 其他代碼./ 將手動(dòng)添加控件與變量m_lstCtrlOne關(guān)聯(lián)DDX_Control(pDX, IDC_LIST1, m_lstCtrlOne);BOOL CCLCTestDlg:OnInitDialog()/ 設(shè)置大圖標(biāo)的Radio按鈕為選中狀態(tài)(CButton*)GetDlgItem(IDC_RADIO1)->SetCheck(BST_CHECKED);/ 自定義函數(shù).

21、創(chuàng)建 "大圖標(biāo)、小圖標(biāo)、列表、報(bào)表" 四種風(fēng)格的CListCtrlCreateListCtrl();/ 自定義函數(shù). 為大圖標(biāo)和小圖標(biāo)風(fēng)格的CListCtrl創(chuàng)建和加載圖標(biāo)鏈表CreateImageList();/ 自定義函數(shù). 插入Column的兩種方法(只對(duì)Report風(fēng)格的報(bào)表有效)InsertColumn();/ 自定義函數(shù). 插入行的兩種方法InsertItem();/ 自定義函數(shù). 更改行的兩種方法SetItemInfo();return TRUE; / return TRUE unless you set the focus to a control/ 創(chuàng)建報(bào)

22、表、圖標(biāo)、小圖標(biāo)和列表四種ListCtrl控件void CCLCTestDlg:CreateListCtrl(void)CRect rect;CRect rectTmp;GetClientRect(&rect);rectTmp.left = rect.left + 10;rectTmp.top = rect.top + 10;rectTmp.right = rectTmp.left + rect.Width() / 3 - 10;rectTmp.bottom = rectTmp.top + rect.Height() / 2 - 50;/ 創(chuàng)建CListCtrl控件, 報(bào)表風(fēng)格(m_l

23、stCtrlRpt)m_lstCtrlRpt.Create(WS_CHILD | WS_VISIBLE | WS_BORDER | LVS_REPORT, rectTmp, this, IDC_LIST2);rectTmp.left = rectTmp.right + 20;rectTmp.right = rectTmp.left + rect.Width() / 3 - 10;/ 創(chuàng)建CListCtrl控件, 大圖標(biāo)風(fēng)格(m_lstCtrlIcon)m_lstCtrlIcon.Create(WS_CHILD | WS_VISIBLE | WS_BORDER | LVS_ICON, rectT

24、mp, this, IDC_LIST3);rectTmp.top = rectTmp.bottom + 10;rectTmp.bottom = rectTmp.top + rect.Height() / 2 - 30;/ 創(chuàng)建CListCtrl控件, 小圖標(biāo)風(fēng)格(m_lstCtrlSIcon)m_lstCtrlSIcon.Create(WS_CHILD | WS_VISIBLE | WS_BORDER | LVS_SMALLICON, rectTmp, this, IDC_LIST4);rectTmp.right = rectTmp.left - 20;rectTmp.left = rectT

25、mp.right - rect.Width() / 3 + 10;/ 創(chuàng)建CListCtrl控件, 列表風(fēng)格(m_lstCtrlList)m_lstCtrlList.Create(WS_CHILD | WS_VISIBLE | WS_BORDER | LVS_LIST, rectTmp, this, IDC_LIST5);/ 創(chuàng)建圖表鏈表void CCLCTestDlg:CreateImageList(void)/ 創(chuàng)建圖標(biāo)鏈表m_ImageListBig.Create(IDB_BITMAP1, 64, 0, RGB(0,0,0);CCLCTestApp* pApp = (CCLCTestAp

26、p*)AfxGetApp();m_ImageListSmall.Create(32, 32, TRUE, 0, 8);m_ImageListSmall.Add(pApp->LoadIcon(IDI_ICON1);m_ImageListSmall.Add(pApp->LoadIcon(IDI_ICON2);m_ImageListSmall.Add(pApp->LoadIcon(IDI_ICON3);m_ImageListSmall.Add(pApp->LoadIcon(IDI_ICON4);m_ImageListSmall.Add(pApp->LoadIcon(ID

27、I_ICON5);m_ImageListSmall.Add(pApp->LoadIcon(IDI_ICON6);m_ImageListSmall.Add(pApp->LoadIcon(IDI_ICON7);m_ImageListSmall.Add(pApp->LoadIcon(IDI_ICON8);/ 設(shè)置圖標(biāo)鏈表m_lstCtrlList.SetImageList(&m_ImageListBig, LVSIL_NORMAL);m_lstCtrlIcon.SetImageList(&m_ImageListBig, LVSIL_NORMAL);m_lstCtrl

28、SIcon.SetImageList(&m_ImageListSmall, LVSIL_SMALL);/ 插入列頭void CCLCTestDlg:InsertColumn(void)CRect rectTmp;m_lstCtrlRpt.GetClientRect(&rectTmp);/ 插入列, 只有Report才用此函數(shù)/ 第一種:使用LV_COLUMN插入LV_COLUMN lvcol;lvcol.mask = LVCF_FMT | LVCF_SUBITEM | LVCF_TEXT | LVCF_WIDTH; lvcol.fmt = LVCFMT_CENTER;int i

29、 = 0;lvcol.pszText = _T("第一列");lvcol.iSubItem = i;lvcol.cx = rectTmp.Width() / 4;m_lstCtrlRpt.InsertColumn(i+, &lvcol);lvcol.pszText = _T("第二列");lvcol.iSubItem = i;m_lstCtrlRpt.InsertColumn(i+, &lvcol);/ 第二種:直接插入m_lstCtrlRpt.InsertColumn(i+, _T("第三列"), LVCFMT_LE

30、FT, rectTmp.Width() / 4); m_lstCtrlRpt.InsertColumn(i+, _T("第四列"), LVCFMT_LEFT, rectTmp.Width() / 4);/ 插入行void CCLCTestDlg:InsertItem(void)/ 插入行/ 第一種:使用LV_ITEM插入LV_ITEM lvitem;int iIndex;lvitem.mask = LVIF_TEXT | LVIF_IMAGE | LVIF_PARAM; lvitem.iItem = 0;lvitem.iSubItem = 0;lvitem.pszText

31、= _T("第一個(gè)");lvitem.iImage = 0;lvitem.lParam = 0;iIndex = m_lstCtrlRpt.InsertItem(&lvitem);lvitem.mask = LVIF_TEXT;lvitem.iItem = iIndex;lvitem.iSubItem = 1;lvitem.pszText = _T("第二個(gè)");m_lstCtrlRpt.SetItem(&lvitem);lvitem.iSubItem = 2;lvitem.pszText = _T("第三個(gè)");m_

32、lstCtrlRpt.SetItem(&lvitem);m_lstCtrlRpt.SetItemText(0, 3, _T("第四個(gè)");/ 第二種:直接插入m_lstCtrlIcon.InsertItem(0, _T("一"), 0);m_lstCtrlIcon.InsertItem(1, _T("二"), 1);m_lstCtrlIcon.InsertItem(2, _T("三"), 2);m_lstCtrlIcon.InsertItem(3, _T("四"), 3);m_lstCt

33、rlIcon.InsertItem(4, _T("五"), 4);m_lstCtrlIcon.InsertItem(5, _T("六"), 5);m_lstCtrlSIcon.InsertItem(0, _T("一"), 0);m_lstCtrlSIcon.InsertItem(1, _T("二"), 1);m_lstCtrlSIcon.InsertItem(2, _T("三"), 2);m_lstCtrlSIcon.InsertItem(3, _T("四"), 3);m_l

34、stCtrlSIcon.InsertItem(4, _T("五"), 4);m_lstCtrlSIcon.InsertItem(5, _T("六"), 5);m_lstCtrlList.InsertItem(0, _T("一"), 0);m_lstCtrlList.InsertItem(1, _T("二"), 1);m_lstCtrlList.InsertItem(2, _T("三"), 2);m_lstCtrlList.InsertItem(3, _T("四"), 3);m

35、_lstCtrlList.InsertItem(4, _T("五"), 4);m_lstCtrlList.InsertItem(5, _T("六"), 5);/ 更改行數(shù)據(jù)void CCLCTestDlg:SetItemInfo(void)/ 第一種方法m_lstCtrlRpt.SetItemText(1, 0, _T("第一種更改方法");m_lstCtrlIcon.SetItemText(1, 0, _T("第一種更改方法");m_lstCtrlSIcon.SetItemText(1, 0, _T("第一種更改方法");m_lstCtrlList.SetItemText(1, 0, _T("第一種更改方法");/第二種方法LV_ITEM lvitem;lvitem.mask = LVIF_TEXT | LVIF_IMAGE;lvitem.iItem = 0;lvitem.iSubItem = 0;lvitem.pszText = _T("第二種更改方法");lvitem.iImage = 2;m_lstCtrlRpt.SetItem(&a