TcxVirtualTreeListOptionsData.SmartLoad Property

Specifies the manner in which a data-aware tree list (TcxDBTreeList or TcxVirtualTreeList) is populated with data.

Declaration

property SmartLoad: Boolean read; write; default False;

Property Value

Type	Default
Boolean	False

Remarks

If the smart load feature is enabled, the tree list is first populated with only root level nodes (a root level for this mode is specified by the tree list’s RootValue property). If a particular node is being expanded, the tree list loads its child nodes. The intent of this feature is to improve performance, and reducing memory use.

Set the SmartLoad property to True, to enable the smart load feature. Otherwise, all nodes will be loaded simultaneously.

Note

The smart load feature is in effect if the tree list’s RootValue property is specified. In addition, the feature requires that records of the self-referenced dataset bound to the tree list are grouped by the parent field’s key values (also called parent key values). This requirement allows the tree list to quickly obtain the entire set of records that correspond to children of a particular parent node by locating the first record whose parent key value matches this parent node’s key value and moving to the next record with a matching parent key value. Once a different parent key value is found, the search for the parent node’s children is complete.

The default value of the SmartLoad property is False.