API version 1

- ‐

merge

指定された範囲を結合します。

結合した結果、結合範囲の左上のセルのみが(結合範囲いっぱいに)表示されます。結合された結果、見えなくなるセルは表示されなくなるだけで、値がクリアされるわけではありません。

呼出形式一覧

呼出形式	説明
void merge()	指定された範囲を結合します。

戻り値一覧

戻り値	説明
void	なし

例外

識別子	説明
SYS-23:5	メソッドの引数が不正です

関連項目

unMerge メソッド

使用例 CRSダウンロード

Form SpreadRange_methods {
   x = 0;
   y = 0;
   width = 800;
   height = 600;

   Spread spread1 {
           x = 8;
           y = 8;
           width = 640;
           height = 440;

           spread1 << CSV {
                   1,2,3,4,5
                   2,3,4,5,6
                   3,4,5,6,7
                   4,5,6,7,8
           };

           maxColumns = 20;
           maxRows = 20;

           cell("A2").style.bgColor = "#EEEEFF";

           #A2:E4の矩形範囲を結合します
           range("A2:E4").merge();
   }

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   #B2:C2の属している結合セルの矩形範囲を取得します
                   var r = ^.spread1.range("B2:C2").getMergeArea();
                   if ( r != null ) {
                           print( "結合範囲 (", r.row, ",", r.column , ")-(", r.row + r.rowsCount-1 ,  ",", r.column + r.columnsCount-1,")");

                           #rの結合を解除します
                           r.unMerge();
                   } else {
                           print("結合範囲が特定できません");
                   }
           }
   }
}