Bar

BarManager.RegistryPath Property

Gets or sets the registry path to which the bar layout is saved.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[DXCategory("Behavior")]
[DefaultValue("")]
public string RegistryPath { get; set; }
<DXCategory("Behavior")>
<DefaultValue("")>
Public Property RegistryPath As String

Property Value

Type Default Description
String

String.Empty

The registry path to which the bar layout is saved.

Remarks

Use the RegistryPath property to specify the registry key where the bar layout should be stored by default.

The Bar Manager allows you to automatically store the layout of its bars to the registry when the form is closed and restore the layout when the form is loaded. In this case, the RegistryPath property specifies where the bar settings are stored. Automatic saving/loading of bar layout is enabled if the BarManager.AutoSaveInRegistry property is set to true.

The RegistryPath property also provides a registry path for the BarManager.SaveToRegistry and BarManager.RestoreFromRegistry methods, which take no parameters.

It is possible to define whole and partial registry keys. For instance if you define a partial key, "Software\MyCompany\MyTool" the full path will be as follows: "HKEY_CURRENT_USER\Software\MyCompany\MyTool". You can also define the entire path "HKEY_LOCAL_MACHINE\Software\MyCompany\MyTool".

If RegistryPath is set to an empty string, the Bar Manager does not automatically save/restore the bar layout and the BarManager.AutoSaveInRegistry property's value is ignored. The BarManager.SaveToRegistry and BarManager.RestoreFromRegistry methods also do nothing in this case.

See Also