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

Showing progress bar in a status bar pane

, 23 Aug 2010 CPOL
Rate this:
Please Sign up or sign in to vote.
An easy way to add a progress control to a status bar

Sample Image

Adding a CProgressCtrl to the status bar has already been addressed by Brad Mann. His method involved modifying the status bar and messing around with the resource editor. I developed a separate CProgressBar class in order to allow the programmer to just drop in a progress bar whereever they wanted using a single "CProgressBar Bar(...)" declaration, which would initialise and display itself and clean up after itself after it was done. The progress bar can also be created once (say as a member variable) and reused multiple times. This new version of the progress bar also resizes itself if the status bar size changes.

The progress bar lets you specify a message (displayed to the left of the bar) and a Progress Control bar in the any pane of your applications status bar (if it has one - thanks to Patty You for a bug fix on that one). The message for the progress bar can be changed at any time, as can the size and range of the bar.

Construction

CProgressBar(); 
CProgressBar(LPCTSTR strMessage, int nSize=100, int MaxValue=100, BOOL bSmooth=FALSE, int nPane=0);
BOOL Create(LPCTSTR strMessage, int nSize=100, int MaxValue=100, BOOL bSmooth=FALSE, int nPane=0);

Construction is either via the constructor or a two-step process using the constructor and the "Create" function. "strMessage" is the message to be displayed, "nSize" is the percentage width of the status bar that will be occupied by the bar (including the text), and "MaxValue" is the maximum range of the bar.

"bSmooth" will only be effective if you have the header files and commctrl32.dll from IE 3.0 or above (no problems for MS VC 5.0). It specifies whether the progress bar will be smooth or chunky.

Operations

    BOOL Success()                      // Construction successful?

    COLORREF SetBarColour(COLORREF clrBar);  // Set Bar colour, returns previous
    COLORREF SetBkColour(COLORREF clrBar);   // Set background colour, returns previous

    int  SetPos(int nPos);              // Same as CProgressCtrl
    int  OffsetPos(int nPos);           // Same as CProgressCtrl
    int  SetStep(int nStep);            // Same as CProgressCtrl
    int  StepIt();                      // Same as CProgressCtrl
    void Clear();                       // Clear the status bar
    void SetRange(int nLower, int nUpper, int nStep = 1);
                                        // Set min, max and step size
    void SetText(LPCTSTR strMessage);   // Set the message
    void SetSize(int nSize);            // Set the bar size

To use the bar, just do something like:

    CProgressBar Bar("Testing", 40, 1000);
    
    for (int i = 0;  i <  1000; i++) 
    {
        // perform operation
        Bar.StepIt();
    }
or it can be done two stage as:
    CProgressBar bar;
    
    bar.Create("Processing", 40, 1000);
    for (int i = 0; i < 1000; i++) 
    { 
        //    perform operation 
        bar.StepIt();
    } 
    bar.SetText("Writing"); 
    for  (int i = 0;  i <  1000; i++) 
    {
        // perform operation
        bar.StepIt();
        PeekAndPump();    // Message pump
    }
    bar.Clear();

In the above case, PeekAndPump() is a function which simply peeks and pumps messages, allowing user interaction with the window during a lengthy process. If the window size changes during the processing, the progress bar size will alsow change.

This article was updated by Michael Martin (allowing the progress bar can now be placed in any pane of the status bar). A further update by YoSilver has fixed an issue that occurs in multithreaded apps. Yet Another Update by Alex Paterson allows you to specify which statusbar you wish the bar to appear in.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Chris Maunder
Founder CodeProject
Canada Canada
Chris is the Co-founder, Administrator, Architect, Chief Editor and Shameless Hack who wrote and runs The Code Project. He's been programming since 1988 while pretending to be, in various guises, an astrophysicist, mathematician, physicist, hydrologist, geomorphologist, defence intelligence researcher and then, when all that got a bit rough on the nerves, a web developer. He is a Microsoft Visual C++ MVP both globally and for Canada locally.
 
His programming experience includes C/C++, C#, SQL, MFC, ASP, ASP.NET, and far, far too much FORTRAN. He has worked on PocketPCs, AIX mainframes, Sun workstations, and a CRAY YMP C90 behemoth but finds notebooks take up less desk space.
 
He dodges, he weaves, and he never gets enough sleep. He is kind to small animals.
 
Chris was born and bred in Australia but splits his time between Toronto and Melbourne, depending on the weather. For relaxation he is into road cycling, snowboarding, rock climbing, and storm chasing.
Follow on   Twitter   Google+   LinkedIn

Comments and Discussions

 
QuestionProgress Bar in Web Application Pinmemberakjha1617-Sep-14 1:33 
QuestionCan't extract the demo PinmemberRon Anders23-Jan-13 18:54 
QuestionCorrelating "range" with time? PinmemberVaclav_Sal24-May-12 6:38 
QuestionAwesome PinmemberAndy Bantly11-Mar-12 10:48 
QuestionIt doesn't work with SetCapture() PinmemberPlamen Petrov29-Dec-11 22:10 
GeneralMy vote of 5 PinmemberMei You Qian18-Aug-11 7:23 
GeneralMy vote of 5 Pinmemberkoothkeeper20-Apr-11 5:19 
GeneralMy vote of 5 Pinmemberwud97181d30-Dec-10 16:31 
GeneralAwesome! PinmemberErnest Laurentin28-Aug-10 11:51 
GeneralDirectives/libraries Pinmemberwmedwardc21-Sep-09 21:42 
QuestionVC6? Pinmemberbasementman15-Jul-09 11:56 
GeneralThanks! Pinmemberccaprani4-Aug-08 10:01 
GeneralThank you PinmemberMember 30926882-Apr-08 9:30 
GeneralI want to use your progress bar to my directx program Pinmemberakira3228-Jul-07 21:13 
GeneralThanks for showing me how to set the colour PinmemberOwen Lawrence21-Mar-07 11:16 
GeneralRe: Thanks for showing me how to set the colour Pinmemberchenjieming10-Jul-10 0:03 
NewsSerious bug! PinmemberYoSilver4-Mar-07 6:06 
GeneralRe: Serious bug! PinmemberJoseph Mccornell7-Feb-08 23:47 
GeneralRe: Serious bug! PinmemberDamir Valiulin13-Jul-09 11:20 
GeneralRe: Serious bug! PinadminChris Maunder15-Jul-09 5:16 
GeneralRe: Serious bug! PinmemberDamir Valiulin15-Jul-09 8:37 
GeneralAbout InterAction Pinmemberwzh1983122110-Dec-06 16:37 
Generalint GetSize() Pinmembermimosa30-Apr-06 13:18 
QuestionAdding snake feature to the control ? Pinmemberjongallegraud19-Mar-06 23:03 
GeneralDoesn't seem to work for dialog status bar PinmemberTobyNorris2-Feb-06 5:56 

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 | Terms of Use | Mobile
Web03 | 2.8.141223.1 | Last Updated 23 Aug 2010
Article Copyright 1999 by Chris Maunder
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid