4D Doc Center : On Host Database Event データベースメソッド

4D v14.3

On Host Database Event データベースメソッド


$1 -> On Host Database Event データベースメソッド

引数	型	説明
$1	倍長整数	イベントコード

Description

On Host Database Event データベースメソッド はデータベースが開いた時と閉じられた時に 4D コンポーネントにコードを実行させることが出来るようになりました。

注: セキュリティ上の理由から、このデータベースメソッドを使用可能にするためには、その実行をホストデータベースで明示的に許可する必要があります。詳細に関しては、Design Reference マニュアルを参照して下さい。

On Host Database Event データベースメソッド は、ホストデータベースのコンポーネントとして使用されているデータベースの中でのみ自動的に実行されます(ホストデータベースのプロパティリストで有効にされている必要があります)。このメソッドはホストデータベースの開閉に関するイベントが発生したときに呼び出されます。

イベントを扱うためには、 $1 引数の値をメソッド内で調べて、 "Database Events" テーマ内にある、以下の定数と比較する必要があります:

定数	型	値	コメント
On after host database exit	倍長整数	4	ホストデータベースの On Exitデータベースメソッドデータベースメソッドが実行を終了したところです。
On after host database startup	倍長整数	2	ホストデーターベースの On Startupデータベースメソッドデータベースメソッドが実行を終了したところです。
On before host database exit	倍長整数	3	ホストデータベースは閉じられようとしているところです。ホストデータベースの On Exitデータベースメソッドデータベースメソッドはまだ呼び出されていない状態です。ホストデータベースの On Exitデータベースメソッドデータベースは、コンポーネントの On Host Database Event データベースメソッドデータベースメソッドが実行されている間は呼び出されません。
On before host database startup	倍長整数	1	ホストデータベースはちょうど開かれたところです。ホストデータベースの On Startupデータベースメソッドデータベースメソッドはまだ呼び出されていません。 On Startupデータベースメソッドデータベースメソッドは、 On Host Database Event データベースメソッドデータベースメソッドがコンポーネント内で実行されている間は呼び出されません。

このコマンドにより、4D コンポーネントはホストデータベースのオペレーションに関連したプリファレンスやユーザー情報を読み込んだり保存したりすることが出来ます。

例題

On Host Database Event の典型例を紹介します:

  // On Host Database Event データベースメソッド

 C_LONGINT($1)

 Case of

    :($1=On before host database startup)

  // この部分にホストデータベースの "On Startup" データベースメソッドの前に実行したいコードを記述します

    :($1=On after host database startup)

  // この部分にホストデータベースの "On Startup" データベースメソッドの後に実行したいコードを記述します

    :($1=On before host database exit)

  // この部分にホストデータベースの "On Exit" データベースメソッドの前に実行したいコードを記述します

    :($1=On after host database exit)

  // この部分にホストデータベースの "On Exit" データベースメソッドの後に実行したいコードを記述します

 End case