Release V0.8.0

1. Improve code structure and comments.
2. Update README.
3. Use Syncfusion NuGet packages instead of the corresponding assemblies.
4. Integrate PortableSettingsProvider V0.2.4 to override the default settings provider to provide better user experience.
5. Upgrade HtmlAgilityPack from V1.11.24 to V1.11.28.
6. Upgrade Syncfusion WPF UI from V18.2.0.44 to V18.3.0.53.
7. Change the Chinese name of the app to "神户座".
8. Adjust the layout of the installation dialogue of the setup EXE file.
9. Improve text contents of the setup EXE file.
10. Reduce application files and adjust the organisation of the setup EXE file.
11. The users are now allowed to choose whether to keep the user config together with some other temp files or not when uninstalling the application.
12. Optimise the explanation of some settings.
13. Optimise the rounding function for day volumes. Now, the specified number of decimal digits can be kept without dropping 0.
14. Adjust the appearance of buttons.
15. The advanced filter of the data grid can now generate unique items in the list.
16. Add support for applying the font family specified in the settings to the controls on the Print Preview window.
17. Update the URL of the product's GitHub repository on the window for showing the info about the product.
18. Fix a bug that some files are not removed when the application is uninstalled.
19. Fix a bug that the user settings restore to default values after upgrading the application. Reconfigure the application as you like, and your preferences should be kept when the application is upgraded next time.
20. Fix a bug that the column for total volumes can be lengthened or shortened without limitation.
21. Fix a bug that the icon of the Print Preview window is incorrect.
22. Fix a bug that some words in the Print Preview window are not displayed in simplified Chinese.
23. Fix a bug that the print preview function works improperly in the dark mode.

Author: ArvinZJC

README-zhCN.md

@@ -1,4 +1,4 @@
-# 沪深小助手（Windows版）
+# 神户座
 
 [![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/ArvinZJC/ShSzStockHelper-Windows?include_prereleases)](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases)
 [![GitHub All Releases](https://img.shields.io/github/downloads/ArvinZJC/ShSzStockHelper-Windows/total)](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases)
@@ -7,9 +7,12 @@
 
 [English](https://github.com/ArvinZJC/ShSzStockHelper-Windows/blob/master/README.md) | **简体中文**
 
-沪深小助手主要用来帮助用户搜索成交价和成交量，可看作是对分价表的组合加工。“沪深”所指代的啥就不多说了，懂的都懂。这款应用程序实现的功能算不上太复杂，设计的目的主要是为了满足一些中国大陆用户的需求（包括家人），因而此应用程序支持的语言仅有简体中文。
+神户座是一个Windows应用程序，它主要用来帮助用户搜索成交价和成交量，可看作是对分价表的组合加工。“神户”玩儿的是谐音梗，指代“沪深”。“沪深”的意思就不多说了，懂的都懂。这款应用程序实现的功能算不上太复杂，设计的目的主要是为了满足一些中国大陆用户的需求（包括家人），因而此应用程序支持的语言仅有简体中文。请注意此项目使用[GPL-3.0协议](https://github.com/ArvinZJC/ShSzStockHelper-Windows/blob/master/LICENSE)。
 
-此项目包含了此应用程序的Windows版的源码。请注意此项目使用[GPL-3.0协议](https://github.com/ArvinZJC/ShSzStockHelper-Windows/blob/master/LICENSE)。
+## 注意
+
+1. 应用程序配置文件和相应的更新日志可在[发行](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases)部分找到。从[V0.3.0](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases/tag/v0.3.0)开始，此项目采用了一个全新的打包方案，制作出来的应用程序配置文件功能体系更全，体积更小，也因此**从低于V0.3.0的版本升级时必须手动卸载旧版本**。
+2. 应用程序支持**Windows 7/8/8.1/10**。
 
 ## 文件夹说明
 
@@ -25,9 +28,4 @@
 
 这个文件夹包含了一个Jupyter Notebook文件，其中用Python代码实现了查询沪深股票代码和相应的股票名称，并将它们保存在一个JSON格式的文件中。这个数据文件是应用程序资源的一部分。
 
-## 注意
-
-1. 应用程序配置文件可从[发行](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases)部分下载。从[V0.3.0](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases/tag/v0.3.0)开始，此项目采用了一个全新的打包方案，制作出来的应用程序配置文件功能体系更全，体积更小，也因此**从低于V0.3.0的版本升级时必须手动卸载旧版本**。
-2. 应用程序支持Windows 7/8/8.1/10。
-
 更多信息请参见各文件夹的README。

README.md

@@ -1,4 +1,4 @@
-# SH/SZ Stock Helper for Windows
+# SH/SZ Stock Helper
 
 [![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/ArvinZJC/ShSzStockHelper-Windows?include_prereleases)](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases)
 [![GitHub All Releases](https://img.shields.io/github/downloads/ArvinZJC/ShSzStockHelper-Windows/total)](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases)
@@ -7,9 +7,12 @@
 
 **English** | [简体中文](https://github.com/ArvinZJC/ShSzStockHelper-Windows/blob/master/README-zhCN.md)
 
-SH/SZ Stock Helper can mainly search strike prices and volumes for the users. Here SH represents Shanghai Stock Exchange, while SZ means Shenzhen Stock Exchange. Please note that this application is mainly designed for a specified part of Chinese users, and contents are displayed in simplified Chinese.
+SH/SZ Stock Helper is a Windows application which can mainly search strike prices and volumes for the users. Here SH represents Shanghai Stock Exchange, while SZ means Shenzhen Stock Exchange. The application is mainly designed for a specified part of Chinese users, and contents are displayed in simplified Chinese. Please note that the code is licensed under [the GPL-3.0 License](https://github.com/ArvinZJC/ShSzStockHelper-Windows/blob/master/LICENSE).
 
-This repository contains the source code of the Windows version of the application. Please note that the code is licensed under [the GPL-3.0 License](https://github.com/ArvinZJC/ShSzStockHelper-Windows/blob/master/LICENSE).
+## ATTENTION
+
+1. The setup EXE files and the corresponding changelogs can be found in the [Releases](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases) section. From [V0.3.0](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases/tag/v0.3.0), a totally new solution to build the setup file is applied to make it more powerful (but with a smaller size) and **any version older than V0.3.0 should be manually uninstalled**.
+2. The application supports **Windows 7/8/8.1/10**.
 
 ## Folder Instructions
 
@@ -25,9 +28,4 @@ This is the Advanced Installer project folder. The files in the folder are mainl
 
 This folder contains a Jupyter Notebook file with Python code to retrieve and store a list of symbols and corresponding names of SH/SZ stocks in a JSON file which is a part of the resources of the application.
 
-## ATTENTION
-
-1. The setup EXE files can be downloaded from [Releases](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases) section. From [V0.3.0](https://github.com/ArvinZJC/ShSzStockHelper-Windows/releases/tag/v0.3.0), a totally new solution to build the setup file is applied to make it more powerful (but with a smaller size) and **any version older than V0.3.0 should be manually uninstalled**.
-2. The application supports Windows 7/8/8.1/10.
-
 For more information, please refer to the README file in each folder.

ShSzStockHelper/App.xaml.cs

@@ -1,16 +1,19 @@
 /*
  * @Description: the back-end code of initialising the app
- * @Version: 1.0.6.20200916
+ * @Version: 1.0.8.20201130
  * @Author: Arvin Zhao
  * @Date: 2020-07-08 10:17:48
  * @Last Editors: Arvin Zhao
- * @LastEditTime: 2020-09-16 14:14:55
+ * @LastEditTime: 2020-11-30 14:14:55
  */
 
+using Bluegrams.Application;
 using Syncfusion.Licensing;
 using Syncfusion.SfSkinManager;
 using System;
+using System.Diagnostics;
 using System.Globalization;
+using System.IO;
 using System.Reflection;
 using System.Threading;
 using System.Windows;
@@ -22,14 +25,60 @@ namespace ShSzStockHelper
     /// </summary>
     public partial class App
     {
+        private static string _productId, _productName, _productVersion, _productCopyright;
         private Mutex _mutex; // It is important to declare the mutex here. Otherwise, it may have no effect.
 
         /// <summary>
         /// Initialise a new instance of the <see cref="App"/> class.
         /// </summary>
         public App()
         {
-            SyncfusionLicenseProvider.RegisterLicense("Mjg5NjU2QDMxMzgyZTMyMmUzMEMwbk5LbjVFbW5VU1ZqUDFmbkF5eXF6dURJVkZ5RDgyNjVnMXF2d0h1c0k9"); // Register Syncfusion license.
+            SyncfusionLicenseProvider.RegisterLicense("MzI2OTM0QDMxMzgyZTMzMmUzMGFyTEY5ai9VTGlKRXcrdlpLSjU5VUlHR1ZZZzkxeDlBYzdkMHMvY0d0LzA9"); // Register a Syncfusion license.
+
+            _productId = Assembly.GetExecutingAssembly().GetName().Name;
+            _productName = ShSzStockHelper.Properties.Resources.NullProductNameError;
+            _productVersion = ShSzStockHelper.Properties.Resources.NullProductVersionError;
+            _productCopyright = ShSzStockHelper.Properties.Resources.NullProductCopyrightError;
+
+            string productCompany = null;
+            var assembly = Assembly.GetEntryAssembly();
+
+            if (assembly != null)
+            {
+                var fileVersionInfo = FileVersionInfo.GetVersionInfo(assembly.Location);
+                var assemblyVersionAttribute = assembly.GetCustomAttribute<AssemblyInformationalVersionAttribute>();
+                var assemblyCopyrightAttribute = assembly.GetCustomAttribute<AssemblyCopyrightAttribute>();
+
+                _productName = fileVersionInfo.ProductName;
+
+                if (assemblyVersionAttribute != null)
+                    _productVersion = assemblyVersionAttribute.InformationalVersion;
+
+                productCompany = fileVersionInfo.CompanyName;
+
+                if (assemblyCopyrightAttribute != null)
+                    _productCopyright = assemblyCopyrightAttribute.Copyright;
+            } // end if
+
+            // Configure the customised settings provider.
+            PortableSettingsProvider.SettingsFileName = "user.config";
+
+            if (_productId != null && productCompany != null)
+            {
+                // ReSharper disable once RedundantAssignment
+                var customisedSettingsDirectory = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), productCompany, _productId);
+
+#if DEBUG
+                customisedSettingsDirectory = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), productCompany, _productId + "_debug");
+#endif
+
+                if (!Directory.Exists(customisedSettingsDirectory))
+                    Directory.CreateDirectory(customisedSettingsDirectory);
+
+                PortableSettingsProviderBase.SettingsDirectory = customisedSettingsDirectory;
+            } // end if
+
+            PortableSettingsProvider.ApplyProvider(ShSzStockHelper.Properties.Settings.Default);
 
             if (ShSzStockHelper.Properties.Settings.Default.ProductTheme == (int) VisualStyles.MaterialDark)
                 Current.Resources.MergedDictionaries.Add((ResourceDictionary)LoadComponent(new Uri("Resources/MaterialDark/Theme.xaml", UriKind.Relative)));
@@ -46,13 +95,40 @@ public App()
 
         protected override void OnStartup(StartupEventArgs e)
         {
-            _mutex = new Mutex(true, Assembly.GetExecutingAssembly().GetName().Name);
+            _mutex = new Mutex(true, _productId);
 
             // Allow running only 1 instance of the product.
             if (_mutex.WaitOne(0, false))
                 base.OnStartup(e);
             else
                 Shutdown();
         } // end method OnStartUp
+
+        /// <summary>
+        /// Get the name of the product.
+        /// </summary>
+        /// <returns>The name of the product.</returns>
+        public static string GetProductName()
+        {
+            return _productName;
+        } // end method GetProductName
+
+        /// <summary>
+        /// Get the version of the product.
+        /// </summary>
+        /// <returns>The version of the product.</returns>
+        public static string GetProductVersion()
+        {
+            return _productVersion;
+        } // end method GetProductName
+
+        /// <summary>
+        /// Get the copyright of the product.
+        /// </summary>
+        /// <returns>The copyright of the product.</returns>
+        public static string GetProductCopyright()
+        {
+            return _productCopyright;
+        } // end method GetProductName
     } // end class App
 } // end namespace ShSzStockHelper