Add methods to change the settings store.

Author: rwf-rr

Source/ORTS.Common/SettingsBase.cs

@@ -116,6 +116,23 @@ protected SettingsBase(SettingsStore settings)
         /// </summary>
         public abstract void Reset();
 
+        /// <summary>
+        /// Change the settings store. Creates a new SettingsStore based on the provided parameters.
+        /// See also SettingsStore.GetSettingStore().
+        /// </summary>
+        /// <param name="filePath">The path to the INI file, or NULL if using the registry.</param>
+        /// <param name="registryKey">The registry key (name), or NULL if using an INI file. </param>
+        /// <param name="section">Optional, the name of the section / subkey.</param>
+        public virtual void ChangeSettingsStore(string filePath, string registryKey, string section)
+        {
+            if (SettingStore != null)
+            {
+                SettingStore.Discard();
+                SettingStore = null;
+            }
+            SettingStore = SettingsStore.GetSettingStore(filePath, registryKey, section);
+        }
+
         /// <summary>
         /// Load settings from the options
         /// </summary>

Source/ORTS.Common/SettingsStore.cs

@@ -138,6 +138,15 @@ protected static void AssertGetUserValueType(Type expectedType)
         /// <param name="name">name of the setting</param>
 		public abstract void DeleteUserValue(string name);
 
+        /// <summary>
+        /// Discard the settings store.
+        /// Performs actions (if any) to close the settings store so that a new one can be used.
+        /// </summary>
+        public virtual void Discard()
+        {
+            // default action is to do nothing. Concrete classes may override.
+        }
+
         /// <summary>
         /// Factory method to create a setting store (sub-class of SettingsStore)
         /// </summary>
@@ -308,6 +317,19 @@ public override void DeleteUserValue(string name)
 		{
 			Key.DeleteValue(name, false);
 		}
+
+        /// <summary>
+        /// Discard the settings store.
+        /// Close the registry key.
+        /// </summary>
+        public override void Discard()
+        {
+            if (Key != null)
+            {
+                Key.Close();
+                // cannot set to null, as Key (and string version) are readonly
+            }
+        }
 	}
 
 	/// <summary>

Source/ORTS.Settings/UserSettings.cs

@@ -585,6 +585,22 @@ public override void Reset()
                 Reset(property.Name);
         }
 
+        /// <summary>
+        /// Change the settings store for the user settings and its sub-settings.
+        /// Creates a new SettingsStore based on the provided parameters.
+        /// </summary>
+        /// <param name="filePath">The path to the INI file, or NULL if using the registry.</param>
+        /// <param name="registryKey">The registry key (name), or NULL if using an INI file. </param>
+        /// <param name="section">Optional, the name of the section / subkey.</param>
+        public override void ChangeSettingsStore(string filePath, string registryKey, string section)
+        {
+            base.ChangeSettingsStore(filePath, registryKey, section);
+            Folders.ChangeSettingsStore(filePath, registryKey, section);
+            Input.ChangeSettingsStore(filePath, registryKey, section);
+            RailDriver.ChangeSettingsStore(filePath, registryKey, section);
+            Content.ChangeSettingsStore(filePath, registryKey, section);
+        }
+
         public void Log()
         {
             foreach (var property in GetProperties().OrderBy(p => p.Name))