void Fail( );
throw( CUserException );
Remarks
The framework calls this member function when a dialog data validation (DDV) operation fails. Fail restores the focus and selection to the control whose validation failed (if there is a control to restore). Fail then throws an exception of type CUserException to stop the validation process. The exception causes a message box explaining the error to be displayed. After DDV validation fails, the user can reenter data in the offending control.
Implementors of custom DDV routines can call Fail from their routines when a validation fails.
For more information on writing your own DDX and DDV routines, see Technical Note 26. For an overview of DDX and DDV, see Dialog Data Exchange and Validation and Dialog Box Topics in Visual C++ Programmer's Guide.
CDataExchange Overview | Class Members | Hierarchy Chart
See Also CDataExchange::PrepareCtrl, CDataExchange::PrepareEditCtrl