TcxCustomTreeList.StoreToIniFile(string,Boolean,string) Method

Saves TreeList-specific information to an INI file.

Declaration

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

Parameters

Name	Type
AStorageName	string
AReCreate	Boolean
ASaveTreeListName	string

Remarks

Use the StoreToIniFile method to save TreeList-specific information to an INI file. This information can be restored to keep changes applied to the TreeList control. The TreeList structure is restored by a RestoreFromIniFile method call. Before restoring the TreeList structure, ensure that the control contains all the columns connected to the dataset fields at the time 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 AStorageName parameter specifies the INI file path and name.

The AReCreate parameter determines whether the INI file required is recreated by each StoreToIniFile method call. If this parameter value is True, the existing INI file is deleted and then created again. Otherwise, information is appended to the end of the existing file.

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