API version 1

- ‐

getMergeArea

属している結合範囲を返します。

矩形範囲内の全てのセルが同じ結合範囲に属している場合、その結合範囲全体を表すSpreadRange オブジェクトを返します。 それ以外の場合はnullを返します。

そのため、SpreadRange オブジェクト内のセルが結合されていない場合、一部のセルのみ結合されている場合、異なる結合範囲に属している場合はいずれもnullが返ります。

呼出形式一覧

呼出形式	説明
CRS::Common::Spread::SpreadRange getMergeArea()	属している結合範囲を返します。

戻り値一覧

戻り値	説明
CRS::Common::Spread::SpreadRange	属している結合範囲へのアクセッサ

例外

なし

関連項目

merge 、 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("結合範囲が特定できません");
                   }
           }
   }
}