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

TcxCustomTreeList.StoreToRegistry(string,Boolean,string) Method

Stores TreeList-specific information to the registry.

#Declaration

Delphi
procedure StoreToRegistry(AStorageName: string; AReCreate: Boolean = True; const ASaveTreeListName: string = '');

#Parameters

Name Type
AStorageName string
AReCreate Boolean
ASaveTreeListName string

#Remarks

Use the StoreToRegistry method to save TreeList-specific information to the registry. This information can be restored after the changes have been applied to the TreeList control. Use the RestoreFromRegistry method to restore the TreeList structure. Before restoring the TreeList structure, ensure that the control contains all the columns connected to dataset fields at the time when the data was saved.

Stored structure information includes: instance names, band and column settings. Stored elements’ (bands, columns) settings specify the position and visibility of elements, captions, sort order, data binding etc.

The registry path for the TreeList information is formed by adding the AStorageName suffix to the HKEY_CURRENT_USER key.

The AReCreate parameter determines whether the required key is recreated by each StoreToRegistry method call. If this parameter value is True, the existing registry key is deleted and then created again. Otherwise, information is appended to the existing key.

For information on the ASaveTreeListName parameter, see the RestoreFromIniFile method description.

See Also