データフィルタリング

ReoGridはデータ範囲に対してフィルターを実行して行を非表示にします。組み込みの列フィルターUI、ルールベースの条件付きフィルター、または任意のGUIに接続した独自のフィルターロジックを使用できます。

フィルターのエントリポイント

• オートフィルターUI – 列ごとにユニークな値を収集するExcelスタイルのドロップダウンです。組み込みオートフィルターを参照してください。
• 条件付きフィルター – ColumnBasedDataSource に対して評価されるルールオブジェクト（ConditionalDataFilter + FilterCondition）です。条件付きフィルターを参照してください。
• カスタムフィルター – RowBasedDataFilter<IRowDataRecord> を実装するか（または Func<int, bool> を使用して）、Worksheet.DoFilter(range, filter) を自分で呼び出します。

最小限の例

述語の使用

var sheet = grid.CurrentWorksheet;
var range = sheet.UsedRange;
sheet.DoFilter(range, rowIndex =>
{
    var value = sheet[rowIndex, 2];            // third column
    return value is double d && d >= 1000;     // keep rows with value >= 1000
});

データフィルターの使用

var condition = new ConditionalDataFilter();
condition.Conditions.Add(new FilterCondition("price", ConditionOperator.GreaterThan, 1000));
condition.OnApply += (s, e) => sheet.DoFilter("A1:D200", condition);
condition.Apply(); // triggers DoFilter

フィルターの組み合わせ

複数のフィルターを同時に適用したい場合（例えば、条件付きルールとフリーテキスト検索の組み合わせ）、MultipleDataFilter を使用します：

var condition = new ConditionalDataFilter();
var search = new TextSearchDataFilter();
var filters = new MultipleDataFilter();
filters.Filters.Add(condition);
filters.Filters.Add(search);

condition.OnApply += (s, e) => sheet.DoFilter("A1:F300", filters);
search.OnApply += (s, e) => sheet.DoFilter("A1:F300", filters);

画面上フィルタリングとデータ駆動フィルタリング

• 画面上フィルター（UI駆動）: 組み込みのオートフィルターと条件付きフィルターは、シート上に既に存在する行を非表示にします。ワークシートに現在読み込まれている範囲に対して動作します。
• データ駆動フィルター: データソースがフィルタリング/クエリをサポートしている場合、まずそこでフィルタリングし（例：データベースクエリ、メモリ内LINQ）、フィルタリング済みの ColumnBasedDataSource をシートにバインドします。ReoGridはフィルタリングされたレコードのみを表示し、追加の画面上フィルターはその上に適用されます。

独自のフィルターUIの構築

1. コントロール（パネル、リスト、チェックボックスなど）を好きな場所にレンダリングします。多くの場合、ヘッダーのドロップダウン内に配置します。
2. ユーザーが選択を変更したら、フィルターオブジェクトを更新して Apply() を呼び出し、OnApply で Worksheet.DoFilter(range, filter) を呼び出します。
3. ヘッダーのドロップダウンの場合、DropdownHeaderCell を派生させてコントロールをドロップダウンコンテンツとしてアタッチし、列ヘッダーにヘッダーボディをインストールします。

ワークシートフィルターメソッド

CreateColumnFilterのオーバーロード

DoFilterのオーバーロード

SortColumn

SortOrder列挙型

イベント

sheet.RowsFiltered += (s, e) =>
{
    Console.WriteLine("Rows have been filtered");
};

フィルタークラス

RowBasedDataFilter<T>（抽象基底クラス）

TextSearchDataFilter

検索文字列を含む行をフィルタリングします（大文字小文字を区別しない、全列を検索）。

var search = new TextSearchDataFilter();
search.Text = "hello";
search.OnApply += (s, e) => sheet.DoFilter(range, search);
search.Apply();

MultipleDataFilter

複数のフィルターを結合します。行が表示されるには、すべてのサブフィルターを通過する必要があります。

詳細

• 組み込みUIの作成と使用方法：組み込みオートフィルター
• ルール構文、演算子、データ解析：条件付きフィルター