CListBox选件类

项目
03/01/2013

提供Windows的功能列表框。

class CListBox : public CWnd

成员

公共构造函数

名称	说明
CListBox::CListBox	构造 CListBox 对象。

公共方法

名称	说明
CListBox::AddString	添加一个字符串到列表框。
CListBox::CharToItem	提供自定义 WM_CHAR 的重写处理为所有者描述没有字符串的列表框。
CListBox::CompareItem	调用由框架确定新项目的位置在已排序的所有者描述列表框。
CListBox::Create	创建Windows列表框并将它附加到 CListBox 对象。
CListBox::DeleteItem	调用由框架，当用户从所有者描述中删除项列表框。
CListBox::DeleteString	从列表框删除字符串。
CListBox::Dir	添加文件名，驱动器或两个从当前目录到列表框。
CListBox::DrawItem	调用由结构，当所有者描述的可视方面是列表框更改。
CListBox::FindString	搜索在列表框中的字符串。
CListBox::FindStringExact	查找与指定字符串匹配的第一个列表框字符串。
CListBox::GetAnchorIndex	检索当前定位点项的从零开始的索引在列表框中。
CListBox::GetCaretIndex	确定具有焦点矩形在多个选择列表框项的索引。
CListBox::GetCount	返回字符串的数量在列表框中。
CListBox::GetCurSel	返回当前选定的字符串的从零开始的索引在列表框中。
CListBox::GetHorizontalExtent	返回在像素宽度列表框可以水平移动。
CListBox::GetItemData	返回一个32位值与列表框项。
CListBox::GetItemDataPtr	返回指向列表框项。
CListBox::GetItemHeight	确定高度列表框中的项。
CListBox::GetItemRect	它在当前显示，返回列表框项的边框。
CListBox::GetListBoxInfo	检索项的数目每列。
CListBox::GetLocale	检索列表框的区域设置标识符。
CListBox::GetSel	返回列表框项的选择状态。
CListBox::GetSelCount	返回在多个选择当前选择的字符串的数量列表框。
CListBox::GetSelItems	返回列表框当前选择的字符串的索引。
CListBox::GetText	将一个列表框项到缓冲区中。
CListBox::GetTextLen	在列表框项的字节数组返回长度。
CListBox::GetTopIndex	返回第一个可见字符串的索引在列表框中。
CListBox::InitStorage	预分配内存块为列表框项和字符串。
CListBox::InsertString	插入到特定位置的字符串列表框。
CListBox::ItemFromPoint	返回列表框项的索引最靠近点。
CListBox::MeasureItem	调用由结构，当所有者描述时列表框创建确定列表框维度。
CListBox::ResetContent	清除列表框的所有项。
CListBox::SelectString	搜索并选中单选的字符串列表框。
CListBox::SelItemRange	选择或取消选择字符串的大小在多个选择的列表框。
CListBox::SetAnchorIndex	设置在多个选定内容的定位点列表框启动一个扩展选择。
CListBox::SetCaretIndex	设置焦点矩形对项目在多重选择的指定索引列表框。
CListBox::SetColumnWidth	设置列宽的多列列表框。
CListBox::SetCurSel	选择列表框字符串。
CListBox::SetHorizontalExtent	将像素宽度列表框可以水平移动。
CListBox::SetItemData	将32位值与列表框项。
CListBox::SetItemDataPtr	设置指向列表框项。
CListBox::SetItemHeight	设置高度列表框中的项。
CListBox::SetLocale	设置列表框的区域设置标识符。
CListBox::SetSel	选择或取消选择在多个选择的列表框项列表框。
CListBox::SetTabStops	将列表框的制表位位置。
CListBox::SetTopIndex	将第一个可见字符串的从零开始的索引在列表框中。
CListBox::VKeyToItem	提供自定义 WM_KEYDOWN 的重写处理为设置了 LBS_WANTKEYBOARDINPUT 样式的列表框。

备注

列表框将显示项列表，例如文件名，用户可以查看并选择。

在单只选择列表框，用户可以选择一项。在多重选择列表框，项的大小可以选择。当用户选择某个项时，该控件将突出显示，而列表框发送通知消息到父窗口。

可以创建一个列表框从对话框模板或直接在代码。若要直接创建它，请构造 CListBox 对象，然后调用创建成员函数创建Windows列表框控件并将其附加到 CListBox 对象。若要使用列表框在对话框模板，请声明在对话框选件类的列表框变量，然后使用 DDX_Control 在对话框选件类的 DoDataExchange 功能将成员变量添加到控件中。（这对于自动执行，将控件添加到变量您的对话框选件类。）

构造。CListBox从派生的类可以选件一步过程。编写该派生类的构造函数和调用 Create 从构造函数内部。

如果希望处理Windows列表框发送的通知消息到其父(通常从 CDialog派生的选件类)中，添加一个消息映射项和消息处理程序成员函数为每个消息的父选件类。

每个消息映射项采用以下形式:

ON_Notification( id, memberFxn )

其中 id 指定发送列表框控件的子窗口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_VKEYTOITEM 具有 LBS_WANTKEYBOARDINPUT 样式的列表框接收 WM_KEYDOWN 消息。

如果要创建在对话框中的一 CListBox 对象(通过对话框资源)，自动销毁 CListBox 对象，当用户关闭对话框时。

如果在中创建的一 CListBox 对象，则可能需要销毁 CListBox 对象。如果在堆栈上创建 CListBox 对象，自动销毁它。使用 new 功能，如果要创建在堆的 CListBox 对象，则必须对对象的 delete 销毁它，当用户关闭父窗口时。

如果将在 CListBox 对象的任何内存，请重写 CListBox 析构函数进程分配。