Skip to main content

VerticalGridSettings.BeforeHeaderFilterFillItems Property

Enables you to provide custom filter items instead of default ones displayed within a Popup Header Filter.

Namespace: DevExpress.Web.Mvc

Assembly: DevExpress.Web.Mvc5.v24.1.dll

NuGet Package: DevExpress.Web.Mvc5

Declaration

public ASPxVerticalGridBeforeHeaderFilterFillItemsEventHandler BeforeHeaderFilterFillItems { get; set; }

Property Value

Type Description
ASPxVerticalGridBeforeHeaderFilterFillItemsEventHandler

An ASPxVerticalGridBeforeHeaderFilterFillItemsEventHandler delegate method allowing you to implement custom processing.

Remarks

End-users can filter row values via the Header Filter. To invoke the filter dropdown, an end-user clicks on the filter button. The BeforeHeaderFilterFillItems event is raised before the filter dropdown is shown and default filter items are created. The event enables you to provide custom filter items.

The data row whose filter button has been clicked is returned by the ASPxVerticalGridBeforeHeaderFilterFillItemsEventArgs.Row property. To add a new filter value, use the ASPxGridHeaderFilterEventArgs.AddValue method.

Set the ASPxGridBeforeHeaderFilterFillItemsEventArgs.Handled property to true to prevent the VerticalGridSettings.HeaderFilterFillItems event from being raised. Otherwise, the event clears the item collection before filling it with default items.

If you would like to add custom items to the default items, use the VerticalGridSettings.HeaderFilterFillItems event.

Note

The VerticalGrid header filter allows the use of HTML tags in an item text.

See Also