X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/cba2db0c2969f9b83e8a1736e260d22200e99a99..6a121452ee63c7cfce8d2907e6209397dc9bcecb:/docs/latex/wx/tvalidat.tex diff --git a/docs/latex/wx/tvalidat.tex b/docs/latex/wx/tvalidat.tex index 9d910371ee..93105606a5 100644 --- a/docs/latex/wx/tvalidat.tex +++ b/docs/latex/wx/tvalidat.tex @@ -1,4 +1,4 @@ -\section{Validator overview}\label{validatoroverview} +\section{wxValidator overview}\label{validatoroverview} Classes: \helpref{wxValidator}{wxvalidator}, \helpref{wxTextValidator}{wxtextvalidator}, \helpref{wxGenericValidator}{wxgenericvalidator} @@ -19,7 +19,7 @@ or you can write your own. Here is an example of wxTextValidator usage. \begin{verbatim} - wxTextCtrl *txt1 = new wxTextCtrl(this, VALIDATE_TEXT, "", + wxTextCtrl *txt1 = new wxTextCtrl(this, -1, wxT(""), wxPoint(10, 10), wxSize(100, 80), 0, wxTextValidator(wxFILTER_ALPHA, &g_data.m_string)); \end{verbatim} @@ -50,7 +50,7 @@ data for the control. If such a variable address is not supplied by the user, th the validator should store the data internally. The \helpref{wxValidator::Validate}{wxvalidatorvalidate} member function should return -TRUE if the data in the control (not the C++ variable) is valid. It should also show +true if the data in the control (not the C++ variable) is valid. It should also show an appropriate message if data was not valid. The \helpref{wxValidator::TransferToWindow}{wxvalidatortransfertowindow} member function should @@ -66,7 +66,7 @@ are passed by reference to window constructors, and must therefore be cloned int You can optionally define event handlers for the validator, to implement filtering. These handlers will capture events before the control itself does. -For an example implementation, see the valtext.h and valtext.cpp files in the wxWindows library. +For an example implementation, see the valtext.h and valtext.cpp files in the wxWidgets library. \wxheading{How validators interact with dialogs} @@ -88,7 +88,7 @@ call \helpref{wxWindow::InitDialog}{wxwindowinitdialog} explicitly before showin window.} When the user clicks on a button, for example the OK button, the application should -first call \helpref{wxWindow::Validate}{wxwindowvalidate}, which returns FALSE if +first call \helpref{wxWindow::Validate}{wxwindowvalidate}, which returns false if any of the child window validators failed to validate the window data. The button handler should return immediately if validation failed. Secondly, the application should call \helpref{wxWindow::TransferDataFromWindow}{wxwindowtransferdatafromwindow} and @@ -101,22 +101,22 @@ this: \begin{verbatim} void wxDialog::OnOK(wxCommandEvent& event) { - if ( Validate() && TransferDataFromWindow() ) - { + if ( Validate() && TransferDataFromWindow() ) + { if ( IsModal() ) EndModal(wxID_OK); else { - SetReturnCode(wxID_OK); - this->Show(FALSE); + SetReturnCode(wxID_OK); + this->Show(false); } - } + } } \end{verbatim} So if using validators and a normal OK button, you may not even need to write any code for handling dialog dismissal. -If you load your dialog from a resource file, you'll need to iterate through the controls +If you load your dialog from a resource file, you will need to iterate through the controls setting validators, since validators can't be specified in a dialog resource.