共用方式為


CListBox 類別

提供視窗清單方塊的功能。

class CListBox : public CWnd

Members

y04ez4c9.collapse_all(zh-tw,VS.110).gif公用建構函式

名稱

描述

CListBox::CListBox

建構 CListBox 物件。

y04ez4c9.collapse_all(zh-tw,VS.110).gif公用方法

名稱

描述

CListBox::AddString

將字串加入至清單方塊。

CListBox::CharToItem

提供自訂 WM_CHAR 的覆寫處理沒有字串的主控描繪清單方塊。

CListBox::CompareItem

呼叫由架構判斷新項目的位置 (排序的主控描繪清單方塊。

CListBox::Create

建立視窗清單方塊並將其附加至 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

會在目前顯示,傳回清單方塊項目的週框 (Bounding Rectangle)。

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

設定清單方塊的定位停駐點 (Tab Stop) 位置。

CListBox::SetTopIndex

將第一個可見的字串之以零起始的索引在清單方塊中。

CListBox::VKeyToItem

提供自訂 WM_KEYDOWN 的覆寫處理為清單方塊。 LBS_WANTKEYBOARDINPUT 樣式集合。

備註

清單方塊會顯示項目清單,例如檔名,則使用者可以檢視並選取 。

在單一選取清單方塊,使用者只能選取一個項目。 在多重選取的清單方塊,項目範圍可選取。 當使用者選取某項目時,它會反白顯示,而清單方塊傳送通知訊息至父視窗。

您可以建立一個清單方塊從對話方塊範本或直接在您的程式碼。 直接建立它, CListBox 建構物件,然後呼叫 建立 成員函式建立視窗清單方塊控制項並將它附加至 CListBox 物件。 使用清單方塊中的 對話方塊樣板宣告,在您的對話方塊類別的清單方塊變數,然後使用 DDX_Control 在您的對話方塊類別的 DoDataExchange 函式連接成員變數加入至控制項。 (這會自動為您執行,當您將控制變數設定為您的對話方塊類別)。

語法結構可以是從 CListBox從衍生之類別中的程序。 提供衍生類別的建構函式和呼叫 建立 從建構函式中呼叫。

如果您要處理的視窗清單方塊所傳送的通知訊息給它的父 CDialog(通常是從衍生的類別),將訊息對應 (Message Map 輸入和訊息處理常式成員函式來為每則訊息的父類別。

每個訊息對應 (Message Map 輸入的格式如下:

ON_Notification( id, memberFxn )

其中 id 指定清單方塊傳送控制項的子視窗 ID 告知和 memberFxn 是您撰寫處理告知父代成員函式的名稱。

父的函式原型 (Prototype) 如下:

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 接收訊息。

  • 具有 LBS_WANTKEYBOARDINPUT 樣式的ON_WM_VKEYTOITEM A 清單方塊 WM_KEYDOWN 接收訊息。

如果您在對話方塊內的 CListBox 物件 (透過對話方塊資源),自動終結 CListBox 物件,在使用者關閉對話方塊時。

如果您在視窗內的 CListBox 物件,您可能需要 CListBox 終結物件。 如果您在堆疊上建立物件, CListBox 自動終結。 您可以使用 new 函式,建立。 CListBox 堆積中的物件,您必須呼叫物件上的 刪除 終結它,當使用者關閉父視窗時。

如果您在 CListBox 配置物件的任何記憶體,請覆寫 CListBox 解構函式處理組態。

繼承階層架構

CObject

CCmdTarget

CWnd

CListBox

需求

**標頭檔:**afxwin.h

請參閱

參考

CWnd 類別

階層架構圖

CWnd 類別

CButton 類別

CComboBox 類別

CEdit 類別

CScrollBar 類別

CStatic 類別

概念

MFC 範例 CTRLTEST