CListBox

CObject
 └CCmdTarget
    └CWnd
       └CListBox

CListBox类提供Windows列表框的功能。列表框显示项的列表，如用户可以见到和选择的文件名称。
在单选列表框里，用户只可选择一个项。在多选列表框里，可选择许多项。当用户选择某项时，其高亮显示且列表框给父窗口发送一个通知消息。
可从对话模板或直接在你的代码中创建列表框。直接创建时，构造CListBox对象，再调用Create成员函数创建Windows列表框控件并将其附加给CListBox对象。要在对话模板中使用列表框，可在对话框类中声明一个CListbox 变量，再在对话框类的DoDataExchange中使用DDX_Control连接成员变量到此控件(当向对话框类中添加控件变量时，ClassWizard自动为你实现）。
构造函数可以是从CListBox派生的类的一个单步进程。为派生类写构造函数并从中调用Create。
如果要处理由列表框发送到其父亲（通常为从CDialog派生的类）的Windows通知消息，为每个消息添加消息映射入口和消息处理成员函数到父类。
每个消息映射入口有以下形式：
ON_Notification( id，memberFxn )
id 指定发送通知的列表框控件的子窗口，memberFxn 是编写处理通知的父成员函数名的地方。
父函数原型如下：
afx_msg void memberFxn( );
下面是可能的消息映射入口列表和描述它们可能被发送到父亲的情况：
ON_LBN_DBLCLK用户双击列表框中的字符串。只有LBS_NOTIFY风格的列表框才会发送此通知消息。
ON_LBN_ERRSPACE列表框不能重新分配足够的内存来满足请求。
ON_LBN_KILLFOCUS列表框正失去输入焦点。
ON_LBN_SELCANCEL当前列表框选择被取消。此消息只有在列表框是LBS_NOTIFY风格时才发送。
ON_LBN_SELCHANGE列表框中的选择可能改变。如果选择被CListBox::SetCurSel成员函数改变，则通知不发送。此通知只适用于LBS_NOTIFY风格的列表框。无论何时用户按下箭头键，即使选择未改变，LBN_SELCHANGE通知消息都被发送给多选列表框。
ON_LBN_SETFOCUS列表框正在接收输入焦点。
ON_WM_CHARTOITEM一个无字符串的自绘制列表接受WM_CHAR消息。
ON_WM_VKEYTOITEMLBS_WANTKEYBOARDINPUT风格的列表框接受WM_KEYDOWN消息。
如果在对话框中构造一个CListBox对象（通过对话资源），当用户关闭对话框时，CListBox对象自动毁弃。
如果在窗口中构造一个CListBox对象，可能需要毁弃CListBox对象。如果在栈上创建CListBox对象，它会自动毁弃。如果使用new函数在堆上创建CListBox对象，必须对此对象调用delete来在用户关闭父窗口时毁弃它。
如果在CListBox对象中分配内存，可覆盖CListBox析构程序释放分配的内存。
#include <afxwin.h>
请参阅：CWnd, CButton, CComboBox, CEdit, CScrollBar, CStatic


CListBox类的成员

构造函数
CListBox构造一个CListBox对象

初始化
Create创建Windows列表框并附加给CListBox对象
InitStorage为列表框的项和字符串预分配内存块

一般操作
GetCount返回列表框中的字符串数目
GetHorizontalExtent返回列表框的水平宽度，用像素表示
SetHorizontalExtent设置列表框的水平宽度，用像素表示
GetTopIndex返回列表框中第一个可见字符串的索引
SetTopIndex设置列表框中第一个可见字符串的基于零的索引
GetItemData返回与列表框有关的32位值
GetItemDataPtr返回指向列表框的指针
SetItemData设置列表框有关的32位值
SetItemDataPtr设置指向列表框的指针
GetItemRect返回当前显示的列表框项的相应矩形
ItemFromPoint返回与某点最近的列表框项的索引
SetItemHeight设置列表框中项的高度
GetItemHeight确定列表框中项的高度
GetSel返回列表框某项的选择
GetText拷贝某列表框项到缓冲区
GetTextLen返回列表框的字节长
SetColumnWidth设置多列列表框的列宽
SetTabStops设置列表框制表键停止位置
GetLocale获取列表框的地点标识符
SetLocale设置列表框的地点标识符

单选操作
GetCurSel返回列表框中当前选择串的基于零的索引
SetCurSel选择一个列表框字符串

多选操作
SetSel在多选列表框中选择或不选某个列表框项
GetCaretIndex确定在多选列表框中有焦点矩形的项的索引
SetCaretIndex设置焦点矩形到多选列表框中的指定的索引项
GetSelCount返回多选列表框中当前选择的字符串的数目
GetSelItems返回列表框中当前选择的字符串的索引
SelItemRange选择/不选多选列表框中的一些字符串
SetAnchorIndex设置多选列表框的锚点以开始扩展选择
GetAnchorIndex获取列表框当前锚点项的基于零的索引

字符串操作
AddString添加一个字符串到列表框中
DeleteString从列表框中删除一个字符串
InsertString在列表框中指定位置插入一个字符串
ResetContent清空列表框所有入口
Dir从当前目录添加文件名称到列表框中
FindString在列表框中查找一个字符串
FindStringExact查找与指定的字符串匹配的第一个列表框字符串
SelectString查找并选择单选列表框中的一个字符串

可覆盖的函数
DrawItem当自绘制列表框的一个可视部分改变时，被框架调用
MeasureItem当自绘制列表框创建时，被框架调用来确定列表框维数
CompareItem被框架调用以确定一系列列表框中某新项的位置
DeleteItem当用户从自绘制列表框中删除某项时，被框架调用
VKeyToItem覆盖以提供LBS_WANTKEYBOARDINPUT风格列表框的设置所需的定制WM_KEYDOWN
CharToItem覆盖以提供不含字符串的自绘制列表框定制WM_CHAR