CCheckListBox 類別

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

class CCheckListBox : public CListBox

Members

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

名稱	描述
CCheckListBox::Create	建立視窗清單方塊並將其附加至 CCheckListBox 物件。
CCheckListBox::DrawItem	呼叫框架，其在主控描繪清單方塊的視覺外觀變更。
CCheckListBox::Enable	啟用或停用清單方塊項目。
CCheckListBox::GetCheck	取得項目的核取方塊的狀態。
CCheckListBox::GetCheckStyle	取得控制項的核取方塊的樣式。
CCheckListBox::IsEnabled	判斷項目是否已啟用。
CCheckListBox::MeasureItem	呼叫框架，則會使用主控描繪模式來建立清單方塊。
CCheckListBox::OnGetCheckPosition	呼叫框架取得項目的核取方塊的位置。
CCheckListBox::SetCheck	設定項目的核取方塊的狀態。
CCheckListBox::SetCheckStyle	將控制項的核取方塊的樣式。

「清單方塊」顯示項目清單，例如檔案名稱。在清單中的每個項目都有一個核取方塊旁邊使用者核取或清除。

CCheckListBox 僅供主控描繪控制項，因為清單的文字字串包含更多。在最簡單，清單方塊會包含文字字串和核取方塊，不過，您完全不需要有文字。例如，您可以在每個項目旁邊有核取方塊的小型點陣圖清單。

若要建立您自己的清單方塊，您必須從 CCheckListBox衍生您的類別。若要衍生您的類別，提供衍生類別的建構函式，然後呼叫建立。

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

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

ON_告知(id， memberFxn)

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

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

afx_msgvoidmemberFxn**( );**

只有明確地與 CCheckListBox 的訊息對應項目 (，但是 CListBox也請參閱訊息對應 (Message Map) 輸入:

如果您的清單方塊是預設清單方塊 (使用預設大小] 核取方塊的字串清單中每個的左側)，您可以使用預設 CCheckListBox::DrawItem 繪製清單方塊。否則，您必須覆寫 CListBox::CompareItem 函式和 CCheckListBox::DrawItem 和 CCheckListBox::MeasureItem 函式。

您可以建立一個清單方塊從對話方塊範本或直接在您的程式碼。