CList控件使用方法1.docx

CList控件使用方法1.docx

《CList控件使用方法1.docx》由会员分享，可在线阅读，更多相关《CList控件使用方法1.docx（17页珍藏版）》请在冰豆网上搜索。

CList控件使用方法1

列表控件可以看作是功能增强的ListBox，它提供了四种风格，而且可以同时显示一列的多中属性值。

MFC中使用CListCtrl类来封装列表控件的各种操作。

通过调用BOOLCreate（DWORDdwStyle,constRECT&rect,CWnd*pParentWnd,UINTnID）;创建一个窗口，dwStyle中可以使用以下一些列表控件的专用风格：

∙LVS_ICONLVS_SMALLICONLVS_LISTLVS_REPORT 这四种风格决定控件的外观，同时只可以选择其中一种，分别对应：

大图标显示，小图标显示，列表显示，详细报表显示

∙LVS_EDITLABELS 结点的显示字符可以被编辑，对于报表风格来讲可编辑的只为第一列。

∙LVS_SHOWSELALWAYS 在失去焦点时也显示当前选中的结点

∙LVS_SINGLESEL 同时只能选中列表中一项

首先你需要设置列表控件所使用的ImageList，如果你使用大图标显示风格，你就需要以如下形式调用：

CImageList*SetImageList（CImageList*pImageList,LVSIL_NORMAL）;如果使用其它三种风格显示而不想显示图标你可以不进行任何设置，否则需要以如下形式调用：

CImageList*SetImageList（CImageList*pImageList,LVSIL_SMALL）;

通过调用intInsertItem（intnItem,LPCTSTRlpszItem）;可以在列表控件中nItem指明位置插入一项，lpszItem为显示字符。

除LVS_REPORT风格外其他三种风格都只需要直接调用InsertItem就可以了，但如果使用报表风格就必须先设置列表控件中的列信息。

通过调用intInsertColumn（intnCol,LPCTSTRlpszColumnHeading,intnFormat,intnWidth,intnSubItem）;可以插入列。

iCol为列的位置，从零开始，lpszColumnHeading为显示的列名，nFormat为显示对齐方式，nWidth为显示宽度，nSubItem为分配给该列的列索引。

在有多列的列表控件中就需要为每一项指明其在每一列中的显示字符，通过调用BOOLSetItemText（intnItem,intnSubItem,LPTSTRlpszText）;可以设置每列的显示字符。

nItem为设置的项的位置，nSubItem为列位置，lpszText为显示字符。

下面的代码演示了如何设置多列并插入数据：

m_list.SetImageList（&m_listSmall,LVSIL_SMALL）;//设置ImageList

m_list.InsertColumn（0,"Col1",LVCFMT_LEFT,300,0）;//设置列

m_list.InsertColumn（1,"Col2",LVCFMT_LEFT,300,1）;

m_list.InsertColumn（2,"Col3",LVCFMT_LEFT,300,2）;

m_list.InsertItem（0,"Item1_1"）;//插入行

m_list.SetItemText（0,1,"Item1_2"）;//设置该行的不同列的显示字符

m_list.SetItemText（0,2,"Item1_3"）;

此外CListCtrl还提供了一些函数用于得到/修改控件的状态。

COLORREFGetTextColor（）/BOOLSetTextColor（COLORREFcr）;用于得到/设置显示的字符颜色。

COLORREFGetTextBkColor（）/BOOLSetTextBkColor（COLORREFcr）;用于得到/设置显示的背景颜色。

voidSetItemCount（intiCount）;用于得到添加进列表中项的数量。

BOOLDeleteItem（intnItem）;用于删除某一项，BOOLDeleteAllItems（）;将删除所有项。

BOOLSetBkImage（HBITMAPhbm,BOOLfTile,intxOffsetPercent,intyOffsetPercent）;用于设置背景位图。

CStringGetItemText（intnItem,intnSubItem）;用于得到某项的显示字符。

列表控件的消息映射同样使用ON_NOTIFY宏，形式如同：

ON_NOTIFY（wNotifyCode,id,memberFxn），wNotifyCode为通知代码，id为产生该消息的窗口ID，memberFxn为处理函数，函数的原型如同voidOnXXXList（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可以知道当前显示的为那一项。

下面的代码演示了这种方法：

charszOut[8][3]={"No.1","No.2","No.3"};

//添加结点

m_list.InsertItem（LPSTR_TEXTCALLBACK,...）

m_list.InsertItem（LPSTR_TEXTCALLBACK,...）

//处理消息

voidCParentWnd:

:

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

voidCParentWnd:

:

OnBeginEditList（NMHDR*pNMHDR,LRESULT*pResult）

{

LV_DISPINFO*pLVDI=（LV_DISPINFO*）pNMHDR;

if（pLVDI->item.iItem==0）;//判断是否取消该操作

*pResult=1;

else

*pResult=0;

}

//处理消息LVN_BEGINLABELEDIT

voidCParentWnd:

:

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）;得到选中项位置。

下面是一些例子

作者：

lixiaosan时间：

04/06/2006

以下未经说明，listctrl默认view风格为report

相关类及处理函数

MFC：

CListCtrl类

SDK：

以“ListView_”开头的一些宏。

如ListView_InsertColumn

1.CListCtrl风格

     LVS_ICON:

为每个item显示大图标     LVS_SMALLICON:

为每个item显示小图标     LVS_LIST:

显示一列带有小图标的item     LVS_REPORT:

显示item详细资料

     直观的理解：

windows资源管理器，“查看”标签下的“大图标，小图标，列表，详细资料”

2.设置listctrl风格及扩展风格

     LONGlStyle;     lStyle.=GetWindowLong（m_list.m_hWnd,GWL_STYLE）;//获取当前窗口style     lStyle.&=~LVS_TYPEMASK;//清除显示方式位     lStyle.|=LVS_REPORT;//设置style     SetWindowLong（m_list.m_hWnd,GWL_STYLE,lStyle）;//设置style     DWORDdwStyle.=m_list.GetExtendedStyle（）;     dwStyle.|=LVS_EX_FULLROWSELECT;//选中某行使整行高亮（只适用与report风格的listctrl）     dwStyle.|=LVS_EX_GRIDLINES;//网格线（只适用与report风格的listctrl）     dwStyle.|=LVS_EX_CHECKBOXES;//item前生成checkbox控件     m_list.SetExtendedStyle（dwStyle）;//设置扩展风格     注：

listview的style请查阅msdn      

3.插入数据

     m_list.InsertColumn（0,"ID",LVCFMT_LEFT,40）;//插入列     m_list.InsertColumn（1,"NAME",LVCFMT_LEFT,50）;     intnRow=m_list.InsertItem（0,“11”）;//插入行     m_list.SetItemText（nRow,1,“jacky”）;//设置数据

4.一直选中item

    选中style中的Showselectionalways，或者在上面第2点中设置LVS_SHOWSELALWAYS

5.选中和取消选中一行

   intnIndex=0;   //选中   m_list.SetItemState（nIndex,LVIS_SELECTED|LVIS_FOCUSED,LVIS_SELECTED|LVIS_FOCUSED）;   //取消选中   m_list.SetItemState（nIndex,0,LVIS_SELECTED|LVIS_FOCUSED）;

6.得到listctrl中所有行的checkbox的状态

     m_list.SetExtendedStyle（LVS_EX_CHECKBOXES）;     CStringstr;     for（inti=0;i

7.得到listctrl中所有选中行的序号

      方法一：

     CStringstr;     for（inti=0;i

     方法二：

     POSITIONpos=m_list.GetFirstSelectedItemPosition（）;     if（pos==NULL）          TRACE0（"Noitemswereselected!

/n"）;     else     {          while（pos）          {               intnItem=m_list.GetNextSelectedItem（pos）;               TRACE1（"Item%dwasselected!

/n",nItem）;               //youcoulddoyourownprocessingonnItemhere          }     }

8.得到item的信息

     TCHARszBuf[1024];     LVITEMlvi;     lvi.iItem=nItemIndex;     lvi.iSubItem=0;     lvi.mask=LVIF_TEXT;     lvi.pszText=szBuf;     lvi.cchTextMax=1024;     m_list.GetItem（&lvi）;

     关于得到设置item的状态，还可以参考msdn文章     Q173242:

UseMaskstoSet/GetItemStatesinCListCtrl               

9.得到listctrl的所有列的header字符串内容

     LVCOLUMNlvcol;     charstr[256];     int  nColNum;     CStringstrColumnName[4];//假如有4列

     nColNum=0;     lvcol.mask=LVCF_TEXT;     lvcol.pszText=str;     lvcol.cchTextMax=256;     while（m_list.GetColumn（nColNum,&lvcol））     {          strColumnName[nColNum]=lvcol.pszText;          nColNum++;     }

10.使listctrl中一项可见，即滚动滚动条

   m_list.EnsureVisible（i,FALSE）;

11.得到listctrl列数

   intnHeadNum=m_list.GetHeaderCtrl（）->GetItemCount（）;

12.删除所有列

   方法一：

       while（m_list.DeleteColumn（0））     因为你删除了第一列后，后面的列会依次向上移动。

   方法二：

     intnColumns=4;     for（inti=nColumns-1;i>=0;i--）        m_list.DeleteColumn（i）;

13.得到单击的listctrl的行列号

     添加listctrl控件的NM_CLICK消息相应函数     voidCTest6Dlg:

:

OnClickList1（NMHDR*pNMHDR,LRESULT*pResult）     {          //方法一：

          /*          DWORDdwPos=GetMessagePos（）;          CPointpoint（LOWORD（dwPos）,HIWORD（dwPos））;            m_list.ScreenToClient（&point）;            LVHITTESTINFOlvinfo;          lvinfo.pt=point;          lvinfo.flags=LVHT_ABOVE;              intnItem=m_list.SubItemHitTest（&lvinfo）;          if（nItem!

=-1）          {               CStringstrtemp;               strtemp.Format（"单击的是第%d行第%d列",lvinfo.iItem,lvinfo.iSubItem）;               AfxMessageBox（strtemp）;          }         */           //方法二:

         /*          NM_LISTVIEW*pNMListView=（NM_LISTVIEW*）pNMHDR;          if（pNMListView->iItem!

=-1）          {               CStringstrtemp;               strtemp.Format（"单击的是第%d行第%d列",                               pNMListView->iItem,pNMListView->iSubItem）;               AfxMessageBox（strtemp）;          }         */          *pResult=0;     }

14.判断是否点击在listctrl的checkbox上

     添加listctrl控件的NM_CLICK消息相应函数     voidCTest6Dlg:

:

OnClickList1（NMHDR*pNMHDR,LRESULT*pResult）     {          DWORDdwPos=GetMessagePos（）;          CPointpoint（LOWORD（dwPos）,HIWORD（dwPos））;            m_list.ScreenToClient（&point）;            LVHITTESTINFOlvinfo;          lvinfo.pt=point;          lvinfo.flags=LVHT_ABOVE;              UINTnFlag;          intnItem=m_list.HitTest（point,&nFlag）;          //判断是否点在checkbox上          if（nFlag==LVHT_ONITEMSTATEICON）          {               AfxMessageBox（"点在listctrl的checkbox上"）;          }          *pResult=0;     }

15.右键点击listctrl的item弹出菜单

     添加listctrl控件的NM_RCLICK消息相应函数     voidCTest6Dlg:

:

OnRclickList1（NMHDR*pNMHDR,LRESULT*pResult）     {          NM_LISTVIEW*pNMListView=（NM_LISTVIEW*）pNMHDR;          if（pNMListView->iItem!

=-1）          {               DWORDdwPos=GetMessagePos（）;               CPointpoint（LOWORD（dwPos）,HIWORD（dwPos））;                  CMenumenu;               VERIFY（menu.LoadMenu（IDR_MENU1））;               CMenu*popup=menu.GetSubMenu（0）;               ASSERT（popup!

=NULL）;               popup->TrackPopupMenu（TPM_LEFTALIGN|TPM_RIGHTBUTTON,point.x,point.y,