组合框把一个编辑框和一个单选择列表框结合在了一起.用户既可以在编辑框中输入,也可以从列表框中选择一个列表项来完成输入。组合框分为简易式(Simple combo box)、下拉式(Drop-down combo box)和下拉列表式(Drop-down list box)三种.简易式组合框包含一个编辑框和一个总是显示的列表框。下拉式组合框同简易式组合框类似,二者的区别在于仅当单击下滚箭头后列表框才会弹出。下拉列表式组合框也有一个下拉的列表框,但它的编辑框是只读的,不能输入字符。
应用程序用CreateWindowEx创建组合框控件时,可根据控件的用途在下表中选择部份常数来设定其风格属性(style)。
常数 | 说明 |
CBS_AUTOHSCROLL | 允许在编辑框中输入超过控件宽度的文字。 |
CBS_DISABLENOSCROLL | 固定显示垂直滚动条。未指定本项时,当列表未超出窗口,垂直滚动条自动隐藏。 |
CBS_DROPDOWN | 指定控件为下拉式列表框,允许在编辑框中输入文字。 |
CBS_DROPDOWNLIST | 指定控件为下拉列表式,不允许在编辑框中输入文字。 |
CBS_HASSTRINGS | 指定控件为含有字符串的自绘式组合框。应用程序在自绘式组合框的列表框中进行自绘时可以用CB_GETLBTEXT消息来取得列表项的文本。 |
CBS_LOWERCASE | 使所有列表项的文本全部变成小写。 |
CBS_NOINTEGRALHEIGHT | 组合框的尺寸由应用程序而不是Windows指定.通常,由Windows指定尺寸会使列表项的某些部分隐藏起来 |
CBS_OEMCONVERT | 使编辑框组件中的正文可以在ANSI字符集和OEM字符集之间相互转换。这在编辑框中包含文件名时是很有用的。 |
CBS_OWNERDRAWFIXED | 指定自绘式组合框,即由父窗口负责绘制列表框的内容,并且列表项有相同的高度。在控件被创建时父窗口将收到WM_MEASUREITEM 消息,当需要重绘时父窗口将收到 WM_DRAWITEM 消息。 |
CBS_OWNERDRAWVARIABLE | 指定自绘式组合框,并且列表项有不同的高度。在控件被创建时父窗口将收到WM_MEASUREITEM 消息,当需要重绘时父窗口将收到 WM_DRAWITEM 消息。 |
CBS_SIMPLE | 指定控件为简易式组合框,其列表框不会自动隐藏,允许在编辑框中输入文字。 |
CBS_SORT | 使插入列表框中的项按字母升序排列。 |
CBS_UPPERCASE | 使所有列表项的文本全部变成大写。 |
应用程序可以通过调用SendMessage向控件发送如下消息来设定和查询控件各种参数。
uMsg | wParam | lParam | 说明 |
CB_ADDSTRING | 0 | 字符串地址 | 追加一个列表项。如果指定了CBS_SORT风格,表项将被重排序,否则将被追加在列表框的最后一项。 |
CB_DELETESTRING | 索引 | 0 | 删除指定的列表项, |
CB_DIR | DDL_ARCHIVE | 指向通配符地址 | 在列表框中列出文件名,必须是当前路径内,符合指定通配符,存档属性的文件名。 |
DDL_DIRECTORY | 在列表框中列出当前路径的子文件夹。子文件夹名前后将加上一对方括号"[*]" | ||
DDL_DRIVES | 在列表框中列出本机的所有驱动器名。驱动器名前后将加上一对方括号和减号"[-*-]" | ||
DDL_EXCLUSIVE | 只列出指定属性的文件名,默认情况下是所有可读写文件都列出。如果没有指定任何文件属性,则不列出文件名。 | ||
DDL_HIDDEN | 列出隐藏属性的文件名。 | ||
DDL_READONLY | 列出只读属性的文件名。 | ||
DDL_READWRITE | 列出读写属性的文件名。 | ||
DDL_SYSTEM | 列出系统属性的文件名。 | ||
CB_FINDSTRING | 起点索引 | 字符串地址 | 根据给定的字符串前辍查找匹配字符串,忽略大小写,从指定起点开始开始查找,当查到某表项的文本字符串的前面包括指定的字符串则结束查找,返回索引号,若找不到则转到列表框第一项继续查找,直到查完所有表项,如果wParam为-1则从列表框第一项开始查找,若还找不到则返回CB_ERR。如:表项字符串为"abc123"和指定字串"ABC"就算匹配。 |
CB_FINDSTRINGEXACT | 开始表项序号 | 字符串地址 | 查找字符串,忽略大小写,与CB_FINDSTRING不同,本操作必须整个字符串相同。如果找到则返回表项序号,否则返回CB_ERR。 |
CB_GETCOUNT | 0 | 0 | 返回列表项的总项数,若出错则返回CB_ERR. |
CB_GETCURSEL | 0 | 0 | 返回当前被选择项的索引,如果没有列表项被选择或有错误发生,则函数返回CB_ERR. |
CB_GETDROPPEDCONTROLRECT | 0 | RECT结构地址 | 取组合框中列表框的屏幕位置。 |
CB_GETDROPPEDSTATE | 0 | 0 | 取组合框中列表框是否可见,返回TRUE可见,FALSE隐藏。 |
CB_GETDROPPEDWIDTH | 0 | 0 | 取组合框中列表框的宽度(像素点)。 |
CB_GETEDITSEL | 起点缓冲地址 或NULL | 终点缓冲地址 或NULL | 取得组合框中编辑控件中选定内容的范围,返回值中低16位为起点与高16位为终点,如果wParam和lParam中指定了地址,则会在该地址填入相应值(dword)。 |
CB_GETEXTENDEDUI | 0 | 0 | 返回组合框是否存在扩展界面,如果存在则返回TRUE否则FALSE。扩展界面详见CB_SETEXTENDEDUI |
CB_GETHORIZONTALEXTENT | 0 | 0 | 返回组合框水平滚动的总宽度(像素点)。本操作只适用于带有水平滚动风格的组合框。 |
CB_GETITEMDATA | 索引 | 0 | 每个列表项都有一个32位的附加数据.本操作返回指定列表项的附加数据。若出错则返回CB_ERR. |
CB_GETITEMHEIGHT | 索引 | 0 | 返回指定列表项的高度(像素点)。 |
CB_GETLBTEXT | 索引 | 缓冲区 | 用于获取指定列表项的字符串。参数lParam指向一个接收字符串的缓冲区。wParam则指定了接收字符串的列表项索引。返回获得的字符串的长度,若出错,则返回CB_ERR。 |
CB_GETLBTEXTLEN | 索引 | 0 | 返回指定列表项的字符串的字节长度(未包括结尾的0)。wParam指定了列表项的索引.若出错则返回CB_ERR。 |
CB_GETLOCALE | 0 | 0 | 取列表项当前用于排序的语言代码,当用户使用CB_ADDSTRING向组合框中的列表框中添加记录并使用CBS_SORT风格进行重新排序时,必须使用该语言代码。返回值中高16位为国家代码。 |
CB_GETTOPINDEX | 0 | 0 | 取组合框中列表框中第一个可见项的索引,若出错则返回CB_ERR. |
CB_INITSTORAGE | 表项数 | 内存字节数 | 本操作只适用于Windows95版本,当你将要向列表框中加入很多表项或有很大的表项时,本操作将预先分配一块内存,以免在今后的操作中一次一次地分配内存,从而加快程序运行速度。 |
CB_INSERTSTRING | 索引 | 字符串地址 | 在列表框中的指定位置插入字符串。wParam指定了列表项的索引,如果为-1,则字符串将被添加到列表的末尾。lParam指向要插入的字符串。本操作返回实际的插入位置,若发生错误,会返回LB_ERR或LB_ERRSPACE。与CB_ADDSTRING不同,本操作不会导致CBS_SORT风格的列表框重新排序。建议不要在具有CBS_SORT风格的列表框中使用本操作,以免破坏列表项的次序。 |
CB_LIMITTEXT | 最大值 | 0 | 限制组合框中编辑控件文本的最大长度 |
CB_RESETCONTENT | 0 | 0 | 清除所有列表项。 |
CB_SELECTSTRING | 开始表项序号 | 字符串地址 | 设定与指定字符串相匹配的列表项为选中项。本操作会滚动列表框以使选择项可见。参数的意义及搜索的方法与CB_FINDSTRING类似。如果找到了匹配的项,返回该项的索引,如果没有匹配的项,返回CB_ERR并且当前的选中项不被改变。 |
CB_SETCURSEL | 索引 | 0 | 设置指定的列表项为当前选择项。本操作会滚动列表框以使选择项可见。参数wParam指定了列表项的索引,若为-1,将清除列表框中的选择。若出错函数返回CB_ERR。 |
CB_SETDROPPEDWIDTH | 宽度(点) | 0 | 设定组合框中的列表框的最大允许宽度。 |
CB_SETEDITSEL | 0 | 范围 | 设置制组合框中编辑控件中文本选定内容范围,该范围被高亮度显示,用于为复制、替换、粘贴、剪切、删除等编辑功能指定范围。lParam的高16位为起点低16位为终点。 |
CB_SETEXTENDEDUI | TRUE或FALSE | 0 | 指定下拉式或下拉列表式组合框是使用默认界面或扩展界面。wParam为FALSE时使用默认界面:用“F4”键切换下拉列表框的打开和关闭而用向下方向键改变选择项。wParam为TRUE时使用扩展界面:禁止使用“F4”而使用向下方向键来打开下拉列表框。 |
CB_SETHORIZONTALEXTENT | 宽度(点) | 0 | 设定组合框中的列表框的宽度。 |
CB_SETITEMDATA | 索引 | 数据值 | 更新组合框中列表框指定列表项的32位附加数据。 |
CB_SETITEMHEIGHT | 索引 | 高度(点) | 指定组合框中列表项显示高度,带有CBS_OWNERDRAWVARIABLE(自绘列表项)风格的控件,只设置由wParam指定项的高度,其它风格将更新所有的列表项的高度。 |
CB_SETLOCALE | 语言代码 | 0 | 设置列表项当前用于排序的语言代码,当用户使用CB_ADDSTRING向组合框中的列表框中添加记录并使用CBS_SORT风格进行重新排序时,必须使用该语言代码。返回值中高16位为国家代码。 |
CB_SETTOPINDEX | 索引 | 0 | 用来将指定的列表项设置为列表框的第一个可见项,该函数会将列表框滚动到合适的位置。wParam指定了列表项的索引.若操作成功,返回0值,否则返回CB_ERR。 |
CB_SHOWDROPDOWN | TRUE或FALSE | 0 | 本操作用本显示或关闭下拉式和下拉列表式组合框的列表框,wParam为TRUE时为显示,FALSE时关闭。 |
uMsg | wParam | lParam | 说明 |
WM_COMPAREITEM | ---- | ---- | ---- |
WM_DRAWITEM | ---- | ---- | ---- |
WM_MEASUREITEM | ---- | ---- | ---- |
当用户在组合框上进行各种操作时,其父窗口将收到WM_COMMAND通知消息,同时wParam的低16位带控件的ID。lParam带控件句柄(hWnd),wParam的高16位带有如下表的消息代码。
消息代码 | 说明 |
CBN_CLOSEUP | 下拉的列表框将关闭。 |
CBN_DBLCLK | 简易式组合框的列表项被双击。 |
CBN_DROPDOWN | 下拉的列表框将打开。 |
CBN_EDITCHANGE | 组合框的编辑控件文本被更改。本消息是在文本被显示后发出的。 |
CBN_EDITUPDATE | 组合框的编辑控件文本被更改。本消息是在文本被显示前发出的。 |
CBN_ERRSPACE | 没有申请到足够内存空间。 |
CBN_KILLFOCUS | 组合框失去键盘输入焦点。 |
CBN_SELCHANGE | 改变当前选择项。 |
CBN_SELENDCANCEL | 用户取消当前的选择。当用户在列表框中选择了一项,然后又在组合框控件外单击鼠标时就会导致该消息的发送。 |
CBN_SELENDOK | 用户确认了自己所作的选择。当用户在列表框中选择了一项,然后按了回车键或单击了下滚箭头时就会发送该消息。 |
CBN_SETFOCUS | 组合框获得了键盘输入焦点。 |