///////////////////////////////////////////////////////////////////////////// // Name: src/generic/progdlgg.cpp // Purpose: wxProgressDialog class // Author: Karsten Ballueder // Modified by: // Created: 09.05.1999 // RCS-ID: $Id$ // Copyright: (c) Karsten Ballueder // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// // ============================================================================ // declarations // ============================================================================ // ---------------------------------------------------------------------------- // headers // ---------------------------------------------------------------------------- // For compilers that support precompilation, includes "wx.h". #include "wx/wxprec.h" #ifdef __BORLANDC__ #pragma hdrstop #endif #if wxUSE_PROGRESSDLG #ifndef WX_PRECOMP #include "wx/utils.h" #include "wx/frame.h" #include "wx/button.h" #include "wx/stattext.h" #include "wx/sizer.h" #include "wx/event.h" #include "wx/gauge.h" #include "wx/intl.h" #include "wx/dcclient.h" #include "wx/timer.h" #include "wx/settings.h" #include "wx/app.h" #endif #include "wx/progdlg.h" #include "wx/evtloop.h" // --------------------------------------------------------------------------- // macros // --------------------------------------------------------------------------- /* Macro for avoiding #ifdefs when value have to be different depending on size of device we display on - take it from something like wxDesktopPolicy in the future */ #if defined(__SMARTPHONE__) #define wxLARGESMALL(large,small) small #else #define wxLARGESMALL(large,small) large #endif // ---------------------------------------------------------------------------- // constants // ---------------------------------------------------------------------------- #define LAYOUT_MARGIN wxLARGESMALL(8,2) static const int wxID_SKIP = 32000; // whatever // ---------------------------------------------------------------------------- // private functions // ---------------------------------------------------------------------------- // update the label to show the given time (in seconds) static void SetTimeLabel(unsigned long val, wxStaticText *label); // ---------------------------------------------------------------------------- // event tables // ---------------------------------------------------------------------------- BEGIN_EVENT_TABLE(wxProgressDialog, wxDialog) EVT_BUTTON(wxID_CANCEL, wxProgressDialog::OnCancel) EVT_BUTTON(wxID_SKIP, wxProgressDialog::OnSkip) EVT_CLOSE(wxProgressDialog::OnClose) END_EVENT_TABLE() IMPLEMENT_CLASS(wxProgressDialog, wxDialog) // ============================================================================ // wxProgressDialog implementation // ============================================================================ // ---------------------------------------------------------------------------- // wxProgressDialog creation // ---------------------------------------------------------------------------- wxProgressDialog::wxProgressDialog(const wxString& title, const wxString& message, int maximum, wxWindow *parent, int style) : wxDialog(GetParentForModalDialog(parent, style), wxID_ANY, title), m_skip(false), m_delay(3), m_hasAbortButton(false), m_hasSkipButton(false) { // we may disappear at any moment, let the others know about it SetExtraStyle(GetExtraStyle() | wxWS_EX_TRANSIENT); m_windowStyle |= style; m_hasAbortButton = (style & wxPD_CAN_ABORT) != 0; m_hasSkipButton = (style & wxPD_CAN_SKIP) != 0; #if defined(__WXMSW__) && !defined(__WXUNIVERSAL__) // we have to remove the "Close" button from the title bar then as it is // confusing to have it - it doesn't work anyhow // // FIXME: should probably have a (extended?) window style for this if ( !m_hasAbortButton ) { EnableCloseButton(false); } #endif // wxMSW #if defined(__SMARTPHONE__) SetLeftMenu(); #endif m_state = m_hasAbortButton ? Continue : Uncancelable; m_maximum = maximum; #if defined(__WXMSW__) || defined(__WXPM__) // we can't have values > 65,536 in the progress control under Windows, so // scale everything down m_factor = m_maximum / 65536 + 1; m_maximum /= m_factor; #endif // __WXMSW__ m_parentTop = wxGetTopLevelParent(parent); // top-level sizerTop wxSizer * const sizerTop = new wxBoxSizer(wxVERTICAL); m_msg = new wxStaticText(this, wxID_ANY, message); sizerTop->Add(m_msg, 0, wxLEFT | wxTOP, 2*LAYOUT_MARGIN); if ( maximum > 0 ) { int gauge_style = wxGA_HORIZONTAL; if ( style & wxPD_SMOOTH ) gauge_style |= wxGA_SMOOTH; m_gauge = new wxGauge ( this, wxID_ANY, m_maximum, wxDefaultPosition, // make the progress bar sufficiently long wxSize(wxMin(wxGetClientDisplayRect().width/3, 300), -1), gauge_style ); sizerTop->Add(m_gauge, 0, wxLEFT | wxRIGHT | wxTOP | wxEXPAND, 2*LAYOUT_MARGIN); m_gauge->SetValue(0); } else { m_gauge = NULL; } // create the estimated/remaining/total time zones if requested m_elapsed = m_estimated = m_remaining = NULL; m_display_estimated = m_last_timeupdate = m_break = 0; m_ctdelay = 0; // also count how many labels we really have size_t nTimeLabels = 0; wxSizer * const sizerLabels = new wxFlexGridSizer(2); if ( style & wxPD_ELAPSED_TIME ) { nTimeLabels++; m_elapsed = CreateLabel(_("Elapsed time:"), sizerLabels); } if ( style & wxPD_ESTIMATED_TIME ) { nTimeLabels++; m_estimated = CreateLabel(_("Estimated time:"), sizerLabels); } if ( style & wxPD_REMAINING_TIME ) { nTimeLabels++; m_remaining = CreateLabel(_("Remaining time:"), sizerLabels); } sizerTop->Add(sizerLabels, 0, wxALIGN_CENTER_HORIZONTAL | wxTOP, LAYOUT_MARGIN); if ( nTimeLabels > 0 ) { // set it to the current time m_timeStart = wxGetCurrentTime(); } #if defined(__SMARTPHONE__) if ( m_hasSkipButton ) SetRightMenu(wxID_SKIP, _("Skip")); if ( m_hasAbortButton ) SetLeftMenu(wxID_CANCEL); #else m_btnAbort = m_btnSkip = NULL; wxBoxSizer *buttonSizer = new wxBoxSizer(wxHORIZONTAL); // Windows dialogs usually have buttons in the lower right corner const int sizerFlags = #if defined(__WXMSW__) || defined(__WXPM__) wxALIGN_RIGHT | wxALL #else // !MSW wxALIGN_CENTER_HORIZONTAL | wxBOTTOM | wxTOP #endif // MSW/!MSW ; if ( m_hasSkipButton ) { m_btnSkip = new wxButton(this, wxID_SKIP, _("&Skip")); buttonSizer->Add(m_btnSkip, 0, sizerFlags, LAYOUT_MARGIN); } if ( m_hasAbortButton ) { m_btnAbort = new wxButton(this, wxID_CANCEL); buttonSizer->Add(m_btnAbort, 0, sizerFlags, LAYOUT_MARGIN); } sizerTop->Add(buttonSizer, 0, sizerFlags, LAYOUT_MARGIN ); #endif // __SMARTPHONE__/!__SMARTPHONE__ SetSizerAndFit(sizerTop); Centre(wxCENTER_FRAME | wxBOTH); if ( style & wxPD_APP_MODAL ) { m_winDisabler = new wxWindowDisabler(this); } else { if ( m_parentTop ) m_parentTop->Disable(); m_winDisabler = NULL; } Show(); Enable(); // this one can be initialized even if the others are unknown for now // // NB: do it after calling Layout() to keep the labels correctly aligned if ( m_elapsed ) { SetTimeLabel(0, m_elapsed); } Update(); } wxStaticText * wxProgressDialog::CreateLabel(const wxString& text, wxSizer *sizer) { wxStaticText *label = new wxStaticText(this, wxID_ANY, text); wxStaticText *value = new wxStaticText(this, wxID_ANY, _("unknown")); // select placement most native or nice on target GUI #if defined(__SMARTPHONE__) // value and time to the left in two rows sizer->Add(label, 1, wxALIGN_LEFT); sizer->Add(value, 1, wxALIGN_LEFT); #elif defined(__WXMSW__) || defined(__WXPM__) || defined(__WXMAC__) || defined(__WXGTK20__) // value and time centered in one row sizer->Add(label, 1, wxLARGESMALL(wxALIGN_RIGHT,wxALIGN_LEFT) | wxTOP | wxRIGHT, LAYOUT_MARGIN); sizer->Add(value, 1, wxALIGN_LEFT | wxTOP, LAYOUT_MARGIN); #else // value and time to the right in one row sizer->Add(label); sizer->Add(value, 0, wxLEFT, LAYOUT_MARGIN); #endif return value; } // ---------------------------------------------------------------------------- // wxProgressDialog operations // ---------------------------------------------------------------------------- bool wxProgressDialog::Update(int value, const wxString& newmsg, bool *skip) { if ( !DoBeforeUpdate(skip) ) return false; wxASSERT_MSG( value == -1 || m_gauge, wxT("cannot update non existent dialog") ); #ifdef __WXMSW__ value /= m_factor; #endif // __WXMSW__ wxASSERT_MSG( value <= m_maximum, wxT("invalid progress value") ); if ( m_gauge ) m_gauge->SetValue(value); UpdateMessage(newmsg); if ( (m_elapsed || m_remaining || m_estimated) && (value != 0) ) { unsigned long elapsed = wxGetCurrentTime() - m_timeStart; if ( m_last_timeupdate < elapsed || value == m_maximum ) { m_last_timeupdate = elapsed; unsigned long estimated = m_break + (unsigned long)(( (double) (elapsed-m_break) * m_maximum ) / ((double)value)) ; if ( estimated > m_display_estimated && m_ctdelay >= 0 ) { ++m_ctdelay; } else if ( estimated < m_display_estimated && m_ctdelay <= 0 ) { --m_ctdelay; } else { m_ctdelay = 0; } if ( m_ctdelay >= m_delay // enough confirmations for a higher value || m_ctdelay <= (m_delay*-1) // enough confirmations for a lower value || value == m_maximum // to stay consistent || elapsed > m_display_estimated // to stay consistent || ( elapsed > 0 && elapsed < 4 ) // additional updates in the beginning ) { m_display_estimated = estimated; m_ctdelay = 0; } } long display_remaining = m_display_estimated - elapsed; if ( display_remaining < 0 ) { display_remaining = 0; } SetTimeLabel(elapsed, m_elapsed); SetTimeLabel(m_display_estimated, m_estimated); SetTimeLabel(display_remaining, m_remaining); } if ( value == m_maximum ) { if ( m_state == Finished ) { // ignore multiple calls to Update(m_maximum): it may sometimes be // troublesome to ensure that Update() is not called twice with the // same value (e.g. because of the rounding errors) and if we don't // return now we're going to generate asserts below return true; } // so that we return true below and that out [Cancel] handler knew what // to do m_state = Finished; if( !HasFlag(wxPD_AUTO_HIDE) ) { EnableClose(); DisableSkip(); #if defined(__WXMSW__) && !defined(__WXUNIVERSAL__) EnableCloseButton(); #endif // __WXMSW__ if ( newmsg.empty() ) { // also provide the finishing message if the application didn't m_msg->SetLabel(_("Done.")); } wxCHECK_MSG(wxEventLoopBase::GetActive(), false, "wxProgressDialog::Update needs a running event loop"); // allow the window to repaint: // NOTE: since we yield only for UI events with this call, there // should be no side-effects wxEventLoopBase::GetActive()->YieldFor(wxEVT_CATEGORY_UI); // NOTE: this call results in a new event loop being created // and to a call to ProcessPendingEvents() (which may generate // unwanted re-entrancies). (void)ShowModal(); } else // auto hide { // reenable other windows before hiding this one because otherwise // Windows wouldn't give the focus back to the window which had // been previously focused because it would still be disabled ReenableOtherWindows(); Hide(); } } else // not at maximum yet { DoAfterUpdate(); } // update the display in case yielding above didn't do it Update(); return m_state != Canceled; } bool wxProgressDialog::Pulse(const wxString& newmsg, bool *skip) { if ( !DoBeforeUpdate(skip) ) return false; wxASSERT_MSG( m_gauge, wxT("cannot update non existent dialog") ); // show a bit of progress m_gauge->Pulse(); UpdateMessage(newmsg); if (m_elapsed || m_remaining || m_estimated) { unsigned long elapsed = wxGetCurrentTime() - m_timeStart; SetTimeLabel(elapsed, m_elapsed); SetTimeLabel((unsigned long)-1, m_estimated); SetTimeLabel((unsigned long)-1, m_remaining); } DoAfterUpdate(); return m_state != Canceled; } bool wxProgressDialog::DoBeforeUpdate(bool *skip) { wxCHECK_MSG(wxEventLoopBase::GetActive(), false, "wxProgressDialog::DoBeforeUpdate needs a running event loop"); // we have to yield because not only we want to update the display but // also to process the clicks on the cancel and skip buttons // NOTE: using YieldFor() this call shouldn't give re-entrancy problems // for event handlers not interested to UI/user-input events. wxEventLoopBase::GetActive()->YieldFor(wxEVT_CATEGORY_UI|wxEVT_CATEGORY_USER_INPUT); Update(); if ( m_skip && skip && !*skip ) { *skip = true; m_skip = false; EnableSkip(); } return m_state != Canceled; } void wxProgressDialog::DoAfterUpdate() { wxCHECK_RET(wxEventLoopBase::GetActive(), "wxProgressDialog::DoAfterUpdate needs a running event loop"); // allow the window to repaint: // NOTE: since we yield only for UI events with this call, there // should be no side-effects wxEventLoopBase::GetActive()->YieldFor(wxEVT_CATEGORY_UI); } void wxProgressDialog::Resume() { m_state = Continue; m_ctdelay = m_delay; // force an update of the elapsed/estimated/remaining time m_break += wxGetCurrentTime()-m_timeStop; EnableAbort(); EnableSkip(); m_skip = false; } bool wxProgressDialog::Show( bool show ) { // reenable other windows before hiding this one because otherwise // Windows wouldn't give the focus back to the window which had // been previously focused because it would still be disabled if(!show) ReenableOtherWindows(); return wxDialog::Show(show); } int wxProgressDialog::GetValue() const { if (m_gauge) return m_gauge->GetValue(); return wxNOT_FOUND; } int wxProgressDialog::GetRange() const { if (m_gauge) return m_gauge->GetRange(); return wxNOT_FOUND; } wxString wxProgressDialog::GetMessage() const { return m_msg->GetLabel(); } void wxProgressDialog::SetRange(int maximum) { wxASSERT_MSG(m_gauge, "The dialog should have been constructed with a range > 0"); wxASSERT_MSG(maximum > 0, "Invalid range"); m_gauge->SetRange(maximum); m_maximum = maximum; #if defined(__WXMSW__) || defined(__WXPM__) // we can't have values > 65,536 in the progress control under Windows, so // scale everything down m_factor = m_maximum / 65536 + 1; m_maximum /= m_factor; #endif // __WXMSW__ } bool wxProgressDialog::WasCancelled() const { return m_hasAbortButton && m_state == Canceled; } bool wxProgressDialog::WasSkipped() const { return m_hasSkipButton && m_skip; } // ---------------------------------------------------------------------------- // event handlers // ---------------------------------------------------------------------------- void wxProgressDialog::OnCancel(wxCommandEvent& event) { if ( m_state == Finished ) { // this means that the count down is already finished and we're being // shown as a modal dialog - so just let the default handler do the job event.Skip(); } else { // request to cancel was received, the next time Update() is called we // will handle it m_state = Canceled; // update the buttons state immediately so that the user knows that the // request has been noticed DisableAbort(); DisableSkip(); // save the time when the dialog was stopped m_timeStop = wxGetCurrentTime(); } } void wxProgressDialog::OnSkip(wxCommandEvent& WXUNUSED(event)) { DisableSkip(); m_skip = true; } void wxProgressDialog::OnClose(wxCloseEvent& event) { if ( m_state == Uncancelable ) { // can't close this dialog event.Veto(); } else if ( m_state == Finished ) { // let the default handler close the window as we already terminated event.Skip(); } else { // next Update() will notice it m_state = Canceled; DisableAbort(); DisableSkip(); m_timeStop = wxGetCurrentTime(); } } // ---------------------------------------------------------------------------- // destruction // ---------------------------------------------------------------------------- wxProgressDialog::~wxProgressDialog() { // normally this should have been already done, but just in case ReenableOtherWindows(); } void wxProgressDialog::ReenableOtherWindows() { if ( HasFlag(wxPD_APP_MODAL) ) { delete m_winDisabler; m_winDisabler = NULL; } else { if ( m_parentTop ) m_parentTop->Enable(); } } // ---------------------------------------------------------------------------- // private functions // ---------------------------------------------------------------------------- static void SetTimeLabel(unsigned long val, wxStaticText *label) { if ( label ) { wxString s; if (val != (unsigned long)-1) { unsigned long hours = val / 3600; unsigned long minutes = (val % 3600) / 60; unsigned long seconds = val % 60; s.Printf(wxT("%lu:%02lu:%02lu"), hours, minutes, seconds); } else { s = _("Unknown"); } if ( s != label->GetLabel() ) label->SetLabel(s); } } void wxProgressDialog::EnableSkip(bool enable) { if(m_hasSkipButton) { #ifdef __SMARTPHONE__ if(enable) SetRightMenu(wxID_SKIP, _("Skip")); else SetRightMenu(); #else if(m_btnSkip) m_btnSkip->Enable(enable); #endif } } void wxProgressDialog::EnableAbort(bool enable) { if(m_hasAbortButton) { #ifdef __SMARTPHONE__ if(enable) SetLeftMenu(wxID_CANCEL); // stock buttons makes Cancel label else SetLeftMenu(); #else if(m_btnAbort) m_btnAbort->Enable(enable); #endif } } void wxProgressDialog::EnableClose() { if(m_hasAbortButton) { #ifdef __SMARTPHONE__ SetLeftMenu(wxID_CANCEL, _("Close")); #else if(m_btnAbort) { m_btnAbort->Enable(); m_btnAbort->SetLabel(_("Close")); } #endif } } void wxProgressDialog::UpdateMessage(const wxString &newmsg) { wxCHECK_RET(wxEventLoopBase::GetActive(), "wxProgressDialog::UpdateMessage needs a running event loop"); if ( !newmsg.empty() && newmsg != m_msg->GetLabel() ) { m_msg->SetLabel(newmsg); // allow the window to repaint: // NOTE: since we yield only for UI events with this call, there // should be no side-effects wxEventLoopBase::GetActive()->YieldFor(wxEVT_CATEGORY_UI); } } #endif // wxUSE_PROGRESSDLG