API version 1

- ‐

swapRange

セル範囲を他のセル範囲と入れ替えます。

入れ替え先がスプレッドシートの範囲外となる部分がある場合(入れ替え先の範囲がmaxColumns、 maxRows プロパティの値を超える場合等)、例外が発生します。

入れ替え元と入れ替え先のセルを参照していた数式は入れ替えた先のセルを参照するよう自動的に変更されます。

呼出形式一覧

呼出形式

説明

void swapRange(integer srcRow1, integer srcColumn1, integer srcRow2, integer srcColumn2, integer dstRow, integer dstColumn)

(srcRow1,srcColumn1)から(srcRow2,srcColumn2)の範囲を(dstRow,dstColumn)を左上とする矩形範囲と入れ替えます。

void swapRange(string srcrange, string dstpos)

セル範囲文字列srcrangeの矩形範囲を、セル文字列dstposを左上とする矩形範囲と入れ替えます。

戻り値一覧

戻り値

説明

void

なし

引数一覧

引数

説明

srcRow1

入れ替え元の矩形範囲の左上セルの行番号。

srcColumn1

入れ替え元の矩形範囲の左上セルの列番号。

srcRow2

入れ替え元の矩形範囲の右下セルの行番号。

srcColumn2

入れ替え元の矩形範囲の右下セルの列番号。

dstRow

入れ替え先の矩形範囲の左上の行番号。

dstColumn

入れ替え先の矩形範囲の左上の列番号。

srcrange

入れ替え元の矩形範囲を示すセル範囲文字列。

dstpos

入れ替え元の矩形範囲の左上のセル示すセル文字列。

例外

識別子

説明

SYS-23:5

メソッドの引数が不正です

関連項目

swapColumnsswapRows メソッド



使用例 CRSダウンロード

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

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

           spread1 << CSV {
                   A,B,C,D,E
                   ,=A1,=B1,=C1,=D1
                   A3,B3,C3,D3,E3
                   A4,B4,C4,D4,E4
           };

           maxColumns = 20;
           maxRows = 20;
           var s = new SpreadStyle;
           s.bgColor = "#EEFFEE";
           range(1,1,2,3).style = s;
           s.bgColor = "#EEEEFF";
           range(1,4,2,6).style = s;

           s.bgColor = "#FFFFEE";
           range("D3:E4").style = s;
           s.bgColor = "#EEEEEE";
           range("A3:B4").style = s;
   }

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   #(1,1)-(2,3)の矩形範囲を左上セルの位置が(1,4)と入れ替えます
                   ^.spread1.swapRange(1,1,2,3,1,4);

                   #D3:E4の矩形範囲をA3セルが左上となる範囲と入れ替えます
                   ^.spread1.swapRange("D3:E4","A3");
           }
   }
}