API version 1

- ‐

copyRange

範囲をコピーします。

コピー先の範囲が maxColumns 、 maxRows プロパティの値より大きくなる場合でも、行列数が拡張されることはありません。 maxColumns 、maxRows プロパティを超えた範囲の情報は破棄されます。

コピー元に相対参照の数式が含まれていた場合、コピー先に設定される数式は相対的な位置関係を維持するよう参照先が自動的に変更されます。

呼出形式一覧

呼出形式	説明
void copyRange(integer srcRow1, integer srcColumn1, integer srcRow2, integer srcColumn2, integer dstRow, integer dstColumn)	(srcRow1,srcColumns1)から(srcRow2,srcColumns2)までの範囲を(dstRow,dstColumn)を左上とする範囲にコピーします。
void copyRange(string srcrange, string dstpos)	セル範囲文字列srcrangeの範囲をセル文字列dstposを左上とする範囲にコピーします。

戻り値一覧

戻り値	説明
void	なし

引数一覧

引数	説明
srcRow1	コピー元範囲の左上セルの行番号
srcColumn1	コピー元範囲の左上セルの列番号
srcRow2	コピー元範囲の右下セルの行番号
srcColumn2	コピー元範囲の右下セルの列番号
dstRow	コピー先の左上セルの行番号
dstColumn	コピー先の左上セルの列番号
srcrange	コピー元セル範囲を表す範囲文字列
dstpos	コピー先セルを表すセル文字列

例外

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

関連項目

SpreadRange クラス

moveRange 、 copyRows 、 copyColumns メソッド

使用例 CRSダウンロード

Form Spread_copyRange {
   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;
   }

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   #(1,1)-(2,3)の矩形範囲を左上セルの位置が(6,2)になるようコピーします
                   ^.spread1.copyRange(1,1,2,3,6,2);

                   #A1:D4の矩形範囲をB9セルが左上となる範囲にコピーします
                   ^.spread1.copyRange("A1:D4","B9");
           }
   }
}