MFC - 列表框

一个列表框显示项目列表，例如用户可以查看和选择的文件名。列表框由CListBox 类表示。在单选列表框中，用户只能选择一个项目。在多选列表框中，可以选择一系列项目。当用户选择一个项目时，它会被高亮显示，并且列表框会向父窗口发送通知消息。

以下是 CListBox 类中的方法列表。

序号	名称及描述
1	AddString 向列表框添加字符串。
2	CharToItem 重写以提供自定义WM_CHAR处理，用于没有字符串的自绘列表框。
3	CompareItem 由框架调用以确定排序的自绘列表框中新项目的的位置。
4	Create 创建 Windows 列表框并将其附加到 CListBox 对象。
5	DeleteItem 当用户从自绘列表框中删除项目时，由框架调用。
6	DeleteString 从列表框中删除字符串。
7	Dir 将当前目录中的文件名、驱动器或两者都添加到列表框。
8	DrawItem 当自绘列表框的视觉外观发生变化时，由框架调用。
9	FindString 在列表框中搜索字符串。
10	FindStringExact 查找与指定字符串匹配的第一个列表框字符串。
11	GetAnchorIndex 检索列表框中当前锚定项目的零索引。
12	GetCaretIndex 确定在多选列表框中具有焦点矩形的项目的索引。
13	GetCount 返回列表框中的字符串数。
14	GetCurSel 返回列表框中当前所选字符串的零索引。
15	GetHorizontalExtent 返回列表框可以水平滚动到的宽度（以像素为单位）。
16	GetItemData 返回与列表框项目关联的 32 位值。
17	GetItemDataPtr 返回指向列表框项目的指针。
18	GetItemHeight 确定列表框中项目的的高度。
19	GetItemRect 返回列表框项目在其当前显示状态下的边界矩形。
20	GetListBoxInfo 检索每列的项目数。
21	GetLocale 检索列表框的区域设置标识符。
22	GetSel 返回列表框项目的选中状态。
23	GetSelCount 返回多选列表框中当前选中的字符串数。
24	GetSelItems 返回列表框中当前选中的字符串的索引。
25	GetText 将列表框项目复制到缓冲区。
26	GetTextLen 返回列表框项目的长度（以字节为单位）。
27	GetTopIndex 返回列表框中第一个可见字符串的索引。
28	InitStorage 为列表框项目和字符串预分配内存块。
29	InsertString 在列表框中的特定位置插入字符串。
30	ItemFromPoint 返回最接近某一点的列表框项目的索引。
31	MeasureItem 当创建自绘列表框以确定列表框尺寸时，由框架调用。
32	ResetContent 清除列表框中的所有条目。
33	SelectString 在单选列表框中搜索并选择字符串。
34	SelItemRange 在多选列表框中选择或取消选择一系列字符串。
35	SetAnchorIndex 将多选列表框中的锚点设置为开始扩展选择。
36	SetCaretIndex 将焦点矩形设置为多选列表框中指定索引处的项目。
37	SetColumnWidth 设置多列列表框的列宽。
38	SetCurSel 选择列表框字符串。
39	SetHorizontalExtent 设置列表框可以水平滚动到的宽度（以像素为单位）。
40	SetItemData 设置与列表框项目关联的 32 位值。
41	SetItemDataPtr 设置指向列表框项目的指针。
42	SetItemHeight 设置列表框中项目的的高度。
43	SetLocale 设置列表框的区域设置标识符。
44	SetSel 在多选列表框中选择或取消选择列表框项目。
45	SetTabStops 设置列表框中的制表位位置。
46	SetTopIndex 设置列表框中第一个可见字符串的零索引。
47	VKeyToItem 重写以提供自定义WM_KEYDOWN处理，用于设置了LBS_WANTKEYBOARDINPUT样式的列表框。

以下是列表框的一些映射条目 -

消息	映射条目	描述
LBN_DBLCLK	ON_LBN_DBLCLK( <id>, <memberFxn> )	当双击列表项时，框架会调用此成员函数。
LBN_KILLFOCUS	ON_LBN_KILLFOCUS( <id>, <memberFxn> )	在失去输入焦点之前，框架会立即调用此成员函数。
LBN_SELCHANGE	ON_LBN_SELCHANGE( <id>, <memberFxn> )	当选择发生更改时，框架会调用此成员函数。
LBN_SETFOCUS	ON_LBN_SETFOCUS( <id>, <memberFxn> )	在获得输入焦点后，框架会调用此成员函数。

让我们通过创建一个新的基于 MFC 对话框的应用程序来了解列表框的简单示例。

步骤 1 - 创建项目后，您将看到 TODO 行，它是文本控件的标题。删除标题并将其 ID 设置为 IDC_STATIC_TXT。

步骤 2 - 从工具箱中拖动列表框。

步骤 3 - 为文本控件添加控件变量。

步骤 4 - 为文本控件添加值变量。

步骤 5 - 为列表框控件添加控件变量。

步骤 6 - 为列表框控件添加事件处理程序。

步骤 7 - 从消息类型中选择 LBN_SELCHANGE，并为事件处理程序输入名称。

步骤 8 - 添加一个函数，该函数将加载列表框。

void CMFCListBoxDlg::LoadListBox() {
   CString str = _T("");
   for (int i = 0; i<10; i++) {

      str.Format(_T("Item %d"), i);
      m_listBox.AddString(str);
   }
}

步骤 9 - 从 CMFCListBoxDlg::OnInitDialog() 中调用该函数，如下面的代码所示。

BOOL CMFCListBoxDlg::OnInitDialog() {
   CDialogEx::OnInitDialog();

   // Set the icon for this dialog. The framework does this automatically
   // when the application's main window is not a dialog
   SetIcon(m_hIcon, TRUE);       // Set big icon
   SetIcon(m_hIcon, FALSE);      // Set small icon

   // TODO: Add extra initialization here
   LoadListBox();
   return TRUE; // return TRUE unless you set the focus to a control
}

步骤 10 - 这是事件处理程序的实现。这将显示列表框中当前选定的项目。

void CMFCListBoxDlg::OnLbnSelchangeList1() {
   // TODO: Add your control notification handler code here
   m_listBox.GetText(m_listBox.GetCurSel(),m_strItemSelected);
   UpdateData(FALSE);
}

步骤 11 - 编译并执行上述代码后，您将看到以下输出。

步骤 12 - 选择任何项目时，它将显示在文本控件上。

mfc_windows_controls.htm

打印页面