TreeListOptionsFilter.FilterEditorAllowCustomExpressions Property

Gets or sets whether the Filter Editor allows you to display, create and edit custom expressions—expressions that cannot be converted to Filter Editor nodes.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.TreeList

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[XtraSerializableProperty]
public DefaultBoolean FilterEditorAllowCustomExpressions { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
<XtraSerializableProperty>
Public Property FilterEditorAllowCustomExpressions As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	A value that specifies whether the Filter Editor allows you to display, create and edit custom expressions.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Property Paths

You can access this nested property as listed below:

Object Type	Path to FilterEditorAllowCustomExpressions
TreeList	.OptionsFilter .FilterEditorAllowCustomExpressions

Remarks

Individual filter expressions (for example, expressions that contain advanced or custom functions) cannot be converted to Filter Editor nodes. Below is an example:

[Sales Date] > AddDays(LocalDateTimeToday(), -25)

The AllowCustomExpressions property specifies whether and how the Filter Editor displays these expressions. The following options are available:

True

The Filter Editor displays custom expressions, and allows users to edit existing and create new custom expressions.

Users can create new custom expressions from a context menu.

Users can click the expression to open the Expression Editor, which allows them to edit the expression.

Handle the TreeList.FilterEditorCreated event to customize this Expression Editor.

Default

The Filter Editor displays custom expressions as simple text. A user cannot edit or create custom expressions.

False

The Filter Editor does not display custom expressions, and does not allow users to create new ones.