メインコンテンツまでスキップ
バージョン: 20 R7 BETA

フォームイベント

フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。 フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。

In your code, you control the events using the FORM Event command, that returns the triggered event. 例:

// ボタンのコード
If(FORM Event.code=On Clicked) 
// ボタンがクリックされたときの動作
End if

すべてのフォームとフォーム上のすべてのアクティブなオブジェクトは、事前に定義されたイベントのセットを受け取ることができますが、フォームやオブジェクト毎に有効にされたイベントだけが実際に発生します。

イベントオブジェクト​

Each event is returned as an object by the FORM Event command. デフォルトで、以下のプロパティが含まれています:

プロパティ型説明
objectNametextイベントをトリガーしているオブジェクト名。フォームによってトリガーされている場合には含まれていません。
codelongintフォームイベントの数値。 Form event code によっても返されます。
descriptiontextフォームイベント名 (例: "On After Edit")

イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。 特に:

イベントとメソッド​

フォームイベントが発生すると、4D は以下のアクションをおこないます:

  • まず 4D は、フォーム中のオブジェクトをブラウズし、発生したオブジェクトイベントがプロパティで選択されているすべてのオブジェクトのオブジェクトメソッドを呼び出します。
  • 次に、発生したイベントに対応するフォームイベントがフォームのプロパティで選択されていれば、フォームメソッドを呼び出します。

オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。 おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。 オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。 そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。 つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。

On Load と On Unload イベントを除き (後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。 言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。

特定のイベントに関連するオブジェクトの数は、イベントの性質により異なります。

イベント一覧​

以下の表は、それぞれのイベントごとにどのようにオブジェクトメソッドとフォームメソッドが呼ばれるかを概説します:

イベントオブジェクトメソッドフォームメソッド対象オブジェクト
On Load◯◯すべてのオブジェクト
On Unload◯◯すべてのオブジェクト
On Validate◯◯すべてのオブジェクト
On Clicked◯◯関係するオブジェクトのみ
On Double Clicked◯◯関係するオブジェクトのみ
On Before Keystroke◯◯関係するオブジェクトのみ
On After Keystroke◯◯関係するオブジェクトのみ
On After Edit◯◯関係するオブジェクトのみ
On Getting Focus◯◯関係するオブジェクトのみ
On Losing Focus◯◯関係するオブジェクトのみ
On ActivateX◯なし
On DeactivateX◯なし
On Outside CallX◯なし
On Page ChangeX◯なし
On Begin Drag Over◯◯関係するオブジェクトのみ
On Drop◯◯関係するオブジェクトのみ
On Drag Over◯X関係するオブジェクトのみ
On Mouse Enter◯◯すべてのオブジェクト
On Mouse Move◯◯すべてのオブジェクト
On Mouse Leave◯◯すべてのオブジェクト
On Mouse Up◯X関係するオブジェクトのみ
On Menu SelectedX◯なし
On Bound variable changeX◯なし
On Data Change◯◯関係するオブジェクトのみ
On Plug in Area◯◯関係するオブジェクトのみ
On Header◯◯すべてのオブジェクト
On Printing Detail◯◯すべてのオブジェクト
On Printing Break◯◯すべてのオブジェクト
On Printing Footer◯◯すべてのオブジェクト
On Close BoxX◯なし
On Display Detail◯◯すべてのオブジェクト
On Open Detail◯ (リストボックス)◯リストボックスのみ
On Close Detail◯ (リストボックス)◯リストボックスのみ
On ResizeX◯なし
On Selection Change◯◯関係するオブジェクトのみ
On Load RecordX◯なし
On TimerX◯なし
On Scroll◯X関係するオブジェクトのみ
On Before Data Entry◯ (リストボックス)X関係するオブジェクトのみ
On Column Moved◯ (リストボックス)X関係するオブジェクトのみ
On Row Moved◯ (リストボックス)X関係するオブジェクトのみ
On Column Resize◯ (リストボックスと 4D View Pro エリア)X関係するオブジェクトのみ
On Header Click◯ (リストボックスと 4D View Pro エリア)X関係するオブジェクトのみ
On Footer Click◯ (リストボックス)X関係するオブジェクトのみ
On After Sort◯ (リストボックス)X関係するオブジェクトのみ
On Long Click◯ (ボタン)◯関係するオブジェクトのみ
On Alternative Click◯ (ボタンとリストボックス)X関係するオブジェクトのみ
On Expand◯ (階層 リストとリストボックス)X関係するオブジェクトのみ
On Collapse◯ (階層 リストとリストボックス)X関係するオブジェクトのみ
On Delete Action◯ (階層 リストとリストボックス)X関係するオブジェクトのみ
On URL Resource Loading◯ (Webエリア)X関係するオブジェクトのみ
On Begin URL Loading◯ (Webエリア)X関係するオブジェクトのみ
On URL Loading Error◯ (Webエリア)X関係するオブジェクトのみ
On URL Filtering◯ (Webエリア)X関係するオブジェクトのみ
On End URL Loading◯ (Webエリア)X関係するオブジェクトのみ
On Open External Link◯ (Webエリア)X関係するオブジェクトのみ
On Window Opening Denied◯ (Webエリア)X関係するオブジェクトのみ
On VP Range Changed◯ (4D View Pro エリア)X関係するオブジェクトのみ
On VP Ready◯ (4D View Pro エリア)X関係するオブジェクトのみ
On Row Resize◯ (4D View Pro エリア)X関係するオブジェクトのみ

イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。 デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。

警告: オブジェクトの On Load と On Unload イベントが生成されるには、オブジェクトとオブジェクトが属するフォームの両方で有効にされていなければなりません。 オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。これら 2つのイベントはフォームレベルでも有効にされていなければなりません。