API version 1

- ‐

sort

データを並べ替えます。

ソート範囲外のセルがソート範囲内のセルを参照している場合、ソートによって参照先は変わりません。 ソート範囲内に数式が入っている場合、ソートによって相対的な参照位置が変化しないよう自動的に数式が変更されます。 第三引数に指定するソート順番は、ソート範囲の左上を１とする数字です。 ソート範囲内に非表示(visible=false)のセルがある場合、そのセルはソート対象から除外されます。

ソートキーの配列要素数と並べ替え順番の配列要素数が異なる場合例外が発生します。

呼出形式一覧

呼出形式	説明
void sort(CRS::Common::Spread::SpreadRange range, integer sortBy, CRS::Common::Core::Number[] sortKeys, CRS::Common::Core::Number[] sortkeyOrders)	range範囲をsortBy方向にsortKeys、sortkeyOrdersでソートする。

戻り値一覧

戻り値	説明
void	なし

引数一覧

引数	説明
range	ソート範囲を示すSpreadRangeオブジェクト
sortBy	ソートの方向を以下の定数で指定します。 定数 値 動作 SORTBY_ROW 0 行を並び替えます(行方向にソートします) SORTBY_COLUMN 1 列を並び替えます(列方向にソートします)
sortKeys	並べ替えのキーにする列／行番号を示す配列オブジェクト
sortkeyOrders	並べ替え順序を示す配列オブジェクト

例外

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

関連項目

columnHeaderClickAction プロパティ

使用例 CRSダウンロード

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

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

           spread1 << CSV {
                   3,2,"=A1+B1"
                   2,2,"=A2+B2"
                   3,2,"=A3+B3"
                   2,2,"=A4+B4"
                   1,2,"=A5+B5"
                   3,1,"=A6+B6"
                   1,1,"=A7+B7"
                   2,1,"=A8+B8"
                   3,1,"=A9+B9"
                   1,1,"=A10+B10"
           };

           maxColumns = 20;
           maxRows = 20;
   }

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   var key = new Array(1,2);
                   var order = new Array(Spread.SORTORDER_ASCENDING,Spread.SORTORDER_ASCENDING);

                   #1-10行をA列、B列をキーとし昇順にソートします
                   ^.spread1.sort(^.spread1.rows(1,10),Spread.SORTBY_ROW,key,order);
           }
   }
}