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

invokeLocal メソッド (FormBase)

◇ 機能および役割

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

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

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

◇ 呼出し方

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

(ただし fB は、クラス FormBase のインスタンス)

◇ 戻り値の型および意味

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

｢存在しない画面フックメソッド Local の呼び出し (invokeLocal)｣

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

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

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

送受信するオブジェクトは、java.io.Serializable インターフェースを実装した public クラスとして、ローカル・セントラル双方から共に参照できることが必要。したがって、これらを定義したクラスモジュールは、ca プロジェクトに含めるのがお勧めである。

◇ 関連事項

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

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

◇ 使用例

Public Overrides Function OpenALcl(ByVal fB As FormBase) As Boolean
    ' フックメソッドが呼ばれたことをクライアントに通知します。
    If fB.DebugFormHook Then
        fB.invokeLocal("OpenALcl フックメソッドが呼び出されました。")
    End If
    Return MyBase.OpenALcl(fB)
End Function

public override bool OpenALcl( FormBase fB ) {
    // フックメソッドが呼ばれたことをクライアントに通知します。
    if (fB.DebugFormHook) {
        fB.invokeLocal("OpenALcl フックメソッドが呼び出されました。");
    }
    return base.OpenALcl(fB);
}

public boolean OpenALcl( FormBase fB ) throws Exception {
    // フックメソッドが呼ばれたことをクライアントに通知します。
    if (fB.DebugFormHook) {
        fB.invokeLocal("OpenALcl フックメソッドが呼び出されました。");
    }
    return super.OpenALcl(fB);
}