DataFilter.WinForms 1.1.4

DataFilter.WinForms

Windows Forms specialization of DataFilter: filter bar chrome, popup controls, and header behaviors. Grid hosting lives in DataFilter.WinForms.PopupHost.

Visual customization: CUSTOMIZATION.md — WinForms

NuGet integration

Install the packages

dotnet add package DataFilter.WinForms
dotnet add package DataFilter.WinForms.PopupHost

Use DataFilter.WinForms.PopupHost for FilterableDataGrid or DataGridViewFilterAdapter.Attach on an existing grid.

Target frameworks

net8.0-windows, net9.0-windows

Dependencies (transitive)

DataFilter.Core, DataFilter.Filtering.ExcelLike, DataFilter.PlatformShared, DataFilter.Localization

Quick start

using DataFilter.PlatformShared.ColumnFilter;
using DataFilter.PlatformShared.ViewModels;
using DataFilter.WinForms.PopupHost;

var vm = new FilterableDataGridViewModel<Employee>
{
    LocalDataSource = employees
};
await vm.RefreshDataAsync();

var grid = new FilterableDataGrid
{
    Dock = DockStyle.Fill,
    AutoGenerateColumns = true,
    ViewModel = vm,
    AreColumnFiltersEnabled = true,
    ColumnFilterTriggerMode = ColumnFilterTriggerMode.HeaderRightClick,
};
grid.DataSource = vm.FilteredItems.Cast<Employee>().ToList();

vm.PropertyChanged += (_, e) =>
{
    if (e.PropertyName == nameof(vm.FilteredItems))
        grid.DataSource = vm.FilteredItems.Cast<Employee>().ToList();
};

Controls.Add(grid);

Optional filter bar — wrap with FilterGridChromeControl and set ShowFilterBar = true (see DataFilter.PlatformShared README).

Pipeline presets:

await vm.ApplyFilterPipelineSnapshotAsync(vm.CreateFilterPipelineSnapshot());

Controls

• FilterGridChromeControl — hosts optional FilterBarControl above grid content.
• FilterBarControl — active-filters chip bar (enable via chrome host).
• FilterPopupControl — column filter popup surface.
• FilterHeaderBehavior — attach filtering to column headers on a custom grid.

Localization

Popup UI texts come from DataFilter.Localization.

using System.Globalization;
using DataFilter.Localization;

LocalizationManager.Instance.SetCulture(new CultureInfo("fr"));

Per-grid culture: IFilterableDataGridViewModel.CultureOverride.

Theming

Popup colors are not hardcoded. Use FilterTheme from PlatformShared:

using DataFilter.PlatformShared.Theming;
using DataFilter.WinForms.Controls;

FilterTheme.Current = FilterTheme.Dark.With(primaryColor: "#007ACC");

// Applied automatically when the popup opens, or call explicitly:
popup.ApplyTheme();
popup.ApplyTheme(myCustomTheme);
popup.ApplyTheme(isDark: true); // shorthand → Light / Dark preset

Resource key mapping and full palette: CUSTOMIZATION.md — WinForms.