Click here to Skip to main content
15,861,168 members
Articles / Desktop Programming / MFC
Article

XProgressWnd - A Popup Progress Window with optional AVI and time

Rate me:
Please Sign up or sign in to vote.
4.89/5 (48 votes)
3 Nov 2008CPOL2 min read 68.6K   1.4K   92   26
XProgressWnd is a popup progress window that display a progress control and optional AVI animation and estimated time left, without requiring a dialog resource.

Introduction

I have been using Chris Maunder's excellent Popup Progress Window for some time now, and wanted to add an AVI animation and "time left" display similar to what you see in IE:

screenshot

XProgressWnd Window

Here is what XProgressWnd looks like:

screenshot

and when you select all options:

screenshot

Changes in Version 2.0

Here are the changes I made to Chris's control:
screenshot Added optional AVI animation.
screenshot Added optional estimated time left, with ability to customize labels.
screenshot Added [X] (Close) button to progress window.
screenshot Used memory DC to eliminate flickering of message text. Text can now be changed dynamically during progress display, with no flickering.
screenshot Fixed problem with NONCLIENTMETRICS and VS2008, plus several other issues reported in forum.

Demo App

The demo app allows you to select an AVI, the progress range, and other options:

screenshot

How To Use

To integrate CXProgressWnd into your app, you first need to add following files to your project:

  • XProgressWnd.cpp
  • XProgressWnd.h

Next, include header file XProgressWnd.h in appropriate project files. Now you are ready to start using CXProgressWnd.

Example 1 - Using XProgressWnd within a single function

The file XProgressWndTestDlg.cpp gives an example:
CXProgressWnd wndProgress(this,
    _T("Progress"), (LPCTSTR)nAvi[m_nAvi], nAviHeight[m_nAvi]);

if (m_bModal)
    wndProgress.GoModal(this);

wndProgress.SetRange(0, nRange[m_nRange])
           .EnableTimeLeft(m_bTimeLeft)
           .SetText(_T("This is a progress window...\n\n")
                    _T("Try dragging it around, hitting Cancel or pressing ESC."));

for (int i = 0; i < nRange[m_nRange]; i++)
{
    if (i > (4000*(m_nRange+1)))
    {
        // no flickering!
        wndProgress.SetText(_T("\nThis is step #%d"), i);
    }
    wndProgress.StepIt();
    wndProgress.PeekAndPump();

    if (wndProgress.Cancelled())
    {
        AfxMessageBox(_T("Operation Canceled."));
        break;
    }
}

Example 2 - Creating XProgressWnd in one function, and using it in another

You can create the XProgressWnd in one part of your program, and use it in another, by declaring a class member variable:
CXProgressWnd *m_pwndProgress;
To create the XProgressWnd:
m_pwndProgress = new CXProgressWnd(this, _T("Progress"),
    (LPCTSTR)nAvi[m_nAvi], nAviHeight[m_nAvi]);

if (m_bModal)
    m_pwndProgress->GoModal(this);

m_pwndProgress->SetRange(0, nRange[m_nRange]);
m_pwndProgress->EnableTimeLeft(m_bTimeLeft);
m_pwndProgress->SetText(_T("This is a progress window...\n\n")
                        _T("Try dragging it around, hitting Cancel or pressing ESC."));
and then you can use it in another function like this:
for (int i = 0; i < nRange[m_nRange]; i++)
{
    if (i > (4000*(m_nRange+1)))
    {
        // no flickering!
        m_pwndProgress->SetText(_T("\nThis is step #%d"), i);
    }
    m_pwndProgress->StepIt();
    m_pwndProgress->PeekAndPump();

    if (m_pwndProgress->Cancelled())
    {
        AfxMessageBox(_T("Operation Canceled."));
        break;
    }
}
When you finish with it, don't forget to delete it:
delete m_pwndProgress;

Revision History

Version 2.0 - 2008 November 3

  • Initial public release.

Usage

This software is released into the public domain. You are free to use it in any way you like, except that you may not sell this source code. If you modify it or extend it, please to consider posting new code here for everyone to share. This software is provided "as is" with no expressed or implied warranty. I accept no liability for any damage or loss of business that this software may cause.

License

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


Written By
Software Developer (Senior) Hans Dietrich Software
United States United States
I attended St. Michael's College of the University of Toronto, with the intention of becoming a priest. A friend in the University's Computer Science Department got me interested in programming, and I have been hooked ever since.

Recently, I have moved to Los Angeles where I am doing consulting and development work.

For consulting and custom software development, please see www.hdsoft.org.






Comments and Discussions

 
GeneralMy vote of 5 Pin
Joerg Hoffmann2-Aug-10 0:13
Joerg Hoffmann2-Aug-10 0:13 
QuestionProblem with small range Pin
Joerg Hoffmann28-Jul-10 4:53
Joerg Hoffmann28-Jul-10 4:53 
AnswerRe: Problem with small range Pin
Hans Dietrich28-Jul-10 5:51
mentorHans Dietrich28-Jul-10 5:51 
GeneralRe: Problem with small range Pin
Joerg Hoffmann28-Jul-10 11:24
Joerg Hoffmann28-Jul-10 11:24 
GeneralRe: Problem with small range Pin
Hans Dietrich29-Jul-10 2:41
mentorHans Dietrich29-Jul-10 2:41 
GeneralRe: Problem with small range Pin
Joerg Hoffmann1-Aug-10 21:30
Joerg Hoffmann1-Aug-10 21:30 
GeneralGreat Job! Pin
gegegegeda15-Jun-10 1:57
gegegegeda15-Jun-10 1:57 
GeneralStack around the variable 'ncm' was corrupted Pin
Sonar17-Sep-09 10:42
Sonar17-Sep-09 10:42 
GeneralRe: Stack around the variable 'ncm' was corrupted Pin
Hans Dietrich17-Sep-09 16:18
mentorHans Dietrich17-Sep-09 16:18 
GeneralSuper but... Pin
Keith Dennis9-Jan-09 3:37
Keith Dennis9-Jan-09 3:37 
GeneralPerfect Pin
Abhijit Jana12-Dec-08 3:19
professionalAbhijit Jana12-Dec-08 3:19 
GeneralWow! Pin
Paul Conrad10-Nov-08 18:34
professionalPaul Conrad10-Nov-08 18:34 
QuestionWho gave it a one? Pin
.dan.g.6-Nov-08 11:42
professional.dan.g.6-Nov-08 11:42 
AnswerRe: Who gave it a one? Pin
Hans Dietrich6-Nov-08 12:21
mentorHans Dietrich6-Nov-08 12:21 
GeneralRe: Who gave it a one? Pin
Hamed Musavi9-Dec-08 4:39
Hamed Musavi9-Dec-08 4:39 
JokeRe: Who gave it a one? Pin
Emil - Gabriel12-Dec-08 4:20
Emil - Gabriel12-Dec-08 4:20 
AnswerRe: Who gave it a one? Pin
Paul Conrad10-Nov-08 18:35
professionalPaul Conrad10-Nov-08 18:35 
AnswerRe: Who gave it a one? Pin
Stefano Bettega11-Nov-08 1:35
professionalStefano Bettega11-Nov-08 1:35 
GeneralRe: Who gave it a one? Pin
Sabuncu7-Feb-09 4:12
Sabuncu7-Feb-09 4:12 
GeneralLengthly operations Pin
Davide Zaccanti4-Nov-08 3:22
Davide Zaccanti4-Nov-08 3:22 
GeneralRe: Lengthly operations Pin
Hans Dietrich4-Nov-08 5:39
mentorHans Dietrich4-Nov-08 5:39 
GeneralRe: Lengthly operations Pin
Davide Zaccanti4-Nov-08 6:01
Davide Zaccanti4-Nov-08 6:01 
GeneralRe: Lengthly operations Pin
NGS 5496724-Nov-08 5:42
NGS 5496724-Nov-08 5:42 
GeneralRe: Lengthly operations Pin
Davide Zaccanti4-Nov-08 6:07
Davide Zaccanti4-Nov-08 6:07 
GeneralRe: Lengthly operations Pin
Joseph Mccornell11-Nov-08 5:16
Joseph Mccornell11-Nov-08 5:16 

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.