CListCtrl用法总结(二)

来源:互联网 发布:360下载不了软件 编辑:程序博客网 时间:2024/06/05 11:50
网站来源:http://blog.csdn.net/lhy2199/article/details/5177032

CListCtrl类封装“列表视图控件”功能,显示每个包含图标(列表视图中)和标签的收集。除图标和标签外,每一项还能有显示在图标和标签的右边的列中的信息。此控件(以及CListCtrl类)只适用于运行于Windows 95和Windows NT 3.51及更高版本的程序。
下面是CListCtrl类的主要概况。对于详细的、概念性的讨论,请参阅联机文档“Visual C++程序员指南”中的“使用ClistCtrl”和“控件主题”。

视图
列表视图控件可用四种不同方式显示其内容,称为“视图”。·图标视图
每一项以全尺寸图标(32×32像素)出现,下面有一个标签。用户可在列表视图窗口拖动项到任意位置。·小图标
视图每一项以小图标(16×16像素)出现,右边有一个标签。用户可在列表视图窗口拖动项到任意位置。·列表视图
每一项以小图标出现,下面有一个标签。项按列排列,不能拖动到列表视图窗口的任何位置。·报表视图
每一项在本行上出现,右边有排列成列的附加信息。最左边的列包含小图标和标签,下一列包含应用指定的子项。嵌入标题控件实现这些列。要了解报表视图标题控件和列的更多信息,请参阅联机文档“Visual C++程序员指南”中的“使用CListCtrl:给控件添加列(报表视图)”。控件的当前列表视图风格指定当前视图。要了解这些风格及其用法的更多信息,请参阅联机文档“Visual C++程序员指南”中的“使用CListCtrl:改变列表控件风格”。

扩展风格
除了标准列表风格,类CListCtrl支持一系列提供丰富功能的扩展风格。此功能的一些示例包括:·逗留选择
有效时,若光标保持在某项上一段时间,则允许自动选择该项。·虚列表视图
如果有效,允许控件支持DWORD项。通过把管理应用项数据放在最顶上而成为可能。除了项选择和焦点信息,所有项信息必须由应用管理。要了解更多信息,请参阅联机文档“Visual C++程序员指南”中的“使用CListCtrl:虚列表控件”。·单击或双击激活
如果有效,允许热跟踪(项文本自动高亮显示)和高亮显示项的单击和双击激活。·拖放列表命令
如果有效,允许拖放列表视图控件中列的记录。只对报表视图有效。要了解使用新扩展风格的更多信息,请参阅联机文档“Visual C++程序员指南”中的“使用CListCtrl:改变列表控件风格”。

项和子项
列表视图控件中的每一项含有一个图标、一个标签、一个当前状态和应用定义值(称为“项数据”)。一个或更多子项还可与每一项联系。一个“子项”是一个字符串,在报表视图中可显示在项图标和标签右边的列里。列表视图控件中的每一项都必须与子项数目相同。
类CListCtrl提供一些函数来插入、删除、查找和更改这些项。要了解更多信息,请参阅“Visual C++程序员指南”中的“使用CListCtrl:列表控件中的滚动、排列、排序和查找”。同时请参阅CListCtrl::GetItem,CListCtrl::InsertItem和CListCtrl::FindItem。
缺省时,列表视图控件负责存储一个项的图标和文本属性。然而,除了这些项类型外,类CListCtrl支持“回调项”。一个“回调项”是一个列表视图项,每个应用棗而不是控件棗存储文本,图标或两者。回调掩码用于指定哪个项的属性(文本和/或图标)由应用提供。如果应用使用回调项,它必须可以提供按需要提供文本和/或图标属性。回调项在你的应用已有部分这种信息时很有帮助。要了解更多信息,请参阅CListCtrl::GetCallBackMask和“使用CListCtrl:回调项和回调掩码”。

图象列表
图标、标题项图象和应用定义的列表视图项状态包含在一些图象列表中(由类CImageList实现),可创建和指派到列表视图控件中。每个列表视图控件可有四个以上的图象列表类型:·大图标
在图标视图中使用,得到全尺寸图标。·小图标
用于小图标、列表和报表视图中,得到图标视图中使用的小版本的图标。·应用定义的状态
包含状态图象,在项图标旁显示以指示一个应用定义状态。·标题项
用于在报表视图中,得到出现在每个标题控件项中的小图象。缺省时,列表视图控件删除指派给它的图象列表(当它删除时);然而,开发者可通过删除由应用定义的不再使用的图象列表。要了解更多信息,请参阅联机文档“Visual C++程序员指南”中的“使用CListCtrl:列表项和图象列表”。
#include <afxcmn.h>

请参阅:CImageList


CListCtrl类的成员

构造函数ClistCtrl构造一个CListCtrl对象Create创建列表控件并将其附加给CListCtrl对象
属性GetBkColor获取列表视图控件的背景色SetBkColor设置列表视图控件的背景色GetImageList获取用于绘制列表视图项的图象列表的句柄SetImageList指定一个图象列表到列表视图控件GetItemCount获取列表视图控件中的项的数量GetItem获取列表视图项的属性GetCallbackMask获取列表视图控件的回调掩码SetCallbackMask设置列表视图控件的回调掩码GetNextItem查找指定特性和指定指定项关系的列表视图项GetFirstSeletedItemPosition在列表视图控件中获取第一个选择的列表视图项的位置GetNextSeletedItem为重复而获取下一个选择的列表视图GetItemRect获取项的有界矩形SetItemPosition在列表视图控件中移动一项到指定位置GetItemPosition获取列表视图项的位置GetStringWidth指定需要显示所有指定字符串的最小列宽GetEditControl获取用于编辑一个项文本的编辑控件的句柄GetColumn获取控件的列的属性SetColumn设置列表视图列的属性GetColumnWidth获取报表视图或列表视图中的列的宽度SetColumnWidth改变报表视图或列表视图中的列的宽度GetCheck获取与某项相关的状态图象的当前显示状态SetCheck设置与某项相关的状态图象的当前显示状态GetViewRect获取列表视图控件中所有项的有界矩形GetTextColor获取列表视图控件的文本颜色SetTextColor设置列表视图控件的文本颜色GetTextBkColor获取列表视图控件的文本背景色SetTextBkColor设置列表视图控件的文本背景色GetTopIndex获取最高级项的索引GetCountPerPage计算可正好垂直放入列表视图控件中的项的数目GetOrigin获取列表视图控件的最初的当前视图SetItemState改变列表视图控件的项的状态GetItemState获取列表视图控件的项的状态GetItemText获取列表视图项或子项的文本SetItemText设置列表视图项或子项的文本SetItemCount准备一个列表视图控件以添加大量的项GetItemData获取与某项相关的应用所指定的值SetItemData设置项的应用指定的值GetSelectedCount获取列表视图控件中选择项的数量SetColumnOrderArray设置列表视图控件的列序(左或右)GetColumnOrderArray获取列表视图控件的列序(左或右)SetIconSpacing设置列表视图控件中的图标的距离GetHeaderCtrl获取列表视图控件的标题控件GetHotCursor获取在热调试对列表视图控件有效时使用的游标SetHotCursor设置在热调试对列表视图控件有效时使用的游标GetSubItemRect获取列表视图控件中某项的有界矩形GetHotItem获取当前在游标下的列表视图项SetHotItem设置列表视图控件的当前热项GetSelectionMark获取列表视图控件的选择屏蔽SetSelectionMark设置列表视图控件的选择屏蔽GetExtendedStyle获取列表视图控件的当前扩展风格SetExtendedStyle设置列表视图控件的当前扩展风格SubItemHitTest指定哪个列表视图项在指定位置,若存在GetWorkAreas获取列表视图控件的当前工作区GetNumberOfWorkAreas获取列表视图控件的当前工作区数量SetItemCountEx设置虚列表视图控件的项的数量SetWorkAreas设置列表视图控件中图标可以显示的区域ApproximateViewRect指定显示列表视图控件项所需的宽度和高度GetBkImage获取列表视图控件的当前背景图象SetBkImage设置列表视图控件的当前背景图象GetHoverTime获取列表视图控件的当前逗留时间SetHoverTime设置列表视图控件的当前逗留时间
操作InsertItem在列表视图控件中插入一个新项DeleteItem从控件中删除一项DeleteAllItems从控件中删除所有项FindItem查找具有指定的字符的列表视图项SortItems使用应用定义的比较函数排序列表视图项HitTest指定哪个列表视图在指定的位置上EnsureVisible保证项是可见的Scroll滚动列表视图控件的内容ReDrawItems强迫列表视图控件刷新一些项Update强迫控件刷新一个指定的项Arrange调整一栏里的项EditLabel开始项文本该处编辑InsertColumn插入列表视图控件中的新列DeleteColumn从列表视图控件中删除一列CreateDragImage为指定的项构造一个拖动图象列表

 

1.     基本风格设置

(1)函数: ModifyStyle( )
(2)重要参数:    LVS_ICON // 大图标
      LVS_SMALLICON // 小图标
      LVS_LIST // 列表
      LVS_REPORT // 报表
(3)说明:
用的比较多的是最后的报表视图.因为它可以有多列,正好代表数据库中的多个属性.所以下面的用法都是针对这种风格的.当然这些风格也可以在控件的属性中设置
(4) 注意
我们知道在窗口各种各样的风格之间,有时是可以用” |”,表示属性叠加.如:
    WS_CHILD | WS_VISIBLE;
但是上面的四种风格是不可能放在一起的.所以不要用到 “ |”操作符.
也正是因此,防止用户出错, 微软干脆把LVS_ICON, LVS_SMALLICON, LVS_LIST, LVS_REPORT这些都不设置成位标志,因此不能叠加.同时还设置了一个多余的掩码:
LVS_TYPEMASK.它是用来屏蔽的.

(5) 举例:
如果我们要判断一个CListCtrl的风格: 
   DWORD dwStyle = m_listctrl.GetStyle( );
// 判断是否大图标样式
   If ( dwStyle & LVS_ICON )
     …….
这种写法是错误的.正确的写法涉及到掩码:
    DWORD dwStyle = m_listctrl.GetStyle( ) & LVS_TYPEMASK;
    If ( dwStyle = = LVS_ICON)
    …….
同理,我们在改变风格时,应该这样写:
    ModifyStyle( LVS_TYPEMASK, LVS_ICON);

2.     扩展风格设置
(1) 函数 : SetExtendedStyle( )   GetExtendedStyle ( )
(2) 重要参数:
   LVS_EX_FULLROWSELECT //选中某行使整行高亮(只适用与报表风格)
   LVS_EX_GRIDLINES //网格线(只适用与报表风格)
   LVS_EX_CHECKBOXES //设置checkbox状态
(3)举例
    DWORD dwStyle = GetExtendedStyle();
              dwStyle |= LVS_EX_FULLROWSELECT; 
              dwStyle |= LVS_EX_GRIDLINES;
              SetExtendedStyle(dwStyle);

3.其他风格设置:
函数: SetTextColor ( ) // 设置文字颜色 
SetBkColor ( ) // 设置边框颜色
SetTextBkColor ( ) // 设置文字背景颜色

//下面直接举例说明

4.图标设置 
可以给大图标风格和小图标风格设置图标:
HICON icon=AfxGetApp()->LoadIcon(IDI_ICON1);
m_icon.Add(icon);
m_listctrl.SetImageList(&m_icon,LVSIL_SMALL);//小图标
m_listctrl.SetImageList(&m_icon,LVSIL_NORMAL)// 大图标

5插入一列
m_listctrl.InsertColumn(0,”哈哈”,LVCFMT_LEFT,80);
其中: 0是索引项,”哈哈”是列标题,LVCFMT_LEFT是显示方式(靠左),80表示列的宽


6插入一行
m_listctrl.InsertItem(0, “123”,0);// 插入为第一行第一列的内容,最后一个0是图标的索引
m_listctrl.SetItemText( 0,1, “123”) ; // 设置第一行第2列的内容
m_ listctrl.SetItemText(0,2, “123”) ; // 设置第一行第3列的内容

7得到所有的行数
m_listctrl.GetItemCount( ) ;

8.得到所有的列数
m_listctrl.GetHeaderCtrl().GetItemCount( ) ;

9.得到被单击的项的行列号
void Cmylist::OnClick(NMHDR* pNMHDR, LRESULT* pResult) //单击消息
{

NM_LISTVIEW *info=(NM_LISTVIEW*)pNMHDR;
   selectedIndex=info->iItem; // 行号
selectedsub=info->iSubItem; // 列号
}     
(Cmylist为CListCtrl的派生类,以selectedIndex和selectedsub为接口,方便使用)        

10.得到被单击的列头索引号
void Cmylist::OnColumnclick(NMHDR* pNMHDR, LRESULT* pResult) 
{
NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
        selectedField=pNMListView->iSubItem;//列头号
}
同上,也是以selectedField为接口,方便用户调用

11.选中或者取消一行
plistctrl->SetItemState(index,LVIS_SELECTED,LVIS_SELECTED);//选中一行
plistctrl->SetItemState(index,0,LVIS_SELECTED);//取消一行
DWORD style=plistctrl->GetItemState(index,LVIS_SELECTED);//获得选中信息

12.获得被选中的多行
   POSITION p=m_listctrl.GetFirstSelectedItemPosition();// 得到第一次选中的位置
   while(p)
   {
    int index=m_listctrl.GetNextSelectedItem(p);
    …
   }

13.删除一行或者一列
m_listctrl.DeleteItem( index );
m_listctrl.DeleteColumn(index);

14.删除多行或者多列
注意要从后面开始删起,比如,如果我想删除第一行和第二行,应该:
   m_listctrl.DeleteItem(1);
   m_listctrl.DeleteItem(0);
而不能:
   m_listctrl.DeleteItem(0);
m_listctrl.DeleteItem(1);
因为每次删除一行或者一列,后面的索引号都要变化,所以从后面开始删除就没关系. 
如果用for循环,应该递减:
For(int k=m_listctrl.GetItemCount( )-1;k>=0;k--)
   m_listctrl.DeleteItem(k);
这就是删除所有行,当然也可以用CListCtrl::DeleteAllItems


15 根据索引号得到某一列的信息
    HDITEM   hdi;   
    TCHAR     lpBuffer[256];     
    hdi.mask   =   HDI_TEXT;   
    hdi.pszText   =   lpBuffer;   
    hdi.cchTextMax   =   256;   
    plistctrl->GetHeaderCtrl()->GetItem(index,   &hdi);
    CString str=hdi.pszText;

 

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

      添加listctrl控件的NM_CLICK消息相应函数
      void CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)
      {
           // 方法一:
           /*
           DWORD dwPos = GetMessagePos();
           CPoint point( LOWORD(dwPos), HIWORD(dwPos) );
   
           m_list.ScreenToClient(&point);
   
           LVHITTESTINFO lvinfo;
           lvinfo.pt = point;
           lvinfo.flags = LVHT_ABOVE;
     
           int nItem = m_list.SubItemHitTest(&lvinfo);
           if(nItem != -1)
           {
                CString strtemp;
                strtemp.Format("单击的是第%d行第%d列", lvinfo.iItem, lvinfo.iSubItem);
                AfxMessageBox(strtemp);
           }
          */
   
          // 方法二:
          /*
           NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
           if(pNMListView->iItem != -1)
           {
                CString strtemp;
                strtemp.Format("单击的是第%d行第%d列",
                                pNMListView->iItem, pNMListView->iSubItem);
                AfxMessageBox(strtemp);
           }
          */
           *pResult = 0;
      }

 


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

      添加listctrl控件的NM_CLICK消息相应函数
      void CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)
      {
           DWORD dwPos = GetMessagePos();
           CPoint point( LOWORD(dwPos), HIWORD(dwPos) );
   
           m_list.ScreenToClient(&point);
   
           LVHITTESTINFO lvinfo;
           lvinfo.pt = point;
           lvinfo.flags = LVHT_ABOVE;
     
           UINT nFlag;
           int nItem = m_list.HitTest(point, &nFlag);
           //判断是否点在checkbox上
           if(nFlag == LVHT_ONITEMSTATEICON)
           {
                AfxMessageBox("点在listctrl的checkbox上");
           } 
           *pResult = 0;
      }

 


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

      添加listctrl控件的NM_RCLICK消息相应函数
      void CTest6Dlg::OnRclickList1(NMHDR* pNMHDR, LRESULT* pResult)
      {
           NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
           if(pNMListView->iItem != -1)
           {
                DWORD dwPos = GetMessagePos();
                CPoint point( LOWORD(dwPos), HIWORD(dwPos) );
    
                CMenu menu;
                VERIFY( menu.LoadMenu( IDR_MENU1 ) );
                CMenu* popup = menu.GetSubMenu(0);
                ASSERT( popup != NULL );
                popup->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON, point.x, point.y, this );
           } 
           *pResult = 0;
}

 

 


16. item切换焦点时(包括用键盘和鼠标切换item时),状态的一些变化顺序

      添加listctrl控件的LVN_ITEMCHANGED消息相应函数
      void CTest6Dlg::OnItemchangedList1(NMHDR* pNMHDR, LRESULT* pResult)
      {
           NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
           // TODO: Add your control notification handler code here
    
           CString sTemp;

           if((pNMListView->uOldState & LVIS_FOCUSED) == LVIS_FOCUSED && 
            (pNMListView->uNewState & LVIS_FOCUSED) == 0)
           {
                sTemp.Format("%d losted focus",pNMListView->iItem);
           }
           else if((pNMListView->uOldState & LVIS_FOCUSED) == 0 &&
               (pNMListView->uNewState & LVIS_FOCUSED) == LVIS_FOCUSED)
           {
                sTemp.Format("%d got focus",pNMListView->iItem);
           } 

           if((pNMListView->uOldState & LVIS_SELECTED) == LVIS_SELECTED &&
            (pNMListView->uNewState & LVIS_SELECTED) == 0)
           {
                sTemp.Format("%d losted selected",pNMListView->iItem);
           }
           else if((pNMListView->uOldState & LVIS_SELECTED) == 0 &&
            (pNMListView->uNewState & LVIS_SELECTED) == LVIS_SELECTED)
           {
                sTemp.Format("%d got selected",pNMListView->iItem);
           }
    
           *pResult = 0;
      }



 


17. 得到另一个进程里的listctrl控件的item内容

http://www.codeproject.com/threads/int64_memsteal.asp



18. 选中listview中的item

Q131284: How To Select a Listview Item Programmatically
http://support.microsoft.com/kb/131284/en-us



19. 如何在CListView中使用CListCtrl的派生类

http://www.codeguru.com/cpp/controls/listview/introduction/article.php/c919/



20. listctrl的subitem添加图标

      m_list.SetExtendedStyle(LVS_EX_SUBITEMIMAGES);
      m_list.SetItem(..); //具体参数请参考msdn

 


21. 在CListCtrl显示文件,并根据文件类型来显示图标

      网上找到的代码,share
      BOOL CTest6Dlg::OnInitDialog()
      {
           CDialog::OnInitDialog();
   
           HIMAGELIST himlSmall;
           HIMAGELIST himlLarge;
           SHFILEINFO sfi;
           char cSysDir[MAX_PATH];
           CString strBuf;

           memset(cSysDir, 0, MAX_PATH);
   
           GetWindowsDirectory(cSysDir, MAX_PATH);
           strBuf = cSysDir;
           sprintf(cSysDir, "%s", strBuf.Left(strBuf.Find("//")+1));

           himlSmall = (HIMAGELIST)SHGetFileInfo ((LPCSTR)cSysDir, 
                      0, 
                      &sfi, 
                      sizeof(SHFILEINFO), 
                      SHGFI_SYSICONINDEX | SHGFI_SMALLICON );
   
           himlLarge = (HIMAGELIST)SHGetFileInfo((LPCSTR)cSysDir, 
                      0, 
                      &sfi, 
                      sizeof(SHFILEINFO), 
                      SHGFI_SYSICONINDEX | SHGFI_LARGEICON);
   
           if (himlSmall && himlLarge)
           {
                ::SendMessage(m_list.m_hWnd, LVM_SETIMAGELIST,
                             (WPARAM)LVSIL_SMALL, (LPARAM)himlSmall);
                ::SendMessage(m_list.m_hWnd, LVM_SETIMAGELIST,
                             (WPARAM)LVSIL_NORMAL, (LPARAM)himlLarge);
           }
           return TRUE; // return TRUE unless you set the focus to a control
      }

      void CTest6Dlg::AddFiles(LPCTSTR lpszFileName, BOOL bAddToDocument)
      {
           int nIcon = GetIconIndex(lpszFileName, FALSE, FALSE);
           CString strSize;
           CFileFind filefind;

           // get file size
           if (filefind.FindFile(lpszFileName))
           {
                filefind.FindNextFile();
                strSize.Format("%d", filefind.GetLength());
           }
           else
                strSize = "0";
   
           // split path and filename
           CString strFileName = lpszFileName;
           CString strPath;

           int nPos = strFileName.ReverseFind('//');
           if (nPos != -1)
           {
                strPath = strFileName.Left(nPos);
                strFileName = strFileName.Mid(nPos + 1);
           }
   
           // insert to list
           int nItem = m_list.GetItemCount();
           m_list.InsertItem(nItem, strFileName, nIcon);
           m_list.SetItemText(nItem, 1, strSize);
           m_list.SetItemText(nItem, 2, strFileName.Right(3));
           m_list.SetItemText(nItem, 3, strPath);
      }

      int CTest6Dlg::GetIconIndex(LPCTSTR lpszPath, BOOL bIsDir, BOOL bSelected)
      {
           SHFILEINFO sfi;
           memset(&sfi, 0, sizeof(sfi));
   
           if (bIsDir)
           {
            SHGetFileInfo(lpszPath, 
                         FILE_ATTRIBUTE_DIRECTORY, 
                         &sfi, 
                         sizeof(sfi), 
                         SHGFI_SMALLICON | SHGFI_SYSICONINDEX |
                         SHGFI_USEFILEATTRIBUTES |(bSelected ? SHGFI_OPENICON : 0)); 
            return sfi.iIcon;
           }
           else
           {
            SHGetFileInfo (lpszPath, 
                         FILE_ATTRIBUTE_NORMAL, 
                         &sfi, 
                         sizeof(sfi), 
                         SHGFI_SMALLICON | SHGFI_SYSICONINDEX | 
                         SHGFI_USEFILEATTRIBUTES | (bSelected ? SHGFI_OPENICON : 0));
            return   sfi.iIcon;
           }
           return -1;
      }

0 0
原创粉丝点击