5.20192.631
FlexSheetValueFilter Wijmo API Class

FlexSheetValueFilter クラス

FlexSheet コントロールの列の値フィルタを定義します。

値フィルタには、シートに表示する値の明示的なリストが含まれます。

階層

コンストラクタ

constructor

プロパティ

column

column: Column

フィルタリングするColumn を取得します。

dataMap

dataMap: DataMap

未加工の値をこのフィルタを編集する際に表示される表示値に変換するために使用されるDataMap を取得または設定します。

exclusiveValueSearch

exclusiveValueSearch: boolean

フィルターにfilterText プロパティによって選択された値のみを含めるかどうかを決定する値を取得または設定します。

このプロパティはデフォルトでtrueに設定されています。この動作はExcelと同じです。 この動作を無効にするには、このプロパティをfalseに設定します。 その場合、リストに表示される項目のみが検索され、 フィルタに含まれる項目が検索されません。

filterText

filterText: string

表示値のリストのフィルタリングに使用される文字列を取得または設定します。

isActive

isActive: boolean

このフィルタがアクティブかどうかを示す値を取得します。

少なくとも1つの値が選択されている場合、そのフィルタはアクティブです。

maxValues

maxValues: number

表示値のリスト内にある要素の最大数を取得または設定します。

非常に多くの項目をリストに追加すると、検索が困難になり、パフォーマンスが損なわれます。 このプロパティは任意の時点で表示される項目数を制限しますが、 ユーザーは検索ボックスを使用して目的の項目をフィルタ処理することができます。

このプロパティは、デフォルトでは250に設定されます。

次のコードは、この値を1,000,000に変更し、事実上、フィールドのすべての一意の値を一覧します。

// 'id'列のmaxItemsプロパティを変更します
var f = new wijmo.grid.filter.FlexGridFilter(s);
f.getColumnFilter('id').valueFilter.maxValues = 1000000;

showValues

showValues: any

値リストに表示されるすべての書式設定された値を含むオブジェクトを取得または設定します。

sortValues

sortValues: boolean

エディタに表示するときに値をソートするかどうかを決定する値を取得または設定します。

uniqueValues を使用して値のカスタムリストを提供した上、 それらの値の順序を維持したい場合、このプロパティは特に便利です。

uniqueValues

uniqueValues: any[]

リストに表示する一意の値を含む配列を取得または設定します。

このプロパティがnullに設定されている場合、リストには、グリッドデータに基づいて値が挿入されます。

データからリストを作成するより、一意の値のリストを明示的に割り当てる方が 効率的です。また、データがサーバー上でフィルタ処理される場合、値フィルタが 適切に動作するには、そうする必要があります(この場合、一部の値が クライアント上に存在しない可能性があり、リストが不完全になるため)。

デフォルトでは、フィルタエディタは、一意の値をユーザーに表示する際に値をソートします。 この動作を抑止して、指定した順序で値を表示する場合は、 sortValues プロパティをfalseに設定します。

たとえば、次のコードは、ValueFilter で'country'フィールドに連結された列に 使用される国名リストを提供します。

// FlexGridのフィルタを作成します
var filter = new wijmo.grid.filter.FlexGridFilter(grid);
// 一意の値のリストを国フィルタに割り当てます
var cf = filter.getColumnFilter('country');
cf.valueFilter.uniqueValues = countries;

メソッド

apply

  • apply(value: any): boolean
  • 値がフィルタに合致するかどうかを示す値を取得します。

    引数

    • value: any

      テストする値。

    戻り値 boolean

clear

  • clear(): void
  • フィルタをクリアします。

    戻り値 void

implementsInterface

  • implementsInterface(interfaceName: string): boolean
  • 指定したインタフェースがサポートされている場合、trueを返します。

    引数

    • interfaceName: string

      調べるインタフェースの名前。

    戻り値 boolean