4f4c5fcfdf
This is a combination of running clang-tidy with modernize-use-nullptr check for some ports (GTK, X11, OSX) and manual changes to the ports for which it couldn't be used easily (MSW, DFB) and also manually updating the docs. Also replace NULL with null or nullptr in the comments as this is more consistent with the use of nullptr in the code and makes it simpler to grep for the remaining occurrences of NULL itself. And also use null in the assert messages. Only a few occurrences of "NULL" are still left in non-C files, mostly corresponding to unclear comments or string output which it might not be safe to change.
474 lines
13 KiB
C++
474 lines
13 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Program: wxWidgets Widgets Sample
|
|
// Name: gauge.cpp
|
|
// Purpose: Part of the widgets sample showing wxGauge
|
|
// Author: Vadim Zeitlin
|
|
// Created: 27.03.01
|
|
// Copyright: (c) 2001 Vadim Zeitlin
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// ============================================================================
|
|
// declarations
|
|
// ============================================================================
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// headers
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// for compilers that support precompilation, includes "wx/wx.h".
|
|
#include "wx/wxprec.h"
|
|
|
|
|
|
// for all others, include the necessary headers
|
|
#ifndef WX_PRECOMP
|
|
#include "wx/log.h"
|
|
#include "wx/timer.h"
|
|
|
|
#include "wx/bitmap.h"
|
|
#include "wx/button.h"
|
|
#include "wx/checkbox.h"
|
|
#include "wx/combobox.h"
|
|
#include "wx/gauge.h"
|
|
#include "wx/radiobox.h"
|
|
#include "wx/statbox.h"
|
|
#include "wx/textctrl.h"
|
|
#endif
|
|
|
|
#include "wx/sizer.h"
|
|
|
|
#include "widgets.h"
|
|
#if wxUSE_GAUGE
|
|
#include "icons/gauge.xpm"
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// constants
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// control ids
|
|
enum
|
|
{
|
|
GaugePage_Reset = wxID_HIGHEST,
|
|
GaugePage_Progress,
|
|
GaugePage_IndeterminateProgress,
|
|
GaugePage_Clear,
|
|
GaugePage_SetValue,
|
|
GaugePage_SetRange,
|
|
GaugePage_CurValueText,
|
|
GaugePage_ValueText,
|
|
GaugePage_RangeText,
|
|
GaugePage_Timer,
|
|
GaugePage_IndeterminateTimer,
|
|
GaugePage_Gauge
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// GaugeWidgetsPage
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class GaugeWidgetsPage : public WidgetsPage
|
|
{
|
|
public:
|
|
GaugeWidgetsPage(WidgetsBookCtrl *book, wxImageList *imaglist);
|
|
virtual ~GaugeWidgetsPage();
|
|
|
|
virtual wxWindow *GetWidget() const override { return m_gauge; }
|
|
virtual void RecreateWidget() override { CreateGauge(); }
|
|
|
|
// lazy creation of the content
|
|
virtual void CreateContent() override;
|
|
|
|
protected:
|
|
// event handlers
|
|
void OnButtonReset(wxCommandEvent& event);
|
|
void OnButtonProgress(wxCommandEvent& event);
|
|
void OnButtonIndeterminateProgress(wxCommandEvent& event);
|
|
void OnButtonClear(wxCommandEvent& event);
|
|
void OnButtonSetValue(wxCommandEvent& event);
|
|
void OnButtonSetRange(wxCommandEvent& event);
|
|
|
|
void OnCheckOrRadioBox(wxCommandEvent& event);
|
|
|
|
void OnUpdateUIValueButton(wxUpdateUIEvent& event);
|
|
void OnUpdateUIRangeButton(wxUpdateUIEvent& event);
|
|
void OnUpdateUIResetButton(wxUpdateUIEvent& event);
|
|
|
|
void OnUpdateUICurValueText(wxUpdateUIEvent& event);
|
|
|
|
void OnProgressTimer(wxTimerEvent& event);
|
|
void OnIndeterminateProgressTimer(wxTimerEvent& event);
|
|
|
|
// reset the gauge parameters
|
|
void Reset();
|
|
|
|
// (re)create the gauge
|
|
void CreateGauge();
|
|
|
|
// start progress timer
|
|
void StartTimer(wxButton*);
|
|
|
|
// stop the progress timer
|
|
void StopTimer(wxButton*);
|
|
|
|
// the gauge range
|
|
unsigned long m_range;
|
|
|
|
// the controls
|
|
// ------------
|
|
|
|
// the checkboxes for styles
|
|
wxCheckBox *m_chkVert,
|
|
*m_chkSmooth,
|
|
*m_chkProgress;
|
|
|
|
// the gauge itself and the sizer it is in
|
|
wxGauge *m_gauge;
|
|
wxSizer *m_sizerGauge;
|
|
|
|
// the text entries for set value/range
|
|
wxTextCtrl *m_textValue,
|
|
*m_textRange;
|
|
|
|
// the timer for simulating gauge progress
|
|
wxTimer *m_timer;
|
|
|
|
private:
|
|
wxDECLARE_EVENT_TABLE();
|
|
DECLARE_WIDGETS_PAGE(GaugeWidgetsPage)
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// event tables
|
|
// ----------------------------------------------------------------------------
|
|
|
|
wxBEGIN_EVENT_TABLE(GaugeWidgetsPage, WidgetsPage)
|
|
EVT_BUTTON(GaugePage_Reset, GaugeWidgetsPage::OnButtonReset)
|
|
EVT_BUTTON(GaugePage_Progress, GaugeWidgetsPage::OnButtonProgress)
|
|
EVT_BUTTON(GaugePage_IndeterminateProgress, GaugeWidgetsPage::OnButtonIndeterminateProgress)
|
|
EVT_BUTTON(GaugePage_Clear, GaugeWidgetsPage::OnButtonClear)
|
|
EVT_BUTTON(GaugePage_SetValue, GaugeWidgetsPage::OnButtonSetValue)
|
|
EVT_BUTTON(GaugePage_SetRange, GaugeWidgetsPage::OnButtonSetRange)
|
|
|
|
EVT_UPDATE_UI(GaugePage_SetValue, GaugeWidgetsPage::OnUpdateUIValueButton)
|
|
EVT_UPDATE_UI(GaugePage_SetRange, GaugeWidgetsPage::OnUpdateUIRangeButton)
|
|
EVT_UPDATE_UI(GaugePage_Reset, GaugeWidgetsPage::OnUpdateUIResetButton)
|
|
|
|
EVT_UPDATE_UI(GaugePage_CurValueText, GaugeWidgetsPage::OnUpdateUICurValueText)
|
|
|
|
EVT_CHECKBOX(wxID_ANY, GaugeWidgetsPage::OnCheckOrRadioBox)
|
|
EVT_RADIOBOX(wxID_ANY, GaugeWidgetsPage::OnCheckOrRadioBox)
|
|
|
|
EVT_TIMER(GaugePage_Timer, GaugeWidgetsPage::OnProgressTimer)
|
|
EVT_TIMER(GaugePage_IndeterminateTimer, GaugeWidgetsPage::OnIndeterminateProgressTimer)
|
|
wxEND_EVENT_TABLE()
|
|
|
|
// ============================================================================
|
|
// implementation
|
|
// ============================================================================
|
|
|
|
#if defined(__WXUNIVERSAL__)
|
|
#define FAMILY_CTRLS UNIVERSAL_CTRLS
|
|
#else
|
|
#define FAMILY_CTRLS NATIVE_CTRLS
|
|
#endif
|
|
|
|
IMPLEMENT_WIDGETS_PAGE(GaugeWidgetsPage, "Gauge", FAMILY_CTRLS );
|
|
|
|
GaugeWidgetsPage::GaugeWidgetsPage(WidgetsBookCtrl *book,
|
|
wxImageList *imaglist)
|
|
:WidgetsPage(book, imaglist, gauge_xpm)
|
|
{
|
|
// init everything
|
|
m_range = 100;
|
|
|
|
m_timer = nullptr;
|
|
|
|
m_chkVert =
|
|
m_chkSmooth =
|
|
m_chkProgress = nullptr;
|
|
|
|
m_gauge = nullptr;
|
|
m_sizerGauge = nullptr;
|
|
}
|
|
|
|
void GaugeWidgetsPage::CreateContent()
|
|
{
|
|
wxSizer *sizerTop = new wxBoxSizer(wxHORIZONTAL);
|
|
|
|
// left pane
|
|
wxStaticBox *box = new wxStaticBox(this, wxID_ANY, "&Set style");
|
|
|
|
wxSizer *sizerLeft = new wxStaticBoxSizer(box, wxVERTICAL);
|
|
|
|
m_chkVert = CreateCheckBoxAndAddToSizer(sizerLeft, "&Vertical");
|
|
m_chkSmooth = CreateCheckBoxAndAddToSizer(sizerLeft, "&Smooth");
|
|
m_chkProgress = CreateCheckBoxAndAddToSizer(sizerLeft, "&Progress");
|
|
|
|
sizerLeft->Add(5, 5, 0, wxGROW | wxALL, 5); // spacer
|
|
|
|
wxButton *btn = new wxButton(this, GaugePage_Reset, "&Reset");
|
|
sizerLeft->Add(btn, 0, wxALIGN_CENTRE_HORIZONTAL | wxALL, 15);
|
|
|
|
// middle pane
|
|
wxStaticBox *box2 = new wxStaticBox(this, wxID_ANY, "&Change gauge value");
|
|
wxSizer *sizerMiddle = new wxStaticBoxSizer(box2, wxVERTICAL);
|
|
|
|
wxTextCtrl *text;
|
|
wxSizer *sizerRow = CreateSizerWithTextAndLabel("Current value",
|
|
GaugePage_CurValueText,
|
|
&text);
|
|
text->SetEditable(false);
|
|
|
|
sizerMiddle->Add(sizerRow, 0, wxALL | wxGROW, 5);
|
|
|
|
sizerRow = CreateSizerWithTextAndButton(GaugePage_SetValue,
|
|
"Set &value",
|
|
GaugePage_ValueText,
|
|
&m_textValue);
|
|
sizerMiddle->Add(sizerRow, 0, wxALL | wxGROW, 5);
|
|
|
|
sizerRow = CreateSizerWithTextAndButton(GaugePage_SetRange,
|
|
"Set &range",
|
|
GaugePage_RangeText,
|
|
&m_textRange);
|
|
m_textRange->SetValue( wxString::Format("%lu", m_range) );
|
|
sizerMiddle->Add(sizerRow, 0, wxALL | wxGROW, 5);
|
|
|
|
btn = new wxButton(this, GaugePage_Progress, "Simulate &progress");
|
|
sizerMiddle->Add(btn, 0, wxALL | wxGROW, 5);
|
|
|
|
btn = new wxButton(this, GaugePage_IndeterminateProgress,
|
|
"Simulate &indeterminate job");
|
|
sizerMiddle->Add(btn, 0, wxALL | wxGROW, 5);
|
|
|
|
btn = new wxButton(this, GaugePage_Clear, "&Clear");
|
|
sizerMiddle->Add(btn, 0, wxALL | wxGROW, 5);
|
|
|
|
// right pane
|
|
wxSizer *sizerRight = new wxBoxSizer(wxHORIZONTAL);
|
|
m_gauge = new wxGauge(this, GaugePage_Gauge, m_range);
|
|
sizerRight->Add(m_gauge, 1, wxCENTRE | wxALL, 5);
|
|
sizerRight->SetMinSize(150, 0);
|
|
m_sizerGauge = sizerRight; // save it to modify it later
|
|
|
|
// the 3 panes panes compose the window
|
|
sizerTop->Add(sizerLeft, 0, wxGROW | (wxALL & ~wxLEFT), 10);
|
|
sizerTop->Add(sizerMiddle, 1, wxGROW | wxALL, 10);
|
|
sizerTop->Add(sizerRight, 1, wxGROW | (wxALL & ~wxRIGHT), 10);
|
|
|
|
// final initializations
|
|
Reset();
|
|
|
|
SetSizer(sizerTop);
|
|
}
|
|
|
|
GaugeWidgetsPage::~GaugeWidgetsPage()
|
|
{
|
|
delete m_timer;
|
|
}
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// operations
|
|
// ----------------------------------------------------------------------------
|
|
|
|
void GaugeWidgetsPage::Reset()
|
|
{
|
|
m_chkVert->SetValue(false);
|
|
m_chkSmooth->SetValue(false);
|
|
m_chkProgress->SetValue(false);
|
|
}
|
|
|
|
void GaugeWidgetsPage::CreateGauge()
|
|
{
|
|
int flags = GetAttrs().m_defaultFlags;
|
|
|
|
if ( m_chkVert->GetValue() )
|
|
flags |= wxGA_VERTICAL;
|
|
else
|
|
flags |= wxGA_HORIZONTAL;
|
|
|
|
if ( m_chkSmooth->GetValue() )
|
|
flags |= wxGA_SMOOTH;
|
|
|
|
if ( m_chkProgress->GetValue() )
|
|
flags |= wxGA_PROGRESS;
|
|
|
|
int val = 0;
|
|
if ( m_gauge )
|
|
{
|
|
val = m_gauge->GetValue();
|
|
|
|
m_sizerGauge->Detach( m_gauge );
|
|
delete m_gauge;
|
|
}
|
|
|
|
m_gauge = new wxGauge(this, GaugePage_Gauge, m_range,
|
|
wxDefaultPosition, wxDefaultSize,
|
|
flags);
|
|
m_gauge->SetValue(val);
|
|
|
|
if ( flags & wxGA_VERTICAL )
|
|
m_sizerGauge->Add(m_gauge, 0, wxGROW | wxALL, 5);
|
|
else
|
|
m_sizerGauge->Add(m_gauge, 1, wxCENTRE | wxALL, 5);
|
|
|
|
m_sizerGauge->Layout();
|
|
}
|
|
|
|
void GaugeWidgetsPage::StartTimer(wxButton *clicked)
|
|
{
|
|
static const int INTERVAL = 300;
|
|
|
|
wxLogMessage("Launched progress timer (interval = %d ms)", INTERVAL);
|
|
|
|
m_timer = new wxTimer(this,
|
|
clicked->GetId() == GaugePage_Progress ? GaugePage_Timer : GaugePage_IndeterminateTimer);
|
|
m_timer->Start(INTERVAL);
|
|
|
|
clicked->SetLabel("&Stop timer");
|
|
|
|
if (clicked->GetId() == GaugePage_Progress)
|
|
FindWindow(GaugePage_IndeterminateProgress)->Disable();
|
|
else
|
|
FindWindow(GaugePage_Progress)->Disable();
|
|
}
|
|
|
|
void GaugeWidgetsPage::StopTimer(wxButton *clicked)
|
|
{
|
|
wxCHECK_RET( m_timer, "shouldn't be called" );
|
|
|
|
m_timer->Stop();
|
|
wxDELETE(m_timer);
|
|
|
|
if (clicked->GetId() == GaugePage_Progress)
|
|
{
|
|
clicked->SetLabel("Simulate &progress");
|
|
FindWindow(GaugePage_IndeterminateProgress)->Enable();
|
|
}
|
|
else
|
|
{
|
|
clicked->SetLabel("Simulate indeterminate job");
|
|
FindWindow(GaugePage_Progress)->Enable();
|
|
}
|
|
|
|
wxLogMessage("Progress finished.");
|
|
}
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// event handlers
|
|
// ----------------------------------------------------------------------------
|
|
|
|
void GaugeWidgetsPage::OnButtonReset(wxCommandEvent& WXUNUSED(event))
|
|
{
|
|
Reset();
|
|
|
|
CreateGauge();
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnButtonProgress(wxCommandEvent& event)
|
|
{
|
|
wxButton *b = (wxButton *)event.GetEventObject();
|
|
if ( !m_timer )
|
|
{
|
|
StartTimer(b);
|
|
}
|
|
else // stop the running timer
|
|
{
|
|
StopTimer(b);
|
|
|
|
wxLogMessage("Stopped the timer.");
|
|
}
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnButtonIndeterminateProgress(wxCommandEvent& event)
|
|
{
|
|
wxButton *b = (wxButton *)event.GetEventObject();
|
|
if ( !m_timer )
|
|
{
|
|
StartTimer(b);
|
|
}
|
|
else // stop the running timer
|
|
{
|
|
StopTimer(b);
|
|
|
|
m_gauge->SetValue(0);
|
|
|
|
wxLogMessage("Stopped the timer.");
|
|
}
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnButtonClear(wxCommandEvent& WXUNUSED(event))
|
|
{
|
|
m_gauge->SetValue(0);
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnButtonSetRange(wxCommandEvent& WXUNUSED(event))
|
|
{
|
|
unsigned long val;
|
|
if ( !m_textRange->GetValue().ToULong(&val) )
|
|
return;
|
|
|
|
m_range = val;
|
|
m_gauge->SetRange(val);
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnButtonSetValue(wxCommandEvent& WXUNUSED(event))
|
|
{
|
|
unsigned long val;
|
|
if ( !m_textValue->GetValue().ToULong(&val) )
|
|
return;
|
|
|
|
m_gauge->SetValue(val);
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnUpdateUIValueButton(wxUpdateUIEvent& event)
|
|
{
|
|
unsigned long val;
|
|
event.Enable( m_textValue->GetValue().ToULong(&val) && (val <= m_range) );
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnUpdateUIRangeButton(wxUpdateUIEvent& event)
|
|
{
|
|
unsigned long val;
|
|
event.Enable( m_textRange->GetValue().ToULong(&val) );
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnUpdateUIResetButton(wxUpdateUIEvent& event)
|
|
{
|
|
event.Enable( m_chkVert->GetValue() || m_chkSmooth->GetValue() ||
|
|
m_chkProgress->GetValue() );
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnCheckOrRadioBox(wxCommandEvent& WXUNUSED(event))
|
|
{
|
|
CreateGauge();
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnProgressTimer(wxTimerEvent& WXUNUSED(event))
|
|
{
|
|
int val = m_gauge->GetValue();
|
|
if ( (unsigned)val < m_range )
|
|
{
|
|
m_gauge->SetValue(val + 1);
|
|
}
|
|
else // reached the end
|
|
{
|
|
wxButton *btn = (wxButton *)FindWindow(GaugePage_Progress);
|
|
wxCHECK_RET( btn, "no progress button?" );
|
|
|
|
StopTimer(btn);
|
|
}
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnIndeterminateProgressTimer(wxTimerEvent& WXUNUSED(event))
|
|
{
|
|
m_gauge->Pulse();
|
|
}
|
|
|
|
void GaugeWidgetsPage::OnUpdateUICurValueText(wxUpdateUIEvent& event)
|
|
{
|
|
event.SetText( wxString::Format("%d", m_gauge->GetValue()));
|
|
}
|
|
|
|
#endif
|
|
// wxUSE_GAUGE
|