CDataExchange::Fail
フレームワークは、ダイアログ データ バリデーション (DDV) の操作が失敗すると、このメンバー関数を呼び出します。
void Fail( );
解説
[失敗] は、検証に失敗したコントロールに (復元するコントロールがある場合)、フォーカスとオプションを復元します。[失敗] は、検証プロセスを停止するに CUserException 型の例外をスローします。例外により表示されるエラーを説明するメッセージ ボックスが表示されます。DDV の検証が失敗しても、ユーザーは問題となっているコントロールにデータを入力し直すことができます。
カスタム DDV ルーチンの Implementors は、検証が失敗したときにルーチンから [失敗] を呼び出すことができます。
独自の DDX と DDV ルーチンを記述する方法の詳細については、テクニカル ノート 26を参照してください。DDX と DDV の概要については、ダイアログ データ エクスチェンジと検証 と ダイアログ ボックスのトピックを参照してください。
必要条件
ヘッダー: afxwin.h