wxWidgets/samples/validate/validate.cpp

677 lines
23 KiB
C++

/////////////////////////////////////////////////////////////////////////////
// Name: validate.cpp
// Purpose: wxWidgets validator sample
// Author: Julian Smart
// Modified by:
// Created: 04/01/98
// Copyright: (c) Julian Smart
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
// See online help for an overview of validators. In general, a
// validator transfers data between a control and a variable.
// It may also test for validity of a string transferred to or
// from a text control. All validators transfer data, but not
// all test validity, so don't be confused by the name.
// For compilers that support precompilation, includes "wx/wx.h".
#include "wx/wxprec.h"
#ifndef WX_PRECOMP
#include "wx/wx.h"
#endif // WX_PRECOMP
#include "validate.h"
#include "wx/sizer.h"
#include "wx/valgen.h"
#include "wx/valtext.h"
#include "wx/valnum.h"
#ifndef wxHAS_IMAGES_IN_RESOURCES
#include "../sample.xpm"
#endif
// ----------------------------------------------------------------------------
// Global data
// ----------------------------------------------------------------------------
wxString g_listbox_choices[] =
{"one", "two", "three"};
wxString g_combobox_choices[] =
{"yes", "no (doesn't validate)", "maybe (doesn't validate)"};
wxString g_radiobox_choices[] =
{"green", "yellow", "red"};
MyData g_data;
// ----------------------------------------------------------------------------
// MyData
// ----------------------------------------------------------------------------
MyData::MyData()
{
// This string will be passed to an alpha-only validator, which
// will complain because spaces aren't alpha. Note that validation
// is performed only when 'OK' is pressed.
m_string = "Spaces are invalid here";
m_string2 = "Valid text";
m_listbox_choices.Add(0);
m_combobox_choice = g_combobox_choices[0];
m_intValue = 0;
m_smallIntValue = 3;
m_doubleValue = 12354.31;
m_percentValue = 0.25;
}
// ----------------------------------------------------------------------------
// MyComboBoxValidator
// ----------------------------------------------------------------------------
bool MyComboBoxValidator::Validate(wxWindow *WXUNUSED(parent))
{
wxASSERT(GetWindow()->IsKindOf(CLASSINFO(wxComboBox)));
wxComboBox* cb = (wxComboBox*)GetWindow();
if (cb->GetValue() == g_combobox_choices[1] ||
cb->GetValue() == g_combobox_choices[2])
{
// we accept any string != g_combobox_choices[1|2] !
wxLogError("Invalid combo box text!");
return false;
}
if (m_var)
*m_var = cb->GetValue();
return true;
}
bool MyComboBoxValidator::TransferToWindow()
{
wxASSERT(GetWindow()->IsKindOf(CLASSINFO(wxComboBox)));
if ( m_var )
{
wxComboBox* cb = (wxComboBox*)GetWindow();
if ( !cb )
return false;
cb->SetValue(*m_var);
}
return true;
}
bool MyComboBoxValidator::TransferFromWindow()
{
wxASSERT(GetWindow()->IsKindOf(CLASSINFO(wxComboBox)));
if ( m_var )
{
wxComboBox* cb = (wxComboBox*)GetWindow();
if ( !cb )
return false;
*m_var = cb->GetValue();
}
return true;
}
// ----------------------------------------------------------------------------
// MyApp
// ----------------------------------------------------------------------------
wxIMPLEMENT_APP(MyApp);
bool MyApp::OnInit()
{
if ( !wxApp::OnInit() )
return false;
// Create and display the main frame window.
MyFrame *frame = new MyFrame((wxFrame *) NULL, "Validator Test",
50, 50, 300, 250);
frame->Show(true);
return true;
}
// ----------------------------------------------------------------------------
// MyFrame
// ----------------------------------------------------------------------------
wxBEGIN_EVENT_TABLE(MyFrame, wxFrame)
EVT_MENU(wxID_EXIT, MyFrame::OnQuit)
EVT_MENU(VALIDATE_TEST_DIALOG, MyFrame::OnTestDialog)
EVT_MENU(VALIDATE_TOGGLE_BELL, MyFrame::OnToggleBell)
wxEND_EVENT_TABLE()
MyFrame::MyFrame(wxFrame *frame, const wxString&title, int x, int y, int w, int h)
: wxFrame(frame, wxID_ANY, title, wxPoint(x, y), wxSize(w, h)),
m_silent(true)
{
SetIcon(wxICON(sample));
// Create a listbox to display the validated data.
m_listbox = new wxListBox(this, wxID_ANY);
m_listbox->Append(wxString("Try 'File|Test' to see how validators work."));
wxMenu *file_menu = new wxMenu;
file_menu->Append(VALIDATE_TEST_DIALOG, "&Test dialog...\tCtrl-T", "Demonstrate validators");
file_menu->AppendCheckItem(VALIDATE_TOGGLE_BELL, "&Bell on error", "Toggle bell on error");
file_menu->AppendSeparator();
file_menu->Append(wxID_EXIT, "E&xit");
wxMenuBar *menu_bar = new wxMenuBar;
menu_bar->Append(file_menu, "&File");
SetMenuBar(menu_bar);
// All validators share a common (static) flag that controls
// whether they beep on error. Here we turn it off:
wxValidator::SuppressBellOnError(m_silent);
file_menu->Check(VALIDATE_TOGGLE_BELL, !wxValidator::IsSilent());
#if wxUSE_STATUSBAR
CreateStatusBar(1);
#endif // wxUSE_STATUSBAR
}
void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event))
{
Close(true);
}
void MyFrame::OnTestDialog(wxCommandEvent& WXUNUSED(event))
{
// The validators defined in the dialog implementation bind controls
// and variables together. Values are transferred between them behind
// the scenes, so here we don't have to query the controls for their
// values.
MyDialog dialog(this, "Validator demonstration");
// When the dialog is displayed, validators automatically transfer
// data from variables to their corresponding controls.
if ( dialog.ShowModal() == wxID_OK )
{
// 'OK' was pressed, so controls that have validators are
// automatically transferred to the variables we specified
// when we created the validators.
m_listbox->Clear();
m_listbox->Append(wxString("string: ") + g_data.m_string);
m_listbox->Append(wxString("string #2: ") + g_data.m_string2);
for(unsigned int i = 0; i < g_data.m_listbox_choices.GetCount(); ++i)
{
int j = g_data.m_listbox_choices[i];
m_listbox->Append(wxString("listbox choice(s): ") + g_listbox_choices[j]);
}
wxString checkbox_state(g_data.m_checkbox_state ? "checked" : "unchecked");
m_listbox->Append(wxString("checkbox: ") + checkbox_state);
m_listbox->Append(wxString("combobox: ") + g_data.m_combobox_choice);
m_listbox->Append(wxString("radiobox: ") + g_radiobox_choices[g_data.m_radiobox_choice]);
m_listbox->Append(wxString::Format("integer value: %d", g_data.m_intValue));
m_listbox->Append(wxString::Format("small int value: %u", g_data.m_smallIntValue));
m_listbox->Append(wxString::Format("double value: %.3f", g_data.m_doubleValue));
m_listbox->Append(wxString::Format("percent value: %.4f", double(g_data.m_percentValue)));
}
}
void MyFrame::OnToggleBell(wxCommandEvent& event)
{
m_silent = !m_silent;
wxValidator::SuppressBellOnError(m_silent);
event.Skip();
}
// ----------------------------------------------------------------------------
// MyDialog
// ----------------------------------------------------------------------------
MyDialog::MyDialog( wxWindow *parent, const wxString& title,
const wxPoint& pos, const wxSize& size, const long WXUNUSED(style) ) :
wxDialog(parent, VALIDATE_DIALOG_ID, title, pos, size, wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER)
{
// setup the flex grid sizer
// -------------------------
wxFlexGridSizer *flexgridsizer = new wxFlexGridSizer(3, 2, 5, 5);
// Create and add controls to sizers.
// Pointers to some of these controls are saved in member variables
// so that we can use them elsewhere, like this one.
m_text = new wxTextCtrl(this, VALIDATE_TEXT);
m_text->SetToolTip("wxTextValidator not set");
m_text->SetHint("Enter some text here, please...");
flexgridsizer->Add(m_text, 1, wxGROW);
// Make it possible to change the wxTextValidator for m_text at runtime.
wxButton* const button =
new wxButton(this, wxID_ANY, "Set new wxTextValidator...");
button->Bind(wxEVT_BUTTON, &MyDialog::OnChangeValidator, this);
flexgridsizer->Add(button, wxSizerFlags().Center());
flexgridsizer->Add(new wxListBox((wxWindow*)this, VALIDATE_LIST,
wxDefaultPosition, wxDefaultSize,
3, g_listbox_choices, wxLB_MULTIPLE,
wxGenericValidator(&g_data.m_listbox_choices)),
1, wxGROW);
m_combobox = new wxComboBox(this, VALIDATE_COMBO, wxEmptyString,
wxDefaultPosition, wxDefaultSize,
3, g_combobox_choices, 0L,
MyComboBoxValidator(&g_data.m_combobox_choice));
m_combobox->SetToolTip("uses a custom validator (MyComboBoxValidator)");
flexgridsizer->Add(m_combobox, 1, wxALIGN_CENTER);
// This wxCheckBox* doesn't need to be assigned to any pointer
// because we don't use it elsewhere--it can be anonymous.
// We don't need any such pointer to query its state, which
// can be gotten directly from g_data.
flexgridsizer->Add(new wxCheckBox(this, VALIDATE_CHECK, "Sample checkbox",
wxDefaultPosition, wxDefaultSize, 0,
wxGenericValidator(&g_data.m_checkbox_state)),
1, wxALIGN_CENTER|wxALL, 15);
flexgridsizer->AddGrowableCol(0);
flexgridsizer->AddGrowableCol(1);
flexgridsizer->AddGrowableRow(1);
// setup a sizer with the controls for numeric validators
// ------------------------------------------------------
wxFlexGridSizer* const
numSizer = new wxFlexGridSizer(5, FromDIP(wxSize(5, 5)));
const wxSizerFlags center = wxSizerFlags().CenterVertical();
wxIntegerValidator<int> valInt(&g_data.m_intValue,
wxNUM_VAL_THOUSANDS_SEPARATOR |
wxNUM_VAL_ZERO_AS_BLANK);
valInt.SetMin(0); // Only allow positive numbers
m_numericTextInt = new wxTextCtrl
(
this,
wxID_ANY,
"",
wxDefaultPosition,
wxDefaultSize,
wxTE_RIGHT,
valInt
);
numSizer->Add(new wxStaticText(this, wxID_ANY, "Positive integer:"),
center);
numSizer->Add(m_numericTextInt, wxSizerFlags(center).Expand());
numSizer->AddSpacer(FromDIP(10));
m_numericTextDouble = new wxTextCtrl
(
this,
wxID_ANY,
"",
wxDefaultPosition,
wxDefaultSize,
wxTE_RIGHT,
wxMakeFloatingPointValidator
(
3,
&g_data.m_doubleValue,
wxNUM_VAL_THOUSANDS_SEPARATOR |
wxNUM_VAL_NO_TRAILING_ZEROES
)
);
numSizer->Add(new wxStaticText(this, wxID_ANY, "Up to 3 decimals:"),
center);
numSizer->Add(m_numericTextDouble, wxSizerFlags(center).Expand());
wxIntegerValidator<unsigned short> smallIntVal(&g_data.m_smallIntValue);
smallIntVal.SetRange(1, 5);
numSizer->Add(new wxStaticText(this, wxID_ANY, "Int between 1 and 5:"),
center);
numSizer->Add(new wxTextCtrl(this, wxID_ANY, "",
wxDefaultPosition, wxDefaultSize, wxTE_RIGHT,
smallIntVal),
wxSizerFlags(center).Expand());
numSizer->AddSpacer(FromDIP(10));
wxFloatingPointValidator<float> percentVal(&g_data.m_percentValue);
percentVal.SetPrecision(2);
percentVal.SetFactor(100.0);
numSizer->Add(new wxStaticText(this, wxID_ANY, "Value displayed in %:"),
center);
numSizer->Add(new wxTextCtrl(this, wxID_ANY, "",
wxDefaultPosition, wxDefaultSize, wxTE_RIGHT,
percentVal),
wxSizerFlags(center).Expand());
// setup the main sizer
// --------------------
wxBoxSizer *mainsizer = new wxBoxSizer( wxVERTICAL );
mainsizer->Add(flexgridsizer, 1, wxGROW | wxALL, 10);
mainsizer->Add(new wxRadioBox((wxWindow*)this, VALIDATE_RADIO, "Pick a color",
wxDefaultPosition, wxDefaultSize,
3, g_radiobox_choices, 1, wxRA_SPECIFY_ROWS,
wxGenericValidator(&g_data.m_radiobox_choice)),
0, wxGROW | wxLEFT|wxBOTTOM|wxRIGHT, 10);
mainsizer->Add( numSizer, wxSizerFlags().Expand().DoubleBorder() );
mainsizer->Add(CreateButtonSizer(wxOK | wxCANCEL),
wxSizerFlags().Expand().DoubleBorder());
SetSizer(mainsizer);
mainsizer->SetSizeHints(this);
// make the dialog a bit bigger than its minimal size:
SetSize(GetBestSize()*1.5);
// Now sets the focus to m_text
m_text->SetFocus();
}
void MyDialog::OnChangeValidator(wxCommandEvent& WXUNUSED(event))
{
TextValidatorDialog dialog(this, m_text);
if ( dialog.ShowModal() == wxID_OK )
{
dialog.ApplyValidator();
}
}
// ----------------------------------------------------------------------------
// TextValidatorDialog
// ----------------------------------------------------------------------------
TextValidatorDialog::TextValidatorDialog(wxWindow *parent, wxTextCtrl* txtCtrl)
: wxDialog(parent, wxID_ANY, "wxTextValidator Dialog"),
m_txtCtrl(txtCtrl),
m_noValidation(true),
m_validatorStyle(wxFILTER_NONE)
{
if ( m_txtCtrl )
{
wxTextValidator* txtValidator =
wxDynamicCast(m_txtCtrl->GetValidator(), wxTextValidator);
if ( txtValidator )
{
m_validatorStyle = txtValidator->GetStyle();
if ( m_validatorStyle != wxFILTER_NONE )
m_noValidation = false;
m_charIncludes = txtValidator->GetCharIncludes();
m_charExcludes = txtValidator->GetCharExcludes();
m_includes = txtValidator->GetIncludes();
m_excludes = txtValidator->GetExcludes();
}
}
wxFlexGridSizer *fgSizer = new wxFlexGridSizer(2, FromDIP(wxSize(5, 5)));
const wxSizerFlags center = wxSizerFlags().CenterVertical();
const StyleValidator styleVal(&m_validatorStyle);
wxCheckBox* filterNone = new wxCheckBox(this, Id_None, "wxFILTER_NONE");
filterNone->SetValue(m_noValidation);
fgSizer->Add(filterNone);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "No filtering takes place."));
fgSizer->Add(new wxCheckBox(this, Id_Empty, "wxFILTER_EMPTY"))
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "Empty strings are filtered out."));
fgSizer->Add(new wxCheckBox(this, Id_Ascii, "wxFILTER_ASCII"))
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "Non-ASCII characters are filtered out."));
fgSizer->Add(new wxCheckBox(this, Id_Alpha, "wxFILTER_ALPHA"))
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "Non-alpha characters are filtered out."));
fgSizer->Add(new wxCheckBox(this, Id_Alphanumeric, "wxFILTER_ALPHANUMERIC"))
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "Non-alphanumeric characters are filtered out."));
fgSizer->Add(new wxCheckBox(this, Id_Digits, "wxFILTER_DIGITS"))
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "Non-digit characters are filtered out."));
fgSizer->Add(new wxCheckBox(this, Id_Numeric, "wxFILTER_NUMERIC"))
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "Non-numeric characters are filtered out."));
fgSizer->Add(new wxCheckBox(this, Id_IncludeList, "wxFILTER_INCLUDE_LIST"), center)
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxTextCtrl(this, Id_IncludeListTxt), wxSizerFlags().Expand())
->GetWindow()->Bind(wxEVT_KILL_FOCUS, &TextValidatorDialog::OnKillFocus, this);
fgSizer->Add(new wxCheckBox(this, Id_IncludeCharList, "wxFILTER_INCLUDE_CHAR_LIST"), center)
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxTextCtrl(this, Id_IncludeCharListTxt, wxString(), wxDefaultPosition,
wxDefaultSize, 0, wxGenericValidator(&m_charIncludes)),
wxSizerFlags().Expand())
->GetWindow()->Bind(wxEVT_KILL_FOCUS, &TextValidatorDialog::OnKillFocus, this);
fgSizer->Add(new wxCheckBox(this, Id_ExcludeList, "wxFILTER_EXCLUDE_LIST"), center)
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxTextCtrl(this, Id_ExcludeListTxt), wxSizerFlags().Expand())
->GetWindow()->Bind(wxEVT_KILL_FOCUS, &TextValidatorDialog::OnKillFocus, this);
fgSizer->Add(new wxCheckBox(this, Id_ExcludeCharList, "wxFILTER_EXCLUDE_CHAR_LIST"), center)
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxTextCtrl(this, Id_ExcludeCharListTxt, wxString(), wxDefaultPosition,
wxDefaultSize, 0, wxGenericValidator(&m_charExcludes)),
wxSizerFlags().Expand())
->GetWindow()->Bind(wxEVT_KILL_FOCUS, &TextValidatorDialog::OnKillFocus, this);
fgSizer->Add(new wxCheckBox(this, Id_Xdigits, "wxFILTER_XDIGITS"))
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "Non-xdigit characters are filtered out."));
fgSizer->Add(new wxCheckBox(this, Id_Space, "wxFILTER_SPACE"))
->GetWindow()->SetValidator(styleVal);
fgSizer->Add(new wxStaticText(this, wxID_ANY, "Allow spaces."));
// Set the main sizer.
wxBoxSizer *mainsizer = new wxBoxSizer( wxVERTICAL );
mainsizer->Add(fgSizer, wxSizerFlags(1).Border(wxALL, 10).Expand());
mainsizer->Add(CreateButtonSizer(wxOK | wxCANCEL),
wxSizerFlags().Expand().DoubleBorder());
SetSizer(mainsizer);
mainsizer->SetSizeHints(this);
// Bind event handlers.
Bind(wxEVT_CHECKBOX, &TextValidatorDialog::OnChecked, this);
Bind(wxEVT_UPDATE_UI, &TextValidatorDialog::OnUpdateUI,
this, Id_Ascii, Id_ExcludeCharListTxt);
}
void TextValidatorDialog::OnUpdateUI(wxUpdateUIEvent& event)
{
event.Enable(!m_noValidation);
if ( m_noValidation )
event.Check(false);
}
void TextValidatorDialog::OnChecked(wxCommandEvent& event)
{
if ( event.GetId() == Id_None )
{
m_noValidation = event.IsChecked();
if ( m_noValidation )
{
long style = wxFILTER_NONE;
// we should keep this flag on if it has been set.
if ( HasFlag(wxFILTER_EMPTY) )
style = wxFILTER_EMPTY;
m_validatorStyle = style;
m_charIncludes.clear();
m_charExcludes.clear();
m_includes.clear();
m_excludes.clear();
}
}
}
void TextValidatorDialog::OnKillFocus(wxFocusEvent &event)
{
wxTextCtrl* txtCtrl = wxDynamicCast(event.GetEventObject(), wxTextCtrl);
if ( txtCtrl && txtCtrl->IsModified() )
{
const int id = event.GetId();
if ( id == Id_IncludeCharListTxt )
{
m_charIncludes = txtCtrl->GetValue();
}
else if ( id == Id_ExcludeCharListTxt )
{
m_charExcludes = txtCtrl->GetValue();
}
else if ( id == Id_IncludeListTxt )
{
m_includes = wxSplit(txtCtrl->GetValue(), ' ');
}
else if ( id == Id_ExcludeListTxt )
{
m_excludes = wxSplit(txtCtrl->GetValue(), ' ');
}
}
event.Skip();
}
void TextValidatorDialog::ApplyValidator()
{
if ( !m_txtCtrl )
return;
wxString tooltip = "uses wxTextValidator with ";
if ( m_noValidation )
{
tooltip += "wxFILTER_NONE|";
}
else
{
if ( HasFlag(wxFILTER_ASCII) )
tooltip += "wxFILTER_ASCII|";
if ( HasFlag(wxFILTER_ALPHA) )
tooltip += "wxFILTER_ALPHA|";
if ( HasFlag(wxFILTER_ALPHANUMERIC) )
tooltip += "wxFILTER_ALPHANUMERIC|";
if ( HasFlag(wxFILTER_DIGITS) )
tooltip += "wxFILTER_DIGITS|";
if ( HasFlag(wxFILTER_NUMERIC) )
tooltip += "wxFILTER_NUMERIC|";
if ( HasFlag(wxFILTER_XDIGITS) )
tooltip += "wxFILTER_XDIGITS|";
if ( HasFlag(wxFILTER_SPACE) )
tooltip += "wxFILTER_SPACE|";
if ( HasFlag(wxFILTER_INCLUDE_LIST) )
tooltip += "wxFILTER_INCLUDE_LIST|";
if ( HasFlag(wxFILTER_INCLUDE_CHAR_LIST) )
tooltip += "wxFILTER_INCLUDE_CHAR_LIST|";
if ( HasFlag(wxFILTER_EXCLUDE_LIST) )
tooltip += "wxFILTER_EXCLUDE_LIST|";
if ( HasFlag(wxFILTER_EXCLUDE_CHAR_LIST) )
tooltip += "wxFILTER_EXCLUDE_CHAR_LIST|";
}
if ( HasFlag(wxFILTER_EMPTY) )
{
tooltip += "wxFILTER_EMPTY|";
}
tooltip.RemoveLast(); // remove the trailing '|' char.
if ( !m_charIncludes.empty() )
{
tooltip += "\nAllowed chars: ";
tooltip += m_charIncludes;
}
if ( !m_charExcludes.empty() )
{
tooltip += "\nDisallowed chars: ";
tooltip += m_charExcludes;
}
m_txtCtrl->SetToolTip(tooltip);
// Prepare and set the wxTextValidator
wxTextValidator txtVal(m_validatorStyle, &g_data.m_string);
txtVal.SetCharIncludes(m_charIncludes);
txtVal.SetCharExcludes(m_charExcludes);
txtVal.SetIncludes(m_includes);
txtVal.SetExcludes(m_excludes);
m_txtCtrl->SetValidator(txtVal);
m_txtCtrl->SetFocus();
}
bool TextValidatorDialog::StyleValidator::TransferToWindow()
{
wxASSERT( wxDynamicCast(m_validatorWindow, wxCheckBox) );
if ( m_style )
{
wxCheckBox* cb = (wxCheckBox*)GetWindow();
if ( !cb )
return false;
const long style = 1L << (cb->GetId()-wxID_HIGHEST-1);
cb->SetValue((*m_style & style) != 0);
}
return true;
}
bool TextValidatorDialog::StyleValidator::TransferFromWindow()
{
wxASSERT( wxDynamicCast(m_validatorWindow, wxCheckBox) );
if ( m_style )
{
wxCheckBox* cb = (wxCheckBox*)GetWindow();
if ( !cb )
return false;
const long style = 1L << (cb->GetId()-wxID_HIGHEST-1);
if ( cb->IsChecked() )
*m_style |= style;
else
*m_style &= ~style;
}
return true;
}