CListCtrl

来源：互联网发布：linux操作系统u盘安装编辑：程序博客网时间：2024/05/22 14:18

VC/MFC之ListCtrl控件使用经验总结(转)

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

1. CListCtrl 风格

      LVS_ICON: 为每个item显示大图标
      LVS_SMALLICON: 为每个item显示小图标
      LVS_LIST: 显示一列带有小图标的item
      LVS_REPORT: 显示item详细资料

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

--------------------------------------------------------------------------------

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

      LONG lStyle;
      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

      DWORD dwStyle = 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
      http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wceshellui5/html/wce50lrflistviewstyles.asp

--------------------------------------------------------------------------------

3. 插入数据

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

InsertItem, SetItemText, SetItem, SetItemData

int InsertItem( const LVITEM* pItem );
int InsertItem( int nItem, LPCTSTR lpszItem );
int InsertItem( int nItem, LPCTSTR lpszItem, int nImage );
int InsertItem( UINT nMask, int nItem, LPCTSTR lpszItem, UINT nState, UINT nStateMask, int nImage, LPARAM lParam ); 一般我们用的比较多的时第2种和第三种,其中第三种时建立一个带有头标的项，要调用第三个,可以先声明一个CImageList对象

BOOL SetItemText( int nItem, int nSubItem, LPTSTR lpszText ); 注意这个函数中的参数nItem就是INSERTITEM中的NITEM,

BOOL SetItem(int nItem, int nSubItem, UINT nMask, LPCTSTR lpszItem, int nImage, UINT nState, UINT nStateMask, LPARAM lParam) 返回值：如果成功，则返回非零值，否则为0。参数： nItem 要设定属性的项的索引值。 nSubItem 要设定属性的子项的索引值。 nMask 指定设定哪种属性（请参阅说明）（1）LVIF_TEXT 必须填充 pszText（2）LVIF_IMAGE 必须填充 iImage （3）LVIF_INDENT 必须填充 iIndent（4）LVIF_PARAM 必须填充 lParam（非0列使用LVIF_PARAM参数，设置失败）（5）LVIF_STATE 必须填充 state 。lpszItem 指定了项标签的以空字符为终止符的字符串的地址。只有指定LVIF_TEXT属性时，设置才有效。nImage 图象列表内项图象的索引值，应用此参数要先设置SetImageList来设置图标链表 nState 为要修改的状态指定值（请参阅说明）。 nStateMask 指定要修改为那种状态（请参阅说明）。 nImage 图象列表之内项的图象的索引。 lParam 与项相关联的应用指定的32位值。

SetItemData: SetItemData可以为每一行绑定一个DWORD类型的变量。用GetItemData可以获得这个变量。举个例子，假设CListCtrl中你需要显示某个数据表中的记录，该表有个流水号主键ID，一般这个ID值本身没有什么意义，用户也不需要看，因此在CListCtrl的可见列中，你不需要显示。但往往做具体查询等操作时，你又需要用这个ID来完成。这时，用SetItemData将其绑定到每一行，将非常方便，用户操作哪一行，则用GetItemData可以得到对应记录的ID，直接用来做操作，很爽。
由于绑定的是DWORD类型，因此还有一个扩展作用是绑定一个指针对象。比如这里我不再是一个ID主键了，而是需要关联一个数据结构，那么就可以把该数据结构对象的指针进行SetItemData绑定。这么做，可以省去再到一堆的数据结构数组中去查找的过程。

--------------------------------------------------------------------------------

4. 一直选中item

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

--------------------------------------------------------------------------------

5. 选中和取消选中一行

    int nIndex = 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);
      CString str;
      for(int i=0; i<m_list.GetItemCount(); i++)
      {
           if( m_list.GetItemState(i, LVIS_SELECTED) == LVIS_SELECTED || m_list.GetCheck(i))
           {
                str.Format(_T("第%d行的checkbox为选中状态"), i);
                AfxMessageBox(str);
           }
      }

--------------------------------------------------------------------------------

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

      方法一：
      CString str;
      for(int i=0; i<m_list.GetItemCount(); i++)
      {
           if( m_list.GetItemState(i, LVIS_SELECTED) == LVIS_SELECTED )
           {
                str.Format(_T("选中了第%d行"), i);
                AfxMessageBox(str);
           }
      }

      方法二：
      POSITION pos = m_list.GetFirstSelectedItemPosition();
      if (pos == NULL)
           TRACE0("No items were selected!\n");
      else
      {
           while (pos)
           {
                int nItem = m_list.GetNextSelectedItem(pos);
                TRACE1("Item %d was selected!\n", nItem);
                // you could do your own processing on nItem here
           }
      }

--------------------------------------------------------------------------------

8. 得到item的信息

      TCHAR szBuf[1024];
      LVITEM lvi;
      lvi.iItem = nItemIndex;
      lvi.iSubItem = 0;
      lvi.mask = LVIF_TEXT;
      lvi.pszText = szBuf;
      lvi.cchTextMax = 1024;
      m_list.GetItem(&lvi);

      关于得到设置item的状态，还可以参考msdn文章
      Q173242: Use Masks to Set/Get Item States in CListCtrl
      http://support.microsoft.com/kb/173242/en-us

得到行的rect
BOOL GetItemRect(
int nItem,
LPRECT lpRect,
UINT nCode
) const;
nItem位置要检索项的索引。
lpRect接收边框 RECT 结构的地址。
nCode列表视图项的节中检索边框。它可以是以下值之一：LVIR_BOUNDS 返回整个项目的边框，包括该图标和标签。LVIR_ICON 返回图标或小图标的边框。LVIR_LABEL 返回项文本的边框。

得到单元格的rect
BOOL GetSubItemRect(
int iItem,
int iSubItem,
int nArea,
CRect& ref
);
iItem子项的父项的索引。
iSubItem子项的从一开始的索引。
nArea确定(列表视图子项)要检索的边框的部分。部分(图标，标签或两者)的边框由一个或多个将或位运算符指定下列值:LVIR_BOUNDS 返回整个项目的边框，包括该图标和标签。LVIR_ICON 返回图标或小图标的边框。LVIR_LABEL 返回整个项目的边框，包括该图标和标签。这与 LVIR_BOUNDS相同。
ref对 CRect 包含子项的边框坐标的对象。

调用CListCtrl::GetSubItemRect()获取subItem==0项的rect时出了问题，我用TRACE打印数据发现left和right的数值是不正确的，似乎获取到的是整个list控件的大小，后来查了一下MSDN，里面写着：
iSubItem The one-based index of the subitem.
BOOL GetSubItemRect( int nItem, int nSubItem, int nArea, CRect& rect )
{
ASSERT(nItem >= 0);
ASSERT(nItem < GetItemCount());
if ((nItem < 0) || nItem >= GetItemCount())
return FALSE;
ASSERT(nSubItem >= 0);
ASSERT(nSubItem < GetHeaderCtrl()->GetItemCount());
if ((nSubItem < 0) || nSubItem >= GetHeaderCtrl()->GetItemCount())
return FALSE;

BOOL bRC = CListCtrl::GetSubItemRect(nItem, nSubItem, nArea, rect);

if (nSubItem == 0)
{
int offset = rect.left;

CRect firstColumnRect;
GetHeaderCtrl()->GetItemRect(0, &firstColumnRect);
rect.left = firstColumnRect.left + offset;
rect.right = firstColumnRect.right + offset;
}

return bRC;
}

--------------------------------------------------------------------------------

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

      LVCOLUMN lvcol;
      char str[256];
      int   nColNum;
      CString strColumnName[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列数

int nHeadNum = m_list.GetHeaderCtrl()->GetItemCount();

--------------------------------------------------------------------------------

12. 删除所有列

      方法一：
         while ( m_list.DeleteColumn (0))
       因为你删除了第一列后，后面的列会依次向上移动。

      方法二：
      int nColumns = 4;
      for (int i=nColumns-1; i>=0; i--)
          m_list.DeleteColumn (i);

--------------------------------------------------------------------------------

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

      添加listctrl控件的NM_CLICK消息相应函数
      void CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)
      {
           // 方法一：


          // 方法二:

           *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时)，状态的一些变化顺序,响应LVN_ITEMCHANGED消息

      添加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
--------------------------------------------------------------------------------

在ListCttrl控件（Report风格）的使用上，有时需要向子列中插入图标，例如要制作一个下载软件，我们计划在控件的第一列用图标的形式显示下载状态：排队、下载中、出错等等，第二列计划用图标显示下载文件类型，要做出这样的效果，就必须使用CListCtrl的SetItem(八个参数)方法，由于我这台电脑上没有MSDN所以这八个参数具体都是什么意思我暂时不清楚，在这只介绍下跟我们的操作关系密切的几个参数。

SetItem（）从左向右数第一个参数（从1起计数）表示操作行的行号，这个行号从0计数，最好这个参数设置为InsertItem（）的返回值，也就是说应该先用InsertItem（）插入一个空行，之后用SetItemText（）具体设置插入行每一列的值。SetItem（）的第二个参数表示即将操作的列号，也就是我们打算将图标插入到第几列中，该行号从0计数。SetItem（）的第五个参数表示图标在CImageList对象（该对象已经通过SetImageList(&ImageList, LVSIL_SMALL)附属至CListCtrl控件）中的序数，该序数从0计数，顺便说一句，准备附属到CListCtrl控件的CImageList对象必须是全局性的，比如可以是类的成员，否则就算其他操作都都正确也看不到图标。

举个例子我们使用的CListCtrl控件的控制对象为m_List，m_List中已经添加了三个列，IDX是InsertItem（）的返回值，表示刚刚插入的新行，附属到m_List的CImageList对象中有5个图标，我们通过m_List.SetItem(IDX, 0, LVIF_IMAGE, NULL, 1, 0, 0, 0);之后，就把CImageList对象中的第1个图标插在了第一列的前部（原先第一列的文字还在），之后接着通过m_List.SetItem(IDX, 2, LVIF_IMAGE, NULL, 0, 0, 0, 0);就把CImageList对象中的第0个图标插在了第二列的前部（原先的文字还在）。可以看到如下实例图：

有一点值得说明，如果只在子列中插入了图标而没有给主列（第一列）插入任何图标，则默认第一列将插入与同一行最后一次给子列插入图标。还有重要的一点，如果想在子列插入图标，首先必须使ListCtrl控件具备LVS_EX_SUBITEMIMAGES风格，例如我们可以通过m_List.SetExtendedStyle(m_List.GetExtendedStyle()|LVS_EX_SUBITEMIMAGES);给控件附加该风格。
注意事项：如果插入后没有显示或者是显示的不是预想的图标很有可能是图片的属性和 CImageList创建的时候不相符合比如 m_imglist.Create(66, 16, ILC_COLORDDB,0,0); 如果你插入的BMP不是66X16大小很有可能就会插入失败而且这里是可能失败这样就造成了不会报错但是图标显示的结果有可能和想要的不通至于哪些图标可以显示哪些不能显示这个就不容易看出来而且如果第一张插入失败了第二张插入成功在显示图标的时候第二张就变成第一张了比较隐含的错误一定注意！

如果CImageList的内容改变，行对应CImageList的序号保持不变，如果CListctrl不重绘，图标不会发生变化。

--------------------------------------------------------------------------------

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;
      }

--------------------------------------------------------------------------------

22. listctrl内容进行大数据量更新时，避免闪烁

      m_list.SetRedraw(FALSE);
      //更新内容
      m_list.SetRedraw(TRUE);
      m_list.Invalidate();
      m_list.UpdateWindow();
或者参考
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_mfc_cwnd.3a3a.setredraw.asp

--------------------------------------------------------------------------------

列表控件可以看作是功能增强的ListBox，它提供了四种风格，而且可以同时显示一列的多中属性值。MFC中使用CListCtrl类来封装列表控件的各种操作。通过调用 BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );创建一个窗口，dwStyle中可以使用以下一些列表控件的专用风格：

LVS_ICON LVS_SMALLICON LVS_LIST LVS_REPORT 这四种风格决定控件的外观，同时只可以选择其中一种，分别对应：大图标显示，小图标显示，列表显示，详细报表显示
LVS_EDITLABELS 结点的显示字符可以被编辑，对于报表风格来讲可编辑的只为第一列。
LVS_SHOWSELALWAYS 在失去焦点时也显示当前选中的结点
LVS_SINGLESEL 同时只能选中列表中一项
首先你需要设置列表控件所使用的ImageList，如果你使用大图标显示风格，你就需要以如下形式调用： CImageList* SetImageList( CImageList* pImageList, LVSIL_NORMAL); 如果使用其它三种风格显示而不想显示图标你可以不进行任何设置，否则需要以如下形式调用： CImageList* SetImageList( CImageList* pImageList, LVSIL_SMALL);
通过调用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
关于ON_NOTIFY有很多内容，将在以后的内容中进行详细讲解。
关于动态提供结点所显示的字符：首先你在项时需要指明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;
}
上面讲述的方法所进行的消息映射必须在父窗口中进行（同样WM_NOTIFY的所有消息都需要在父窗口中处理）。
如何得到当前选中项位置：在列表控件中没有一个类似于ListBox中GetCurSel()的函数，但是可以通过调用GetNextItem( -1, LVNI_ALL | LVNI_SELECTED);得到选中项位置。

23. listctrl排序

Q250614：How To Sort Items in a CListCtrl in Report View
http://support.microsoft.com/kb/250614/en-us

// 排序用的比较函数

static int CALLBACK MyCompareProc(LPARAMlParam1, LPARAMlParam2, LPARAMlParamSort)
{
     CString &lp1 = *((CString *)lParam1);
     CString &lp2 = *((CString *)lParam2);
     int &sort = *(int *)lParamSort;
     if (sort == 0)
     {
         returnlp1.CompareNoCase(lp2);
     }
     else
     {
         returnlp2.CompareNoCase(lp1);
     }
}
//要处理的事件
ON_NOTIFY(LVN_COLUMNCLICK, IDC_LIST1, &CDlg::OnLvnColumnclickList1)
//处理代码

voidCDlg::OnLvnColumnclickList1(NMHDR *pNMHDR, LRESULT *pResult)
{
     LPNMLISTVIEWpNMLV = reinterpret_cast<LPNMLISTVIEW>(pNMHDR);
     intLength = m_ListCtrl.GetItemCount();
     CArray<CString,CString> ItemData;
     ItemData.SetSize(Length);
     for (inti = 0; i < Length; i++)
     {
         ItemData[i] = m_ListCtrl.GetItemText(i,pNMLV->iSubItem);
         m_ListCtrl.SetItemData(i,(DWORD_PTR)&ItemData[i]);//设置排序关键字
    }
     staticintsort = 0;
     staticintSubItem = 0;
     if (SubItem != pNMLV->iSubItem)
     {
         sort = 0;
         SubItem = pNMLV->iSubItem;
     }
     else
     {
         if (sort == 0)
         {
              sort = 1;
         }
         else
         {
              sort = 0;
         }
     }
     m_ListCtrl.SortItems(MyCompareProc,(DWORD_PTR)&sort);//排序
     *pResult = 0;
}

--------------------------------------------------------------------------------

24. 在listctrl中选中某个item时动态改变其icon或bitmap

Q141834: How to change the icon or the bitmap of a CListCtrl item in Visual C++
http://support.microsoft.com/kb/141834/en-us

--------------------------------------------------------------------------------

25. 在添加item后，再InsertColumn()后导致整列数据移动的问题

Q151897: CListCtrl::InsertColumn() Causes Column Data to Shift
http://support.microsoft.com/kb/151897/en-us

--------------------------------------------------------------------------------

26. 关于listctrl第一列始终居左的问题

解决办法：把第一列当一个虚列，从第二列开始插入列及数据，最后删除第一列。

具体解释参阅 http://msdn.microsoft.com/library/default.asp?url=/library/en-us/shellcc/platform/commctls/listview/structures/lvcolumn.asp

--------------------------------------------------------------------------------

27. 锁定column header的拖动

集成CListCtrl，重写以下方法
// 控制控件的列宽
BOOL CMyListCtrl::OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult)
{
    HD_NOTIFY   *pHDN = (HD_NOTIFY*)lParam;

        if((pHDN->hdr.code == HDN_ITEMCHANGINGW || pHDN->hdr.code == HDN_ITEMCHANGINGA)
                && pHDN->pitem->cxy < 80)
        {
                *pResult = TRUE;                // disable change
                return TRUE;                    // Processed message
        }

        return CListCtrl::OnNotify(wParam, lParam, pResult);
}

//禁止特定的列移动
BOOL CMyListCtrl::OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult)
{
        HD_NOTIFY   *pHDN = (HD_NOTIFY*)lParam;

        if((pHDN->hdr.code == HDN_BEGINTRACKW || pHDN->hdr.code == HDN_BEGINTRACKA)
                && pHDN->iItem == 0)            // Prevent only first (col# 0) from resizing
        {
                *pResult = TRUE;                // disable tracking
                return TRUE;                    // Processed message
        }

        return CListCtrl::OnNotify(wParam, lParam, pResult);
}

--------------------------------------------------------------------------------

28. 如何隐藏clistctrl的列

把需隐藏的列的宽度设为0,然后检测当该列为隐藏列时，用上面第27点的锁定某列的拖动来实现

--------------------------------------------------------------------------------

29. listctrl进行大数据量操作时，使用virtual list

http://www.microsoft.com/msj/archive/S2061.aspx
http://www.codeguru.com/cpp/controls/listview/advanced/article.php/c4151/
http://www.codeproject.com/listctrl/virtuallist.asp

--------------------------------------------------------------------------------

30. 关于item只能显示259个字符的问题

解决办法：需要在item上放一个edit。

--------------------------------------------------------------------------------

31. 响应在listctrl的column header上的鼠标右键单击

Q125694: How To Find Out Which Listview Column Was Right-Clicked
http://support.microsoft.com/kb/125694/en-us

--------------------------------------------------------------------------------

32. 类似于windows资源管理器的listview

Q234310: How to implement a ListView control that is similar to Windows Explorer by using DirLV.exe
http://support.microsoft.com/kb/234310/en-us

--------------------------------------------------------------------------------

33. 在ListCtrl中OnTimer只响应两次的问题

Q200054：
PRB: OnTimer() Is Not Called Repeatedly for a List Control
http://support.microsoft.com/kb/200054/en-us

--------------------------------------------------------------------------------

34. 以下为一些为实现各种自定义功能的listctrl派生类

(1) 拖放
http://www.codeproject.com/listctrl/dragtest.asp

                   在CListCtrl和CTreeCtrl间拖放
                   http://support.microsoft.com/kb/148738/en-us

          (2)    多功能listctrl
                   支持subitem可编辑，图标，radiobutton，checkbox，字符串改变颜色的类
                   http://www.codeproject.com/listctrl/quicklist.asp

                   支持排序，subitem可编辑，subitem图标，subitem改变颜色的类
                   http://www.codeproject.com/listctrl/ReportControl.asp

(3) subitem中显示超链接
http://www.codeproject.com/listctrl/CListCtrlLink.asp

(4) subitem的tooltip提示
http://www.codeproject.com/listctrl/ctooltiplistctrl.asp

          (5)    subitem中显示进度条
                   http://www.codeproject.com/listctrl/ProgressListControl.asp
                   http://www.codeproject.com/listctrl/napster.asp
                   http://www.codeguru.com/Cpp/controls/listview/article.php/c4187/

          (6)    动态改变subitem的颜色和背景色
                    http://www.codeproject.com/listctrl/highlightlistctrl.asp
                    http://www.codeguru.com/Cpp/controls/listbox/colorlistboxes/article.php/c4757/

          (7)    类vb属性对话框
                    http://www.codeproject.com/listctrl/propertylistctrl.asp
                    http://www.codeguru.com/Cpp/controls/listview/propertylists/article.php/c995/
                    http://www.codeguru.com/Cpp/controls/listview/propertylists/article.php/c1041/

          (8)    选中subitem(只高亮选中的item)
                    http://www.codeproject.com/listctrl/SubItemSel.asp
                    http://www.codeproject.com/listctrl/ListSubItSel.asp

          (9)    改变行高已实现
                    http://www.codeproject.com/listctrl/changerowheight.asp

          (10)   改变行颜色已实现
                    http://www.codeproject.com/listctrl/coloredlistctrl.asp

          (11)   可编辑subitem的listctrl
                    http://www.codeproject.com/listctrl/nirs2000.asp
                    http://www.codeproject.com/listctrl/editing_subitems_in_listcontrol.asp

          (12)   subitem可编辑，插入combobox，改变行颜色，subitem的tooltip提示
                    http://www.codeproject.com/listctrl/reusablelistcontrol.asp

          (13)   header 中允许多行字符串
                    http://www.codeproject.com/listctrl/headerctrlex.asp

          (14)   插入combobox
                    http://www.codeguru.com/Cpp/controls/listview/editingitemsandsubitem/article.php/c979/

          (15)   添加背景图片
                    http://www.codeguru.com/Cpp/controls/listview/backgroundcolorandimage/article.php/c4173/
                    http://www.codeguru.com/Cpp/controls/listview/backgroundcolorandimage/article.php/c983/

http://www.vchelp.net/vchelp/archive.asp?type_id=9&class_id=1&cata_id=1&article_id=1088&search_term=

          (16) 自适应宽度的listctrl
          http://www.codeproject.com/useritems/AutosizeListCtrl.asp

          (17) 改变ListCtrl高亮时的颜色(默认为蓝色)
           处理 NM_CUSTOMDRAW
           http://www.codeproject.com/listctrl/lvcustomdraw.asp

(18) 改变header颜色
http://www.pocketpcdn.com/articles/hdr_color.html

--------------------------------------------------------------------------------

35.判断CListCtrl的哪行记录被选中了

int n = -1;
POSITION pos = m_pCtrl->GetFirstSelectedItemPosition(); //返回第一个选中的行位置
if (pos != NULL)
{
   while (pos)
   {
                  n = m_pCtrl->GetNextSelectedItem(pos); //返回下一个选中的行数(返回值从0开始)
                //做相应操作
   }
}

--------------------------------------------------------------------------------

36.响应单击CListCtrl事件

//响应CMyListView的=NUM_CLICK消息

//直接用VC类向导生成后,不用再次添加声明和消息映射
//添加函数声明
afx_msg void OnClick(NMHDR* pNMHDR, LRESULT* pResult);
//添加消息映射
ON_NOTIFY_REFLECT(NM_CLICK, OnClick)
void CMyListView::OnClick(NMHDR* pNMHDR, LRESULT* pResult)
{
        // TODO: Add your control notification handler code here
          NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
        if(pNMListView->iItem != -1)
        {

                //值从0开始计算,无数据区不相应时间
                //相应操作
        }
          *pResult = 0;
}

37、wm_mouseleave和wm_mousehover使用

默认情况下，窗口是不响应 WM_MOUSELEAVE 和 WM_MOUSEHOVER 消息的，所以要使用 _TrackMouseEvent 函数来激活这两个消息。调用这个函数后，当鼠标在指定窗口上停留超过一定时间或离开窗口后，该函数会 Post 这两个消息到指定窗口。

使用方法：
1. 在对话框类中定义一个变量来标识是否追踪当前鼠标状态，之所以要这样定义是要避免鼠标已经在窗体之上时，一移动鼠标就不断重复产生 WM_MOUSEHOVER 。
BOOL _bMouseTrack=TRUE ;

2. 在 OnMouseMove 中调用 _TrackMouseEvent 函数
if (_bMouseTrack) // 若允许追踪，则。
{
TRACKMOUSEEVENT csTME;
csTME.cbSize = sizeof (csTME);
csTME.dwFlags = TME_LEAVE|TME_HOVER;
csTME.hwndTrack = m_hWnd ;// 指定要追踪的窗口
csTME.dwHoverTime = 10; // 鼠标在按钮上停留超过 10ms ，才认为状态为 HOVER
::_TrackMouseEvent (&csTME); // 开启 Windows 的 WM_MOUSELEAVE ， WM_MOUSEHOVER 事件支持

_bMouseTrack=FALSE ; // 若已经追踪，则停止追踪
}

(#add 摘自MSDN:The _TrackMouseEvent function posts messages when the mouse pointer leaves a window or hovers over a window for a specified amount of time. This function callsTrackMouseEvent if it exists, otherwise it emulates it.)
3. 在 OnMouseLeave 中再次允许追踪鼠标状态
_bMouseTrack=TRUE ;

4. 备注：这两个消息的映射要自己写
ON_MESSAGE(WM_MOUSEHOVER,OnMouseHover)
ON_MESSAGE(WM_MOUSELEAVE,OnMouseLeave)

注意:也可以用下面代码在PreTranslateMessage函数中接收，不需要自己写WM_MOUSELEASE和WM_MOUSEHOVER消息的响应函数(当然你要自己写也行)：
if(pMsg-> message==WM_MOUSELEAVE)
AfxMessageBox( "mouse leave ");

else if(pMsg->message == WM_MOUSEHOVER)

AfxMessageBos("mouse leave");

38、虚拟列表技术

给一个链接，介绍的比较详细：http://hi.baidu.com/qi_xian/blog/item/929b04ce27d02c0592457ef8.html

当数据量大时，使用InsertItem插入数据的过程是很漫长的。这时我们有两个方法来解决该问题：一是使用CListCtrl的虚拟列表技术，二是采用分页显示的方法。对于虚拟列表技术，上述链接中的文章讲的很详细，我用过它的比较简单的方法，后来改用了分页方法。

使用虚拟列表技术，有三点需要搞清楚：

① 使用虚拟技术时，需要将CListCtrl控件的Owner Data属性设置为ture。

② 给虚拟列表添加元素时，不需要使用InserItem函数，通过调用SetItemCount设置数据总个数，然后由系统产生不同的消息，在相应的消息响应函数中完成插入工作。

③ 虚拟列表向父窗口发送的消息有三种： ⑴ 当它需要数据时，发送LVN_GETDISPINFO消息； ⑵ 当用户试图查找某个元素时，发送LVN_ODFINDITEM消息； ⑶当需要缓冲数据时，发送 LVN_ODCACHEHINT消息。

当我们使用LVN_GETDISPINFO 的消息处理函数来插入元素时，必须首先检查列表请求的是什么数据（如LVIF_TEXT、LVIF_IMAGE等），然后插入不同的子项。示例如下：

void CDataAnalysis::OnLvnGetdispinfoAnalysisList(NMHDR *pNMHDR, LRESULT *pResult)
{
NMLVDISPINFO *pDispInfo = reinterpret_cast<NMLVDISPINFO*>(pNMHDR);
// TODO: Add your control notification handler code here
LV_ITEM* pItem= &(pDispInfo)->item;
int iItemIndex= pItem->iItem;
size_t converted = 0;
wchar_t wStr[30]; //Unicode字符串
if (pItem->mask & LVIF_TEXT) //字符串缓冲区有效
{
switch(pItem->iSubItem)
{
case 0: //填充数据项的名字,xxxxx表示要填充的字符
mbstowcs_s(&converted, wStr, 30, xxxxxx, _TRUNCATE);
lstrcpy(pItem->pszText,wStr);
break;
case 1: //填充子项1
mbstowcs_s(&converted, wStr, 30, xxxxxx, _TRUNCATE);
lstrcpy(pItem->pszText,wStr);
break;
case 2: //填充子项2
mbstowcs_s(&converted, wStr, 30, xxxxxx, _TRUNCATE);
lstrcpy(pItem->pszText,wStr);
break;
case 3: //填充子项3
lstrcpy(pItem->pszText,xxxxxx);
break;
}
}
*pResult = 0;
}

void CDataAnalysis::OnLvnGetdispinfoAnalysisList(NMHDR *pNMHDR, LRESULT *pResult){NMLVDISPINFO *pDispInfo = reinterpret_cast<NMLVDISPINFO*>(pNMHDR);// TODO: Add your control notification handler code hereLV_ITEM* pItem= &(pDispInfo)->item;int iItemIndex= pItem->iItem;size_t converted = 0;wchar_t wStr[30];            //Unicode字符串if (pItem->mask & LVIF_TEXT) //字符串缓冲区有效{switch(pItem->iSubItem){case 0: //填充数据项的名字,xxxxx表示要填充的字符mbstowcs_s(&converted, wStr, 30, xxxxxx, _TRUNCATE);lstrcpy(pItem->pszText,wStr);break;case 1: //填充子项1mbstowcs_s(&converted, wStr, 30, xxxxxx, _TRUNCATE);lstrcpy(pItem->pszText,wStr);break;case 2: //填充子项2mbstowcs_s(&converted, wStr, 30, xxxxxx, _TRUNCATE);lstrcpy(pItem->pszText,wStr);break;case 3://填充子项3lstrcpy(pItem->pszText,xxxxxx);break;}}*pResult = 0;}

39、自绘

1、owner draw fixed设置为true

2、view设置为report

3、实现虚函数DrawItem

4、重写OnPaint之后，就不会再执行DrawItem。

0 0