ASPxTreeList.ProcessOnClickRowFilter Event

Enables you to apply custom filter criteria when the filter row is in the OnClick mode.

Namespace: DevExpress.Web.ASPxTreeList

Assembly: DevExpress.Web.ASPxTreeList.v19.2.dll

Declaration

public event ASPxTreeListOnClickRowFilterEventHandler ProcessOnClickRowFilter
Public Event ProcessOnClickRowFilter As ASPxTreeListOnClickRowFilterEventHandler

Event Data

The ProcessOnClickRowFilter event handler receives an argument of the ASPxTreeListOnClickRowFilterEventArgs type. The following properties provide information specific to this event.

Property Description
Criteria Gets the applied filter criteria.
Kind Gets or sets a value specifying which action should be performed within the corresponding event handler.
Values Gets or sets values that are the custom texts displayed within the filter row cells.

Remarks

End-users can build simple filter criteria and apply them using the Filter Row, which can work in either Auto or OnClick mode (based on the TreeListSettingsBehavior.FilterRowMode property value). When the filter works in OnClick mode, you can use the ProcessOnClickRowFilter event handler to perform any actions before the filter criteria are applied.

This event is raised twice and enables you to perform the following actions.

  • Provide custom filter criteria.
  • Specify text displayed within the auto-filter row cell.

When the event parameter's GridAutoFilterEventArgs.Kind property returns GridViewAutoFilterEventKind.CreateCriteria, you can provide custom filter criteria with the GridAutoFilterEventArgs.Criteria property.

Note

When handling the ProcessOnClickRowFilter event, you should apply filter criteria only to the column that is filtered.

When the GridAutoFilterEventArgs.Kind property returns GridViewAutoFilterEventKind.ExtractDisplayText, you can provide custom text displayed within the filter row cells with the GridOnClickRowFilterEventArgs.Values property.

In the OnClick mode, use the ASPxTreeList.ProcessColumnAutoFilter event handler to perform any actions before the filter criteria are applied.

Note

Online Demos Refer to the Tree List - Data Filter Row(Web Forms) online demo to review how to filter Tree List data nodes using the Filter Row.

See Also