TreeListOptionsBehavior.AllowBoundCheckBoxesInVirtualMode Property

Gets or sets whether node check states can be specified dynamically - using the TreeList.VirtualTreeGetCellValue/TreeList.VirtualTreeSetCellValue events, and IVirtualTreeListData.VirtualTreeGetCellValue/VirtualTreeSetCellValue interface methods.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v20.1.dll

Declaration

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

Property Value

Type Default Description
Boolean

false

true if node check states can be specified dynamically - via dedicated events and methods; false if these events/methods are only fired to get/set node values.

Property Paths

You can access this nested property as listed below:

Library Object Type Path to AllowBoundCheckBoxesInVirtualMode
WinForms Controls GanttControl
.OptionsBehavior.AllowBoundCheckBoxesInVirtualMode
GanttControl
.OptionsBehavior.AllowBoundCheckBoxesInVirtualMode
ResourcesTree
.OptionsBehavior.AllowBoundCheckBoxesInVirtualMode
TreeList
.OptionsBehavior.AllowBoundCheckBoxesInVirtualMode
Reporting XRDesignFieldList
.OptionsBehavior.AllowBoundCheckBoxesInVirtualMode
XRDesignFieldList
.OptionsBehavior.AllowBoundCheckBoxesInVirtualMode
XRDesignReportExplorer
.OptionsBehavior.AllowBoundCheckBoxesInVirtualMode
XRDesignReportExplorer
.OptionsBehavior.AllowBoundCheckBoxesInVirtualMode

Remarks

TreeList allows you to implement virtual binding mode (dynamic data load) by handling the TreeList.VirtualTreeGetCellValue and TreeList.VirtualTreeSetCellValue events, or by binding the control to a business object that implements the IVirtualTreeListData interface. See the following topics to learn more.

You can use the TreeListOptionsView.CheckBoxStyle, TreeListOptionsView.RootCheckBoxStyle and TreeListNode.ChildrenCheckBoxStyle properties to enable node built-in check boxes/radio buttons that allow end-users to check certain nodes. In this case, you can set the AllowBoundCheckBoxesInVirtualMode property to true to use the TreeList.VirtualTreeGetCellValue/TreeList.VirtualTreeSetCellValue events and IVirtualTreeListData.VirtualTreeGetCellValue/VirtualTreeSetCellValue methods to specify not only node values, but also node check states.

When the AllowBoundCheckBoxesInVirtualMode property is true, the TreeList.VirtualTreeGetCellValue event/IVirtualTreeListData.VirtualTreeGetCellValue interface method will additionally be fired for each node with the VirtualTreeGetCellValueInfo.IsCheckState parameter set to true. To provide a node's check state, assign it to the VirtualTreeGetCellValueInfo.CellData parameter (when IsCheckState is true).

Similarly, when an end-user modifies a node's check state, the TreeList.VirtualTreeSetCellValue event/IVirtualTreeListData.VirtualTreeSetCellValue interface method will be fired with the VirtualTreeSetCellValueInfo.IsCheckState parameter set to true. In this case, save the node's check state (which is stored in the VirtualTreeSetCellValueInfo.NewCellData parameter) according to your logic.

See Also