Skip to main content

TreeList.SubstituteFilter Event

Allows you to replace the applied filter with another filter.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v22.2.dll

NuGet Package: DevExpress.Win.TreeList


public event EventHandler<SubstituteFilterEventArgs> SubstituteFilter

Event Data

The SubstituteFilter event's data class is SubstituteFilterEventArgs. The following properties provide information specific to this event:

Property Description
Filter Gets or sets the filter applied to a data control.


The SubstituteFilter event fires when an end-user applies a new filter criterion to the control, allowing you to replace the applied filter with another one. The currently applied filter is specified by the Filter event argument. To replace this filter, assign a new filter criterion to this parameter.

private void treeList1_SubstituteFilter(object sender, DevExpress.Data.SubstituteFilterEventArgs e){  
    if (e.Filter.ToString() == "[DEPARTMENT] = 'Corporate Headquarters'"){
        e.Filter = DevExpress.Data.Filtering.CriteriaOperator.Parse("[DEPARTMENT] = 'Corporate Headquarters' And [LOCATION] = 'Monterey'");


Do not modify the existing filter object assigned to the Filter event argument.

See Also