表組みの管理

4D Write Proドキュメントには表を含めることができます。4D Write Pro の表組みはプログラミングによって作成・定義されますが、そのコンテンツについては変更可能で、ユーザーによって管理されます。行の高さ、並び、マージン、テキストスタイル、カラー、境界線を含め、様々な 4D Write Pro 表属性が編集可能です。

4D Write Pro の表はWP Insert table コマンドを呼び出すことによって作成されます。その後、WP Table append row コマンドを使用して行を追加することができます。

注: ユーザーはセルの範囲をコピー・ペーストすることによって表を作成することができます:

セルの中身はWP Table append row コマンドを使用することでプログラミングによって追加することができます。

表組みの作成後は、セルの中身はユーザーによってランタイムで編集可能です。ユーザーはセル内をクリックし、通常の段落同様、選択、編集、コピー/ペースト、あるいはテキストまたはピクチャーの削除をすることが可能です。またTabキーを使用してセルを移動していくことも可能です(Shift+Tabで逆方向に移動していきます)。

セル内でキャリッジリターンを使用すると、セル内に新しい段落を作成します。

セルの幅は固定であることに注意して下さい。ユーザーがテキストを入力するかピクチャーを貼り付けると、行の高さが必要に応じて自動的に拡張され、テキストは自動的に折り返されます:

ユーザーはまた、カラム、行、あるいはセルを選択し、ビルトインのポップアップメニューあるいはカスタマイズされたインターフェースを使用して、テキストスタイル、カラー、並び、などの利用可能な属性を適用することができます。4D Write Proでは表組みの任意の部分を選択する複数のコマンドを提供します:

• WP Table get rows は行のレンジ(またはヘッダー行レンジ)を取得します。
• WP Table get columns はカラムのレンジを取得します。(*)
• WP Table get cells はセルのレンジを取得します。

(*) カラムは、それに相当するものがhtmlにはありません。4D Write Proでは、カラムのレンジは実際にはセルのレンジであり、これはつまりカラムはセルと同じプロパティを持つことを意味します。

レンジを選択したら、WP SET ATTRIBUTES コマンドを使用して適切な属性を適用することができます。セルの中では、そのコンテンツに応じて、属性は段落、章、あるいはピクチャーへと適用されます。例えば、表組みあるいは表組みのセルに対しては、高さ、フォントサイズ、境界線、パッディング、などを設定することができます(詳細な情報については、4D Write Pro属性 の章を参照して下さい)。

異なる属性が表の要素に同時に適用された場合、レンダリングには以下の優先順位が適用されます:

1. 表が最初にレンダリングされます
2. 行がレンダリングされます(このとき表属性を上書きします)
3. セル/カラムがレンダリングされます(このとき行属性を上書きします)

表の列の幅は、列のセパレータを左か右にドラッグすることで変更することができます。セパレータが水平方向に移動できる時、カーソルはルーラー上の水平方向の矢印に変形して移動可能であることを示します:

列のリサイズをすると、On After Edit フォームイベントが発生します。

列をリサイズするには、列セパレータをクリックし、左か右にドラッグします。最小の列幅は8pt です。右の列が最小幅に達すると、それ以降は隣の列より右にある列は全て移動されていきます。最初の列、またはすぐ左の列が最小幅に達した場合、その方向へのリサイズはそれ以上できません。

Shift キーを押しながら列をリサイズすると、右の列の幅は変更されません。

Note: 列のリサイズをするためには、4D Write Pro ドキュメントの入力可能プロパティが有効化されている必要があります。

ページモードあるいは下書きモードで表示した場合(あるいはドキュメント印刷のコンテキストにおいて)、4D Write Pro の表は以下の場合に分割されることがあります:

4D Write Pro では、1つの表につき、5つまでヘッダー行を指定することができます。ヘッダー行として選択された行は、カラムブレーク、あるいは改ページがあればそこに必ず繰り返し表示されます。

表に対してフォーミュラオブジェクトをデータソースとして割り当て、表内からThis を使用した式 を使用することで計算された値にアクセスすることができます(以下参照)。データソースのフォーミュラは、フォーミュラが計算されたとき(例: ドキュメントが開かれたとき、WP COMPUTE FORMULAS コマンドが呼ばれたとき、など)に4D Write Pro によって処理されます。この機能はデータコンテキストの機能を活用しています(WP SET DATA CONTEXT 参照)。

データソースのフォーミュラオブジェクトが(空でない)コレクションまたはエンティティセレクションを返す場合、フォーミュラが計算されるとすぐに表はデータが埋められます。表にはコレクション内にある要素数分だけ、あるいはエンティティセレクション内のエンティティ数分だけ行が表示されます。(ヘッダー行を除いた)最初の行はテンプレート行として使用され、そこにはThis.item.lastname といったような特別なキーワードを使用した式を挿入することができます。式はコレクションまたはエンティティセレクションからのデータの処理中に置き換えられます。このテンプレート行は、フォーミュラが計算された後のコレクションまたはエンティティセレクション内の項目数と項目行の数が合致するように複製されていきます。

表にデータソースを割り当てる場合、WP SET ATTRIBUTES コマンドとwk datasource 定数を使用し、値として4D formula オブジェクトを渡します。例えば、表の中にFrance に住む全ての人のデータを行に表したい場合、以下のようなコードを使用します:

• データソースフォーミュラがオブジェクトが(空ではない)コレクションまたはエンティティセレクションを返す場合、表はフォーミュラが計算される時点で地頭的に埋められていきます。行の数は少なくともコレクション内の要素数、またはエンティティセレクション内のエンティティ数と同じだけ格納されています。繰り返される行と呼ばれる、表の最初の行は、テンプレート行として使用されます(ヘッダー行とブレーク行(あれば)は除く)。
• 繰り返される行(およびブレーク行)内では、This.item.lastname のような特殊なキーワードを使用した式を挿入することができます。式は、処理の過程で、コレクションまたはエンティティセレクションからのデータによって置き換えられます。繰り返される行は、フォーミュラ計算後に項目行がコレクションまたはエンティティセレクション内の項目の数と同じになるように複製されていきます。
• データソースフォーミュラがコレクションまたはエンティティセレクションを返さない場合、あるいは空のコレクション/エンティティセレクションを返す場合、表の行は自動的には作成されず、全ての行は通常の行として扱われます。

表からデータソースを削除するためには、WP RESET ATTRIBUTES コマンドを使用してください。このコマンドはデータソース属性値をnull に設定します:

データソースに基づいた表デザインは、以下のような行を格納しています:

アイコン	行	数	必須	条件	説明
	ヘッダー行	最大5	-	-	標準の表ヘッダー、繰り返し表示されるヘッダー行 参照
	繰り返される行	1	必須	データソースフォーミュラは必ず繰り返される要素を返す必要があります	表にヘッダー行またはブレーク行がない場合、繰り返される行が表の最初の行となります。それ以外の場合には、ヘッダー行の後の最初の行がこの行となります。一般的にはThis を使用した式(例: This.item.value )が記述されています。ドキュメントが値を表示モードで行が複製されているとき、この式を通して処理されたデータへとアクセスすることができます。
	ソートブレーク行	最大5	-	データソースフォーミュラは必ず繰り返される要素を返す必要があります	繰り返される行の前または後に表示される行。ブレーク行 参照
	下部キャリーオーバー行	1	-	データソースフォーミュラは必ず繰り返される要素を返す必要があります	繰り返される行またはブレーク行のあとに最初に表示される行。キャリーオーバー行 参照
	その他の行	無制限	-	-	標準の行(複製されません)

表示例(参照を表示 モード):

フォーミュラが計算されると、繰り返される行は、データソースフォーミュラから返される全エンティティ数またはコレクション項目数と合致するまで自動的に複製されます:

いずれの場合にしても、以下の宣言を使用することで実際の行数を得ることができます:

データソースに基づいた表は下部キャリー行をサポートします。これは表が複数のページ/カラムに分割される場合に各ページ/カラムの下部に自動的に表示される行です。キャリーオーバー行はThis.previousItems という式を使用することで、ここまで表示/印刷された項目に基づいた追加の情報を表示することができます(This を使用した式 参照)。この機能を使用することで、例えば小計行を追加することなどができます。

キャリーオーバー行は以下のように表示されます: 

• データソース表が単一のページ(またはカラム)に収まらない場合に表示されます
• 表の下部に表示されます
• 最初のページ(または最初のカラム)を含め、他の全てのページ/カラムに表示されますが、最後のページ/カラムには表示されません。

重要: キャリーオーバー行は、空でないコレクションまたはエンティティセレクションを返すデータソースフォーミュラで埋められた表において、値を表示モードのときにのみ利用できます。それ以外の場合、またはデータソースフォーミュラが計算されていない場合には、キャリーオーバー行は通常の行として表示されます。

キャリーオーバー行は以下のように作成できます:

1. 表のテンプレートに、繰り返される行またはブレーク行のすぐ後に行を追加し、例えばThis.previousItems のように必要なフォーミュラを中に入力します。
2. ドキュメントにおいてキャリーオーバー行を有効化します。以下の2つの方法があります:
   - bottomCarryOverRow 標準アクションを使用する(4D Write Pro標準アクションの使用 参照)
   - WP SET ATTRIBUTES コマンドに wk bottom carry over row 表 属性セレクターを組み合わせて使用する

注意: キャリーオーバー行機能が有効化されている場合、行内の改ページは許可されません(表のページ分け 参照)。対応するオプションが設定されてい場合には、無視されます。

データソースに基づいた表では1つまたは複数の並べ替えブレーク行をサポートします。これは繰り返される行の前または後に表示することができます。並べ替えブレーク行を使用すると、表内で既に並べ替えられているデータソースの項目を、計算されたフォーミュラの値に基づいて複数の部分に区分けすることができます。

フォーミュラの値が変わるたびに、新しいブレーク行が挿入されます。そのため、表が正確にレンダリングされるためには、表のデータソースとして使用されているエンティティセレクション(またはコレクション)は適切にソートされている必要があります。例えば、国ごとおよび都市ごとにブレーク行を挿入したい場合、データソースは以下のように指定されている必要があります: ds.people.all().orderBy("country asc, city asc")

ブレーク値は、wk break formula 属性を通して定義されます。値は通常、"This.item.name'' のような、項目のプロパティに基づいたフォーミュラです。そうでない場合には値は全く変化しないことがあり、これではブレークフォーミュラは意味のないものになってしまいます。wk break formula 属性は、表に何のデータソースもない場合、あるいは行がヘッダー行の場合には無視されます。ブレーク行は繰り返される行と(前か後ろに)隣り合うか、他のブレーク行と隣り合うように配置されなければなりません。そうでない場合にはこれは無視されます。

この機能で使用することができるThis.breakItems 式を使用することで、例えば、繰り返される行全体の平均を1つのブレーク行で表示することができます。breakItems は、表のデータソースがエンティティセレクションならエンティティセレクションの、表のデータソースがコレクションならコレクションの、データソースの評価されたサブセットです。そのため、ブレーク行内には、以下のように書くことができます: This.breakItems.sum("salary")

ブレーク行を作成するには、以下の手順に従って下さい:

1. データソースを、表示したいブレークに対応したレベルで並べ替えして下さい。例: ds.People.all().orderBy("continent asc, country asc, city asc")
   
2. ブレーク行を表のテンプレート内に追加します。ブレーク行を繰り返される行の後に配置したい場合、ブレークはデータソースとは逆順のソートと合致する必要があり、繰り替えされる行の前に配置したい場合、ブレークはデータソースと同じソート順と合致する必要があります。
3. 選択された行に対してwk break formula 属性を設定します:

表内のフォーミュラ内で使用された場合、This キーワードはコンテキストに応じて異なるデータへのアクセスを提供します:

その他のコンテキストにおいては、これらの式はundefined を返します。

注意: フォーミュラの挿入についてのより詳しい情報については、WP INSERT FORMULA を参照してください。

表がデータソースからのデータが表示されている場合、参照が計算されると行が自動的に作成されます。行を挿入または削除したり、セルのコンテンツを削除したり、スタイルを変えたり、といったことができます:

しかしながら、表のデータソースが再計算された場合、計算された行への変更は(最初の行以外)全て失われてしまうという点に注意して下さい。その一方で、最初の行は繰り返される行であるため、この行に対して行われた変更は、表のデータソースが再計算された際に全ての行へと伝搬していきます。同じことはブレーク行にも適用され、計算されたブレーク行に対して行われた編集はテンプレートブレーク行を除いて全て失われてしまいます(テンプレートのブレーク行は表の最初または最後に配置されます)。

例えば、以下の表は、:

式が再計算されたあとは以下のようになります:

カーソルが、データソースが割り当てられている表のセル内に挿入された時、以下の情報を表示する警告アイコンが左上角に表示されます:

フォーミュラが参照として表示されている場合、あるいはドキュメントを保存した時、最初の行のみがテンプレート行として表示/保存されます(フォーミュラが固定化されていなかった場合)。

フォーミュラが固定化されると、表は標準の表となり、表のデータソースはリセットされます。

注意: freezeExpressions 標準アクションを使用しても、フォーミュラは再計算されません。