Release V0.3.0

1. Change the app's Chinese name.
2. The app now uses the specified font family instead of the system default.
3. The main window is by default maximised (previously restored down).
4. Redesign the date pickers, due to the bad performance of the previous ones. Now they have a calendar view to make it easier to pick a date.
5. Optimise the appearance of the search button and the outer borders of the display area for the data grid.
6. Add hints for the situation when the search access is denied by the data source.
7. Add a busy indicator to show the indication of data loading.
8. Round each day's volumes to the nearest integer, and keep 1 decimal place for total volumes.
9. Enable row selection of the data grid which can provide a better view especially when the row is long, and clearing row selection is also enabled.
10. Sorting is by default disabled for each day's volumes (previously enabled for all columns). Besides, it is allowed to sort data to its initial order other than ascending or descending order.
11. Columns are auto-sized before becoming visible.
12. Display weekday names for columns whose header text is a date.
13. The columns for Saturday's and Sunday's volumes are not displayed now.
14. Optimise the content style of the exported Excel files and automatically enable filters for the columns.
15. Enable printing the data grid. If the column width is too long, you can just return to adjust it and then click the print button again.
16. Solve a potential crash problem during multiple times of searching.
17. Fix a bug that the tooltips of the title bar's buttons for controlling the window state are not displayed in simplified Chinese.
18. Fix a bug that the font colour of the text box for the symbol does not change to red sometimes when the input is in a wrong format (e.g., SH6010065).
19. Fix a bug that the data grid may not be in the initial status (sorting, column width, etc.) after clicking the search button.
20. Fix a bug that the data grid cannot be correctly exported as an Excel file in XLS format.
21. Fix a bug that UI can get temporarily choppy when the search button is clicked.

Author: ArvinZJC

ShSzStockHelper/App.xaml

@@ -1,9 +1,10 @@
-<Application x:Class="ShSzStockHelper.App"
+<!-- The app initialiser. -->
+<Application x:Class="ShSzStockHelper.App"
              xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
              xmlns:local="clr-namespace:ShSzStockHelper"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
              StartupUri="HomeWindow.xaml">
     <Application.Resources>
-         
+        <local:StylePropertyViewModel x:Key="StyleProperties" />
     </Application.Resources>
-</Application>
+</Application>

ShSzStockHelper/Helpers/StrikePrice_VolumeDataProcessor.cs renamed to ShSzStockHelper/Helpers/StrikePriceVolumeDataProcessor.cs

@@ -1,10 +1,10 @@
 /*
  * @Description: helper class for processing data of strike prices and volumes collected
- * @Version: 1.0.3.20200719
+ * @Version: 1.0.6.20200808
  * @Author: Arvin Zhao
  * @Date: 2020-07-15 18:25:42
  * @Last Editors: Arvin Zhao
- * @LastEditTime: 2020-07-19 19:25:42
+ * @LastEditTime: 2020-08-08 19:25:42
  */
 
 using HtmlAgilityPack;
@@ -15,10 +15,10 @@ namespace ShSzStockHelper
     /// <summary>
     /// A helper class for processing data of strike prices and volumes collected.
     /// </summary>
-    class StrikePrice_VolumeDataProcessor
+    class StrikePriceVolumeDataProcessor
     {
+        private readonly StylePropertyViewModel _stylePropertyViewModel;
         private const string _cellNodePath = "//tbody/tr";
-        private const string _dateStringFormat = "yyyy-M-d";
 
         /// <summary>
         /// The symbol of a stock.
@@ -35,49 +35,62 @@ class StrikePrice_VolumeDataProcessor
         /// </summary>
         public DateTime EndDate { get; set; }
 
+        public StrikePriceVolumeDataProcessor()
+        {
+            _stylePropertyViewModel = new StylePropertyViewModel(); // Initialise the view model class for using the defined style properties.
+        } // end constructor StrikePriceVolumeDataProcessor
+
         /// <summary>
         /// Get data of strike prices and volumes.
         /// </summary>
         /// <returns>
-        /// A 2D array of type decimal of size at least (1, 3) containing the data or of size (1, 1) if the date range is too long, or <c>null</c> if the filters are wrong.
-        /// The first index of the array represents the index of rows (start from 0).
-        /// The second index of the array represents the index of columns (start from 0).
-        /// For the second index, Index 0 represents strike prices, while Index 1 represents total volumes. The other indexes represent each day's volumes.
+        /// A jagged 2D array of type "decimal?" of size at least (1, 3) containing the data,
+        ///     or a 2D array of size (1, 1) if access is denied by the specified source providing data of strike prices and volumes,
+        ///     or a 2D array of size (1, 2) if the date range is too long,
+        ///     or <c>null</c> if the filters are wrong.
+        /// <br /><br />
+        /// The first number of the size represents the number of rows.
+        /// The second number of the size represents the number of columns.
+        /// For columns, Index 0 represents strike prices, while Index 1 represents total volumes. These two columns should not have <c>null</c> data. The other indexes represent each day's volumes.
+        /// <br /><br />
+        /// Each "row" of the 2D array will have the same number of elements, so it can be seen as a rectangular one.
+        /// The 2D array containing the data is sorted by strike prices in descending order.
         /// </returns>
-        public decimal?[,] GetStrikePrice_VolumeData()
+        public decimal?[][] GetStrikePriceVolumeData()
         {
             HtmlNode rootNode = GetRootNode(StartDate, EndDate);
 
             if (rootNode.SelectNodes("//body/div") != null)
             {
-                HtmlNodeCollection strikePrice_TotalVolumeNodes = rootNode.SelectNodes(_cellNodePath);
+                HtmlNodeCollection strikePriceTotalVolumeNodes = rootNode.SelectNodes(_cellNodePath);
 
-                if (strikePrice_TotalVolumeNodes != null)
+                if (strikePriceTotalVolumeNodes != null)
                 {
                     int dayTotalCount = EndDate.Subtract(StartDate).Days + 1; // Calculate the number of days (>= 1) from the start date to the end date.
-                    decimal?[,] strikePrice_VolumeRows = new decimal?[strikePrice_TotalVolumeNodes.Count, 2 + dayTotalCount]; // The table of strike prices and volumes should have at least 3 columns (strike price, total volume, and each day's volume).
+                    decimal?[][] strikePriceVolumeRowCollection = new decimal?[strikePriceTotalVolumeNodes.Count][]; // The table of strike prices and volumes should have at least 3 columns (strike price, total volume, and each day's volume).
+                    decimal?[] strikePriceVolumeRow;
                     int nodeIndex = 0; // Represent the index of rows (start from 0).
                     int elementIndex; // Represent the index of columns (start from 0).
 
                     // Get data of strike prices and total volumes.
-                    foreach (HtmlNode node in strikePrice_TotalVolumeNodes)
+                    foreach (HtmlNode node in strikePriceTotalVolumeNodes)
                     {
                         elementIndex = 0;
+                        strikePriceVolumeRow = new decimal?[2 + dayTotalCount];
 
                         foreach (HtmlNode element in node.Elements("td"))
                         {
-                            // Index 0 represents strike price, while Index 1 represents total volume. (Determined by the specified data source.)
+                            // Index 0 represents strike prices, while Index 1 represents total volumes. (Determined by the specified data source.)
                             if (elementIndex < 2)
                             {
                                 decimal elementValue = Convert.ToDecimal(element.InnerText);
-                                strikePrice_VolumeRows[nodeIndex, elementIndex] = elementIndex == 0 ? elementValue : elementValue / 100m; // 总成交量：1手 = 100股。
-                                elementIndex++;
+                                strikePriceVolumeRow[elementIndex++] = elementValue; // Here the unit of total volumes is "股".
                             }
                             else
                                 break;
                         } // end foreach
 
-                        nodeIndex++;
+                        strikePriceVolumeRowCollection[nodeIndex++] = strikePriceVolumeRow;
                     } // end foreach
 
                     if (dayTotalCount > 1)
@@ -86,36 +99,36 @@ class StrikePrice_VolumeDataProcessor
                         for (int dayCount = 0; dayCount < dayTotalCount; dayCount++)
                         {
                             DateTime dayVolumeDate = Convert.ToDateTime(StartDate.ToShortDateString()).AddDays(dayCount);
-                            HtmlNodeCollection strikePrice_DayVolumeNodes = GetRootNode(dayVolumeDate, dayVolumeDate).SelectNodes(_cellNodePath);
+                            HtmlNodeCollection strikePriceDayVolumeNodes = GetRootNode(dayVolumeDate, dayVolumeDate).SelectNodes(_cellNodePath);
 
                             /*
                              * Execute the code block if the specified node collection is not null.
                              * Otherwise, just keep the initial element value (0 of type decimal) of the 2D array containing data of strike prices and volume.
                              */
-                            if (strikePrice_DayVolumeNodes != null)
+                            if (strikePriceDayVolumeNodes != null)
                             {
                                 nodeIndex = 0;
 
-                                foreach (HtmlNode node in strikePrice_DayVolumeNodes)
+                                foreach (HtmlNode node in strikePriceDayVolumeNodes)
                                 {
                                     elementIndex = 0;
                                     decimal strikePrice = 0m;
 
                                     foreach (HtmlNode element in node.Elements("td"))
                                     {
-                                        // Index 0 represents strike price. (Determined by the specified data source.)
+                                        // Index 0 represents strike prices. (Determined by the specified data source.)
                                         if (elementIndex == 0)
                                         {
                                             strikePrice = Convert.ToDecimal(element.InnerText);
                                             elementIndex++;
                                         }
-                                        // Index 1 represents the specified day's volume. (Determined by the specified data source.)
+                                        // Index 1 represents the specified day's volumes. (Determined by the specified data source.)
                                         else if (elementIndex == 1)
                                         {
-                                            for (int nodeCount = 0; nodeCount < strikePrice_TotalVolumeNodes.Count; nodeCount++)
-                                                if (strikePrice_VolumeRows[nodeCount, 0] == strikePrice)
+                                            for (int nodeCount = 0; nodeCount < strikePriceTotalVolumeNodes.Count; nodeCount++)
+                                                if (strikePriceVolumeRowCollection[nodeCount][0] == strikePrice)
                                                 {
-                                                    strikePrice_VolumeRows[nodeCount, 2 + dayCount] = Convert.ToDecimal(element.InnerText) / 100m; // 每日成交量：1手 = 100股。
+                                                    strikePriceVolumeRowCollection[nodeCount][2 + dayCount] = Convert.ToDecimal(element.InnerText); // Here the unit of the specified day's volumes is "股".
                                                     break;
                                                 } // end if
 
@@ -129,23 +142,29 @@ class StrikePrice_VolumeDataProcessor
                                 } // end foreach
                             }
                             else
-                                for (int nodeCount = 0; nodeCount < strikePrice_TotalVolumeNodes.Count; nodeCount++)
-                                    strikePrice_VolumeRows[nodeCount, 2 + dayCount] = null;
+                                for (int nodeCount = 0; nodeCount < strikePriceTotalVolumeNodes.Count; nodeCount++)
+                                    strikePriceVolumeRowCollection[nodeCount][2 + dayCount] = null;
                         } // end for
                     }
                     else
-                        for (int nodeCount = 0; nodeCount < strikePrice_TotalVolumeNodes.Count; nodeCount++)
-                            strikePrice_VolumeRows[nodeCount, 2] = strikePrice_VolumeRows[nodeCount, 1];
+                        for (int nodeCount = 0; nodeCount < strikePriceTotalVolumeNodes.Count; nodeCount++)
+                            strikePriceVolumeRowCollection[nodeCount][2] = strikePriceVolumeRowCollection[nodeCount][1];
+
+                    // TODO: sorting may not be needed when getting data from the web.
+                    // Array.Sort(strikePriceVolumeRowCollection, (x, y) => Comparer<decimal>.Default.Compare((decimal) y[0], (decimal) x[0])); // Sort by strike prices in descending order.
 
-                    return strikePrice_VolumeRows;
+                    return strikePriceVolumeRowCollection;
                 }
                 // Wrong filters (symbol/start date/end date).
                 else
                     return null;
             }
+            // Access is denied by the specified data source.
+            else if (rootNode.SelectNodes("//body/h1") != null)
+                return new decimal?[1][] { new decimal?[1] };
             // The date range is too long.
             else
-                return new decimal?[1, 1];
+                return new decimal?[1][] { new decimal?[2] };
         } // end method GetStrikePrice_VolumeData
 
         /// <summary>
@@ -157,8 +176,8 @@ class StrikePrice_VolumeDataProcessor
         private HtmlNode GetRootNode(DateTime startDate, DateTime endDate)
         {
             return new HtmlWeb()
-                .Load(@"http://market.finance.sina.com.cn/pricehis.php?symbol=" + Symbol + "&startdate=" + startDate.ToString(_dateStringFormat) + "&enddate=" + endDate.ToString(_dateStringFormat))
+                .Load(@"http://market.finance.sina.com.cn/pricehis.php?symbol=" + Symbol + "&startdate=" + startDate.ToString(_stylePropertyViewModel.DateFormat) + "&enddate=" + endDate.ToString(_stylePropertyViewModel.DateFormat))
                 .DocumentNode;
         } // end method GetRootNode
-    } // end class StrikePrice_VolumeDataProcessor
+    } // end class StrikePriceVolumeDataProcessor
 } // end namespace ShSzStockHelper