Click here to Skip to main content
14,425,525 members

Showing progress bar in a status bar pane

Rate this:
4.88 (54 votes)
Please Sign up or sign in to vote.
4.88 (54 votes)
23 Aug 2010CPOL
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 CodeProject. He is also co-founder of Developer Media and ContentLab.IO. He's been programming since the 80's and has been, in various guides, an astrophysicist, bacyard mechanic, mathematician, physicist, breeder of carnivorous plants, hydrologist, geomorphologist, defence intelligence researcher and then, when all that got a bit rough on the nerves, a web developer.

His programming experience includes C/C++, C#, SQL, MFC, ASP.NET, TypeScript and far, far too much FORTRAN. He has worked on PocketPCs, Old mainframes, new Macs, cheap phones, and a CRAY YMP C90 behemoth but finds notebooks take up less desk space.

He is kind to small animals and has a soft spot for cheesecake.

Chris was born and bred in Australia but splits his time between Toronto and Melbourne, depending on the weather. For relaxation he is obsessively into road cycling, physiology, occasionally snowboarding and rock climbing, and wishes he were a storm chaser.

Comments and Discussions

 
QuestionWhy complicate ? Pin
Member 1116586715-May-16 13:54
MemberMember 1116586715-May-16 13:54 
AnswerRe: Why complicate ? Pin
Chris Maunder15-May-16 15:20
cofounderChris Maunder15-May-16 15:20 
QuestionProgress Bar in Web Application Pin
akjha1617-Sep-14 1:33
Memberakjha1617-Sep-14 1:33 
QuestionCan't extract the demo Pin
Ron Anders23-Jan-13 18:54
MemberRon Anders23-Jan-13 18:54 
QuestionCorrelating "range" with time? Pin
Vaclav_24-May-12 6:38
MemberVaclav_24-May-12 6:38 
QuestionAwesome Pin
Andy Bantly11-Mar-12 10:48
MemberAndy Bantly11-Mar-12 10:48 
QuestionIt doesn't work with SetCapture() Pin
Plamen Petrov29-Dec-11 22:10
professionalPlamen Petrov29-Dec-11 22:10 
GeneralMy vote of 5 Pin
Mei You Qian18-Aug-11 7:23
professionalMei You Qian18-Aug-11 7:23 
GeneralMy vote of 5 Pin
koothkeeper20-Apr-11 5:19
professionalkoothkeeper20-Apr-11 5:19 
GeneralMy vote of 5 Pin
wud97181d30-Dec-10 16:31
Memberwud97181d30-Dec-10 16:31 
GeneralAwesome! Pin
Ernest Laurentin28-Aug-10 11:51
MemberErnest Laurentin28-Aug-10 11:51 
GeneralDirectives/libraries Pin
wmedwardc21-Sep-09 21:42
Memberwmedwardc21-Sep-09 21:42 
QuestionVC6? Pin
basementman15-Jul-09 11:56
Memberbasementman15-Jul-09 11:56 
GeneralThanks! Pin
ccaprani4-Aug-08 10:01
Memberccaprani4-Aug-08 10:01 
GeneralThank you Pin
Sundevil2-Apr-08 9:30
MemberSundevil2-Apr-08 9:30 
GeneralI want to use your progress bar to my directx program Pin
akira3228-Jul-07 21:13
Memberakira3228-Jul-07 21:13 
GeneralThanks for showing me how to set the colour Pin
Owen Lawrence21-Mar-07 11:16
MemberOwen Lawrence21-Mar-07 11:16 
GeneralRe: Thanks for showing me how to set the colour Pin
chenjieming10-Jul-10 0:03
Memberchenjieming10-Jul-10 0:03 
NewsSerious bug! Pin
YoSilver4-Mar-07 6:06
MemberYoSilver4-Mar-07 6:06 
GeneralRe: Serious bug! Pin
Joseph Mccornell7-Feb-08 23:47
MemberJoseph Mccornell7-Feb-08 23:47 
GeneralRe: Serious bug! Pin
Damir Valiulin13-Jul-09 11:20
MemberDamir Valiulin13-Jul-09 11:20 
GeneralRe: Serious bug! Pin
Chris Maunder15-Jul-09 5:16
cofounderChris Maunder15-Jul-09 5:16 
GeneralRe: Serious bug! Pin
Damir Valiulin15-Jul-09 8:37
MemberDamir Valiulin15-Jul-09 8:37 
GeneralAbout InterAction Pin
wzh1983122110-Dec-06 16:37
Memberwzh1983122110-Dec-06 16:37 
Generalint GetSize() Pin
mimosa30-Apr-06 13:18
Membermimosa30-Apr-06 13:18 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Article
Posted 20 Nov 1999

Tagged as

Stats

504.7K views
14.1K downloads
191 bookmarked