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

TreeList.CheckBoxFieldName Property

Gets or sets the name of the field whose values define the node check states.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v24.2.dll

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

#Declaration

[DefaultValue("")]
[XtraSerializableProperty]
public string CheckBoxFieldName { get; set; }

#Property Value

Type Default Description
String String.Empty

The name of the field to bind to the node check states.

#Remarks

To synchronize the node check states with a data source field, assign this field’s name to the CheckBoxFieldName property. In this instance, nodes’ initial check states are retrieved from this field. When a node is checked or unchecked, its new state is saved to this field.

The data source field you assign to this property should be of Boolean or Nullable Boolean (in case the AllowIndeterminateCheckState property is enabled) data type.

The following list describes the data source values to which the node check states correspond.

  • Checked state corresponds to true
  • Unchecked state corresponds to false
  • Indeterminate state corresponds to null.

See Node Checking - Checkboxes and Radio Buttons to learn more.

See Also