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

Open (開設) 画面フックメソッド

　この画面フックメソッドは、主にアプリフレームと呼ばれる画面アプリのための上位フレームワークを設計する方々がお使いになるものです。一般のアプリ開発者の方々は、上位フレームワーク設計者から示された情報があれば、必ずしもここの内容を詳細に知る必要はありません。

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

この画面アプリ全体にかかわるファイルまたはデータベースのオープンなどの開設処理 (たとえばトランザクションファイルに関する開設処理) を行う。

あらかじめ処理対象レコード群が決まっているような場合は、ここでオープンなどの開設処理を行い、適当な変数 (上図の灰色の矢印) がそれを指し示すように環境設定するのがよい。そうでない場合、この環境設定処理は、画面フックメソッド SelectFh または SelectExec などが行うように先送りすることになる。

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

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

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

VB での書き方:
　Friend Function Open(パラメタ宣言列) As Boolean
　または
　Friend Function 画面略称_Open(パラメタ宣言列) As Boolean

C# での書き方:
　internal bool Open(パラメタ宣言列)
　または
　internal bool 画面略称_Open(パラメタ宣言列)

Java での書き方:
　boolean Open(パラメタ宣言列)
　または
　boolean 画面略称_Open(パラメタ宣言列)

なお、フック名としては、Open の他に開設を用いることができる。

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

画面を初めて表示した直後 (1 回だけ呼び出される)。 項目フックメソッド Open よりも前に呼び出される。 画面フックメソッド OpenALcl および項目フックメソッド OpenALcl よりも前に呼び出される。

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

(戻り値に意味なし)

デフォルト動作:　なし。

定数 FormBase.OPEN_Allow および FormBase.OPEN_Deny は、意味がなくなった。

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

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

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

特定の項目固有の開設処理は、この画面フックメソッドではなく、項目フックメソッド Open, または OpenALcl で で行ってください。

セントラル側で行う開設処理は、この画面フックメソッドではなく、画面フックメソッド OpenALcl，または項目フックメソッド OpenALcl で行ってください。

◇ 関連事項

開設処理に関係するフックメソッドには、 画面フックメソッド Open (本フックメソッド)，項目フックメソッド Open，画面フックメソッド OpenALcl，項目フックメソッド OpenALcl の四つがある。

この画面フックメソッドは、画面フックメソッド Close と対をなす。

初期設定の機能を果たす画面フックメソッドに BeginPrg があるが、この画面フックメソッドの方が後に呼び出される。

◇ 使用例

' 受注業務画面に関するローカル側の初期設定処理を行う。
Friend Function 開設() As Boolean
    ' (ここにオープン時に行う処理を記述します。)
    Return FormBase.OPEN_Allow
End Function ' 開設

// 受注業務画面に関するローカル側の初期設定処理を行う。
internal bool 開設() {
    // (ここにオープン時に行う処理を記述します。)
    return FormBase.OPEN_Allow;
} // 開設

// 受注業務画面に関するローカル側の初期設定処理 ・・・ を行う。
boolean 開設() {
    // (ここにオープン時に行う処理を記述します。)
    return FormBase.OPEN_Allow;
} // 開設