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

XProgressWnd - A Popup Progress Window with optional AVI and time

, 3 Nov 2008 CPOL
Rate this:
Please Sign up or sign in to vote.
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)

Share

About the Author

Hans Dietrich
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 PinmemberJoerg Hoffmann2-Aug-10 1:13 
QuestionProblem with small range PinmemberJoerg Hoffmann28-Jul-10 5:53 
AnswerRe: Problem with small range PinmentorHans Dietrich28-Jul-10 6:51 
GeneralRe: Problem with small range PinmemberJoerg Hoffmann28-Jul-10 12:24 
GeneralRe: Problem with small range PinmentorHans Dietrich29-Jul-10 3:41 
GeneralRe: Problem with small range PinmemberJoerg Hoffmann1-Aug-10 22:30 
GeneralGreat Job! Pinmembergegegegeda15-Jun-10 2:57 
GeneralStack around the variable 'ncm' was corrupted PinmemberSonar17-Sep-09 11:42 
GeneralRe: Stack around the variable 'ncm' was corrupted PinmvpHans Dietrich17-Sep-09 17:18 
GeneralSuper but... PinmemberKeith Dennis9-Jan-09 4:37 
GeneralPerfect PinmemberAbhijit Jana12-Dec-08 4:19 
GeneralWow! PinmemberPaul Conrad10-Nov-08 19:34 
QuestionWho gave it a one? Pinmember.dan.g.6-Nov-08 12:42 
AnswerRe: Who gave it a one? PinmvpHans Dietrich6-Nov-08 13:21 
GeneralRe: Who gave it a one? PinmemberHamed Mosavi9-Dec-08 5:39 
JokeRe: Who gave it a one? Pinmembersk8er_boy28712-Dec-08 5:20 
AnswerRe: Who gave it a one? PinmemberPaul Conrad10-Nov-08 19:35 
AnswerRe: Who gave it a one? PinmemberStefano Bettega11-Nov-08 2:35 
GeneralRe: Who gave it a one? PinmemberSabuncu7-Feb-09 5:12 
GeneralLengthly operations PinmemberDavide Zaccanti4-Nov-08 4:22 
GeneralRe: Lengthly operations PinmvpHans Dietrich4-Nov-08 6:39 
GeneralRe: Lengthly operations PinmemberDavide Zaccanti4-Nov-08 7:01 
GeneralRe: Lengthly operations PinmemberNGS 5496724-Nov-08 6:42 
GeneralRe: Lengthly operations PinmemberDavide Zaccanti4-Nov-08 7:07 
GeneralRe: Lengthly operations PinmemberJoseph Mccornell11-Nov-08 6:16 

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.141223.1 | Last Updated 3 Nov 2008
Article Copyright 2008 by Hans Dietrich
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid