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

マーカー

これらのプロパティを使用して、テーブルフォーム の縦ルーラー上でのマーカーの位置を精密に指定することができます。 マーカーは主に出力フォームで使用されます。 マーカーはリストされる情報を制御し、ヘッダーやブレーク、詳細、フッターを設定します。 各エリア内に配置されたオブジェクトは、対応する場所に表示や印刷されます。

フォームが出力フォームとして使用されるときは、画面用であれ印刷用であれ、マーカー設定が考慮されて各エリアが指定された場所に表示/印刷されます。 また、サブフォームエリア内のリストフォームとしてフォームが使用される場合も出力マーカーは有効です。 ただし、フォームが入力フォームとして使用される場合、マーカー設定は無視されます。

これらのエリアに配置されたオブジェクトに割り当てられたメソッドは、適切なイベントが有効にされていれば、エリアが表示/印刷されるときに実行されます。 たとえば、ヘッダーエリアに配置されたオブジェクトのメソッドは On Header イベントで実行されます。


フォームブレーク

フォームブレークエリアはレコードリストの下に一回だけ表示あるいは印刷されます。

ブレークエリアは詳細マーカー (D) とブレークマーカー (B0) の間です。 レポートに 複数のブレークエリアを追加することもできます。

ブレークエリアの大きさは変更することができます。 レコードデータではない情報 (説明や日付、時刻など) のほか、線やその他のグラフィック要素を表示するためにブレークエリアを使用できます。 印刷レポートでは、小計などのサマリ計算をおこなって印刷するために使用できます。

JSON 文法

名称データタイプとりうる値
markerBreakinteger | integer collectionブレークマーカーの位置 (ピクセル単位)、またはブレークマーカー位置のコレクションを指定します。
最小値: 0

フォーム詳細

フォーム詳細エリアは、レポート中のレコード毎に画面に表示されたり印刷されたりします。 詳細エリアはヘッダーマーカー (H) と詳細マーカー (D) の間です。

詳細エリアの大きさは変更することができます。 詳細エリアに配置したオブジェクトはレコード毎に表示または印刷されます。 主にフィールドや変数を配置して、各レコードの情報を表示/印刷しますが、他のオブジェクトを配置することもできます。

JSON 文法

名称データタイプとりうる値
markerBodyinteger詳細マーカーの位置。 最小値: 0

フォームフッター

フォームフッターエリアは、画面ではレコードリストの下の表示されます。 印刷レポートの場合は、各ページの一番下に印刷されます。 フッターエリアはブレークマーカー (B0) とフッターマーカー (F) の間です。

フッターエリアの大きさは変更することができます。

フッターエリアを使用して画像、ページ番号、日付、また各ページの下部に配置したいテキストを何でも印刷できます。 通常、画面表示用の出力フォームでは、フッターエリアに検索や並べ替え、印刷などをおこなうためのボタンを配置します。 すべてのアクティブオブジェクトを配置できます。

JSON 文法

名称データタイプとりうる値
markerFooterinteger最小値: 0

フォームヘッダー

フォームヘッダーエリアは画面の一番上に表示され、また印刷時には各ページの一番上に印刷されます。 ヘッダーエリアはフォームの一番上からヘッダーマーカー (H) までの間です。

ヘッダーエリアの大きさは変更することができます。 ヘッダーエリアには列のタイトル、フォームの説明、その他の情報、会社ロゴなどの画像を配置します。

サブフォームとして表示される出力フォーム、あるいは DISPLAY SELECTIONMODIFY SELECTION コマンドを使用して表示される出力フォームのヘッダーエリアにアクティブオブジェクトを配置して使用することもできます。 以下のようなアクティブオブジェクトを配置できます:

  • ボタン、ピクチャーボタン
  • コンボボックス、ドロップダウンリスト、ピクチャーポップアップメニュー
  • 階層リスト、リストボックス
  • ラジオボタン、チェックボックス、3Dチェックボックス
  • 進捗インジケーター、ルーラー、ステッパー、スピナー

addSubrecord (サブレコード追加) や cancelautomaticSplitter (自動スプリッター) などの標準アクションをボタンに割り当てることができます。 ヘッダーエリアに配置したアクティブオブジェクトでは以下のイベントを使用できます: On Load, On Clicked, On Header, On Printing Footer, On Double Clicked, On Drop, On Drag Over, On Unload。 フォームメソッドが On Header イベントで呼び出されるのは、エリアのオブジェクトメソッドが呼び出された後になります。

フォームには、追加のヘッダーエリア を作成し、追加ブレークと関連づけることができます。 レベル1ヘッダーは、最初のソートフィールドによりグループ化されたレコードが印刷される直前に印刷されます。

JSON 文法

名称データタイプとりうる値
markerHeaderinteger | integer collectionヘッダーマーカーの位置 (ピクセル単位)、またはヘッダーマーカー位置のコレクションを指定します。
最小値: 0

追加マーカーの作成

レポート用に追加のブレークエリアやヘッダーエリアを作成できます。 これらの追加されたエリアを使用して、小計などの計算結果をレポートに印刷したり、その他の情報を効果的に表示することができます。

追加エリアは、フォームブレークフォームヘッダー のプロパティにマーカー位置のコレクションを指定すると定義されます。

4Dフォームエディターでは、Altキーを押しながら適切なコントロールマーカーをクリックして、追加のコントロールラインを作成します。

フォームは常に、ヘッダー、詳細、ブレーク (レベル0)、およびフッターエリアを持った状態で作成されます。

ブレークレベル0 は、レポート対象の全レコードが印刷された後に実行されます。 追加のブレークマーカーはそれぞれ "ブレークレベル1"、"ブレークレベル2" などと呼ばれます。

レベル1のブレークは一番目のソートフィールドでグループ化されたレコードが印刷された後に発生します。

ラベル説明実行タイミング
B1ブレークレベル1一番目のソートフィールド印刷後
B2ブレークレベル2二番目のソートフィールド印刷後
B3ブレークレベル3三番目のソートフィールド印刷後

追加のヘッダーはブレークに関連付けられます。 レベル1ヘッダーは、最初のソートフィールドによりグループ化されたレコードが印刷される直前に印刷されます。

ラベル説明実行タイミング
H1ヘッダーレベル1一番目のソートフィールド印刷後
H2ヘッダーレベル2二番目のソートフィールド印刷後
H3ヘッダーレベル3三番目のソートフィールド印刷後

ブレーク処理を開始するために Subtotal コマンドを使用する場合、ソート順に従って作成されるすべてのブレークレベル数から 1 マイナスした数のブレークエリアを作成すべきです。 ブレークエリアに何も印刷する必要がない場合、マーカーを移動してその高さを 0 にします。 ブレークエリアの数よりも多いフィールド数でソートすると、印刷時に最後のブレークエリアが繰り返されます。