Click here to Skip to main content
Click here to Skip to main content

Super Combo Box - combo-box with columns, colors and more

, 12 Apr 2004
Rate this:
Please Sign up or sign in to vote.
A CComboBox derived class that contains colors, columns, bold fonts, and images.

Sample Image - SuperComboBox.jpg

Motivation

I was looking around for a CComboBox derived class that would combine some features I needed - multiple columns, colors, icons and more.

Some of these features are found in other controls, but not under one roof, so I've decided to put them all together, in a simple way that will also have room for future growth.

Introduction

This class is a CComboBox derived class that enhances its functionalities:

  1. Multi-columns, when each column's width is controllable.
  2. An optional image-list can be supplied and an image can be set to the left of each row.
  3. Color of each row can be set.
  4. Each row can be bolded.

The code is based on Alex Hazanov's ComboBox Bold, just took it a bit further... thanks Alex.

Implementation

The WIN32/MFC implementation of a CComboBox provides DWORD element - Item Data, accessed via the SetItemData() and GetItemData() for storing extra information for each item of the combo-box. I used this member to store all the extra data I need to know of each row. This data is stored in the nested ItemData structure which is constructed for each element in the combo-box:

struct ItemData
{
    ItemData() : crTextColor(RGB(0,0,0)),nImageIndex(-1),bBold(FALSE),dwItemData(0){}
    COLORREF crTextColor;                // Row's color.
    int nImageIndex;                     // Index of the image in the image-list.
    std::map<int,CString> mapStrings;    // Map of string of all columns.
    BOOL bBold;                          // TRUE if the row is bolded.
    DWORD dwItemData;                    // Giving back the Item Data to the user...
};

All the new interface functions are added for setting the extra attributes of the combo-box by modifying the ItemData structure, and invalidating the combo-box.

For not loosing the original functionality of the CComboBox's SetItemData() and GetItemData(), the ItemData contains a DWORD member as well, that is accessed via the CComboBoxSuper.

A vector of all columns' width stores the width of all columns, and the size of this vector is also the number of columns in the combo-box.

Most of the job is done in the DrawItem function. This function is called for each item's drawing, and reads its item data, and draw the item accordingly.

Another function implemented is the virtual OnDeleteItem, which is called each time an element is removed from the combo-box, and deletes the ItemData of the element deleted from the combo-box, including ResetContent().

Usage

To use in a dialog - add a normal combo to the dialog, and replace the class from CComboBox to CComboBoxSuper.

Make sure to change the combo style to Owner Drawn Fixed and Has String in the resource editor, or by code.

To create on the fly - call create of the CComboBoxSuper object, and don't forget the styles.

Note: I always used the combo as a drop-list, in dropdown you get the first column's text only for editing.

During init function or all around the code, the following functions can be called:

  1. Setting to column number, and column width:

    void SetColumnCount(int nColumnCount); 
    /** Sets the number of columns to use - 
    new columns are inserted at default width. */
    
    void SetColumnWidth(int nColumnIndex, int nWidth); 
    /** Sets the width of a specific column. */
    m_ctrlSuperCombo.SetColumnCount(5);
    
    m_ctrlSuperCombo.SetColumnWidth(0, 100);
  2. Adding rows the combo (normal CComboBox function):

    m_ctrlSuperCombo.AddString("Row 1");
    m_ctrlSuperCombo.AddString("Row 2");
  3. Adding sub-item strings:

    void SetItemText(int nItemIndex, int nColumn, CString str); 
    /** Sets an item or sub-item text. */
    m_ctrlSuperCombo.SetItemText(1,1,"Yes");
    
    m_ctrlSuperCombo.SetItemText(2,1,"No");
  4. Setting a row color:

    void SetItemColor(int nItemIndex, COLORREF rcTextColor); 
    /** Sets a row's color. */
    m_ctrlSuperCombo.SetItemColor(1, RGB(255,0,0));
    
    m_ctrlSuperCombo.SetItemColor(2, RGB(0,128,0));
  5. Setting a row to bold (default is not bolded for all added rows):

    void SetItemBold(int nItemIndex, BOOL bBold = TRUE); 
    /** Set a specific row to bold. */
    m_ctrlSuperCombo.SetItemBold(2);
    
    m_ctrlSuperCombo.SetItemBold(1, FALSE);
  6. Setting images:

    void SetImageList(CImageList* pImageList); 
    /** Sets the image list to use - will be show 
    only if SetUseImage is called. */
    
    void SetItemImage(int nItemIndex, int nImageIndex); 
    /** Sets a row's image index. */
    
    void SetUseImage(BOOL bUseImage=TRUE) 
    /** Sets to TRUE for using the image list, 
    of FALSE to disable the use of the image-list. */
    m_ctrlSuperCombo.SetImageList(&m_ImageList);
    
    m_ctrlSuperCombo.SetUseImage();
    
    m_ctrlSuperCombo.SetItemImage(1, 1);

History

  • 20-03-2004 : Version 1.0 - First release.
  • 03-04-2004 : Change in documentations according to readers' requests.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

ronhash
Web Developer
United States United States
No Biography provided

Comments and Discussions

 
GeneralIt works (here is a method to auto adjust the column sizes and the dropdown width) Pinmemberg_d15-Sep-14 11:44 
QuestionGood, It is my favorite Pinmembermaplewang2-Aug-12 0:23 
SuggestionCode : Auto Size Implementation PinmemberRAJKUMARV23-Mar-12 3:13 
SuggestionAuto Sizing - Columns PinmemberRAJKUMARV15-Mar-12 21:04 
QuestionWhat finally made this work for me. Pinmemberbramoin9-Mar-12 11:48 
QuestionLicense? Pinmembercmconti13-Jul-11 8:22 
What license is this source released under?
QuestionCombo-box's dropdown button color? Pinmemberddas-edEN23-Jul-08 23:36 
QuestionDoes it work in a DLL? PinmemberVictor Monteverde9-Nov-07 9:18 
AnswerNevermind - WM_DRAWITEM PinmemberVictor Monteverde12-Nov-07 7:02 
GeneralDon't work in Vs 2005 PinmemberFilippoCSM6-Nov-07 2:31 
QuestionGetOrCreateItemData Bug [modified] Pinmemberforkit29-Oct-07 14:52 
GeneralErrors compiling with VS2005 PinmemberC++ Hacker2-May-07 22:44 
GeneralRe: Errors compiling with VS2005 Pinmemberforkit31-Oct-07 4:05 
GeneralRe: Errors compiling with VS2005 PinmemberC++ Hacker11-Nov-07 22:03 
Question.Net? PinmemberMember #247019224-Jan-07 5:17 
GeneralAdded functionality: disabled items Pinmemberpatrickp16-Jan-07 5:44 
GeneralRe: Added functionality: disabled items Pinmemberronhash29-Jan-07 9:11 
QuestionBackground color PinmemberTheIronFist12-Dec-06 10:33 
AnswerRe: Background color PinmemberTheIronFist29-Dec-06 1:15 
GeneralRe: Background color Pinmemberronhash29-Jan-07 9:13 
QuestionDrop-down button color Pinmemberddas-edEN23-Jul-08 23:34 
QuestionCombobox is 3 pixels bigger in height than normal? PinmemberFuzzychaos29-Oct-06 9:23 
AnswerRe: Combobox is 3 pixels bigger in height than normal? Pinmemberronhash29-Oct-06 15:16 
AnswerRe: Combobox is 3 pixels bigger in height than normal? PinmemberFuzzychaos30-Oct-06 15:13 
GeneralInital value shown in super combor box Pinmemberdoctorrie9-Apr-06 15:10 
GeneralRe: Inital value shown in super combor box Pinmemberronhash20-Apr-06 13:20 
QuestionCComboBoxEx compatibility ? Pinmembernaflat29-Sep-05 6:34 
AnswerRe: CComboBoxEx compatibility ? PinsussAnonymous2-Oct-05 1:24 
GeneralRe: CComboBoxEx compatibility ? Pinmembernaflat3-Oct-05 1:15 
GeneralGDI Leak Pinmembermsr.perfect18-Jul-05 22:42 
Generalnew version PinmemberJoerg Tiedemann10-Jun-05 7:36 
GeneralRe: new version Pinmemberronhash10-Jun-05 8:19 
GeneralRe: new version PinmemberJoerg Tiedemann14-Jun-05 1:58 
QuestiondwItemData - shouldn't it be DWORD_PTR? PinmemberFilther28-Jan-05 5:42 
GeneralBound Columns or select return to Edit PinmemberPatrickM17-Dec-04 10:44 
GeneralEditable columns PinmemberMalis23-Jul-04 9:33 
GeneralRe: Editable columns Pinmemberronhash28-Jul-04 10:25 
GeneralC# Pinmembercelsojp20-May-04 10:18 
GeneralGetOrCreateItemData should initialize ItemData struct! PinmemberThomas Haase23-Apr-04 0:16 
GeneralRe: GetOrCreateItemData should initialize ItemData struct! Pinmemberronhash24-Apr-04 11:42 
GeneralRe: GetOrCreateItemData should initialize ItemData struct! PinmemberThomas Haase25-Apr-04 22:39 
Generalwww.appspeed.com Pinmemberjedyking14-Apr-04 5:28 
GeneralWrong param at ImageList_Create PinmemberThomas Haase7-Apr-04 2:08 
GeneralQuestion related to Itemdata PinmemberAlbert Hermann30-Mar-04 0:59 
GeneralRe: Question related to Itemdata Pinmemberronhash30-Mar-04 1:03 
GeneralRe: Question related to Itemdata PinmemberAlbert Hermann30-Mar-04 3:24 
GeneralRe: Question related to Itemdata Pinmemberronhash30-Mar-04 6:36 
GeneralMinor problem with sample project... Pinmemberwhatisron28-Mar-04 6:16 
GeneralRe: Minor problem with sample project... Pinmemberronhash28-Mar-04 6:52 
GeneralWow! PinmemberBamaco220-Mar-04 10:03 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.141015.1 | Last Updated 13 Apr 2004
Article Copyright 2004 by ronhash
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid