]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/validatr.tex
added null pointer check and assert
[wxWidgets.git] / docs / latex / wx / validatr.tex
index c5c13bf4d2508e54ed644d453f57d4efe1455c34..8ab80c677ce675d4390561e5343d053a05334f89 100644 (file)
@@ -18,24 +18,38 @@ To specify a default, `null' validator, use the symbol {\bf wxDefaultValidator}.
 
 For more information, please see \helpref{Validator overview}{validatoroverview}.
 
+\pythonnote{If you wish to create a validator class in wxPython you should
+derive the class from {\tt wxPyValidator} in order to get Python-aware
+capabilities for the various virtual methods.}
+
 \wxheading{Derived from}
 
 \helpref{wxEvtHandler}{wxevthandler}\\
 \helpref{wxObject}{wxobject}
 
+\wxheading{Include files}
+
+<wx/validate.h>
+
+\wxheading{Library}
+
+\helpref{wxCore}{librarieslist}
+
 \wxheading{See also}
 
-\helpref{Validator overview}{validatoroverview}, \helpref{wxTextValidator}{wxtextvalidator}
+\helpref{Validator overview}{validatoroverview}, 
+\helpref{wxTextValidator}{wxtextvalidator}, 
+\helpref{wxGenericValidator}{wxgenericvalidator},
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxValidator::wxValidator}\label{wxvalidatorconstr}
+\membersection{wxValidator::wxValidator}\label{wxvalidatorctor}
 
 \func{}{wxValidator}{\void}
 
 Constructor.
 
-\membersection{wxValidator::\destruct{wxValidator}}
+\membersection{wxValidator::\destruct{wxValidator}}\label{wxvalidatordtor}
 
 \func{}{\destruct{wxValidator}}{\void}
 
@@ -43,7 +57,7 @@ Destructor.
 
 \membersection{wxValidator::Clone}\label{wxvalidatorclone}
 
-\constfunc{virtual wxValidator*}{Clone}{\void}
+\constfunc{virtual wxObject*}{Clone}{\void}
 
 All validator classes must implement the {\bf Clone} function, which returns
 an identical copy of itself. This is because validators are passed to control
@@ -60,6 +74,13 @@ This base function returns NULL.
 
 Returns the window associated with the validator.
 
+\membersection{wxValidator::SetBellOnError}\label{wxvalidatorsetbellonerror}
+
+\func{void}{SetBellOnError}{\param{bool}{ doIt = true}}
+
+This functions switches on or turns off the error sound produced by the
+validators if an invalid key is pressed.
+
 \membersection{wxValidator::SetWindow}\label{wxvalidatorsetwindow}
 
 \func{void}{SetWindow}{\param{wxWindow*}{ window}}
@@ -68,23 +89,22 @@ Associates a window with the validator.
 
 \membersection{wxValidator::TransferFromWindow}\label{wxvalidatortransferfromwindow}
 
-\func{virtual bool}{TransferToWindow}{\param{wxWindow*}{ parent}}
+\func{virtual bool}{TransferToWindow}{}
 
 This overridable function is called when the value in the window must be
-transferred to the validator. Return FALSE if there is a problem.
+transferred to the validator. Return false if there is a problem.
 
 \membersection{wxValidator::TransferToWindow}\label{wxvalidatortransfertowindow}
 
-\func{virtual bool}{TransferToWindow}{\param{wxWindow*}{ parent}}
+\func{virtual bool}{TransferToWindow}{}
 
 This overridable function is called when the value associated with the validator must be
-transferred to the window. Return FALSE if there is a problem.
+transferred to the window. Return false if there is a problem.
 
 \membersection{wxValidator::Validate}\label{wxvalidatorvalidate}
 
 \func{virtual bool}{Validate}{\param{wxWindow*}{ parent}}
 
 This overridable function is called when the value in the associated window must be validated.
-Return FALSE if the value in the window is not valid; you may pop up an error dialog.
-
+Return false if the value in the window is not valid; you may pop up an error dialog.