MFC - 列表控件

封装了列表视图控件的功能，该控件显示项目的集合，每个项目由一个图标（来自图像列表）和一个标签组成。它由CListCtrl类表示。列表控件包含使用四种视图之一来显示项目列表。

图标
小图标
列表
报表

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

序号	名称和描述
1	ApproximateViewRect 确定显示列表视图控件项目所需的宽度和高度。
2	Arrange 将项目对齐到网格上。
3	CancelEditLabel 取消项目文本编辑操作。
4	Create 创建列表控件并将其附加到 CListCtrl 对象。
5	CreateDragImage 为指定的项目创建拖动图像列表。
6	CreateEx 使用指定的 Windows 扩展样式创建列表控件并将其附加到 CListCtrl 对象。
7	DeleteAllItems 删除控件中的所有项目。
8	DeleteColumn 从列表视图控件中删除一列。
9	DeleteItem 从控件中删除一个项目。
10	DrawItem 当自绘控件的视觉外观发生变化时调用。
11	EditLabel 开始对项目的文本进行就地编辑。
12	EnableGroupView 启用或禁用列表视图控件中的项目是否显示为组。
13	EnsureVisible 确保项目可见。
14	FindItem 搜索具有指定特性的列表视图项目。
15	GetBkColor 检索列表视图控件的背景颜色。
16	GetBkImage 检索列表视图控件当前的背景图像。
17	GetCheck 检索与项目关联的状态图像的当前显示状态。
18	GetColumn 检索控件列的属性。
19	GetColumnOrderArray 检索列表视图控件的列顺序（从左到右）。
20	GetColumnWidth 检索报表视图或列表视图中列的宽度。
21	GetCountPerPage 计算列表视图控件中可以垂直容纳的项目数量。
22	GetEditControl 检索用于编辑项目文本的编辑控件的句柄。
23	GetEmptyText 检索如果当前列表视图控件为空则要显示的字符串。
24	GetExtendedStyle 检索列表视图控件的当前扩展样式。
25	GetFirstSelectedItemPosition 检索列表视图控件中第一个选定列表视图项目的位置。
26	GetFocusedGroup 检索当前列表视图控件中具有键盘焦点的组。
27	GetGroupCount 检索当前列表视图控件中的组数。
28	GetGroupInfo 获取列表视图控件指定组的信息。
29	GetGroupInfoByIndex 检索当前列表视图控件中指定组的信息。
30	GetGroupMetrics 检索组的度量。
31	GetGroupRect 检索当前列表视图控件中指定组的边界矩形。
32	GetGroupState 检索当前列表视图控件中指定组的状态。
33	GetHeaderCtrl 检索列表视图控件的标题控件。
34	GetHotCursor 检索在为列表视图控件启用热跟踪时使用的光标。
35	GetHotItem 检索当前位于光标下的列表视图项目。
36	GetHoverTime 检索列表视图控件的当前悬停时间
37	GetImageList 检索用于绘制列表视图项目的图像列表的句柄。
38	GetInsertMark 检索插入标记的当前位置。
39	GetInsertMarkColor 检索插入标记的当前颜色。
40	GetInsertMarkRect 检索包含插入点的矩形。
41	GetItem 检索列表视图项目的属性。
42	GetItemCount 检索列表视图控件中的项目数。
43	GetItemData 检索与项目关联的应用程序特定值。
44	GetItemIndexRect 检索当前列表视图控件中子项目所有部分或部分的边界矩形。
45	GetItemPosition 检索列表视图项目的位置。
46	GetItemRect 检索项目的边界矩形。
47	GetItemSpacing 计算当前列表视图控件中项目之间的间距。
48	GetItemState 检索列表视图项目的状态。
49	GetItemText 检索列表视图项目或子项目的文本。
50	GetNextItem 搜索具有指定属性并与给定项目具有指定关系的列表视图项目。
51	GetNextItemIndex 检索当前列表视图控件中具有指定属性集的项目的索引。
52	GetNextSelectedItem 检索列表视图项目位置的索引，以及用于迭代的下一个选定列表视图项目的位置。
53	GetNumberOfWorkAreas 检索列表视图控件的当前工作区数。
54	GetOrigin 检索列表视图控件的当前视图原点。
55	GetOutlineColor 检索列表视图控件边框的颜色。
56	GetSelectedColumn 检索列表控件中当前选定列的索引。
57	GetSelectedCount 检索列表视图控件中选定项目的数量。
58	GetSelectionMark 检索列表视图控件的选择标记。
59	GetStringWidth 确定显示给定字符串所需的最小编列宽度。
60	GetSubItemRect 检索列表视图控件中项目的边界矩形。
61	GetTextBkColor 检索列表视图控件的文本背景颜色。
62	GetTextColor 检索列表视图控件的文本颜色。
63	GetTileInfo 检索列表视图控件中图块的信息。
64	GetTileViewInfo 检索图块视图中列表视图控件的信息。
65	GetToolTips 检索列表视图控件用于显示工具提示的工具提示控件。
66	GetTopIndex 检索最顶层可见项目的索引。
48	GetView 获取列表视图控件的视图。
67	GetViewRect 检索列表视图控件中所有项目的边界矩形。
68	GetWorkAreas 检索列表视图控件的当前工作区。
69	HasGroup 确定列表视图控件是否具有指定的组。
70	HitTest 确定哪个列表视图项目位于指定位置。
71	InsertColumn 在列表视图控件中插入新列。
72	InsertGroup 将组插入列表视图控件。
73	InsertGroupSorted 将指定的组插入已排序的组列表。
74	InsertItem 在列表视图控件中插入新项目。
75	InsertMarkHitTest 检索最接近指定点的插入点。
76	IsGroupViewEnabled 确定是否为列表视图控件启用了组视图。
77	IsItemVisible 指示当前列表视图控件中指定的项目是否可见。
78	MapIDToIndex 将当前列表视图控件中项目的唯一 ID 映射到索引。
79	MapIndexToID 将当前列表视图控件中项目的索引映射到唯一 ID。
80	MoveGroup 移动指定的组。
81	MoveItemToGroup 将指定的组移动到列表视图控件的指定零基索引。
82	RedrawItems 强制列表视图控件重新绘制一系列项目。
83	RemoveAllGroups 从列表视图控件中删除所有组。
84	RemoveGroup 从列表视图控件中删除指定的组。
85	Scroll 滚动列表视图控件的内容。
86	SetBkColor 设置列表视图控件的背景颜色。
87	SetBkImage 设置列表视图控件的当前背景图像。
88	SetCallbackMask 设置列表视图控件的回调掩码。
89	SetCheck 设置与项目关联的状态图像的当前显示状态。
90	SetColumn 设置列表视图列的属性。
91	SetColumnOrderArray 设置列表视图控件的列顺序（从左到右）。
92	SetColumnWidth 更改报表视图或列表视图中列的宽度。
93	SetExtendedStyle 设置列表视图控件的当前扩展样式。
94	SetGroupInfo 设置列表视图控件指定组的信息。
95	SetGroupMetrics 设置列表视图控件的组度量。
96	SetHotCursor 设置在为列表视图控件启用热跟踪时使用的光标。
97	SetHotItem 设置列表视图控件的当前热点项。
98	SetHoverTime 设置列表视图控件的当前悬停时间。
99	SetIconSpacing 设置列表视图控件中图标之间的间距。
100	SetImageList 将图像列表分配给列表视图控件。
101	SetInfoTip 设置工具提示文本。
102	SetInsertMark 将插入点设置为定义的位置。
103	SetInsertMarkColor 设置插入点的颜色。
104	SetItem 设置列表视图项的一些或全部属性。
105	SetItemCount 准备列表视图控件以添加大量项。
106	SetItemCountEx 设置虚拟列表视图控件的项计数。
107	SetItemData 设置项的应用程序特定值。
108	SetItemIndexState 设置当前列表视图控件中项的状态。
109	SetItemPosition 将项目移动到列表视图控件中的指定位置。
110	SetItemState 更改列表视图控件中项的状态。
111	SetOutlineColor 设置列表视图控件边框的颜色。
112	SetSelectedColumn 设置列表视图控件的选中列。
113	SetSelectionMark 设置列表视图控件的选择标记。
114	SetTextBkColor 设置列表视图控件中文本的背景颜色。
115	SetTextColor 设置列表视图控件的文本颜色。
116	SetTileInfo 设置列表视图控件图块的信息。
117	SetTileViewInfo 设置列表视图控件在平铺视图中使用的信息。
118	SetToolTips 设置列表视图控件将用于显示工具提示的工具提示控件。
119	SetView 设置列表视图控件的视图。
120	SetWorkAreas 设置列表视图控件中可以显示图标的区域。
121	SortGroups 使用用户定义函数对列表视图控件的组进行排序。
122	SortItems 使用应用程序定义的比较函数对列表视图项进行排序。
123	SortItemsEx 使用应用程序定义的比较函数对列表视图项进行排序。
124	SubItemHitTest 确定哪个列表视图项（如果有）位于给定位置。
125	Update 强制控件重新绘制指定的项。
126	SetItemText 更改列表视图项或子项的文本。
127	GetCallbackMask 检索列表视图控件的回调掩码。

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

步骤 1 - 删除 TODO 行并拖动一个列表控件。

步骤 2 - 在“属性”窗口中，您将在“视图”下拉列表中看到不同的选项。

步骤 3 - 从“视图”字段中选择“报表”。

步骤 4 - 为列表控件添加控制变量 m_listCtrl。

步骤 5 - 在 OnInitDialog() 中初始化列表控件。

BOOL CMFCListControlDlg::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
   // Ask Mfc to create/insert a column
   m_listCtrl.InsertColumn( 
      0,              // Rank/order of item 
      L"ID",          // Caption for this header 
      LVCFMT_LEFT,    // Relative position of items under header 
      100);           // Width of items under header
		
   m_listCtrl.InsertColumn(1, L"Name", LVCFMT_CENTER, 80);
   m_listCtrl.InsertColumn(2, L"Age", LVCFMT_LEFT, 100);
   m_listCtrl.InsertColumn(3, L"Address", LVCFMT_LEFT, 80);
   
   int nItem;

   nItem = m_listCtrl.InsertItem(0, L"1");
   m_listCtrl.SetItemText(nItem, 1, L"Mark");
   m_listCtrl.SetItemText(nItem, 2, L"45");
   m_listCtrl.SetItemText(nItem, 3, L"Address 1");
   
   nItem = m_listCtrl.InsertItem(0, L"2");
   m_listCtrl.SetItemText(nItem, 1, L"Allan");
   m_listCtrl.SetItemText(nItem, 2, L"29");
   m_listCtrl.SetItemText(nItem, 3, L"Address 2");

   nItem = m_listCtrl.InsertItem(0, L"3");
   m_listCtrl.SetItemText(nItem, 1, L"Ajay");
   m_listCtrl.SetItemText(nItem, 2, L"37");
   m_listCtrl.SetItemText(nItem, 3, L"Address 3");

   return TRUE; // return TRUE unless you set the focus to a control
}

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

mfc_windows_controls.htm

打印页面