Category Listbox

• Download source files - 2 Kb
• Download demo project - 20 Kb

Without checkboxes. (Default)	With checkboxes.

Description

Categories have the following attributes:

• Are indicated in the list with a grey background.
• Category name must be unique. (They are case sensitive.)
• Can have 0 to N items under them.
• Have open/close buttons to show/hide their items.
• Can be opened/closed by double clicking them or by pressing the space bar.

Category items have the following attributes:

• Must be assigned to a category.
• Item name does not have to be unique.
• Can have a checkbox displayed next to it. (Microsoft Outlook does not have this feature.)
• Checkboxes can be checked/unchecked by clicking them or by pressing the space bar.
• Items can store DWORD data with them. (CListBox has this feature.)

Other supported features:

• Sorts categories and their items if the LBS_SORT style has been set.
• Supports selection modes Single, Multiple, Extended, and None.
• SHOULD support unicode. (I haven't verified this.)

Implementation

   AddString( LPCTSTR pString );
   InsertString( int iIndex, LPCTSTR pString );
   DeleteString( int iIndex );
   GetItemData( int iIndex );
   SetItemData( int iIndex, DWORD dwValue );

The category listbox class has been made as simple as possible to make it easy for you to add this control to your project. You only need to add the files "CatListBox.cpp" and "CatListBox.h" to your project. That's it! You do not have to add any images to your resource file because this class draws its buttons and checkboxes itself.

To add this control to your dialog, do the following:

1. Add a listbox to your dialog's resource.
   
2. Setup your listbox's resource for "Owner Draw: Fixed" and check "Has Strings".
   
   
   
   
3. Create a CCatListBox member variable in your dialog's code. For example...

      #include "CatListBox.h"
      class MyDialog : public CDialog
      {
         public:
         // Dialog Data
         //{{AFX_DATA( MyDialog )
         enum { IDD = IDD_MY_DIALOG };
         CCatListBox   m_lstCategories;        // Create your variable here.
         //}}AFX_DATA
      }
   
      // Subclass the listbox here.
      // Make sure to replace IDC_LISTBOX_ID with the one you're using.
      void MyDialog::DoDataExchange( CDataExchange* pDX )
      {
         CDialog::DoDataExchange( pDX );
         //{{AFX_DATA_MAP( MyDialog )
         DDX_Control( pDX, IDC_LISTBOX_ID, m_lstCategories );   // Subclass it!
         //}}AFX_DATA_MAP
      }
   

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)