Scrollable List of Buttons

Sample Image

Environment: VC6 SP2, NT4, Win95

This class allows you to create a scrollable list of buttons. It is
derived from Chris Maunder’s excellent
Grid Control
which appears here on the CodeGuru site. Note that users of this control
are bound by Chris’ copyright requirements detailed on his web page.

My application has a feature which allows a user
to define one or more “commands”. The commands become buttons whose numbers
can grow without limit.
My users prefer this scrollable list of buttons
over a combobox and “go” button implementation (often see on a Web sites) because:

  • It’s less clicking
  • They can see more than one command at a time

Don’t fret too much about using an entire grid implementation to do
something as trivial as a list of buttons. The grid’s executable
footprint is quite small. In addition, if you would like to change
fonts, change text colors, add an image to the button, etc. you can call
the appropriate grid functions to make this happen.

To Use


Get CGridCtrl Source. Create a new project in VC++. Create a new subdirectory within
the project folder named “GridCtrl”. Download the latest version of the
Grid Control and place all
source files within your new GridCtrl folder. Add these files to your VC++ project.

Add Button List Source. Download the button list
source files and add to the VC++ project.

Add the Button List Control to your Dialog. Use VC++ dialog editor to create
a custom control whose class name is: MFCGridCtrl.

Edit your Dialog Header File:


        #include "BtnListCtrl.h"
        ...

    // Dialog Data
        ...

        CBtnListCtrl m_BtnListCtrl;

Edit your Dialog Implementation File:


    // register the control per CGridCtrl requirements

        void CMyDlg::DoDataExchange(CDataExchange* pDX)
        {
            CDialog::DoDataExchange(pDX);
            //{{AFX_DATA_MAP(CMyDlg)
            //}}AFX_DATA_MAP
            ...
            DDX_GridControl(pDX, IDC_BTNLIST, m_BtnListCtrl);
        }


    // add message handling for button clicks

        BEGIN_MESSAGE_MAP(CMyDlg, CDialog)
            //{{AFX_MSG_MAP(CMyDlg)
            //}}AFX_MSG_MAP
            ...
            ON_NOTIFY(GVN_COLUMNCLICK, IDC_BTNLIST, OnBtnClick)
        END_MESSAGE_MAP()
        ...

        void CMyDlg::OnBtnClick( NMHDR* pNMHDR, LRESULT* pResult)
        {
            GV_DISPINFO *pgvDispInfo = (GV_DISPINFO *)pNMHDR;
            GV_ITEM     *pgvItem = &pgvDispInfo->item;

            if( pgvItem->row > -1 ) // -1 indicates clicked on control but not button
            {
                TRACE( "Clicked Btn Row=%i", pgvItem->row);
            }
            *pResult = 0;
        }

    // Initialize the button list class

        BOOL CMyDlg::OnInitDialog()
        {
            ...

            // TODO: Add extra initialization here
            m_BtnListCtrl.InitializeButtons();

            return TRUE;  // return TRUE  unless you set the focus to a control
        }

    // set the button labels anytime after initialization
        ...

        CStringArray StringArrayLabels;
        StringArrayLabels.Add( "Btn Label");
        m_BtnListCtrl.WriteButtonLabels( StringArrayLabels);

Downloads

Download demo project (includes exe and Grid source)- 109 Kb

Download source – 4 Kb

History

More by Author

Get the Free Newsletter!

Subscribe to Developer Insider for top news, trends & analysis

Must Read