SSpread.Sortメソッド

 

説明

 

指定のデータを並べ替えます。

 

呼出形式

 

Sort(col, row, col2, row2, sortby [, sortkeys, sortkeyorders])

戻り値

 

成功すれば$TRUE、その他の場合は$FALSE

引数

 

col

並べ替え範囲の先頭の列番号

row

並べ替え範囲の先頭の行番号

col2

並べ替え範囲の最後の列番号

row2

並べ替え範囲の最後の行番号

sortby

並べ替えの種類

以下の値を指定します。

定数

説明

$SortByRow

0

行の並べ替え

$SortByCol

1

列の並べ替え

sortkeys

並べ替えのキーにする列/行番号を示す配列オブジェクト(省略可)

sortkeyorders

並べ替え順序を示す配列オブジェクト(省略可)

以下の値を指定します。

説明

1

昇順で並べ替え

2

降順で並べ替え

 

sortkeyssortkeyordersには、並べ替えに必要な情報を持つ配列オブジェクトを指定します。配列のインデックスが小さい方が、並べ替えのキーの優先順位が高くなります。

インデックスを同じにすることで、並べ替えのキーにする行/列番号と、並べ替え順序(昇順/降順)の組み合わせを設定できます。

sortkeyssortkeyordersを省略した場合は、SortKeyプロパティ、SortKeyOrderプロパティの値を使用します。

 

例外

 

EXT-1

Sortの引数が不正です

 

使用例

/* SortKeySortKeyOrderプロパティを使用する例 */
SortKey(0) = 2; /* 1キー 2列目 */
SortKey(1) = 3; /* 2キー 3列目 */
SortKey(2) = 4; /* 3キー 4列目 */
SortKeyOrder(0) = $SortKeyOrderAscending;  /* 1キー 昇順 */
SortKeyOrder(1) = $SortKeyOrderDescending; /* 2キー 降順 */
SortKeyOrder(2) = $SortKeyOrderDescending; /* 3キー 降順 */
Sort(1, -1, 4, -1, $SortByRow); /* 14列目の全行をソート */
 
/* すべて引数で指定する例(処理内容は上と同じ) */
var sortkeys = new Number[3];
var sortorder = new Number[3];
sortkeys[0] = 2;
sortkeys[1] = 3;
sortkeys[2] = 4;
sortorder[0] = 1;
sortorder[1] = 2;
sortorder[2] = 2;
Sort(1, -1, 4, -1, $SortByRow, sortkeys, sortorder);

 

関連項目

 

SortKeySortKeyOrderプロパティ

 



「オンラインマニュアル」一覧へ戻る
「Bizの宝箱」TOPへ戻る