组合框控件 — CComboBox

       组合框其实就是把一个编辑框和一个列表框组合到了一起,分为三种:简易(Simple)组合框、下拉式(Dropdown)组合框和下拉列表式(Drop List)组合框。Properties面板中设置type属性。在动态创建时,BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID ); 在 dwStyle中添加CBS_DROPDOWNLIST参数即可。其显示效果分别为:

 组合框控件 — CComboBox-风君雪科技博客组合框控件 — CComboBox-风君雪科技博客组合框控件 — CComboBox-风君雪科技博客      

常用通知消息

       组合框被操作时会向父窗口发送通知消息,这些通知消息及其含义如下:

       CBN_CLOSEUP:组合框的列表框组件被关闭,简易组合框不会发送该通知消息
       CBN_DBLCLK:用户在某列表项上双击鼠标,只有简易组合框才会发送该通知消息
       CBN_DROPDOWN:组合框的列表框组件下拉,简易式组合框不会发送该通知消息
       CBN_EDITUPDATE:在编辑框准备显示改变了的正文时发送该消息,下拉列表式组合框不会发送该消息
       CBN_EDITCHANGE:编辑框的内容被用户改变了,与CBN_EDITUPDATE不同,该消息是在编辑框显示的正文被刷新后才发出的,下拉列表式组合框不会发送该消息
       CBN_ERRSPACE:组合框无法申请足够的内存来容纳列表项
       CBN_SELENDCANCEL:表明用户的选择应该取消,当用户在列表框中选择了一项,然后又在组合框控件外单击鼠标时就会导致该消息的发送
       CBN_SELENDOK:用户选择了一项,然后按了回车键或单击了下滚箭头,该消息表明用户确认了自己所作的选择
       CBN_KILLFOCUS:组合框失去了输入焦点
       CBN_SELCHANGE:用户通过单击或移动箭头键改变了列表的选择
       CBN_SETFOCUS:组合框获得了输入焦点

  其消息映射形如:

         ON_CBN_SELCHANGE(IDC_COMBO_PRINTERS, &CPrintDlgAppDlg::OnCbnSelchangeComboPrinters)

         ON_CBN_EDITCHANGE(IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnCbnEditchangeComboPrinters)

         ON_CBN_CLOSEUP(IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnCbnCloseupComboPrinters)

         ON_CBN_DROPDOWN(IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnCbnDropdownComboPrinters)

         ON_CBN_EDITUPDATE(IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnCbnEditupdateComboPrinters)

         ON_CBN_DBLCLK(IDC_COMBO_PRINTERS, &CPrintDlgAppDlg::OnCbnDblclkComboPrinters)

         ON_CBN_ERRSPACE(IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnCbnErrspaceComboPrinters)

         ON_CBN_SELENDCANCEL(IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnCbnSelendcancelComboPrinters)

         ON_CBN_SELENDOK(IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnCbnSelendokComboPrinters)

         ON_CBN_SETFOCUS(IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnCbnSetfocusComboPrinters)

         ON_NOTIFY(NM_THEMECHANGED, IDC_COMBO_PRINTERS,
&CPrintDlgAppDlg::OnNMThemeChangedComboPrinters)

组合框控件的创建

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

       在对话框中加入组合框时,可以往对话框模板中拖入Combo
Box控件,然后在Properties面板中可以配置各种属性。如果在程序中动态创建,则要使用CComboBox类的成员函数Create。Create函数的原型如下:

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

      其中,dwStyle指定组合框控件的风格,rect为列表框弹出后组合框的位置和尺寸,pParentWnd是指向父窗口的指针,不能为NULL,nID指定组合框控件的ID。重点是dwStyle参数,它可以指定组合框控件的风格,包括以下几种:

      
CBS_AUTOHSCROLL:使编辑框组件具有水平滚动的风格
       CBS_DISABLENOSCROLL:使列表框在不需要滚动时显示一个禁止的垂直滚动条
       CBS_DROPDOWN:指定一个下拉式组合框
       CBS_DROPDOWNLIST:指定一个下拉列表式组合框
       CBS_HASSTRINGS:指定一个含有字符串的自绘式组合框
       CBS_LOWERCASE:将编辑框和列表框中的所有文本都自动转换为小写字符
       CBS_NOINTEGRALHEIGHT:组合框的尺寸由应用程序而不是Windows
指定,通常,由Windows指定尺寸会使列表项的某些部分隐藏起来
       CBS_OEMCONVERT:使编辑框组件中的正文可以在ANSI
字符集和OEM字符集之间相互转换。这在编辑框中包含文件名时是很有用的
       CBS_OWNERDRAWFIXED:指定自绘式组合框,即由父窗口负责绘制列表框的内容,并且列表项有相同的高度
       CBS_OWNERDRAWVARIABLE:指定自绘式组合框,并且列表项有不同的高度
       CBS_SIIMPLE:指定一个简易组合框
       CBS_SORT:自动对列表框组件中的项进行排序
       CBS_UPPERCASE:将编辑框和列表框中的所有文本都自动转换为大写字符

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

       删除组合框中某指定位置的列表项。nIndex参数指定了要删除的列表项的索引。该函数的返回值如果大于等于0,那么它就是组合框中剩余列表项的数量。如果nIndex指定的索引超出了列表项的数量则返回CB_ERR。

       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);
       在组合框控件的列表框中查找一个字符串,如果查找到则选中它,并将其显示到编辑框中。参数同FindString。如果字符串被查找到则返回此列表项的索引,如果查找失败则返回CB_ERR,并且当前选择项不改变。

      
此外,CComboBox类还继承了CWnd类的成员函数GetWindowText、SetWindowText等。

    一般在使用此控件时,初始化时需要添加相应的信息:
        for (int i = 0; i < printers.size(); i++)
        {
            m_comboPrinters.AddString(printers.at(i));
        }
        m_comboPrinters.SetCurSel(0);

    需要清空所有的信息时,使用
        while (m_comboPrinters.GetCount() > 0)
        {
            m_comboPrinters.DeleteString(0);
        }

参考资料

http://www.jizhuomi.com/software/189.html