TdxPSFileBasedExplorer.SaveToIniFile(string) Method

Saves the explorer’s settings to an INI file.

Declaration

procedure SaveToIniFile(const AFileName: string); overload;

Parameters

Name	Type
AFileName	string

Remarks

The first overloaded variant of this method creates an INI file with the name, specified by the AFileName parameter, and saves settings to this INI file, within the section labeled by the explorer’s name. If the specified file exists, it’s overwritten. You can specify the full path to the file or a path relative to an application’s starting folder.

The second overloaded variant of this method saves the explorer’s settings within a specified section of a certain INI file that is currently open. AIniFile and ASection specify the INI file and section, respectively. This overloaded variant is called internally by the first overloaded variant and the SaveToRegistry method, which pass the default parameter values. By default, only the explorer’s root path is saved. You can override the SaveToIniFile method in TdxPSFileBasedExplorer descendants to save any additional data.

The first overloaded variant of the SaveToIniFile method is called automatically when the explorer’s settings are stored to an INI file with ExpressPrinting System settings. To enable this mode, assign dxstIniFile to the OptionsStoring.StorageType property of the currently active engine controller, and designate the destination file via the engine controller’s OptionsStoring.IniFileName property.

To load the explorer’s settings from an INI file, call the LoadFromIniFile method.