Progress Cell for Grid Control.

• Download demo executable - 44 Kb
• Download source - 3.9 Kb
• Download sample project - 94.1 Kb

Introduction

For a recent project, I needed to monitor the progress of a variable number of long tasks. This could be from none to hundreds in the extreme case. After abandoning the idea of creating / hiding / destroying an army of actual progress controls, I hit on the idea of creating a cell type for Chris Maunder's grid control. I already knew how to use it from multiple projects. I knew it had the flexibility I needed, so it was just a case of rolling up my sleeves and writing a new CGridCell...

Using the code

Using the code should not be too tough. Just add the header to your CPP file:

#include "GridCellProgress.h"

and use the cell type as you would any other grid cell type.

    CGridCellProgress *pProg;
    for (int n = 0; n < 10; n++)
        m_Grid.SetCellType (n, 0, RUNTIME_CLASS(CGridCellProgress));

    pProg = (CGridCellProgress *)m_Grid.GetCell (0,0);
    pProg->SetText ("One");
    pProg->SetPos (0);

New Cell Methods

I like to think these new cell method names are pretty self explanatory. (Yes, I'm lazy.)

    virtual    BOOL    EnablePercentage (BOOL bEnable);
    virtual    BOOL    EnablePathCompaction (BOOL bEnable);

    virtual    void    SetRange(int nLower, int nUpper);
    virtual    void    SetLower(int nLower);
    virtual    void    SetUpper(int nUpper);
    virtual    void    SetPos    (int nPos);
    virtual void    SetColor(COLORREF clr);

    virtual    void    GetRange(int &nLower, int &nUpper);
    virtual    int    GetLower();
    virtual    int    GetUpper();
    virtual    int    GetPos    ();
    virtual COLORREF GetColor();

Notes

This was tested against v2.24 of the grid control, and includes that in the sample project. From the Grid Controls page, there is a v2.25 now available. There shouldn't be any difficulty with the new version. Similarly, I haven't tested this on ME, Win 2K3, Longhorn etc. I don't anticipate problems, but you never know! I've been caught out assuming before...

I have also used Color instead of spelling it properly as Colour. I find myself typing American for SDK functions etc, and properly for my own variables. As the new cell functions imitate those of CProgressCtrl, I thought I'd better imitate the spelling too.

Acknowledgements

There are two obvious people to thank:

• Chris Maunder for his excellent Grid control class, which I have used many times.
• Secondly, Keith Rule for his neat and tidy CMemDC class. While I haven't used it directly here, Chris does, and I have used it elsewhere to good effect.

History

• 2004 May 11th - First released into the wild.