CListBox选件类

提供Windows的功能列表框。

class CListBox : public CWnd

成员

y04ez4c9.collapse_all(zh-cn,VS.110).gif公共构造函数

名称

说明

CListBox::CListBox

构造 CListBox 对象。

y04ez4c9.collapse_all(zh-cn,VS.110).gif公共方法

名称

说明

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 析构函数进程分配。

继承层次结构

CObject

CCmdTarget

CWnd

CListBox

要求

**标头:**afxwin.h

请参见

参考

CWnd 类

层次结构图

CWnd 类

CButton选件类

CComboBox选件类

CEdit选件类

CScrollBar选件类

CStatic选件类

概念

MFC示例CTRLTEST