JVCL Help:TJvCustomDBTreeView.UpdateTree

From Project JEDI Wiki
Jump to navigationJump to search
JEDI Visual Component Library Help

Search in JVCL Help

 
Search in all projects
 

Summary

Forces the tree view to be updated following changes to node(s) or the dataset for the data-aware tree view control.


Pascal

 procedureUpdateTree;


Description

UpdateTree is the method used to force the content in the tree view to be updated following changes to node(s) or the dataset for the data-aware tree view control. UpdateTree is called from the UpdateUnLock method when UpdateLock reaches the value zero (0).
UpdateTree calls CheckDataset to ensure that a valid dataset is available for access values used in building and rendering the tree in the data-aware tree view control.
When UpdateLock has been called previously, or a nested call to UpdateTree has been performed, no additional action is taken in the method.
UpdateTree visits rows in the underlying dataset for the DataSource to ensure that TJvDBTreeNode instances in the Items property match the values present in the dataset. This includes visiting any child nodes and their associated data as represented in Items.
When data is located that does not exist in the Items for the tree structure, the node (or child node) is added using the values indicated by the MasterField, DetailField, and ItemField properties.
Applications do not normally call UpdateTree; it is called automatically in UpdateUnLock and when the dataset performs event notifications for scroll, browse, or data changed events.


About

Contribute to this help topic

This documentation wiki is based on the collaborative effort of Project JEDI users. Your edits are welcome in order to improve documentation quality: edit this page