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

invokeLocal メソッド (ItemBase)

◇ 機能および役割

パラメタで指定された送付オブジェクトをローカル側に送信し、項目フックメソッド Local を呼び出し、その戻り値の受領オブジェクトをローカル側から受信する。

◇ 所属クラス (ツーピーススタイルの場合にこのメソッドが宣言されているクラス)

AppliTech.WorkFrame.ItemBase (セントラル)

◇ 呼出し方

iB.invokeLocal(送付オブジェクト)

(ただし iB は、クラス ItemBase のインスタンス)

◇ 戻り値の型および意味

戻り値の型: オブジェクト型 (Object, object)

意味: 受領オブジェクト。

◇ パラメタの型および意味

送付オブジェクト (オブジェクト型): このオブジェクトをローカル側に送付する。

◇ 例外の発生 (誤った呼出しの際に発生する例外)

｢フックメソッド Local の中なので使用できません (invokeLocal)｣

｢フックメソッド Central の中なので使用できません (invokeLocal)｣

｢セントラル側主導機能が使用できません (invokeLocal)｣

｢他の画面または他の画面の項目なので使用できません (invokeLocal)｣

｢現 FormBase でないので使用できません (invokeLocal)｣

｢I/R 処理中 (初期値派生処理中または Recalc モード) なので使用できません (invokeLocal)｣

｢すでに終了処理を実施中なので使用できません (invokeLocal)｣

｢セントラル側主導機能が使用できません (LocalHelper)｣

｢セントラル側主導機能のセットアップが未完 (LocalHelper)｣

｢すでに終了処理を実施中なので､ このメソッドは使用できません (LocalHelper)｣

｢Local フックメソッドが見つかりません (invokeLocal)｣

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

このメソッドが使用できるのは、プロジェクトオプションセントラル側主導機能がオンの場合に限られる。

送受信するオブジェクトは、<Serializable()> または [Serializable()] 指定をした Public Class として、ローカル・セントラル双方のソリューションから共に参照できるアセンブリに含めて、ローカルプロジェクトおよびセントラルプロジェクトから参照設定することが必要。したがって、これらを定義したクラスモジュールは、ca プロジェクトに含めるのがお勧め。

◇ 関連事項

RHMI (Remote Hook Method Invocation) に関係するメソッドには、 ローカル側の FormBase のメソッド invokeCentral，ローカル側の ItemBase のメソッド invokeCentral，セントラル側の FormBase のメソッド invokeLocal，セントラル側の ItemBase のメソッド invokeLocal (本メソッド) の四つがある。

ローカル・セントラル間の通信に関するメソッドには、 FormBase のフックメソッド BackToLocalWith，FormBase のフックメソッド invokeCentral，ItemBase のフックメソッド invokeCentral，FormBase のフックメソッド invokeLocal，ItemBase のフックメソッド invokeLocal (本メソッド) の五つがある。

◇ 使用例

Friend Function 生徒管理_生徒姓_Check(ByVal iB_生徒姓 As ItemBase, ByVal fB As FormBase) As Integer
    ' フックメソッドが呼ばれたことをクライアントに通知します。
    If fB.DebugItemHook AndAlso Not (fB.RecalcMode) AndAlso Not (fB.DerivedByInitVal) Then
        iB_生徒姓.invokeLocal("[テスト]生徒姓チェックフックメソッドが呼び出されました。")
    End If
    Return ItemBase.CHECK_OK
End Function

internal int 生徒管理_生徒姓_Check( ItemBase iB_生徒姓, FormBase fB ) {
    // フックメソッドが呼ばれたことをクライアントに通知します。
    if (fB.DebugItemHook && (!fB.RecalcMode) && (!fB.DerivedByInitVal)) {
        iB_生徒姓.invokeLocal("[テスト]生徒姓チェックフックメソッドが呼び出されました。");
    }
    return ItemBase.CHECK_OK;
}

public int 生徒管理_生徒姓_Check( ItemBase iB_生徒姓, FormBase fB )
        throws Exception {
    // フックメソッドが呼ばれたことをクライアントに通知します。
    if (fB.DebugItemHook && (!fB.RecalcMode)
            && (!fB.DerivedByInitVal)) {
        iB_生徒姓.invokeLocal("[テスト]生徒姓チェックフックメソッドが呼び出されました。");
    }
    return ItemBase.CHECK_OK;
}