VB C# ALL プログラミング言語によるフィルタ (ここで選んだ言語で選別された説明や図だけが表示されます)

★ sss 仕様のフックメソッド (通常の開発では Check をお使いください)

CheckR 項目フックメソッド

◇ 役割 (この項目フックメソッドに委託されている処理)

項目フックメソッド CheckC を補助する形で使われて、再計算 (Recalc) モードにおける単項目チェック処理を行う。

項目フックメソッド CheckC は再計算 (Recalc) モードにおいて呼び出されることがないので、再計算 (Recalc) モードにおける単項目チェック処理が必要な場合には、このフックメソッドで行う。

◇ 配置 (ツーピーススタイルの場合にこの項目フックメソッドをどこに配置できるか)

セントラルピースに配置するか、または配置しない。ローカルピースに配置することは禁止されている。

◇ 代表的な書き方 (詳しい構文はフックメソッドの書き方を参照)

VB での書き方:
　Friend Function CheckR(パラメタ宣言列) As Integer
　または
　Friend Function 項目略称_CheckR(パラメタ宣言列) As Integer

C# での書き方:
　internal int CheckR(パラメタ宣言列)
　または
　internal int 項目略称_CheckR(パラメタ宣言列)

Java での書き方:
　int CheckR(パラメタ宣言列)
　または
　int 項目略称_CheckR(パラメタ宣言列)

◇ 呼び出される契機 (以下が切っ掛けとなりこのフックメソッドが呼び出される)

再計算 (Recalc) モードにおける単項目チェック処理のとき。

◇ 戻り値の意味とデフォルト動作 (戻り値による ItemBase への伝言)

ItemBase.CHECK_OK (= 0):　項目の単項目チェックが OK である。

n (1 以上の整数) または ItemBase.CHECK_NG (= 1):　エラーコード n のエラーの検出がなされた。なお、RelCheck 系フックメソッドのエラーと区別するために、Check 系フックメソッドで検出したエラーは、10000 より小さい値にすることをお勧めする。

(このエラーコード n は、Response フックメソッドおよび ErrorMsg フックメソッドの Cd_Error パラメタの値になる)

デフォルト動作:　CheckR 項目フックメソッドが組み込まれていない場合の動作は、ItemBase.CHECK_OK が設定された場合と同様である。

◇ 代行メッセージ (処理の流れに応じて発せられるメッセージ; カスタマイズ可能)

(関係する代行メッセージなし)

◇ 使用上のヒントと注意事項

単項目チェックを行う際にセントラル側の特定の資源 (データベースの参照など) が必要な場合には、この項目フックメソッドを用いるのがよい。セントラル側およびローカル側の特定の資源を必要としない場合には (あるいは双方に同じ資源がある場合には)、項目フックメソッド CheckRLC を用いるのがよい。

CheckR フックメソッドの中で、チェック対象の項目 (すなわちこの項目) の値を強制的に変更したい場合には、この項目を ByRef 指定のパラメタとして、このフックメソッドの中で変更することができる。あるいは、ItemBase の setValue メソッドで変更することもできる。

CheckR フックメソッドの中で、チェック対象の項目 (すなわちこの項目) の値を強制的に変更したい場合には、ItemBase の setValue メソッドで変更することができる。

このフックメソッドのパラメタとして、この項目の縦の合計値 (Su_項目略称) を指定しないことをお勧めする。なぜなら、合計値にはこの項目の最新の値が反映されていない。

◇ 関連事項

◇ 使用例

Friend Function CheckR(ByVal fB As FormBase, ByVal 発注元コード As String) As Integer
    Return ItemBase.CHECK_OK
End Function ' CheckR

internal int CheckR( FormBase fB, string 発注元コード ) {
    return ItemBase.CHECK_OK;
} // CheckR

int CheckR( FormBase fB, String 発注元コード ) {
    return ItemBase.CHECK_OK;
} // CheckR