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

TdxBarManager.SaveToIniFile(string) Method

Saves bar manager’s settings to an INI file.

#Declaration

Delphi
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;
See Also