ListCtrl控件的使用

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

2、可編輯的只為第一列。 LVS_SHOWSELALWAYS 在失去焦點(diǎn)時也顯示當(dāng)前選中的結(jié)點(diǎn)LVS_SINGLESEL 同時只能選中列表中一項(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就可以了，但如果使用報表風(fēng)格就必須先設(shè)置列表控件中的列信息。int InsertColumn( int nCol, LPCTSTR lpszColumnHeading, int nFormat , int nWidth, int nSubItem);iCol：為列的位置，從零開始lpszColumnHeading：為顯示的列名nFormat：為顯示對齊方式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)前客戶區(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);這部分初始化操作，最好放在對話框類的OnInitDialog()函數(shù)里，自動初始化。6.插入行int InsertItem( int nItem, LPCTSTR lpszItem );nItem：指明插入位置lpszItem：為顯示字符。m_list.InsertItem(0,"數(shù)據(jù)一"); /插入第一個數(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ù)量已明確時使用。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)，在具體使用時需要轉(zhuǎn)換成其他類型的結(jié)構(gòu)。對于列表控件可能取值和對應(yīng)的數(shù)據(jù)結(jié)構(gòu)為：LVN_BEGINLA

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

11、INFO，然后填充其中item.pszText。通過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;/通過iItem得到需要顯示的字符在數(shù)組中的位置*pResult = 0;關(guān)于編輯某項(xiàng)的顯示字符：（在報表風(fēng)格中只對第一列有效）首先需要設(shè)置列表控件的LVS_EDITLABELS風(fēng)格，在開始編輯時該控件將會發(fā)送LVN_BEGINLABELEDIT，你可以通過在處理函數(shù)中返回TRUE來取消接下來的編輯，在編輯完成后會發(fā)送LVN_ENDLABELEDIT，在處理該消息時需要將參數(shù)pNMHDR轉(zhuǎn)換為LPNMLVDISPINFO，然后通過其中

13、的item.pszText得到編輯后的字符，并重置顯示字符。如果編輯在中途中取消該變量為NULL。下面的代碼說明如何處理這些消息： /處理消息 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)位置：在列表控件中沒有一個類似于Lis

15、tBox中GetCurSel()的函數(shù)，但是可以通過調(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)中行中的任意一個列選中這一條記錄LVS_EX_GRIDLINES表示列之間有分隔符號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è)置表頭對齊方式lvColumn.iSubItem = i; 表頭列序lvColumn.pszText = HeaderTxti; 表頭名稱lvColumn.cx = 90; 表頭寬度m_list.InsertColumn(i,&lvColumn); 插入列三、列表控制的數(shù)據(jù)結(jié)構(gòu)列表控制中包含兩個非常重要的數(shù)據(jù)結(jié)構(gòu)LV_ITEM和LV_COLUMN。LV_ITEM用于

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

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

19、2、導(dǎo)入幾個圖標(biāo)IDI_ICON1-IDI_ICON8,用來裝載到LVS_ICON ,LVS_SMALLICON風(fēng)格的CListCtrl中.3、在對話框的最右邊加入一個CListCtrl,代碼中會實(shí)現(xiàn)該控件的風(fēng)格切換.4、在對話框窗口中設(shè)計組合框(Group Box),組合框中設(shè)置四個無線按鈕(Radio),分別用來切換"大圖標(biāo)、小圖標(biāo)、列表、報表"風(fēng)格,在設(shè)置無線按鈕時,需要注意的是只有大圖標(biāo)的Group屬性為選中狀態(tài),而其它無線按鈕的狀態(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)/ 其他代碼./ 將手動添加控件與變量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)、列表、報表" 四種風(fēng)格的CListCtrlCreateListCtrl();/ 自定義函數(shù). 為大圖標(biāo)和小圖標(biāo)風(fēng)格的CListCtrl創(chuàng)建和加載圖標(biāo)鏈表CreateImageList();/ 自定義函數(shù). 插入Column的兩種方法(只對Report風(fēng)格的報表有效)InsertColumn();/ 自定義函數(shù). 插入行的兩種方法InsertItem();/ 自定義函數(shù). 更改行的兩種方法SetItemInfo();return TRUE; / return TRUE unless you set the focus to a control/ 創(chuàng)建報

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控件, 報表風(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("第一個");lvitem.iImage = 0;lvitem.lParam = 0;iIndex = m_lstCtrlRpt.InsertItem(&lvitem);lvitem.mask = LVIF_TEXT;lvitem.iItem = iIndex;lvitem.iSubItem = 1;lvitem.pszText = _T("第二個");m_lstCtrlRpt.SetItem(&lvitem);lvitem.iSubItem = 2;lvitem.pszText = _T("第三個");m_

32、lstCtrlRpt.SetItem(&lvitem);m_lstCtrlRpt.SetItemText(0, 3, _T("第四個");/ 第二種:直接插入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