Back to Devexpress

TreeListOptionsBehavior.AllowRecursiveNodeChecking Property

windowsforms-devexpress-dot-xtratreelist-dot-treelistoptionsbehavior-dd07cde9.md

latest3.2 KB
Original Source

TreeListOptionsBehavior.AllowRecursiveNodeChecking Property

Gets or sets whether child nodes are automatically checked/unchecked when a parent node is checked/unchecked and vice versa.

Namespace : DevExpress.XtraTreeList

Assembly : DevExpress.XtraTreeList.v25.2.dll

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

Declaration

csharp
[DefaultValue(false)]
[XtraSerializableProperty]
public virtual bool AllowRecursiveNodeChecking { get; set; }
vb
<DefaultValue(False)>
<XtraSerializableProperty>
Public Overridable Property AllowRecursiveNodeChecking As Boolean

Property Value

TypeDefaultDescription
Booleanfalse

true if child nodes are automatically checked/unchecked when a parent node is checked/unchecked and vice versa; otherwise, false.

|

Property Paths

You can access this nested property as listed below:

Object TypePath to AllowRecursiveNodeChecking
TreeList

.OptionsBehavior .AllowRecursiveNodeChecking

|

Remarks

If the AllowRecursiveNodeChecking property is enabled:

  • child nodes are automatically checked/unchecked when a parent node is checked/unchecked
  • a parent node is checked/unchecked, when you check/uncheck all its child nodes.

The node checking feature can be enabled with the TreeListOptionsView.CheckBoxStyle, TreeListOptionsView.RootCheckBoxStyle and TreeListNode.ChildrenCheckBoxStyle properties. See Node Checking - Checkboxes and Radio Buttons to learn more.

Note

If you enable the AllowRecursiveNodeChecking option and utilize the TreeList.CheckBoxFieldName property, the data source field should support null values.

See Also

Node Checking - Checkboxes and Radio Buttons

TreeListOptionsBehavior Class

TreeListOptionsBehavior Members

DevExpress.XtraTreeList Namespace