フック一覧 BeginPrgALcl (画面フック) 前の画面フック 次の画面フック

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

BeginPrgALcl (実行開始処理現地後) 画面フックメソッド

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

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

この画面プログラムに関するプログラム起動時の初期設定処理を行う。なお、プログラムを起動してよいかどうかのチェックを行うこともできる。

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

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

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

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

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

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

なお、フック名としては、BeginPrgALcl の他に実行開始処理現地後を用いることができる。

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

プログラムの実行を開始して、画面の表示を行う前に (1 回だけ呼び出される)。 項目フックメソッド BeginPrgALcl よりも前に呼び出される。 画面フックメソッド BeginPrg および項目フックメソッド BeginPrg よりも後に呼び出される。

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

FormBase.BEGINPRGALCL_Allow (= True): プログラムの開始を許可するので、起動処理を継続せよ。

FormBase.BEGINPRGALCL_Deny (= False): プログラムの起動処理をやめて停止せよ。FormBase は、この伝言を受けると、アプリ操作者からなされたプログラムの起動指示を無視して、プログラムの起動処理を取りやめる。

デフォルト動作: BeginPrgALcl 画面フックメソッドが組み込まれていない場合の動作は、FormBase.BEGINPRGALCL_Allow が設定された場合と同様である。

開始閉鎖許諾チェックオプションをオンにした場合に限って、戻り値の指定が有効となる。このオプションがオフの場合には、戻り値として FormBase.BEGINPRGALCL_Allow が指定されたものとみなされる。なお、このオプションは、ダイアログ画面オプションで指定できる。

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

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

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

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

ローカル側で行う初期設定処理は、この画面フックメソッドではなく、画面フックメソッド BeginPrg,または項目フックメソッド BeginPrg で行ってください。

関連事項

プログラムの実行開始に関係するフックメソッドには、 画面フックメソッド BeginPrg,項目フックメソッド BeginPrg,画面フックメソッド BeginPrgALcl (本フックメソッド),項目フックメソッド BeginPrgALcl の四つがある。

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

使用例

' 受注業務プログラムの実行開始時の処理を行う (BeginPrgALcl)。
Friend Function 実行開始処理現地後(ByVal fB As FormBase) As Boolean
    ' (ここに実行開始時に行う処理を記述します。)
    Return FormBase.BEGINPRGALCL_Allow
End Function ' 実行開始処理現地後
// 受注業務プログラムの実行開始時の処理を行う (BeginPrgALcl)。
internal bool 実行開始処理現地後( FormBase fB ) {
    // (ここに実行開始時に行う処理を記述します。)
    return FormBase.BEGINPRGALCL_Allow;
} // 実行開始処理現地後
// 受注業務プログラムの実行開始時の処理を行う (BeginPrgALcl)。
boolean 実行開始処理現地後( FormBase fB ) {
    // (ここに実行開始時に行う処理を記述します。)
    return FormBase.BEGINPRGALCL_Allow;
} // 実行開始処理現地後