sortRange メソッド

このシートのデータモデル内のセル範囲をソートします。

シンタックス

Javascript (Usage)
Javascript (Specification)

var instance = new GC.Spread.Sheets.Worksheet(name);
var value; // Type: boolean
value = instance.sortRange(row,
                           column,
                           rowCount,
                           columnCount,
                           byRows,
                           sortInfo,
                           sortInfo.index,
                           sortInfo.ascending,
                           sortInfo.compareFunction,
                           sortOption,
                           sortOption.groupSort,
                           sortOption.ignoreHidden);

function sortRange( 
   row : number,
   column : number,
   rowCount : number,
   columnCount : number,
   byRows : boolean,
   sortInfo : Object,
   sortInfo.index : number,
   sortInfo.ascending : boolean,
   sortInfo.compareFunction : Function,
   sortOption : ISortOptions,
   sortOption.groupSort : groupSort,
   sortOption.ignoreHidden : boolean
) : boolean;

パラメータ

row

ソートするセルブロックの開始行のインデックス。

column

ソートするセルブロックの開始列のインデックス。

rowCount

セルブロックの行数。

columnCount

セルブロックの列数。

byRows

行単位でソートする場合はtrue、列単位でソートする場合はfalseに設定します。

sortInfo

以下の設定が使用できます。

sortInfo.index	number型	ソートする列または行のインデックス。
sortInfo.ascending	boolean型	ソート順序が昇順かどうか。

sortInfo.index

ソートする列または行のインデックス

sortInfo.ascending

ソート順序が昇順であるかどうかを表すブール値。

sortInfo.compareFunction

ソート順が昇順かどうか。 function（value1、value2）{return 0;}。

sortOption

sortOptionは、ソートの詳細なパフォーマンスを示します。

sortOption.groupSort

グループ化されたデータでの並べ替える操作を示します。すべてのグループとその内部コンテンツを並べ替えるかどうか。

sortOption.ignoreHidden

非表示の値を無視して、表示値のみを並べ替えるかどうか。

戻り値の型

データのソートが成功した場合はtrue、それ以外の場合はfalse。

使用例

次のサンプルコードは、範囲をソートします。

Javascript

sheet.setValue(0,0,"112");
sheet.setValue(1,0,"10");
sheet.setValue(2,0,"223");
sheet.setValue(3,0,"20");
sheet.setValue(4,0,"334");
sheet.setValue(5,0,"30");
sheet.sortRange(0, 0, 6, 1, true, [
                {index:0, ascending:true}
                ]);

Javascript

sheet.setValue(0,0,"112");
sheet.setValue(1,0,"10");
sheet.setValue(2,0,"223");
sheet.setValue(3,0,"20");
sheet.setValue(4,0,"334");
sheet.setValue(5,0,"30");
sheet.sortRange(0, 0, 6, 1, true, [
                {index:0, ascending:true}
                ]);

参照

Worksheet タイプ
 データの並べ替え
 データの並べ替え