validationFailed()

システム関数 ConverseLib.validationFailed は、次の 2 つの方法のいずれかで使用します。
  • textUI プログラムのフィールド妥当性検査関数で呼び出された場合、ConverseLib.validationFailed は、すべての検証関数が処理された後、受け取ったテキスト書式を再表示します。最後に呼び出された ConverseLib.validationFailed は、表示するメッセージを決定します。

    可能な場合、メッセージは書式自体に (書式プロパティー msgField が参照しているフィールドに) 表示されます。 書式プロパティー msgField に値が存在しない場合は、メッセージが別のモーダル画面に表示された後、書式が表示されます。

  • 検証関数の外部で呼び出された場合、ConverseLib.validationFailed は、conversedisplayprint、または show 文によって次に書式が表示されるときに、指定されたメッセージを表示します。この場合の振る舞いは、ConverseLib.displayMsgNum の振る舞いに似ています。

いずれの場合も、ConverseLib.validationFailed に割り当てられた値は システム変数 ConverseVar.validationMsgNum に格納されます。

  ConverseLib.validationFailed([msgNumber INT in])
msgNumber
表示するメッセージの数。引数は、整数リテラル、またはプリミティブ型の SMALLINT か INT、または BIN に 相当する型の項目でなければなりません。 この数字は、プログラムのメッセージ・テーブルの最初の列にある各セルと比較されます。 メッセージ・テーブルは、プログラムの msgTablePrefix プロパティーが参照している データ・テーブルです。 検索されたメッセージは同じ行の 2 番目の列に格納されます。

デフォルトのメッセージ番号は 9999 です。

フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.