MFC—列表框控件ListBox、组合框控件Combo Box（常用控件）

大家好，欢迎来到IT知识分享网。

前面两节讲了比较常用的按钮控件，并通过按钮控件实例说明了具体用法。本文要讲的是列表框控件（ListBox）及其使用实例。

列表框控件简介

列表框给出了一个选项清单，允许用户从中进行单项或多项选择，被选中的项会高亮显示。列表框可分为单选列表框和多选列表框，顾名思义，单选列表框中一次只能选择一个列表项，而多选列表框可以同时选择多个列表项。

列表框也会向父窗口发送通知消息。这些通知消息及含义如下：

列表框控件的创建

MFC将列表框控件的所有操作都封装到了CListBox类中。

创建列表框控件时，可以在对话框模板中直接拖入列表框控件Listbox，然后添加控件变量使用。但如果需要动态创建列表框，就要用到CListBox类的Create成员函数了。Create成员函数的原型如下：

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

参数rect指定了列表框的位置和尺寸，pParentWnd为父窗口的指针，nID用于指定列表框控件的ID。最后重点讲讲参数dwStyle，它指定了列表框控件的风格，以下是各种风格说明：

dwStyle可以是以上所列风格的组合。与其他控件一样，除了这些风格一般还要为列表框控件设置WS_CHILD、WS_VISIBLE、WS_TABSTOP、WS_BORDER、WS_VSCROLL等风格。一般创建单选列表框时，风格要设置为：WS_CHILD|WS_VISIBLE|WS_TABSTOP|LBS_STANDARD，如果不希望列表框项排序显示则应去掉LBS_STANDARD。创建多选列表框时，只需要在单选列表框风格后添加LBS_MULTIPLESEL或LBS_EXTENDEDSEL风格。

对于对话框模板中直接添加的列表框控件，其属性页中的属性包含了以上风格，例如属性Multicolumn对应的就是LBS_MULTICOLUMN风格。

CListBox类的主要成员函数

 int GetCount( ) const; 

返回值：返回列表框中列表项的数目，如果发生错误则返回LB_ERR。

 int GetSel(int nIndex) const; 

参数：nIndex指定某个列表项的索引。

返回值：返回nIndex指定列表项的状态。如果此列表项被选择了则返回一个正值，否则返回0，若发生错误则返回LB_ERR。

 int SetSel(int nIndex,BOOL bSelect = TRUE); 

 int AddString(LPCTSTR lpszItem); 

 int InsertString(int nIndex, LPCTSTR lpszItem); 

 int DeleteString(UINT nIndex); 

 void ResetContent(); 

该函数用于清除所有列表项。

 int GetText(int nIndex,LPTSTR lpszBuffer) const; void GetText(int nIndex,CString& rString) const; 

这两个成员函数用于获取指定列表项的字符串。参数nIndex 指定了列表项的索引。参数lpszBuffer 指向一个接收字符串的缓冲区。引用参数rString 则指定了接收字符串的CString对象。第一个版本的函数会返回获得的字符串的长度，若出错，则返回LB_ERR；第二个版本的函数则不会。

 int GetTextLen(int nIndex) const; 

 int GetCurSel() const; 

该函数仅适用于单选列表框，用来返回当前被选择项的索引，如果没有列表项被选择或有错误发生，则函数返回LB_ERR。

 int SetCurSel(int nSelect); 

该函数仅适用于单选列表框，用来选择指定的列表项。该函数会滚动列表框以使选择项可见。参数nIndex 指定了列表项的索引，若为-1，那么将清除列表框中的选择。若出错函数返回LB_ERR。

 int GetSelCount() const; 

该函数仅用于多重选择列表框，它返回选择项的数目，若出错函数返回LB_ERR。

 int FindString(int nStartAfter,LPCTSTR lpszItem) const; 

该函数用于对列表项进行与大小写无关的搜索。参数nStartAfter 指定了开始搜索的位置，合理指定nStartAfter 可以加快搜索速度，若nStartAfter 为-1，则从头开始搜索整个列表。参数lpszItem 指定了要搜索的字符串。函数返回与lpszItem 指定的字符串相匹配的列表项的索引，若没有找到匹配项或发生了错误，则会返回LB_ERR。FindString 函数先从nStartAfter指定的位置开始搜索，若没有找到匹配项，则会从头开始搜索列表。只有找到匹配项，或对整个列表搜索完一遍后，搜索过程才会停止，所以不必担心会漏掉要搜索的列表项。

 int SelectString(int nStartAfter,LPCTSTR lpszItem); 

该函数仅适用于单选列表框，用来选择与指定字符串相匹配的列表项。该函数会滚动列表框以使选择项可见。参数的意义及搜索的方法与函数FindString 类似。如果找到了匹配的项，函数返回该项的索引，如果没有匹配的项，函数返回LB_ERR 并且当前的选择不被改变。

CListBox类应用实例

最后给大家写一个简单的实例，说明CListBox的几个成员函数及通知消息等的使用方法。此实例实现的功能：在单选列表框中显示一个网站列表，然后在用鼠标左键选择某列表项时，将选中列表项的文本显示到编辑框中。下面是具体实现步骤：

1. 创建一个基于对话框的MFC工程，名称设置为“Example24”。
2. 在自动生成的对话框模板IDD_EXAMPLE24_DIALOG中，删除“TODO: Place dialog controls here.”静态文本控件、“OK”按钮和“Cancel”按钮。添加一个Listbox控件，ID设置为IDC_WEB_LIST，Sort属性设为False，以取消排序显示。再添加一个静态文本控件和一个编辑框，静态文本控件的Caption属性设为“您选择的站点：”，编辑框的ID设为IDC_SEL_WEB_EDIT，Read Only属性设为True。此时的对话框模板如下图：

3. 为列表框IDC_WEB_LIST添加CListBox类型的控件变量m_listBox。
4. 在对话框初始化时，我们将站点名加入到列表框中，那么需要修改CExample24Dlg::OnInitDialog()函数为：

BOOL CExample24Dlg::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  m_listBox.AddString(_T("新浪")); // 在列表框结尾添加字符串“新浪”  m_listBox.AddString(_T("鸡啄米")); // 在列表框结尾添加字符串“鸡啄米”  m_listBox.AddString(_T("猫扑")); // 在列表框结尾添加字符串“猫扑”  m_listBox.InsertString(2, _T("百度")); // 在列表框中索引为2的位置插入字符串“百度”  return TRUE; // return TRUE unless you set the focus to a control  } 

5. 我们希望在选中列表项改变时，将最新的选择项实时显示到编辑框中，那么这就要用到LBN_SELCHANGE通知消息。为列表框IDC_WEB_LIST的通知消息LBN_SELCHANGE添加消息处理函数CExample24Dlg::OnLbnSelchangeWebList()，并修改如下：

void CExample24Dlg::OnLbnSelchangeWebList() { 
    // TODO: Add your control notification handler code here  CString strText; int nCurSel; nCurSel = m_listBox.GetCurSel(); // 获取当前选中列表项  m_listBox.GetText(nCurSel, strText); // 获取选中列表项的字符串  SetDlgItemText(IDC_SEL_WEB_EDIT, strText); // 将选中列表项的字符串显示到编辑框中  } 

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

关于列表框ListBox的讲解就到此为止了。大家如果想试验更多的列表框成员函数，可以在上面的小例子中加入更多的功能来体会。

上一节讲了列表框控件ListBox的使用，本节主要讲解组合框控件Combo Box。组合框同样相当常见，例如，在Windows系统的控制面板上设置语言或位置时，有很多选项，用来进行选择的控件就是组合框控件。它为我们的日常操作提供了很多方便。

组合框控件简介

组合框其实就是把一个编辑框和一个列表框组合到了一起，分为三种：简易（Simple）组合框、下拉式（Dropdown）组合框和下拉列表式（Drop List）组合框。下面讲讲它们的区别。

下拉式组合框默认不显示列表框，只有在点击了编辑框右侧的下拉箭头才会弹出列表框，列表框弹出后如下图：

下拉列表式组合框的编辑框是不能编辑的，只能由用户在下拉列表框中选择了某项后，在编辑框中显示其文本。下拉列表式组合框如下图：

经过上面的介绍，大家应该知道，最常用的当属下拉式组合框和下拉列表式组合框了，它们在很多时候能使程序看起来更专业，更简洁，让用户在进行选择操作时更方便。

组合框控件的创建

MFC将组合框控件的所有操作都封装到了CComboBox类中。

我们在对话框中加入组合框时，可以往对话框模板中拖入Combo Box控件，而后添加CComboBox类型的控件变量使用，但如果我们想在程序中动态创建的话，就要使用CComboBox类的成员函数Create了。Create函数的原型如下：

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

dwStyle参数可以是以上风格的组合。跟其他控件一样，创建时一般也还要指定WS_CHILD、WS_VISIBLE、WS_TABSTOP和WS_VSCROLL等风格。

在对话框模板中直接添加组合框控件时，其属性页中的属性包含了以上风格，例如属性Uppercase设为True就相当于指定了CBS_UPPERCASE风格。

CComboBox类的主要成员函数

因为组合框是由编辑框和列表框组合而成的，所以组合框的操作和编辑框与列表框的操作有很多相似之处，同样的，CComboBox类的成员函数也和CEdit类与CListBox类的成员函数有很多相似之处，不但功能相似，甚至函数名和参数也很相似。下面大概讲解下CComboBox类的主要成员函数，更详细的内容可以参见MSDN。

 int GetCount( ) const; 

获取组合框控件的列表框中列表项的数量。

 int GetCurSel( ) const; 

获取组合框控件的列表框中选中项的索引，如果没有选中任何项，该函数返回CB_ERR。

 int SetCurSel(int nSelect); 

在组合框控件的列表框中选择某项。nSelect参数指定了要选择的列表项的索引，如果为-1则列表框中当前选择项被取消选中，编辑框也被清空。

 DWORD GetEditSel( ) const; 

获取组合框控件的编辑框中当前选择范围的起始和终止字符的位置。该函数返回一个32位数，低16位存放起始位置，高16位存放选择范围后第一个非选择字符的位置。如果该函数用于下拉列表式组合框时，会返回CB_ERR。

 BOOL SetEditSel(int nStartChar,int nEndChar); 

用于在组合框控件的编辑框中选择字符。nStartChar参数指定起始位置，nEndChar参数指定终止位置。

 DWORD_PTR GetItemData(int nIndex) const; 

获取组合框中指定项所关联的32位数据。nIndex参数指定组合框控件的列表框某项的索引（从0开始）。

 int SetItemData(int nIndex,DWORD_PTR dwItemData); 

为某个指定的组合框列表项设置一个关联的32位数。nIndex参数指定要进行设置的列表项索引。dwItemData参数指定要关联的新值。

 void GetLBText(int nIndex,CString& rString) const; 

从组合框控件的列表框中获取某项的字符串。nIndex参数指定要获取字符串的列表项的索引，CString参数用于接收取到的字符串。

 int GetLBTextLen(int nIndex) const; 

获取组合框控件的列表框中某项的字符串长度。nIndex参数指定要获取字符串长度的列表项的索引。

 int GetTopIndex( ) const; 

获取组合框控件的列表框中第一个可见项的索引。

 int SetTopIndex(int nIndex); 

将组合框控件的列表框中某个指定项设置为可见的。nIndex参数指定了该列表项的索引。该函数成功则返回0，有错误发生则返回CB_ERR。

 BOOL LimitText(int nMaxChars); 

用于限制用户在组合框控件的编辑框中能够输入的最大字节长度。nMaxChars参数指定了用户能够输入文字的最大字节长度，如果为0则长度被限制为65535个字节。

 int AddString(LPCTSTR lpszString); 

为组合框控件中的列表框添加新的列表项。lpszString参数是指向要添加的字符串的指针。该函数的返回值如果大于等于0，那么它就是新列表项的索引，而如果有错误发生则会返回CB_ERR，如果没有足够的内存存放新字符串则返回CB_ERRSPACE。

 int DeleteString(UINT nIndex); ```cpp 删除组合框中某指定位置的列表项。nIndex参数指定了要删除的列表项的索引。该函数的返回值如果大于等于0，那么它就是组合框中剩余列表项的数量。如果nIndex指定的索引超出了列表项的数量则返回CB_ERR。 ```cpp int FindString(int nStartAfter,LPCTSTR lpszString) const; 

在组合框控件的列表框中查找但不选中第一个包含指定前缀的列表项。nStartAfter参数指定了第一个要查找的列表项之前的那个列表项的索引。lpszString指向包含要查找的前缀的字符串。该函数的返回值如果大于等于0，那么它是匹配列表项的索引，如果查找失败则返回CB_ERR。

 int InsertString(int nIndex,LPCTSTR lpszString); 

向组合框控件的列表框中插入一个列表项。nIndex参数指定了要插入列表项的位置，lpszString参数则指定了要插入的字符串。该函数返回字符串被插入的位置，如果有错误发生则会返回CB_ERR，如果没有足够的内存存放新字符串则返回CB_ERRSPACE。

 int SelectString(int nStartAfter,LPCTSTR lpszString); 

CComboBox类应用实例

最后给大家写一个简单的实例，说明CComboBox的几个成员函数及通知消息等的使用方法。此实例实现的功能：在组合框中包含一个网站列表，切换组合框控件的列表框中选择的列表项时，将新选中的列表项的文本显示到编辑框中。下面是具体实现步骤：

1. 创建一个基于对话框的MFC工程，名称设置为“Example25”。
2. 在自动生成的对话框模板IDD_EXAMPLE25_DIALOG中，删除“TODO: Place dialog controls here.”静态文本控件、“OK”按钮和“Cancel”按钮。添加一个Combo Box控件，ID设置为IDC_WEB_COMBO，Type属性设为Drop List，为下拉列表式组合框，编辑框不允许用户输入，Sort属性设为False，以取消排序显示。再添加一个静态文本控件和一个编辑框，静态文本控件的Caption属性设为“您选择的网站：”，编辑框的ID设为IDC_SEL_WEB_EDIT，Read Only属性设为True。此时的对话框模板如下图：

3. 为组合框IDC_WEB_COMBO添加CComboBox类型的控件变量m_comboWeb。
4. 在对话框初始化时，我们将站点名加入到组合框中，并默认选择第一项，那么需要修改CExample25Dlg::OnInitDialog()函数为：

BOOL CExample25Dlg::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  // 为组合框控件的列表框添加列表项“鸡啄米”  m_comboWeb.AddString(_T("wdl")); // 为组合框控件的列表框添加列表项“百度”  m_comboWeb.AddString(_T("百度")); // 在组合框控件的列表框中索引为1的位置插入列表项“新浪”  m_comboWeb.InsertString(1, _T("新浪")); // 默认选择第一项  m_comboWeb.SetCurSel(0); // 编辑框中默认显示第一项的文字“鸡啄米”  SetDlgItemText(IDC_SEL_WEB_EDIT, _T("wdl")); return TRUE; // return TRUE unless you set the focus to a control  } 

5. 我们希望在组合框中选中的列表项改变时，将最新的选择项实时显示到编辑框中，那么这就要用到CBN_SELCHANGE通知消息。为列表框IDC_WEB_COMBO的通知消息CBN_SELCHANGE添加消息处理函数CExample25Dlg::OnCbnSelchangeWebCombo()，并修改如下：

void CExample25Dlg::OnCbnSelchangeWebCombo() { 
    // TODO: Add your control notification handler code here  CString strWeb; int nSel; // 获取组合框控件的列表框中选中项的索引  nSel = m_comboWeb.GetCurSel(); // 根据选中项索引获取该项字符串  m_comboWeb.GetLBText(nSel, strWeb); // 将组合框中选中的字符串显示到IDC_SEL_WEB_EDIT编辑框中  SetDlgItemText(IDC_SEL_WEB_EDIT, strWeb); } 

6. 运行程序，弹出结果对话框，在对话框的组合框中改变选择项时，编辑框中的显示会相应改变。效果图如下：
   
   

组合框的内容就是这些了。相对于CComboBox类数量不少的成员函数来说，本节的实例只是用到了很少的几个，大家可以根据上面所讲试试其他的成员函数。