A multi-check ListBox

 
Download Source Code and
Example project

I had a desire/requirement on a recent project to have a CCheckListbox class that allowed for
more than one checkbox in front of the string. The 3-state style set by the CCheckListbox
simply didn’t do what I wanted or needed. I had a list of people who could fall into 2 different
categories at the same time. The 3-state style told me that this person fell into one category,
but I had to just know WHICH one.

So, I decided to write a class that extended the capabilities of the CCheckListbox. What I
came up with was the CMultiCheckListBox class. What it does is add another checkbox
in front of the original checkbox in the CCheckListbox implementation.

To use the class, follow these steps:

• Add a member variable to the desired class (CDialog, CFormView, etc.)
  

   CMultiCheckListBox m_List; 
  

• Subclass the list box variable just created.
  

  
  
   void CCharityReportDlg::DoDataExchange(CDataExchange* pDX)
   {
      CDialog::DoDataExchange(pDX);
      //{{AFX_DATA_MAP(CCharityReportDlg)
      DDX_Control(pDX, IDC_LIST1, m_List);
      //}}AFX_DATA_MAP
   }
              
  

• To set the first checkbox for listbox item nIndex, call SetCheck(nIndex, nCheck)
  

   m_List.SetCheck(nIndex,1); 
  

• To set the second checkbox, call SetMultiCheck(nIndex, nCheck)
  

   m_List.SetMultiCheck(nIndex,1); 
  

• To retrieve the checkbox state of the first checkbox, call GetCheck(nIndex)
  

   m_List.GetCheck(nIndex); 
  

• To retrieve the checkbox state of the second checkbox, call GetMultiCheck(nIndex)
  

   m_List.MultiGetCheck(nIndex); 
  

Last updated: 4 July 1998