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

列印頁面