Click here to Skip to main content
11,412,833 members (75,301 online)
Click here to Skip to main content

A Popup Progress Window

, 21 Apr 2002 CPOL
Rate this:
Please Sign up or sign in to vote.
A popup window containing a progress control and cancel button - no resource file needed

Sample Image

Introduction

There are many occasions where it's nice to have a popup window that shows the progress of a lengthy operation. Incorporating a dialog resource with a progress control and cancel button, then linking up the control messages for every project you wish to have the progress window can get monotonous and messy.

The class CProgressWnd is a simple drop in window that contains a progress control, a cancel button and a text area for messages. The text area can display 4 lines of text as default, although this can be changed using CProgressWnd::SetWindowSize() (below)

Construction

    CProgressWnd(); 
    CProgressWnd(CWnd* pParent, LPCTSTR strTitle, BOOL bSmooth=FALSE);
    BOOL Create(CWnd* pParent, LPCTSTR strTitle, BOOL bSmooth=FALSE);

Construction is either via the constructor or a two-step process using the constructor and the Create function. pParent is the parent of the progress window,strTitle is the window caption title. 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 GoModal(LPCTSTR strTitle = _T("Progress"), BOOL bSmooth=FALSE); 
                                        // Make window modal

    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 SetRange(int nLower, int nUpper, int nStep = 1);
                                        // Set min, max and step size

    void Hide();                        // Hide the window
    void Show();                        // Show the window
    void Clear();                       // Clear the text and reset the 
                                        // progress bar
    void SetText(LPCTSTR fmt, ...);     // Set the text in the text area

    BOOL Cancelled()                    // Has the cancel button been pressed?

    void SetWindowSize(int nNumTextLines, int nWindowWidth = 390);
                                        // Sets the size of the window 
                                        // according to the number of text 
                                        // lines specifed and the
                                        // desired window size in pixels.

    void PeekAndPump(BOOL bCancelOnESCkey = TRUE);  
                                        // Message pumping, with options of
                                        // allowing Cancel on ESC key.  

The PeekAndPump function allows messages to be pumped during long operations. The first parameter allows the window to be cancelled by pressing the ESC key.

You can also make the window modal by creating the window and calling GoModal(). This will disable the main window, and re-enable the main window when this window is destroyed. See the demo app for example code.

The window will also store and restore its position to and from the registry between incantations.

To use the window, just do something like:

    CProgressWnd wndProgress(this, "Progress");

    // wndProgress.GoModal(); // Call this if you want a modal window
    wndProgress.SetRange(0,5000);
    wndProgress.SetText("Processing...");         

    for (int i = 0; i < 5000; i++) {
        wndProgress.StepIt();
        wndProgress.PeekAndPump();

        if (wndProgress.Cancelled()) {
            MessageBox("Progress Cancelled");
            break;
        }
    }    

or it can be done two stage as:

    CProgressWnd wndProgress;
    
    if (!wndProgress.Create(this, "Progress"))
        return;

    wndProgress.SetRange(0,5000);
    wndProgress.SetText("Processing...");         

History

  • 13 Apr 2002 - added SaveSettings call to OnCancel. Updated project for VC.NET.
  • 22 Apr 2002 - minor mods by Luke Gabello

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

 
Questionquestion Pin
kcpnevergiveup at 15-Apr-13 17:21
memberkcpnevergiveup15-Apr-13 17:21 
i'm curious why this program can not be used in VS2008
AnswerRe: question Pin
kcpnevergiveup at 15-Apr-13 18:01
memberkcpnevergiveup15-Apr-13 18:01 
GeneralThis is really cool.... Pin
Rangarajan Varadan at 8-Apr-09 7:52
memberRangarajan Varadan8-Apr-09 7:52 
Generalthanks Pin
Dirk Higbee at 2-Sep-08 4:17
memberDirk Higbee2-Sep-08 4:17 
QuestionProgress bar frozen Pin
Solange2008 at 31-Aug-08 13:05
memberSolange200831-Aug-08 13:05 
QuestionCrash in CProgressWnd::Create() in VS2008 Pin
oldNic at 15-Aug-08 8:28
memberoldNic15-Aug-08 8:28 
AnswerRe: Crash in CProgressWnd::Create() in VS2008 Pin
oldNic at 18-Aug-08 11:41
memberoldNic18-Aug-08 11:41 
GeneralRe: Crash in CProgressWnd::Create() in VS2008 Pin
arokicki at 5-Mar-09 8:57
memberarokicki5-Mar-09 8:57 
AnswerRe: Crash in CProgressWnd::Create() in VS2008 Pin
Ards at 6-Jun-11 19:02
memberArds6-Jun-11 19:02 
Generalerror C2504: 'CWnd' : base class undefined Pin
Luke DeStevens at 9-Oct-07 11:29
memberLuke DeStevens9-Oct-07 11:29 
GeneralRe: error C2504: 'CWnd' : base class undefined Pin
jaymz at 12-May-08 2:43
memberjaymz12-May-08 2:43 
QuestionHow get rid of flickering? Pin
Walxer at 28-Aug-07 14:04
memberWalxer28-Aug-07 14:04 
GeneralThank you Chris : I no more need two threads Pin
charfeddine_ahmed at 24-Aug-07 2:28
membercharfeddine_ahmed24-Aug-07 2:28 
QuestionAccessing Progress Window? Pin
WVP at 10-Aug-07 6:48
memberWVP10-Aug-07 6:48 
AnswerRe: Accessing Progress Window? Pin
charfeddine_ahmed at 24-Aug-07 3:21
membercharfeddine_ahmed24-Aug-07 3:21 
GeneralGood! Pin
napo@burgasnet.com at 26-Jun-07 4:28
membernapo@burgasnet.com26-Jun-07 4:28 
GeneralThe same for .NET Pin
_slav_ at 4-Feb-07 4:04
member_slav_4-Feb-07 4:04 
GeneralCool ! Pin
eigen at 30-Sep-06 19:03
membereigen30-Sep-06 19:03 
Generalproblem used in worker thread Pin
how jack at 24-Feb-06 10:48
memberhow jack24-Feb-06 10:48 
GeneralRe: problem used in worker thread Pin
Kevin Done at 9-Nov-11 22:21
memberKevin Done9-Nov-11 22:21 
GeneralCrash on MouseOver Pin
Staati at 25-Jan-06 5:48
memberStaati25-Jan-06 5:48 
GeneralRe: Crash on MouseOver Pin
Staati at 26-Jan-06 6:37
memberStaati26-Jan-06 6:37 
GeneralAlways crashes for me :-( Pin
EthannCastell at 4-Oct-05 1:49
memberEthannCastell4-Oct-05 1:49 
Generalgreat timesaver Pin
jefflewis at 26-Aug-05 23:38
memberjefflewis26-Aug-05 23:38 
Generalget information popup Pin
Tailana at 1-Jun-05 23:33
memberTailana1-Jun-05 23:33 
GeneralConsole Pin
bachi at 13-Feb-05 22:12
memberbachi13-Feb-05 22:12 
GeneralWorkaround to bitmap buttons showing through Pin
Tom Archer at 9-Jan-05 9:09
memberTom Archer9-Jan-05 9:09 
GeneralRe: Workaround to bitmap buttons showing through Pin
kido97 at 2-Nov-09 23:43
memberkido972-Nov-09 23:43 
GeneralVC++ 7.0 Problem Pin
Anonymous at 22-Oct-04 2:36
sussAnonymous22-Oct-04 2:36 
GeneralRe: VC++ 7.0 Problem Pin
Solion at 22-Oct-04 2:41
memberSolion22-Oct-04 2:41 
GeneralRe: VC++ 7.0 Problem Pin
seafishkakakaka at 28-Apr-08 13:08
memberseafishkakakaka28-Apr-08 13:08 
GeneralGoModal() always on top Pin
LizardKingSchwing at 6-Apr-04 0:33
memberLizardKingSchwing6-Apr-04 0:33 
GeneralRe: GoModal() always on top Pin
mcvf at 26-May-04 8:10
membermcvf26-May-04 8:10 
GeneralSmall cosmetic fix Pin
phykell at 24-Sep-03 3:40
memberphykell24-Sep-03 3:40 
QuestionHow to call up the progressbar Pin
Pelge at 28-Apr-03 10:08
memberPelge28-Apr-03 10:08 
QuestionCrash? Pin
Anonymous at 2-Oct-02 17:37
sussAnonymous2-Oct-02 17:37 
QuestionPoopup...? Pin
Hockey at 25-Aug-02 17:39
memberHockey25-Aug-02 17:39 
AnswerRe: Poopup...? Pin
Chris Maunder at 11-Dec-02 11:52
adminChris Maunder11-Dec-02 11:52 
QuestionSmall bug with title ? Pin
Jonathan de Halleux at 29-Apr-02 1:01
memberJonathan de Halleux29-Apr-02 1:01 
GeneralThanks for the minor mods Pin
Geert Delmeiren at 22-Apr-02 23:41
memberGeert Delmeiren22-Apr-02 23:41 
GeneralRe: Thanks for the minor mods Pin
Luke Gabello at 16-May-02 2:51
memberLuke Gabello16-May-02 2:51 
GeneralJust a spelling error Pin
Brit at 22-Apr-02 12:30
memberBrit22-Apr-02 12:30 
GeneralRe: Just a spelling error Pin
Ravi Bhavnani at 22-Apr-02 12:51
memberRavi Bhavnani22-Apr-02 12:51 
GeneralRe: Just a spelling error Pin
Chris Maunder at 22-Apr-02 14:49
adminChris Maunder22-Apr-02 14:49 
GeneralSmall improvement Pin
Geert Delmeiren at 12-Apr-02 2:44
memberGeert Delmeiren12-Apr-02 2:44 
GeneralShort cut keys Pin
Geert Delmeiren at 11-Apr-02 6:25
memberGeert Delmeiren11-Apr-02 6:25 
GeneralExiting Pin
Hal Baird at 3-Apr-02 1:56
memberHal Baird3-Apr-02 1:56 
GeneralWher to call the function Pin
housefreak at 14-Mar-02 14:03
memberhousefreak14-Mar-02 14:03 
GeneralRe: Wher to call the function Pin
AJ Wilkinson at 10-Dec-02 14:12
memberAJ Wilkinson10-Dec-02 14:12 
GeneralRe: Wher to call the function Pin
Chris Maunder at 11-Dec-02 11:50
adminChris Maunder11-Dec-02 11:50 

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
Web02 | 2.8.150427.1 | Last Updated 22 Apr 2002
Article Copyright 1999 by Chris Maunder
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid