/////////////////////////////////////////////////////////////////////////////
// Name: validate.cpp
-// Purpose: wxWindows validation sample
+// Purpose: wxWindows validator sample
// Author: Julian Smart
// Modified by:
// Created: 04/01/98
// RCS-ID: $Id$
-// Copyright: (c) Julian Smart and Markus Holzem
-// Licence: wxWindows license
+// Copyright: (c) Julian Smart
+// Licence: wxWindows license
/////////////////////////////////////////////////////////////////////////////
+// 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.
+
#ifdef __GNUG__
-// #pragma implementation
-// #pragma interface
-#endif
+# pragma implementation
+#endif // __GNUG__
// For compilers that support precompilation, includes "wx/wx.h".
#include "wx/wxprec.h"
#ifdef __BORLANDC__
-#pragma hdrstop
-#endif
+# pragma hdrstop
+#endif // __BORLANDC__
#ifndef WX_PRECOMP
-#include "wx/wx.h"
-#endif
+# include "wx/wx.h"
+#endif // WX_PRECOMP
+
+#include "validate.h"
+#include "wx/sizer.h"
+#include "wx/valgen.h"
#include "wx/valtext.h"
-#include "validate.h"
+// ----------------------------------------------------------------------------
+// Global data
+// ----------------------------------------------------------------------------
-BEGIN_EVENT_TABLE(MyFrame, wxFrame)
- EVT_MENU(wxID_EXIT, MyFrame::OnQuit)
- EVT_MENU(VALIDATE_TEST_DIALOG, MyFrame::OnTestDialog)
-END_EVENT_TABLE()
+MyData g_data;
-IMPLEMENT_APP(MyApp)
+wxString g_listbox_choices[] =
+ {"one", "two", "three"};
+
+wxString g_combobox_choices[] =
+ {"yes", "no", "maybe"};
-MyData g_data;
+wxString g_radiobox_choices[] =
+ {"green", "yellow", "red"};
-bool MyApp::OnInit(void)
+// ----------------------------------------------------------------------------
+// MyData
+// ----------------------------------------------------------------------------
+
+MyData::MyData()
{
- // Create the main frame window
- MyFrame *frame = new MyFrame((wxFrame *) NULL, (char *) "Validation Test", 50, 50, 300, 250);
+ // 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. It would be nice to
+ // enhance this so that validation would occur when the text
+ // control loses focus.
+ m_string = "Spaces are invalid here";
+ m_listbox_choices.Add(0);
+}
- // Give it an icon
+// ----------------------------------------------------------------------------
+// MyApp
+// ----------------------------------------------------------------------------
+
+IMPLEMENT_APP(MyApp)
+
+bool MyApp::OnInit()
+{
+ // Create and display the main frame window.
+ MyFrame *frame = new MyFrame((wxFrame *) NULL, "Validator Test", 50, 50, 300, 250);
+ frame->Show(true);
+ SetTopWindow(frame);
+ return true;
+}
+
+// ----------------------------------------------------------------------------
+// MyFrame
+// ----------------------------------------------------------------------------
+
+BEGIN_EVENT_TABLE(MyFrame, wxFrame)
+ EVT_MENU(wxID_EXIT, MyFrame::OnQuit)
+ EVT_MENU(VALIDATE_TEST_DIALOG, MyFrame::OnTestDialog)
+ EVT_MENU(VALIDATE_TOGGLE_BELL, MyFrame::OnToggleBell)
+END_EVENT_TABLE()
+
+MyFrame::MyFrame(wxFrame *frame, const char *title, int x, int y, int w, int h)
+ : wxFrame(frame, -1, title, wxPoint(x, y), wxSize(w, h)),
+ m_silent(true)
+{
#ifdef __WXMSW__
- frame->SetIcon(wxIcon("mondrian"));
-#endif
-#ifdef __X__
- frame->SetIcon(wxIcon("aiai.xbm"));
-#endif
+ SetIcon(wxIcon(_T("mondrian")));
+#endif // __WXMSW__
- // Make a menubar
- wxMenu *file_menu = new wxMenu;
+ // Create a listbox to display the validated data.
+ m_listbox = new wxListBox(this, -1);
+ m_listbox->Append(wxString(_T("Try 'File|Test' to see how validators work.")));
- file_menu->Append(VALIDATE_TEST_DIALOG, "&Test dialog");
- file_menu->Append(wxID_EXIT, "E&xit");
- wxMenuBar *menu_bar = new wxMenuBar;
- menu_bar->Append(file_menu, "File");
- frame->SetMenuBar(menu_bar);
+ wxMenu *file_menu = new wxMenu;
- frame->CreateStatusBar(1);
+ file_menu->Append(VALIDATE_TEST_DIALOG, "&Test", "Demonstrate validators");
+ file_menu->Append(VALIDATE_TOGGLE_BELL, "&Bell on error", "Toggle bell on error", true);
+ file_menu->AppendSeparator();
+ file_menu->Append(wxID_EXIT, "E&xit");
- // Show the frame
- frame->Show(TRUE);
+ wxMenuBar *menu_bar = new wxMenuBar;
+ menu_bar->Append(file_menu, "File");
+ SetMenuBar(menu_bar);
- SetTopWindow(frame);
+ // All validators share a common (static) flag that controls
+ // whether they beep on error. Here we turn it off:
+ wxValidator::SetBellOnError(m_silent);
+ file_menu->Check(VALIDATE_TOGGLE_BELL, !wxValidator::IsSilent());
- return TRUE;
+ CreateStatusBar(1);
}
-// My frame constructor
-MyFrame::MyFrame(wxFrame *frame, char *title, int x, int y, int w, int h):
- wxFrame(frame, -1, title, wxPoint(x, y), wxSize(w, h))
-{}
-
void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event))
{
- Close(TRUE);
+ Close(true);
}
void MyFrame::OnTestDialog(wxCommandEvent& WXUNUSED(event))
{
- MyDialog dialog(this, "Validation test dialog", wxPoint(100, 100), wxSize(340, 170));
-
- dialog.ShowModal();
+ // 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(_T("string: ")) + g_data.m_string);
+ 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(_T("listbox choice(s): ")) + g_listbox_choices[j]);
+ }
+
+ wxString checkbox_state(g_data.m_checkbox_state ? _T("checked") : _T("unchecked"));
+ m_listbox->Append(wxString(_T("checkbox: ")) + checkbox_state);
+ m_listbox->Append(wxString(_T("combobox: ")) + g_data.m_combobox_choice);
+ m_listbox->Append(wxString(_T("radiobox: ")) + g_radiobox_choices[g_data.m_radiobox_choice]);
+ }
}
-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|wxDIALOG_MODAL)
+void MyFrame::OnToggleBell(wxCommandEvent& event)
{
- wxButton *but1 = new wxButton(this, wxID_OK, "OK", wxPoint(250, 10), wxSize(80, 30));
- (void)new wxButton(this, wxID_CANCEL, "Cancel", wxPoint(250, 60), wxSize(80, 30));
+ m_silent = !m_silent;
+ wxValidator::SetBellOnError(m_silent);
+ event.Skip();
+}
- (void)new wxTextCtrl(this, VALIDATE_TEXT, "",
- wxPoint(10, 10), wxSize(120, -1), 0, wxTextValidator(wxFILTER_ALPHA, &g_data.m_string));
+// ----------------------------------------------------------------------------
+// MyDialog
+// ----------------------------------------------------------------------------
- SetBackgroundColour(wxColour(0,0,255));
+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|wxDIALOG_MODAL|wxRESIZE_BORDER)
+{
+ // Sizers automatically ensure a workable layout.
+ wxBoxSizer *mainsizer = new wxBoxSizer( wxVERTICAL );
+ wxFlexGridSizer *flexgridsizer = new wxFlexGridSizer(2, 2, 5, 5);
+
+ // Create and add controls to sizers. Note that a member variable
+ // of g_data is bound to each control upon construction. There is
+ // currently no easy way to substitute a different validator or a
+ // different transfer variable after a control has been constructed.
+
+ // Pointers to some of these controls are saved in member variables
+ // so that we can use them elsewhere, like this one.
+ text = new wxTextCtrl(this, VALIDATE_TEXT, "",
+ wxPoint(10, 10), wxSize(120, -1), 0,
+ wxTextValidator(wxFILTER_ALPHA, &g_data.m_string));
+ flexgridsizer->Add(text);
+
+ // 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",
+ wxPoint(130, 10), wxSize(120, -1), 0,
+ wxGenericValidator(&g_data.m_checkbox_state)));
+
+ flexgridsizer->Add(new wxListBox((wxWindow*)this, VALIDATE_LIST,
+ wxPoint(10, 30), wxSize(120, -1),
+ 3, g_listbox_choices, wxLB_MULTIPLE,
+ wxGenericValidator(&g_data.m_listbox_choices)));
+
+ combobox = new wxComboBox((wxWindow*)this, VALIDATE_COMBO, "",
+ wxPoint(130, 30), wxSize(120, -1),
+ 3, g_combobox_choices, 0L,
+ wxGenericValidator(&g_data.m_combobox_choice));
+ flexgridsizer->Add(combobox);
+
+ mainsizer->Add(flexgridsizer, 1, wxGROW | wxALL, 10);
+
+ mainsizer->Add(new wxRadioBox((wxWindow*)this, VALIDATE_RADIO, "Pick a color",
+ wxPoint(10, 100), wxSize(-1, -1),
+ 3, g_radiobox_choices, 1, wxRA_SPECIFY_ROWS,
+ wxGenericValidator(&g_data.m_radiobox_choice)),
+ 0, wxGROW | wxALL, 10);
+
+ wxGridSizer *gridsizer = new wxGridSizer(2, 2, 5, 5);
+
+ wxButton *ok_button = new wxButton(this, wxID_OK, "OK", wxPoint(250, 70), wxSize(80, 30));
+ ok_button->SetDefault();
+ gridsizer->Add(ok_button);
+ gridsizer->Add(new wxButton(this, wxID_CANCEL, "Cancel", wxPoint(250, 100), wxSize(80, 30)));
+
+ mainsizer->Add(gridsizer, 0, wxGROW | wxALL, 10);
+
+ SetSizer(mainsizer);
+ mainsizer->SetSizeHints(this);
+}
- but1->SetFocus();
- but1->SetDefault();
+bool MyDialog::TransferDataToWindow()
+{
+ bool r = wxDialog::TransferDataToWindow();
+ // These function calls have to be made here, after the
+ // dialog has been created.
+ text->SetFocus();
+ combobox->SetSelection(0);
+ return r;
}