【MFC】列表视图控件——List Control

最新推荐文章于 2023-05-23 21:08:40 发布

Cain Xcy

最新推荐文章于 2023-05-23 21:08:40 发布

阅读量6.2k

点赞数 5

分类专栏： MFC 文章标签： MFC

本文链接：https://blog.csdn.net/m0_43458204/article/details/107641264

版权

MFC 专栏收录该内容

42 篇文章 127 订阅

订阅专栏

01、文章目录

文章目录

02、List Control介绍

列表视图控件List Control同样比较常见，它能够把任何字符串内容以列表的方式显示出来，这种显示方式的特点是整洁、直观，在实际应用中能为用户带来方便。

列表视图控件是对列表框控件List Box的改进和延伸。列表视图控件的列表项一般有图标（Icon）和标签（Label）两部分。图标是对列表项的图形描述，标签是文字描述。当然列表项可以只包含图标也可以只包含标签，这个是可以自己规定的。

List Box后面再说了，我没时间写，先应付工作先，边学边写。

列表视图控件有4种风格：Icon、Small Icon、List和Report。下面简单说下4种风格各自的特点：

Icon大图标风格：列表项的图标通常为32×32像素，在图标的下面显示标签。
Small Icon小图标风格：列表项的图标通常为16×16像素，在图标的右面显示标签。
List列表风格：与小图标风格类似，图标和文字的对齐方式不同。
Report报表风格：列表视图控件可以包含一个列表头来描述各列的含义。每行显示一个列表项，通常可以包含多个列表子项。最左边的列表子项的标签左边可以添加一个图标，而它右边的所有子项则只能显示文字。这种风格的列表视图控件很适合做各种报表。（也是我目前需要的）

03、List Control的通知消息

在MFC消息映射机制中的“各种Windows消息的消息处理函数”部分，就曾以列表视图控件为例简单讲了WM_NOTIFY通知消息及其消息映射入口和消息处理函数的形式。如果你忘记了可以跳转到那篇文章看一看，了解一下。

这里给出下面将要演示的列表视图控件实例中，通知码为NM_CLICK的通知消息的消息映射入口：
ON_NOTIFY(NM_CLICK, IDC_PROGRAM_LANG_LIST, &CExample29Dlg::OnNMClickProgramLangList)
还有消息处理函数自动生成时的形式：

void CExample29Dlg::OnNMClickProgramLangList(NMHDR *pNMHDR, LRESULT *pResult)   
{   
    LPNMITEMACTIVATE pNMItemActivate = reinterpret_cast<LPNMITEMACTIVATE>(pNMHDR);   
    // TODO: Add your control notification handler code here   
    *pResult = 0;   
}

我们看到，上面的代码中将NMHDR指针类型的pNMHDR强制转换为LPNMITEMACTIVATE类型的pNMItemActivate，那么我们就可以在函数中通过pNMHDR来访问NMHDR结构，也可以通过pNMItemActive指针变量来访问第一个元素为NMHDR结构体变量的扩充结构。

当然列表视图控件还有一些自己特有的通知消息，下面就介绍几个其中比较常用的。

LVN_ITEMCHANGING 和LVN_ITEMCHANGED：当列表视图的状态发生变化时，会发送这两个通知消息。例如，当用户选择了新的列表项时，程序就会收到这两个消息。
消息会附带一个指向NMLISTVIEW 结构的指针，消息处理函数可从该结构中获得状态信息。两个消息的不同之处在于，前者的消息处理函数如果返回TRUE，那么就阻止选择的改变，如果返回FALSE，则允许改变。

LVN_KEYDOWN：该消息表明了一个键盘事件。消息会附带一个指向NMLVKEYDOWN结构的指针，通过该结构程序可以获得按键的信息。

LVN_BEGINLABELEDIT 和LVN_ENDLABELEDIT：分别在用户开始编辑和结束编辑标题时发送。消息会附带一个指向NMLVDISPINFO结构的指针。在前者的消息处理函数中，可以调用GetEditControl成员函数返回一个指向用于编辑标题的编辑框的指针，如果处理函数返回FALSE，则允许编辑，如果返回TRUE，则禁止编辑。在后者的消息处理函数中，NMLVDISPINFO结构中的item.pszText指向编辑后的新标题，如果pszText 为NULL，那么说明用户放弃了编辑，否则，程序应负责更新表项的标题，这可以由SetItem或SetItemText函数来完成。

在这里插入图片描述

04、List Control的相关结构体

下面我们来介绍一下与列表视图控件有关的一些结构体。

NMHDR结构体

C++代码：

typedef struct tagNMHDR {   
    HWND hwndFrom;     // 控件窗口的句柄   
     UINT_PTR idFrom;   // 控件ID   
    UINT code;         // 控件的通知消息码   
} NMHDR;

此结构体在很多情况下都是其他扩充结构体的第一个元素，比如上面的NMITEMACTIVATE结构体：

C++代码：

ypedef struct tagNMITEMACTIVATE {   
    NMHDR hdr;   
    int iItem;   
    int iSubItem;   
    UINT uNewState;   
    UINT uOldState;   
    UINT uChanged;   
    POINT ptAction;   
    LPARAM lParam;   
    UINT uKeyFlags;   
} NMITEMACTIVATE, *LPNMITEMACTIVATE;

LVITEM

该结构体包含了列表视图控件中列表项或列表子项的各种属性。

C++代码：

typedef struct _LVITEM {    
    UINT mask;           // 掩码位的组合（下面有对应掩码的元素都已在括号中标出掩码），表明哪些元素是有效的   
    int iItem;           // 列表项的索引   
    int iSubItem;        // 列表子项的索引   
    UINT state;          // 状态，下面会列出。（LVIF_STATE）   
    UINT stateMask;      // 状态掩码，用来说明要获取或设置哪些状态。下面会列出   
    LPTSTR pszText;      // 指向列表项或列表子项的标签字符串。（LVIF_TEXT）   
    int cchTextMax;      // pszText指向缓冲区的字符的个数，包括字符串结束符。（LVIF_TEXT）   
    int iImage;          // 图标的索引。(LVIF_IMAGE)   
    LPARAM lParam;       // 32位的附加数据。(LVIF_PARAM)   
#if (_WIN32_IE >= 0x0300)   
    int iIndent;   
#endif   
#if (_WIN32_WINNT >= 0x501)   
    int iGroupId;   
    UINT cColumns; // tile view columns   
    PUINT puColumns;   
#endif   
#if (_WIN32_WINNT >= 0x0600)   
    int* piColFmt;   
    int iGroup;   
#endif   
} LVITEM, *LPLVITEM;

下面是state和stateMask的取值及含义：

状态	对应的状态掩码	含义
LVIS_CUT	同左	列表项或列表子项被选择用来进行剪切和粘贴操作
LVIS_DROPHILITED	同左	列表项或列表子项成为拖动操作的目标
LVIS_FOCUSED	同左	列表项或列表子项具有输入焦点
LVIS_SELECTED	同左	列表项或列表子项被选中

LVCOLUMN结构体

该结构体仅适用于Report报表式列表视图控件。在向列表控件中插入一列时需要用到此结构体。它包含了列表控件某列的各种属性。

C++代码：

typedef struct _LVCOLUMN {    
    UINT mask;              // 掩码位的组合（下面有对应掩码的元素都已在括号中标出掩码），表明哪些元素是有效的   
    int fmt;                    // 该列的表头和列表子项的标签正文显示格式，可以是LVCFMT_CENTER、LVCFMT_LEFT或LVCFMT_RIGHT。（LVCF_FMT）   
    int cx;                     // 以像素为单位的列的宽度。（LVCF_FMT）   
    LPTSTR pszText;    // 指向列表头标题正文的字符串。（LVCF_TEXT）   
    int cchTextMax;     // pszText指向缓冲区的字符的个数，包括字符串结束符。（LVCF_TEXT）   
    int iSubItem;          // 该列的索引。（LVCF_SUBITEM）   
#if (_WIN32_IE >= 0x0300)   
    int iImage;   
    int iOrder;   
#endif   
#if (_WIN32_WINNT >= 0x0600)   
    int cxMin;   
    int cxDefault;   
    int cxIdeal;   
#endif   
} LVCOLUMN, *LPLVCOLUMN;

显然这正是我要用到的结构体。

NMLISTVIEW结构体

该结构体存放了列表视图控件通知消息的相关信息。列表视图控件的大部分通知消息都会附带指向该结构体的指针。

C++代码：

typedef struct tagNMLISTVIEW {   
    NMHDR hdr;       // 标准的NMHDR 结构   
     int iItem;       // 列表项的索引   
     int iSubItem;    // 列表子项的索引   
     UINT uNewState;  // 列表项或列表子项的新状态   
     UINT uOldState;  // 列表项或列表子项原来的状态   
     UINT uChanged;   // 取值与LVITEM的mask成员相同，用来表明哪些状态发生了变化   
     POINT ptAction;  // 事件发生时鼠标的客户区坐标   
     LPARAM lParam;   //32位的附加数据   
} NMLISTVIEW, *LPNMLISTVIEW;

05、List Control的创建

MFC同样为列表视图控件的操作提供了CListCtrl类。

如果我们不想在对话框模板中直接拖入List Control来使用列表视图控件，而是希望动态创建它，则要用到CListCtrl类的成员函数Create函数，原型如下：（这里只做简单介绍，一般不用这种方式，除非原生控件）

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

参数介绍：

rect：列表视图控件的位置和尺寸
pParentWnd：指向父窗口的指针
nID：指定列表视图控件的ID
dwStyle：用于设定列表视图控件的风格

每次说到原生创建方法，总是有dwStyle，很复杂，这里介绍一下，基本都是用标准的，很少有人用其他类型。
在这里插入图片描述
与前面的控件一样，除了以上风格一般我们还要为列表视图控件设置WS_CHILD和WS_VISIBLE风格。对于直接在对话框模板中创建的列表视图控件，其属性页中的属性与上述风格是对应的，例如，属性Alignment默认为Left，也就等价于指定了LVS_ALIGNLEFT风格。

06、CListCtrl类的主要成员函数

CListCtrl类有很多成员函数，这里就为大家介绍几个常用的主要成员函数。

UINT GetSelectedCount( ) const;
该函数返回列表视图控件中被选择列表项的数量。
POSITION GetFirstSelectedItemPosition( ) const;
获取列表视图控件中第一个被选择项的位置。返回的POSITION值可以用来迭代来获取其他选择项，可以当作参数传入下面的GetNextSelectedItem函数来获得选择项的索引。如果没有被选择项则返回NULL。
int GetNextSelectedItem(POSITION& pos) const;
该函数获取由pos指定的列表项的索引，然后将pos设置为下一个位置的POSITION值。参数pos为之前调用GetNextSelectedItem或GetFirstSelectedItemPosition得到的POSITION值的引用。返回值就是pos指定列表项的索引。
int GetItemCount( ) const;
获取列表视图控件中列表项的数量。
int InsertColumn(int nCol,const LVCOLUMN* pColumn ); int InsertColumn(int nCol,LPCTSTR lpszColumnHeading,int nFormat = LVCFMT_LEFT,int nWidth = -1,int nSubItem = -1 );
这两个函数用于在报表式列表视图控件中插入列。第一个函数中，nCol参数为插入列的索引，pColumn参数指向LVCOLUMN结构，其中包含了插入列的属性。第二个函数中，nCol参数也是插入列的索引，lpszColumnHeading参数为列标题字符串，nFormat参数为列中文本的对齐方式，可以是LVCFMT_LEFT、LVCFMT_RIGHT或LVCFMT_CENTER，nWidth参数为列宽，nSubItem为插入列对应列表子项的索引。两个函数在成功时都返回新列的索引，失败都返回-1。
BOOL DeleteColumn(int nCol);
该函数用于删除列表视图控件中的某列。参数nCol为删除列的索引。删除成功则返回TRUE，失败返回FALSE。
`int InsertItem(int nItem,LPCTSTR lpszItem);
向列表视图控件中插入新的列表项。参数nItem为要插入项的索引，参数lpszItem为要插入项的标签字符串。如果插入成功则返回新列表项的索引，否则返回-1。
BOOL DeleteItem(int nItem);
从列表视图控件中删除某个列表项。参数nItem指定了要删除的列表项的索引。删除成功则返回TRUE，否则返回FALSE。
CString GetItemText(int nItem,int nSubItem) const;
获取指定列表项或列表子项的显示文本。参数nItem指定了列表项的索引，参数nSubItem指定了列表子项的索引。
`
BOOL SetItemText(int nItem,int nSubItem,LPCTSTR lpszText);
设置指定列表项或列表子项的显示文本。参数nItem和nSubItem同GetItemText。参数lpszText为要设置的显示文本字符串。如果设置成功则返回TRUE，否则返回FALSE。
DWORD_PTR GetItemData(int nItem) const;
该函数用于获取指定列表项的附加32位数据。参数nItem为列表项的索引。返回值就是由nItem指定列表项的附加32位数据。
BOOL SetItemData(int nItem,DWORD_PTR dwData);
该函数用于为指定列表项设置附加32位是数据。参数nItem为列表项的索引，参数dwData为列表项的附加32位数据。

07、代码实例

这里实例直接用的网上的，看了下，明白怎么用了就开始干活了。

给大家写一个简单的实例，说明CListCtrl类的几个成员函数及通知消息等的使用方法。因为在开发中最常用的要属报表风格的List Control了，所以给大家写的是一个报表List Control的例子。

此实例实现的功能：在单选列表视图控件中显示一个简单的编程语言排行榜，然后在用鼠标左键选择某列表项时，将选中列表项的文本显示到编辑框中。下面是具体实现步骤：

创建一个基于对话框的MFC工程，名称设置为“Example29”。
在自动生成的对话框模板IDD_EXAMPLE29_DIALOG中，删除“TODO: Place dialog controls here.”静态文本控件、“OK”按钮和“Cancel”按钮。添加一个List Control控件，ID设置为IDC_PROGRAM_LANG_LIST，View属性设为Report，即为报表风格，Single Selection属性设为True。再添加一个静态文本控件和一个编辑框，静态文本控件的Caption属性设为“选择的语言：”，编辑框的ID设为IDC_LANG_SEL_EDIT，Read Only属性设为True。此时的对话框模板如下图：
为列表视图控件IDC_PROGRAM_LANG_LIST添加CListCtrl类型的控件变量m_programLangList。
在对话框初始化时，我们将编程语言排行榜加入到列表视图控件中，那么需要修改CExample29Dlg::OnInitDialog()函数为：

C++代码：

BOOL CExample29Dlg::OnInitDialog()   
{   
    CDialogEx::OnInitDialog();   
  
    // Add "About..." menu item to system menu.   
  
    // IDM_ABOUTBOX must be in the system command range.   
    ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);   
    ASSERT(IDM_ABOUTBOX < 0xF000);   
  
    CMenu* pSysMenu = GetSystemMenu(FALSE);   
    if (pSysMenu != NULL)   
    {   
        BOOL bNameValid;   
        CString strAboutMenu;   
        bNameValid = strAboutMenu.LoadString(IDS_ABOUTBOX);   
        ASSERT(bNameValid);   
        if (!strAboutMenu.IsEmpty())   
        {   
            pSysMenu->AppendMenu(MF_SEPARATOR);   
            pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);   
        }   
    }   
  
    // Set the icon for this dialog.  The framework does this automatically   
    //  when the application's main window is not a dialog   
    SetIcon(m_hIcon, TRUE);         // Set big icon   
    SetIcon(m_hIcon, FALSE);        // Set small icon   
  
    // TODO: Add extra initialization here   
    CRect rect;   
  
    // 获取编程语言列表视图控件的位置和大小   
    m_programLangList.GetClientRect(&rect);   
  
    // 为列表视图控件添加全行选中和栅格风格   
    m_programLangList.SetExtendedStyle(m_programLangList.GetExtendedStyle() | LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);   
  
    // 为列表视图控件添加三列   
    m_programLangList.InsertColumn(0, _T("语言"), LVCFMT_CENTER, rect.Width()/3, 0);   
    m_programLangList.InsertColumn(1, _T("2012.02排名"), LVCFMT_CENTER, rect.Width()/3, 1);   
    m_programLangList.InsertColumn(2, _T("2011.02排名"), LVCFMT_CENTER, rect.Width()/3, 2);   
  
    // 在列表视图控件中插入列表项，并设置列表子项文本   
    m_programLangList.InsertItem(0, _T("Java"));   
    m_programLangList.SetItemText(0, 1, _T("1"));   
    m_programLangList.SetItemText(0, 2, _T("1"));   
    m_programLangList.InsertItem(1, _T("C"));   
    m_programLangList.SetItemText(1, 1, _T("2"));   
    m_programLangList.SetItemText(1, 2, _T("2"));   
    m_programLangList.InsertItem(2, _T("C#"));   
    m_programLangList.SetItemText(2, 1, _T("3"));   
    m_programLangList.SetItemText(2, 2, _T("6"));   
    m_programLangList.InsertItem(3, _T("C++"));   
    m_programLangList.SetItemText(3, 1, _T("4"));   
    m_programLangList.SetItemText(3, 2, _T("3"));   
  
    return TRUE;  // return TRUE  unless you set the focus to a control   
}

我们希望在选中列表项改变时，将最新的选择项实时显示到编辑框中，那么可以使用NM_CLICK通知消息。为列表框IDC_PROGRAM_LANG_LIST的通知消息NM_CLICK添加消息处理函数CExample29Dlg::OnNMClickProgramLangList，并修改如下：

void CExample29Dlg::OnNMClickProgramLangList(NMHDR *pNMHDR, LRESULT *pResult)   
{   
    LPNMITEMACTIVATE pNMItemActivate = reinterpret_cast<LPNMITEMACTIVATE>(pNMHDR);   
    // TODO: Add your control notification handler code here   
    *pResult = 0;   
  
    CString strLangName;    // 选择语言的名称字符串   
    NMLISTVIEW *pNMListView = (NMLISTVIEW*)pNMHDR;   
  
    if (-1 != pNMListView->iItem)        // 如果iItem不是-1，就说明有列表项被选择   
    {   
        // 获取被选择列表项第一个子项的文本   
        strLangName = m_programLangList.GetItemText(pNMListView->iItem, 0);   
        // 将选择的语言显示与编辑框中   
        SetDlgItemText(IDC_LANG_SEL_EDIT, strLangName);   
    }   
}

运行程序，弹出结果对话框，在对话框的列表框中用鼠标改变选中项时，编辑框中的显示会相应改变。效果图如下：

关于列表视图控件List Control的内容总算讲完了，内容不少，但实际上这些还只是一部分，在实际开发中会遇到各种问题，需要大家去查阅MSDN或上网找资料等来解决。

08、总结

由于工作需要，临时就写了一篇，在网上找各种资源，总结了一下。如果不全面，请网上查漏补缺。
版权声明：转载请注明出处，谢谢！

Cain Xcy

关注

5
点赞
踩
48

收藏

觉得还不错? 一键收藏
打赏
1
评论
【MFC】列表视图控件——List Control

01、文章目录文章目录01、文章目录02、List Control介绍03、List Control的通知消息04、List Control的相关结构体05、List Control的创建06、CListCtrl类的主要成员函数07、代码实例08、总结02、List Control介绍列表视图控件List Control同样比较常见，它能够把任何字符串内容以列表的方式显示出来，这种显示方式的特点是整洁、直观，在实际应用中能为用户带来方便。列表视图控件是对列表框控件List Box的改进和延伸。列表视
复制链接

扫一扫