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

列印頁面