XListBox - Owner-draw CListBox with selectable text and background colors

• Download demo project - 75.4 KB

Introduction

Listboxes are still useful for many things. I use them frequently when I need to log something. Usually, logging means flagging some exception or unusual event, so it is nice to be able to use colors to draw user's attention to these items.

Here is my CXListBox class. It is very simple to use, and can be used like a CListBox if you wish. Its power lies in its ability to display lines with text and background colors. Currently, the colors are limited to the 16 basic colors, because of the way the colors are stored.

Implementation

Briefly, here is the implementation: the listbox's style is set to ownerdraw fixed and has strings. Each string that is added to listbox is prefixed by two additional characters — one for text color and one for background color. When it is time to display string, CXListBox::DrawItem looks at these two color bytes to determine how to draw line. This approach is far simpler than allocating a memory block and stuffing the pointer using SetItemData(), although the tradeoff is that you are limited to 16 colors.

XListBox Features

The demo project provides a sample app that allows choice of text, text and background colors, and other options:

1. Enter text in edit box and click on Add String.
2. Text is displayed using combination of 16 text and background colors. XListBox is implemented using same color numbering as CColorPickerCB class — see ColorPickerCB.cpp.
3. You can optionally write listbox strings to log file. Note that strings are always appended to end of file, even when InsertString() is used.
4. The Line Number Options dialog allows you to choose whether to display line numbers, and colors for gutter background and line number text:

   

5. XListBox offers printf-style formatting combined with text and background color selection.
6. Optional right-click context menu — using IDR_XLISTBOX popup menu resource — allows for copying/clearing listbox.

How To Use

To integrate XListBox into your own app, you first need to add following files to your project:

• XListBox.cpp
• XListBox.h
• Clipboard.cpp
• Clipboard.h

IDR_XLISTBOX MENU DISCARDABLE 
BEGIN
    POPUP "XListBox"
    BEGIN
        MENUITEM "&Select All",   ID_EDIT_SELECT_ALL
        MENUITEM "&Copy",         ID_EDIT_COPY
        MENUITEM "C&lear",        ID_EDIT_CLEAR
    END
END

You will also need IDR_XLISTBOX popup menu resource (if you want context menu). You can add popup menu by calling SetContextMenuId() like this:

    m_List.SetContextMenuId(IDR_XLISTBOX);

Next, include header file XListBox.h in dialog's .h file, and create a CXListBox variable (easiest is to let Class WIzard generate a variable for CListBox object, then rename to CXListBox). See XListBoxTestDlg.h for example.

Here are some examples of how to display text with the CXListBox class, assuming you have variable named m_List:

• m_List.AddString(_T("This is a sample string"));

  This adds string to listbox with black text on a white background.

• m_List.AddLine(CXListBox::White, CXListBox::Red, _T("This is a sample string"));

  This adds string to listbox with white text on a red background.

• m_List.Printf(CXListBox::Blue, CXListBox::White, 0, _T("XListBox Version %d.%d"), nMajor, nMinor);

  This adds string to listbox with blue text on a white background, using printf formatting.

Revision History

Version 1.2 - 2008 February 24

• Fixed problems using XListBox with VS2005.
• Added demo project for VS2005.
• Changed InsertString() to accept colors (defaults to black on white).
• Changed AddLine(), AddString(), and Printf() to return index of line just added.
• Added functions GetBackgroundColor(), GetTextColor(), SetBackgroundColor(), and SetTextColor().
• Added option to display line numbers.
• Added option to log to file.

Version 1.0 - 2002 March 20

• Initial public release

Acknowledgments

The XListBox demo uses color picker combobox written by James R. Twine, which may be found here, and the CClipboard class written by David Terracino, which may be found here.

Usage

This software is released into the public domain. You are free to use it in any way you like, except that you may not sell this source code. If you modify it or extend it, please to consider posting new code here for everyone to share. This software is provided "as is" with no expressed or implied warranty. I accept no liability for any damage or loss of business that this software may cause.