4D Doc Center : FORM LOAD

4D v14.3

FORM LOAD


FORM LOAD ( {aTable ;} form {; *} )

引数	型	説明
aTable	テーブル	ロードするテーブルフォーム(省略時はプロジェクトフォームをロード)
form	文字	印刷のために開くプロジェクトフォームの名前、または空の文字列を渡すと、カレントのプロジェクトフォームを閉じる
*	演算子	指定時、コマンドはコンポーネントから実行した場合にホストのデータベースコマンドが適応されます(それ以外の場合は無視されます)。

説明

FORM LOADコマンドを使用して印刷・データ解析用に form (プロジェクトフォームまたはテーブルフォーム) をロードできます。

このコマンドを使用するためには、 OPEN PRINTING JOBコマンドを事前に使用して印刷ジョブが開かれている必要があります。 OPEN PRINTING JOBコマンドは FORM UNLOADコマンドを暗示的に呼び出すので、このコンテキストでは FORM LOADコマンドを呼び出す必要があります。一度ロードされると、この form はカレントの印刷フォームとなります。 Print object コマンドを含む、全てのオブジェクト管理コマンドはこのフォームに対して動作します。

もしも印刷フォームが事前( FORM LOAD コマンドを呼び出す前)にロードされていた場合は、そのフォームは閉じられ、formにより置き換えられます。ひとつの印刷セッションで複数のプロジェクトフォームを開いたり閉じたりできます。FORM LOADで印刷フォームを変更してもページブレークは生成されません。ページブレークを管理するのは開発者の仕事です。

プロジェクトフォーム(またはフォームのオブジェクトメソッド)を開く際は、 On Load フォームイベントのみが実行されます。他のフォームイベントは無視されます。印刷の終わりには On Unload フォームイベントが実行されます。

フォームのグラフィックな一貫性を保持するために、プラットフォームにかかわらず"印刷"アピアランスプロパティを適用することをお勧めします。

CLOSE PRINTING JOBコマンドが呼び出されると、カレント印刷フォームは自動で閉じられます。

Compatibility note: v14以前のバージョンの4Dでは、 FORM LOADコマンド(v14以前はOPEN PRINTING FORMという名称)は form引数に空の文字列を渡す事によってカレントのプロジェクトフォームを閉じていました。このシンタックスはv14以降サポートされておらず、渡してもエラーが返されます。フォームを閉じる際には FORM UNLOAD コマンドまたは CLOSE PRINTING JOBを使用して下さい。

コンテンツの解析

ここではデータ解析のためスクリーン外のフォームをロードする使用法を解説します。これをするためには、 FORM LOAD を印刷ジョブ以外のコンテキストで呼び出すだけです。この際にはフォームイベントは実行されません。

FORM LOAD はフォームコンテンツを処理するために FORM GET OBJECTS コマンドと OBJECT Get typeコマンドと合わせて使用することができます。その後、フォームをメモリーから解放するために FORM UNLOADコマンドを呼び出す必要があります。

どの場合においても、スクリーン上のフォームはロードされたままである(FORM LOAD コマンドによって影響されない)ので、 FORM UNLOADコマンドを呼び出したあとリロードする必要はないということです。

コマンドがコンポーネントから実行された場合、デフォルトでコンポーネントフォームを呼び出します。* 演算子を渡した場合、メソッドはホストデータベースフォームをロードします。

例題 1

印刷ジョブにプロジェクトフォームを呼び出す場合:

 OPEN PRINTING JOB

 FORM LOAD("print_form")

  // イベントとオブジェクトメソッドの実行

例題 2

印刷ジョブにテーブルフォームを呼び出す場合:

 OPEN PRINTING JOB

 FORM LOAD([People];"print_form")

  // イベントとオブジェクトメソッドの実行

例題 3

フォームの内容を解析してテキスト入力エリアに何らかの処理をする場合:

 FORM LOAD([People];"my_form")

  // イベントやメソッドを実行することなくフォームを選択

 FORM GET OBJECTS(arrObjNames;arrObjPtrs;arrPages;*)

 For($i;1;Size of array(arrObjNames))

    If(OBJECT Get type(*;arrObjNames{$i})=Object type text input)

  //… processing

    End if

 End for

 FORM UNLOAD

4D v14.3

FORM LOAD

FORM LOAD

説明

データの印刷

コンテンツの解析

例題 1

例題 2

例題 3