TdxBarManager.SaveToIniFile(string) Method

Saves bar manager’s settings to an INI file.

Declaration

procedure SaveToIniFile(const AFileName: string);

Parameters

Name	Type
AFileName	string

Remarks

Use the SaveToIniFile method to store the bar manager’s settings into the INI file specified by the AFileName parameter. If the specified file name is an empty string, the SaveToIniFile method does nothing. The settings saved in an INI file are listed in the following table.

Section	Settings
Bar manager’s properties	Menu settings, hint visibility, a count of toolbars within the current bar manager, etc.
Toolbars’ and subitems’ properties	A toolbar’s caption, docking settings, settings of toolbar items, etc.

You can restore bar manager’s settings from an INI file using the LoadFromINIFile method. Also settings can be saved to and restored from a stream or the registry. Please refer to the SaveToStream or SaveToRegistry and, LoadFromStream or LoadfromRegistry method pairs.

Note

You should call the SaveToIniFile method from a child form’s OnClose event handler to save bar manager’s settings in MDI applications.

For example:

procedure TForm1.FormClose(Sender: TObject; var Action: TCloseAction);
begin
  with dxbarManager1 do
    SaveToIniFile(IniFileName);
  Action := caFree;
end;