CListBox 類別

發行項
02/28/2013

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

class CListBox : public CWnd

Members

公用建構函式

名稱	描述
CListBox::CListBox	建構 CListBox 物件。

公用方法

名稱	描述
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 接收訊息。