表を作成する際に、2つ以上のセルを結合して、表の特定のセクションに中央揃えのタイトルを作成する必要がある場合がよくあります。4D v18 R4では、プログラミングによってセルのグループを結合したり、解除したりするための新しいコマンド群が自由に使えるようになりました。それでは、いくつかの例を見てみましょう。
マージされたセル
結合されたセルを作成するには、結合したいすべてのセルを含む範囲を定義するだけです。この範囲をパラメータとして VP ADD SPANコマンドにパラメータとして渡すと、うまくいきます。
例えば、以下のようなドキュメントを使ってみましょう。
第1四半期と 第2四半期のセルを隣接するセルにマージし、南地域のセルをその下の2行にマージしたい場合は、単に次のコードを使用します。
// First quarter range
$q1:=VP Cells ("ViewProArea";2;3;3;1)
// Second quarter range
$q2 :=VP Cells ("ViewProArea";5;3;1)
// South area range
$south :=VP Cells ("ViewProArea";0;5;1;3)
VP ADD SPAN (VP Combine ranges ($q1;$q2;$south))
以下はその結果です。
マージされたセルを取得する
結合されたすべてのセルのテキストを中央揃えにしたい場合は、次のコマンドを使用します。 VP Get spansコマンドを使用して、結合されたすべてのセルを取得できます。
// Search all the merge cells in the spreadsheet
$range:=VP Get spans (VP All ("ViewProArea"))
//すべてのスパンにスタイルを適用
$style :=New object("vAlign";vk vertical align center; "hAlign";vk horizontal align center)
VP SET CELL STYLE ($range;$style)
結合されたセルの削除
何らかの理由で、文書内のセルスパンを削除する（セルの結合を解除する）必要がある場合、単に VP REMOVE SPAN:
// Search all the merge cells in the spreadsheet
$range:=VP Get spans (VP All ("ViewProArea"))
// 見つかったマージンセルを削除
VP REMOVE SPAN ($range)
もっと情報が必要ですか？ドキュメントをご覧ください。