Add font size properties and improve SVG alignment

Introduces FontSize and HeaderFontSize dependency properties to the grid, updates the view and view model to support them, and exposes them in the demo. Improves SVG icon vertical alignment in cells. Also adds XML documentation to ThemeColor, cleans up the readme, and removes unused GridControl and GridCustomDrawOperation files.

Author: CyLuGh

readme.md

@@ -1,10 +1,7 @@
 # HierarchyGrid
 
- 
-
-This component aims to display data along two different hierarchical classifications, as if a datagrid had its rows and columns defined by treeviews.
-
- 
+This component aims to display data along two different hierarchical classifications, as if a datagrid had its rows and
+columns defined by trees.
 
 ## Definitions
 
@@ -14,112 +11,89 @@ Rows and columns are defined by *HierarchyDefinition*. There are two kinds of th
 
 - *ConsumerDefinition*: extracts information from the object received from the producer, by default on column level.
 
- 
-
 ```csharp
-
 public object Content { get; set; }
-
 ```
 
 Defines the content of the grid header associated to the definition.
 
- 
-
 ```csharp
-
 public X Add<X>(X child) where X : HierarchyDefinition
-
 ```
 
 Adds a properly set child element to the current hierarchy definition.
 
- 
-
 ### ProducerDefinition
 
 ```csharp
-
-public Func<object> Producer { get; set; }
-
+public Func<object>? Producer { get; set; }
 ```
 
 Defines the function that will be used to retrieve data from the producer.
 
- 
-
 ```csharp
+public Func<Qualification>? Qualify { get; set; }
+```
 
-public Func<Qualification> Qualify { get; set; }
+Allows override of qualification for all elements produced by this definition, independently of the consumer
+definition.
 
+```csharp
+public bool IsLocked { get; set; }
 ```
 
-Allows override of qualification for all elements produced by this definition, independently from the consumer definition.
-
- 
+If set to true, all produced elements will be read-only, even if the consumer defines an editor.
 
 ### ConsumerDefinition
 
 ```csharp
-
-public Func<object, object> Consumer { get; set; }
-
+public Func<object, object>? Consumer { get; set; }
 ```
 
 Defines the function that will extract information from the provided data.
 
- 
-
 ```csharp
-
-public Func<object, string> Formatter { get; set; }
-
+public Func<object, string>? Formatter { get; set; }
 ```
 
 Defines the function that will format the consumer result as it will be displayed in the grid.
 
- 
-
 ```csharp
-
-public Func<object, Qualification> Qualify { get; set; }
-
+public Func<object, Qualification>? Qualify { get; set; }
 ```
 
 Defines the function that will set the cell qualification according to consumer result.
 
- 
-
 ```csharp
-
-public Func<object, (byte a, byte r, byte g, byte b)> Colorize { get; set; }
-
+public Func<object, (ThemeColor, ThemeColor)>? Colorize { get; set; }
 ```
 
 Defines the function that will set the cell background if cell qualification is set to ***Custom***.
 
- 
-
 ```csharp
+public Func<object, object, string, bool>? Editor { get; set; }
+```
 
-public Func<object, object, string, bool> Editor { get; set; }
+Defines the function called when a cell edition is validated. The first parameter is the object provided by the
+producer, the second is the result from the consumer, and the third one is the string input from the editing textbox.
+The
+boolean returns whether data has been updated.
 
+```csharp
+public Func<object, object, bool>? IsLocked { get; set; }
 ```
 
-Defines the function called when a cell edition is validated. The first parameter is the object provided by the producer, the second is the result from the consumer and the third one is the string input from the editing textbox. The boolean returns whether or not data has been updated.
-
- 
+Indicates that the cell can't be edited. The first parameter is raw data from the producer, and the second is the result
+from the consumer.
 
 ## Resulting grid
 
- 
-
 ### Qualifications
 
-Cell rendering can be modified according to a qualification. Available values are: Unset, Empty, Normal, Error, Warning, Remark, Custom, ReadOnly.
-
- 
+Cell rendering can be modified according to a qualification. Available values are: Unset, Empty, Normal, Error, Warning,
+Remark, Custom, ReadOnly.
 
 ## Known issues
 
-Even if UI performance has always been a major focus, *bindings* do impact scrolling speed. The more cells are displayed, the more the component will slow down.
+Even if UI performance has always been a major focus, the more cells are displayed, the more the component will slow
+down.

src/Demo.AvaloniaApplication/Resources/edit.svg

@@ -32,6 +32,8 @@
                             DefaultRowHeight="60"
                             StatusMessage="I'm a test message!"
                             EnableCrosshair="True"
+                            HeaderFontSize="18"
+                            FontSize="12"
                             DockPanel.Dock="Top"/>
       </DockPanel>
     </TabItem>

src/Demo.AvaloniaApplication/Views/MainView.axaml

@@ -5,56 +5,82 @@ namespace HierarchyGrid.Avalonia;
 public partial class Grid
 {
     public static readonly StyledProperty<string?> StatusMessageProperty =
-        AvaloniaProperty.Register<Grid , string?>( nameof( StatusMessage ) , "No message" );
+        AvaloniaProperty.Register<Grid, string?>(nameof(StatusMessage), "No message");
 
     public string? StatusMessage
     {
-        get => GetValue( StatusMessageProperty );
-        set => SetValue( StatusMessageProperty , value );
+        get => GetValue(StatusMessageProperty);
+        set => SetValue(StatusMessageProperty, value);
     }
 
     public static readonly StyledProperty<int> DefaultColumnWidthProperty =
-        AvaloniaProperty.Register<Grid , int>( nameof( DefaultColumnWidth ) , 120 );
+        AvaloniaProperty.Register<Grid, int>(nameof(DefaultColumnWidth), 120);
 
     public int DefaultColumnWidth
     {
-        get => GetValue( DefaultColumnWidthProperty );
-        set => SetValue( DefaultColumnWidthProperty , value );
+        get => GetValue(DefaultColumnWidthProperty);
+        set => SetValue(DefaultColumnWidthProperty, value);
     }
 
-    public static readonly StyledProperty<int> DefaultRowHeightProperty =
-        AvaloniaProperty.Register<Grid , int>( nameof( DefaultRowHeight ) , 30 );
+    public static readonly StyledProperty<int> DefaultRowHeightProperty = AvaloniaProperty.Register<
+        Grid,
+        int
+    >(nameof(DefaultRowHeight), 30);
 
     public int DefaultRowHeight
     {
-        get => GetValue( DefaultRowHeightProperty );
-        set => SetValue( DefaultRowHeightProperty , value );
+        get => GetValue(DefaultRowHeightProperty);
+        set => SetValue(DefaultRowHeightProperty, value);
     }
 
     public static readonly StyledProperty<int> DefaultHeaderWidthProperty =
-        AvaloniaProperty.Register<Grid , int>( nameof( DefaultHeaderWidth ) , 80 );
+        AvaloniaProperty.Register<Grid, int>(nameof(DefaultHeaderWidth), 80);
 
     public int DefaultHeaderWidth
     {
-        get => GetValue( DefaultHeaderWidthProperty );
-        set => SetValue( DefaultHeaderWidthProperty , value );
+        get => GetValue(DefaultHeaderWidthProperty);
+        set => SetValue(DefaultHeaderWidthProperty, value);
     }
 
     public static readonly StyledProperty<int> DefaultHeaderHeightProperty =
-        AvaloniaProperty.Register<Grid , int>( nameof( DefaultHeaderHeight ) , 30 );
+        AvaloniaProperty.Register<Grid, int>(nameof(DefaultHeaderHeight), 30);
 
     public int DefaultHeaderHeight
     {
-        get => GetValue( DefaultHeaderHeightProperty );
-        set => SetValue( DefaultHeaderHeightProperty , value );
+        get => GetValue(DefaultHeaderHeightProperty);
+        set => SetValue(DefaultHeaderHeightProperty, value);
     }
 
-    public static readonly StyledProperty<bool> EnableCrosshairProperty =
-        AvaloniaProperty.Register<Grid , bool>( nameof( EnableCrosshair ) , false );
+    public static readonly StyledProperty<bool> EnableCrosshairProperty = AvaloniaProperty.Register<
+        Grid,
+        bool
+    >(nameof(EnableCrosshair), false);
 
     public bool EnableCrosshair
     {
-        get => GetValue( EnableCrosshairProperty );
-        set => SetValue( EnableCrosshairProperty , value );
+        get => GetValue(EnableCrosshairProperty);
+        set => SetValue(EnableCrosshairProperty, value);
+    }
+
+    public static readonly StyledProperty<float> FontSizeProperty = AvaloniaProperty.Register<
+        Grid,
+        float
+    >(nameof(FontSize), 15);
+
+    public float FontSize
+    {
+        get => GetValue(FontSizeProperty);
+        set => SetValue(FontSizeProperty, value);
+    }
+
+    public static readonly StyledProperty<float> HeaderFontSizeProperty = AvaloniaProperty.Register<
+        Grid,
+        float
+    >(nameof(HeaderFontSize), 15);
+
+    public float HeaderFontSize
+    {
+        get => GetValue(HeaderFontSizeProperty);
+        set => SetValue(HeaderFontSizeProperty, value);
     }
 }

src/HierarchyGrid.Avalonia/Grid.DependencyProperties.cs

@@ -204,6 +204,8 @@ private static void ApplyDependencyProperties(Grid view, HierarchyGridViewModel
         viewModel.DefaultHeaderWidth = view.DefaultHeaderWidth;
         viewModel.StatusMessage = view.StatusMessage ?? "No message";
         viewModel.EnableCrosshair = view.EnableCrosshair;
+        viewModel.FontSize = view.FontSize;
+        viewModel.HeaderFontSize = view.HeaderFontSize;
     }
 
     private static async Task SkiaElement_PaintSurface(