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.

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