Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

FilterControl.InitNode Event

Allows you to customize a node’s settings when it is initialized.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DXCategory("Events")]
public event InitNodeEventHandler InitNode

#Event Data

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

Property Description
IsNewNode Gets whether the node is newly created.
PropertyName Gets or sets the property (field) name.
PropertyType Gets the type of the current property (column/field). Inherited from BaseNodeEventArgs.

The event data class exposes the following methods:

Method Description
SetOperation(FunctionOperatorType) Sets the operation type for the current node.
SetOperation(ClauseType) Sets the operation type for the current node.
SetOperation(String) Applies a registered custom function to the current node.

#Remarks

The InitNode event fires in the following cases:

  • You add a new node in the Filter Control. In this case, the IsNewNode event parameter returns true.
  • You change the property (field) name for an existing node (via a dropdown list). In this case, the IsNewNode event parameter returns false.

To change the operation type for the current node, use the SetOperation method (available from the event arguments).

#Example

The following example sets the default operation type to GreaterOrEqual for the UnitPrice field.

image

private void filterControl1_InitNode(object sender, DevExpress.XtraEditors.Filtering.InitNodeEventArgs e) {
    if (e.PropertyName == "UnitPrice")
        e.SetOperation(DevExpress.Data.Filtering.Helpers.ClauseType.GreaterOrEqual);
}
See Also