ig.excel.CustomListSortCondition

カスタムの順序付き値リストに基づいてセルを並べ替えるために使用される並べ替え条件です。

備考

並べ替えの方向が昇順である場合は、カスタム リストに含まれているセルが最初に現れてそのリスト内での順序通りに並べられ、そのあとに他のセルが現れて並べ替え以前の順序と同じ相対順序で並べられていくという形でデータ範囲の並べ替えが行われます。並べ替えの方向が降順である場合は、カスタム リストに含まれていないセルが最初にデータ領域に現れて、並べ替え以前の順序と同じ相対順序で並べられます。そのあとには他のセルがリストとは逆の順序で並べられていきます。

この並べ替え条件に指定されたリスト値が文字列値です。並べ替えられるセルが文字列値を含むセルである場合には、その値に基づいてセルの並べ替えが行われます。そうでない場合にはセル テキストが使用されます。たとえば、セルの値が 0.01 であっても、そのセルがパーセンテージ セルとして書式設定されている場合、この並べ替え条件でセルを並べ替えるために使用されるテキストは、「0.01」ではなく、「1%」になります。セル テキストが使用される場合、さまざまなセルで繰り返し利用される埋め込み文字がセルの書式文字列に含まれていても、そうした文字は比較に使用されるセル テキストから除外されます。

セルの値をカスタム リスト内の値と突き合わせる場合、文字列の比較は、SortSettings`1.caseSensitive の設定によって、大文字・小文字を区別または区別せずに比較されます。

セル テキストに埋め込み文字が繰り返し現れる場合、そうした文字は文字列の比較対象から除外されます。

依存関係

jquery-1.4.4.js
infragistics.util.js
infragistics.ext_core.js
infragistics.ext_collections.js
infragistics.ext_collectionsExtended.js
infragistics.ext_io.js
infragistics.ext_text.js
infragistics.documents.core_core.js
infragistics.ext_ui.js
このコントロールにオプションはありません。
このコントロールにイベントはありません。
  • ig.excel.CustomListSortCondition
    コンストラクター

    new $.ig.excel.CustomListSortCondition( sortDirection:ig.excel.SortDirection, list:string[] );

    新しい CustomListSortCondition インスタンスを作成します。

    • sortDirection
    • タイプ:ig.excel.SortDirection
    • データの並べ替えに使用する方向。
    • list
    • タイプ:string[]
    • 並べ替えの優先順位に従って並べられた値のリスト。

    例外

    例外 説明
    ig.excel.InvalidEnumArgumentException sortDirection が SortDirection 列挙体で定義されていないです。

    備考

    並べ替えの方向が昇順である場合は、カスタム リストに含まれているセルが最初に現れてそのリスト内での順序通りに並べられ、そのあとに他のセルが現れて並べ替え以前の順序と同じ相対順序で並べられていくという形でデータ範囲の並べ替えが行われます。並べ替えの方向が降順である場合は、カスタム リストに含まれていないセルが最初にデータ領域に現れて、並べ替え以前の順序と同じ相対順序で並べられます。そのあとには他のセルがリストとは逆の順序で並べられていきます。

  • equals

    .equals( obj:object );
    返却型:
    boolean
    返却型の説明:
    指定したオブジェクトがこのインスタンスと等しい場合は True、そうでない場合は False。

    CustomListSortCondition が指定されたオブジェクトと等しいかどうかを決定します。

    • obj
    • タイプ:object
    • 等しいかどうかをテストするためのオブジェクト。
  • getHashCode

    .getHashCode( );
    返却型:
    number
    返却型の説明:
    このインスタンスのハッシュに使用できる数値。

    CustomListSortCondition のハッシュ コードを取得します。

  • list

    .list( );

    並べ替えに使用する値の優先順位リストを取得します。

    備考

    この並べ替え条件に指定されたリスト値が文字列値です。並べ替えられるセルが文字列値を含むセルである場合には、その値に基づいてセルの並べ替えが行われます。そうでない場合にはセル テキストが使用されます。たとえば、セルの値が 0.01 であっても、そのセルがパーセンテージ セルとして書式設定されている場合、この並べ替え条件でセルを並べ替えるために使用されるテキストは、「0.01」ではなく、「1%」になります。セル テキストが使用される場合、さまざまなセルで繰り返し利用される埋め込み文字がセルの書式文字列に含まれていても、そうした文字は比較に使用されるセル テキストから除外されます。

    セルの値をカスタム リスト内の値と突き合わせる場合、文字列の比較は、SortSettings`1.caseSensitive の設定によって、大文字・小文字を区別または区別せずに比較されます。

    セル テキストに埋め込み文字が繰り返し現れる場合、そうした文字は文字列の比較対象から除外されます。

Copyright © 1996 - 2024 Infragistics, Inc. All rights reserved.