CrossPlatform GUI Programming with wxWidgets [Electronic resources] نسخه متنی

Custom Dialog Class Implementation

These are the header and implementation files for the PersonalRecordDialog class described in Chapter 9, "Creating Custom Dialogs." It can be found in examples/chap09 on the CD-ROM.

Listing J-1. Header File for PersonalRecordDialog

////////////////////////////////////////////////////////////////////
// Name:        personalrecord.h
// Purpose:     Dialog to get name, age, sex, and voting preference
// Author:      Julian Smart
// Created:     02/28/04 06:52:49
// Copyright:   (c) 2004, Julian Smart
// Licence:     wxWindows license
////////////////////////////////////////////////////////////////////
#ifndef _PERSONALRECORD_H_
#define _PERSONALRECORD_H_
#ifdef __GNUG__
#pragma interface "personalrecord.cpp"
#endif
/*!
* Includes
*/
#include "wx/spinctrl.h"
#include "wx/statline.h"
/*!
* Control identifiers
*/
enum {
ID_PERSONAL_RECORD = 10000,
ID_NAME = 10001,
ID_AGE = 10002,
ID_SEX = 10003,
ID_VOTE = 10006,
ID_RESET = 10004
};
/*!
* PersonalRecordDialog class declaration
*/

class PersonalRecordDialog: public wxDialog
{
DECLARE_CLASS( PersonalRecordDialog )
DECLARE_EVENT_TABLE()
public:
//// Constructors
PersonalRecordDialog( );
PersonalRecordDialog( wxWindow* parent,
wxWindowID id = ID_PERSONAL_RECORD,
const wxString& caption = wxT("Personal Record"),
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = wxCAPTION|wxRESIZE_BORDER|wxSYSTEM_MENU );
/// Member initialization
void Init();
/// Creation
bool Create( wxWindow* parent,
wxWindowID id = ID_PERSONAL_RECORD,
const wxString& caption = wxT("Personal Record"),
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = wxCAPTION|wxRESIZE_BORDER|wxSYSTEM_MENU );
/// Creates the controls and sizers
void CreateControls();
/// Sets the validators for the dialog controls
void SetDialogValidators();
/// Sets the help text for the dialog controls
void SetDialogHelp();
/// Name accessors
void SetName(const wxString& name) { m_name = name; }
wxString GetName() const { return m_name; }

/// Age accessors
void SetAge(int age) { m_age = age; }
int GetAge() const { return m_age; }
/// Sex accessors (male = false, female = true)
void SetSex(bool sex) { sex ? m_sex = 1 : m_sex = 0; }
bool GetSex() const { return m_sex == 1; }
/// Does the person vote?
void SetVote(bool vote) { m_vote = vote; }
bool GetVote() const { return m_vote; }
//// PersonalRecordDialog event handler declarations
/// wxEVT_UPDATE_UI event handler for ID_VOTE
void OnVoteUpdate( wxUpdateUIEvent& event );
/// wxEVT_COMMAND_BUTTON_CLICKED event handler for ID_RESET
void OnResetClick( wxCommandEvent& event );
/// wxEVT_COMMAND_BUTTON_CLICKED event handler for wxID_HELP
void OnHelpClick( wxCommandEvent& event );
//// PersonalRecordDialog member variables
/// Data members
wxString    m_name;
int         m_age;
int         m_sex;
bool        m_vote;
};
#endif
// _PERSONALRECORD_H_

Listing J-2. Implementation File for PersonalRecordDialog

////////////////////////////////////////////////////////////////////
// Name:        personalrecord.cpp
// Purpose:     Dialog to get name, age, sex, and voting preference
// Author:      Julian Smart
// Created:     02/28/04 06:52:49
// Copyright:   (c) 2004, Julian Smart
// Licence:     wxWindows license
////////////////////////////////////////////////////////////////////
#ifdef __GNUG__
#pragma implementation "personalrecord.h"
#endif
// For compilers that support precompilation, includes "wx/wx.h".
#include "wx/wxprec.h"
#ifdef __BORLANDC__
#pragma hdrstop
#endif
#include "wx/valtext.h"
#include "wx/valgen.h"
#include "personalrecord.h"
/*!
* PersonalRecordDialog type definition
*/
IMPLEMENT_CLASS( PersonalRecordDialog, wxDialog )
/*!
* PersonalRecordDialog event table definition
*/
BEGIN_EVENT_TABLE( PersonalRecordDialog, wxDialog )
EVT_UPDATE_UI( ID_VOTE, PersonalRecordDialog::OnVoteUpdate )
EVT_BUTTON( ID_RESET, PersonalRecordDialog::OnResetClick )
EVT_BUTTON( wxID_HELP, PersonalRecordDialog::OnHelpClick )
END_EVENT_TABLE()

/*!
* PersonalRecordDialog constructors
*/
PersonalRecordDialog::PersonalRecordDialog( )
{
Init();
}
PersonalRecordDialog::PersonalRecordDialog( wxWindow* parent,
wxWindowID id, const wxString& caption,
const wxPoint& pos, const wxSize& size, long style )
{
Init();
Create(parent, id, caption, pos, size, style);
}
/// Initialization
void PersonalRecordDialog::Init( )
{
m_name = wxEmptyString;
m_age = 25;
m_sex = false;
m_vote = false;
}
/*!
* PersonalRecord creator
*/
bool PersonalRecordDialog::Create( wxWindow* parent,
wxWindowID id, const wxString& caption,
const wxPoint& pos, const wxSize& size, long style )
{
// We have to set extra styles before creating the
// dialog

SetExtraStyle(wxWS_EX_BLOCK_EVENTS|wxDIALOG_EX_CONTEXTHELP);
if (!wxDialog::Create( parent, id, caption, pos, size, style ))
return false;
CreateControls();
SetDialogHelp();
SetDialogValidators();
// This fits the dialog to the minimum size dictated by
// the sizers
GetSizer()->Fit(this);
// This ensures that the dialog cannot be sized smaller
// than the minimum size
GetSizer()->SetSizeHints(this);
// Centre the dialog on the parent or (if none) screen
Centre();
return true;
}
/*!
* Control creation for PersonalRecordDialog
*/
void PersonalRecordDialog::CreateControls()
{
// A top-level sizer
wxBoxSizer* topSizer = new wxBoxSizer(wxVERTICAL);
this->SetSizer(topSizer);
// A second box sizer to give more space around the controls
wxBoxSizer* boxSizer = new wxBoxSizer(wxVERTICAL);
topSizer->Add(boxSizer, 0, wxALIGN_CENTER_HORIZONTAL|wxALL, 5);
// A friendly message
wxStaticText* descr = new wxStaticText( this, wxID_STATIC,
wxT("Please enter your name, age and sex, 
and specify whether you wish to\nvote in
 a general election."), wxDefaultPosition, wxDefaultSize, 0 );
boxSizer->Add(descr, 0, wxALIGN_LEFT|wxALL, 5);
// Spacer

boxSizer->Add(5, 5, 0, wxALIGN_CENTER_HORIZONTAL|wxALL, 5);
// Label for the name text control
wxStaticText* nameLabel = new wxStaticText ( this, wxID_STATIC,
wxT("&Name:"), wxDefaultPosition, wxDefaultSize, 0 );
boxSizer->Add(nameLabel, 0, wxALIGN_LEFT|wxALL, 5);
// A text control for the user's name
wxTextCtrl* nameCtrl = new wxTextCtrl ( this,
 ID_NAME, wxT("Emma"), wxDefaultPosition,
 wxDefaultSize, 0 );
boxSizer->Add(nameCtrl, 0, wxGROW|wxALL, 5);
// A horizontal box sizer to contain age, sex and vote
wxBoxSizer* ageSexVoteBox = new wxBoxSizer(wxHORIZONTAL);
boxSizer->Add(ageSexVoteBox, 0, wxGROW|wxALL, 5);
// Label for the age control
wxStaticText* ageLabel = new wxStaticText ( this, wxID_STATIC,
wxT("&Age:"), wxDefaultPosition, wxDefaultSize, 0 );
ageSexVoteBox->Add(ageLabel, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5);
// A spin control for the user's age
wxSpinCtrl* ageSpin = new wxSpinCtrl ( this, ID_AGE,
wxEmptyString, wxDefaultPosition, wxSize(60, -1),
wxSP_ARROW_KEYS, 0, 120, 25 );
ageSexVoteBox->Add(ageSpin, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5);
// Label for the sex control
wxStaticText* sexLabel = new wxStaticText ( this, wxID_STATIC,
wxT("&Sex:"), wxDefaultPosition, wxDefaultSize, 0 );
ageSexVoteBox->Add(sexLabel, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5);
// Create the sex choice control
wxString sexStrings[] = {
wxT("Male"),
wxT("Female")
};
wxChoice* sexChoice = new wxChoice ( this, ID_SEX,
wxDefaultPosition, wxSize(80, -1), WXSIZEOF(sexStrings),
sexStrings, 0 );
sexChoice->SetStringSelection(wxT("Female"));
ageSexVoteBox->Add(sexChoice, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5);

// Add a spacer that stretches to push the Vote control
// to the right
ageSexVoteBox->Add(5, 5, 1, wxALIGN_CENTER_VERTICAL|wxALL, 5);
wxCheckBox* voteCheckBox = new wxCheckBox( this, ID_VOTE,
wxT("&Vote"), wxDefaultPosition, wxDefaultSize, 0 );
voteCheckBox ->SetValue(true);
ageSexVoteBox->Add(voteCheckBox, 0,
wxALIGN_CENTER_VERTICAL|wxALL, 5);
// A dividing line before the OK and Cancel buttons
wxStaticLine* line = new wxStaticLine ( this, wxID_STATIC,
wxDefaultPosition, wxDefaultSize, wxLI_HORIZONTAL );
boxSizer->Add(line, 0, wxGROW|wxALL, 5);
// A horizontal box sizer to contain Reset, OK, Cancel and Help
wxBoxSizer* okCancelBox = new wxBoxSizer(wxHORIZONTAL);
boxSizer->Add(okCancelBox, 0, wxALIGN_CENTER_HORIZONTAL|wxALL, 5);
// The Reset button
wxButton* reset = new wxButton( this, ID_RESET, wxT("&Reset"),
wxDefaultPosition, wxDefaultSize, 0 );
okCancelBox->Add(reset, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5);
// The OK button
wxButton* ok = new wxButton ( this, wxID_OK, wxT("&OK"),
wxDefaultPosition, wxDefaultSize, 0 );
okCancelBox->Add(ok, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5);
// The Cancel button
wxButton* cancel = new wxButton ( this, wxID_CANCEL,
wxT("&Cancel"), wxDefaultPosition, wxDefaultSize, 0 );
okCancelBox->Add(cancel, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5);
// The Help button
wxButton* help = new wxButton( this, wxID_HELP, wxT("&Help"),
wxDefaultPosition, wxDefaultSize, 0 );
okCancelBox->Add(help, 0, wxALIGN_CENTER_VERTICAL|wxALL, 5);
}

// Set the validators for the dialog controls
void PersonalRecordDialog::SetDialogValidators()
{
FindWindow(ID_NAME)->SetValidator(
wxTextValidator(wxFILTER_ALPHA, & m_name));
FindWindow(ID_AGE)->SetValidator(
wxGenericValidator(& m_age));
FindWindow(ID_SEX)->SetValidator(
wxGenericValidator(& m_sex));
FindWindow(ID_VOTE)->SetValidator(
wxGenericValidator(& m_vote));
}
// Sets the help text for the dialog controls
void PersonalRecordDialog::SetDialogHelp()
{
wxString nameHelp = wxT("Enter your full name.");
wxString ageHelp = wxT("Specify your age.");
wxString sexHelp = wxT("Specify your gender, male or female.");
wxString voteHelp = wxT("Check this if you wish to vote.");
FindWindow(ID_NAME)->SetHelpText(nameHelp);
FindWindow(ID_NAME)->SetToolTip(nameHelp);
FindWindow(ID_AGE)->SetHelpText(ageHelp);
FindWindow(ID_AGE)->SetToolTip(ageHelp);
FindWindow(ID_SEX)->SetHelpText(sexHelp);
FindWindow(ID_SEX)->SetToolTip(sexHelp);
FindWindow(ID_VOTE)->SetHelpText(voteHelp);
FindWindow(ID_VOTE)->SetToolTip(voteHelp);
}
/*!
* wxEVT_UPDATE_UI event handler for ID_CHECKBOX
*/
void PersonalRecordDialog::OnVoteUpdate( wxUpdateUIEvent& event )
{
wxSpinCtrl* ageCtrl = (wxSpinCtrl*) FindWindow(ID_AGE);
if (ageCtrl->GetValue() < 18)
{
event.Enable(false)
event.Check(false);
}
else
event.Enable(true);
}
/*!
* wxEVT_COMMAND_BUTTON_CLICKED event handler for ID_RESET
*/
void PersonalRecordDialog::OnResetClick( wxCommandEvent& event )
{
Init();
TransferDataToWindow();
}
/*!
* wxEVT_COMMAND_BUTTON_CLICKED event handler for wxID_HELP
*/
void PersonalRecordDialog::OnHelpClick( wxCommandEvent& event )
{
// Normally we would wish to display proper online help.
// For this example, we're just using a message box.
/*
wxGetApp().GetHelpController().
DisplaySection(wxT("Personal record dialog"));
*/
wxString helpText =
wxT("Please enter your full name, age and gender.\n")
wxT("Also indicate your willingness to vote in general elections.\n\n")
wxT("No non-alphabetical characters are allowed in the name field.\n")
wxT("Try to be honest about your age.");
wxMessageBox(helpText,
wxT("Personal Record Dialog Help"),
wxOK|wxICON_INFORMATION, this);
}