feat: dialog: refactor to support non-generic call, add options and remove parameters.

demo/Ursa.Demo/ViewModels/DialogDemoViewModel.cs

@@ -90,11 +90,13 @@ public class DialogDemoViewModel: ObservableObject
         var vm = new PlainDialogViewModel();
         if (IsWindow)
         {
-            DefaultResult = await Dialog.ShowModalAsync<PlainDialog, PlainDialogViewModel>(
-                vm,
-                "Please select a date",
-                SelectedMode,
-                SelectedButton);
+            DefaultResult = await Dialog.ShowModal<PlainDialog, PlainDialogViewModel>(
+                vm, options: new DialogOptions()
+                {
+                    Title = "Please select a date",
+                    Mode = SelectedMode,
+                    Button = SelectedButton
+                });
             Date = vm.Date;
         }
         else
@@ -131,7 +133,7 @@ public class DialogDemoViewModel: ObservableObject
 
             if (IsModal)
             {
-                Result = await Dialog.ShowCustomModalAsync<DialogWithAction, DialogWithActionViewModel, bool>(
+                Result = await Dialog.ShowCustomModal<DialogWithAction, DialogWithActionViewModel, bool>(
                     vm);
                 Date = vm.Date;
             }

src/Ursa/Controls/Dialog/Dialog.cs

@@ -9,81 +9,25 @@ namespace Ursa.Controls;
 
 public static class Dialog
 {
-    /// <summary>
-    /// Show a Window Modal Dialog that with all content fully customized. 
-    /// </summary>
-    /// <param name="vm"></param>
-    /// <typeparam name="TView"></typeparam>
-    /// <typeparam name="TViewModel"></typeparam>
-    /// <typeparam name="TResult"></typeparam>
-    /// <returns></returns>
-    public static async Task<TResult?> ShowCustomModalAsync<TView, TViewModel, TResult>(TViewModel vm) 
-        where TView : Control, new()
-    {
-        var mainWindow = GetMainWindow();
-        return await ShowCustomModalAsync<TView, TViewModel, TResult>(mainWindow, vm);
-    }
-    
-    /// <summary>
-    /// Show a Window Dialog that with all content fully customized. 
-    /// </summary>
-    /// <param name="vm"></param>
-    /// <typeparam name="TView"></typeparam>
-    /// <typeparam name="TViewModel"></typeparam>
-    /// <returns></returns>
-    public static void ShowCustom<TView, TViewModel>(TViewModel vm) 
-        where TView : Control, new()
-    {
-        var mainWindow = GetMainWindow();
-        ShowCustom<TView, TViewModel>(mainWindow, vm);
-    }
-    
-    /// <summary>
-    /// Show a Window Modal Dialog that with all content fully customized. And the owner of the dialog is specified.
-    /// </summary>
-    /// <param name="owner"></param>
-    /// <param name="vm"></param>
-    /// <typeparam name="TView"></typeparam>
-    /// <typeparam name="TViewModel"></typeparam>
-    /// <typeparam name="TResult"></typeparam>
-    /// <returns></returns>
-    public static async Task<TResult> ShowCustomModalAsync<TView, TViewModel, TResult>(Window? owner, TViewModel? vm) 
-        where TView: Control, new()
-    {
-        var window = new DialogWindow
-        {
-            Content = new TView { DataContext = vm },
-            DataContext = vm,
-        };
-        if (owner is null)
-        {
-            window.Show();
-            return default;
-        }
-        else
-        {
-            var result = await window.ShowDialog<TResult>(owner);
-            return result;
-        }
-    }
-    
-    
     /// <summary>
     /// Show a Window Dialog that with all content fully customized. And the owner of the dialog is specified.
     /// </summary>
+    /// <param name="vm">Dialog ViewModel instance</param>
     /// <param name="owner"></param>
-    /// <param name="vm"></param>
+    /// <param name="options"></param>
     /// <typeparam name="TView"></typeparam>
     /// <typeparam name="TViewModel"></typeparam>
     /// <returns></returns>
-    public static void ShowCustom<TView, TViewModel>(Window? owner, TViewModel? vm) 
+    public static void ShowCustom<TView, TViewModel>(TViewModel? vm, Window? owner = null, DialogOptions? options = null) 
         where TView: Control, new()
     {
         var window = new DialogWindow
         {
-            Content = new TView { DataContext = vm },
+            Content = new TView(),
             DataContext = vm,
         };
+        AssignOptionsToDialogWindow(window, options);
+        owner ??= GetMainWindow();
         if (owner is null)
         {
             window.Show();
@@ -94,43 +38,96 @@ public static class Dialog
         }
     }
     
-    public static async Task<DialogResult> ShowModalAsync<TView, TViewModel>(
-        Window? owner, 
-        TViewModel vm, 
-        string? title = null, 
-        DialogMode mode = DialogMode.None, 
-        DialogButton buttons = DialogButton.OKCancel)
-        where TView : Control, new()
-    {
-        var window = new DefaultDialogWindow()
+    public static void ShowCustom(Control view, object? vm, Window? owner = null, DialogOptions? options = null)
+    { 
+        var window = new DialogWindow
         {
-            Content = new TView() { DataContext = vm },
+            Content = view,
             DataContext = vm,
-            Buttons = buttons,
-            Title = title,
-            Mode = mode,
         };
+        AssignOptionsToDialogWindow(window, options);
+        owner ??= GetMainWindow();
         if (owner is null)
         {
             window.Show();
-            return DialogResult.None;
         }
         else
         {
-            var result = await window.ShowDialog<DialogResult>(owner);
-            return result;
+            window.Show(owner);
         }
     }
-    
-    public static async Task<DialogResult> ShowModalAsync<TView, TViewModel>(
-        TViewModel vm, 
-        string? title = null, 
-        DialogMode mode = DialogMode.None, 
-        DialogButton buttons = DialogButton.OKCancel)
+
+    public static Task<DialogResult> ShowModal<TView, TViewModel>(TViewModel vm, Window? owner = null,
+        DialogOptions? options = null)
         where TView: Control, new()
     {
-        var mainWindow = GetMainWindow();
-        return await ShowModalAsync<TView, TViewModel>(mainWindow, vm, title, mode, buttons);
+        var window = new DefaultDialogWindow
+        {
+            Content = new TView(),
+            DataContext = vm,
+        };
+        AssignOptionsToDefaultDialogWindow(window, options);
+        owner ??= GetMainWindow();
+        if (owner is null)
+        {
+            window.Show();
+            return Task.FromResult(DialogResult.None);
+        }
+        return window.ShowDialog<DialogResult>(owner);
+    }
+    
+    public static Task<DialogResult> ShowModal(Control view, object? vm, Window? owner = null, DialogOptions? options = null)
+    {
+        var window = new DefaultDialogWindow
+        {
+            Content = view,
+            DataContext = vm,
+        };
+        AssignOptionsToDefaultDialogWindow(window, options);
+        owner ??= GetMainWindow();
+        if (owner is null)
+        {
+            window.Show();
+            return Task.FromResult(DialogResult.None);
+        }
+        return window.ShowDialog<DialogResult>(owner);
+    }
+
+    public static Task<TResult?> ShowCustomModal<TView, TViewModel, TResult>(TViewModel vm, Window? owner = null,
+        DialogOptions? options = null)
+        where TView: Control, new()
+    {
+        var window = new DialogWindow
+        {
+            Content = new TView(),
+            DataContext = vm,
+        };
+        AssignOptionsToDialogWindow(window, options);
+        owner ??= GetMainWindow();
+        if (owner is null)
+        {
+            window.Show();
+            return Task.FromResult(default(TResult));
+        }
+        return window.ShowDialog<TResult?>(owner);
+    }
+
+    public static Task<TResult?> ShowCustomModal<TResult>(Control view, object? vm, Window? owner = null,
+        DialogOptions? options = null)
+    {
+        var window = new DialogWindow
+        {
+            Content = view,
+            DataContext = vm,
+        };
+        AssignOptionsToDialogWindow(window, options);
+        owner ??= GetMainWindow();
+        if (owner is null)
+        {
+            window.Show();
+            return Task.FromResult(default(TResult));
+        }
+        return window.ShowDialog<TResult?>(owner);
     }
     
     private static Window? GetMainWindow()
@@ -138,76 +135,49 @@ public static class Dialog
         var lifetime = Application.Current?.ApplicationLifetime;
         return lifetime is IClassicDesktopStyleApplicationLifetime { MainWindow: { } w } ? w : null;
     }
-}
 
-public static class OverlayDialog
-{
-    public static Task<DialogResult> ShowModalAsync<TView, TViewModel>(
-        TViewModel vm, 
-        string? hostId = null, 
-        string? title = null,
-        DialogMode mode = DialogMode.None,
-        DialogButton buttons = DialogButton.OKCancel)
-        where TView : Control, new()
+    private static void AssignOptionsToDialogWindow(DialogWindow window, DialogOptions? options)
     {
-        var t = new DefaultDialogControl()
+        if (options is null)
         {
-            Content = new TView(){ DataContext = vm },
-            DataContext = vm,
-            Buttons = buttons,
-            Title = title,
-            Mode = mode,
-        };
-        var host = OverlayDialogManager.GetHost(hostId);
-        host?.AddModalDialog(t);
-        return t.ShowAsync<DialogResult>();
+            options = new DialogOptions();
+        }
+        window.WindowStartupLocation = options.StartupLocation;
+        window.Title = options.Title;
+        if (options.StartupLocation == WindowStartupLocation.Manual)
+        {
+            if (options.Position is not null)
+            {
+                window.Position = options.Position.Value;
+            }
+            else
+            {
+                window.WindowStartupLocation = WindowStartupLocation.CenterOwner;
+            }
+        }
     }
-
-    public static Task<TResult> ShowCustomModalAsync<TView, TViewModel, TResult>(
-        TViewModel vm, 
-        string? hostId = null)
-        where TView: Control, new()
+    
+    private static void AssignOptionsToDefaultDialogWindow(DefaultDialogWindow window, DialogOptions? options)
     {
-        var t = new DialogControl()
+        if (options is null)
         {
-            Content = new TView() { DataContext = vm },
-            DataContext = vm,
-        };
-        var host = OverlayDialogManager.GetHost(hostId);
-        host?.AddModalDialog(t);
-        return t.ShowAsync<TResult>();
-    }
-
-    public static void Show<TView, TViewModel>(
-        TViewModel vm, 
-        string? hostId = null, 
-        string? title = null, 
-        DialogMode mode = DialogMode.None, 
-        DialogButton buttons = DialogButton.OKCancel)
-        where TView: Control, new()
-    {
-        var t = new DefaultDialogControl()
+            options = new DialogOptions();
+        }
+        window.WindowStartupLocation = options.StartupLocation;
+        window.Title = options.Title;
+        window.Buttons = options.Button;
+        window.Mode = options.Mode;
+        if (options.StartupLocation == WindowStartupLocation.Manual)
         {
-            Content = new TView() { DataContext = vm },
-            DataContext = vm,
-            Buttons = buttons,
-            Title = title,
-            Mode = mode,
-        };
-        var host = OverlayDialogManager.GetHost(hostId);
-        host?.AddDialog(t);
-    }
-
-    public static void ShowCustom<TView, TViewModel>(TViewModel vm, string? hostId = null)
-        where TView: Control, new()
-    {
-        var t = new DialogControl()
-        {
-            Content = new TView() { DataContext = vm },
-            DataContext = vm,
-        };
-        var host = OverlayDialogManager.GetHost(hostId);
-        host?.AddDialog(t);
+            if (options.Position is not null)
+            {
+                window.Position = options.Position.Value;
+            }
+            else
+            {
+                window.WindowStartupLocation = WindowStartupLocation.CenterOwner;
+            }
+        }
     }
     
     

src/Ursa/Controls/Dialog/DialogOptions.cs

@@ -0,0 +1,32 @@
+using Avalonia;
+using Avalonia.Controls;
+using Ursa.Common;
+
+namespace Ursa.Controls;
+
+public class DialogOptions
+{
+    /// <summary>
+    /// The Startup Location of DialogWindow. Default is <see cref="WindowStartupLocation.CenterOwner"/>
+    /// </summary>
+    public WindowStartupLocation StartupLocation { get; set; } = WindowStartupLocation.CenterOwner;
+    /// <summary>
+    /// The Position of DialogWindow startup location if <see cref="StartupLocation"/> is <see cref="WindowStartupLocation.Manual"/>
+    /// </summary>
+    public PixelPoint? Position { get; set; }
+    /// <summary>
+    /// Title of DialogWindow, Default is null
+    /// </summary>
+    public string? Title { get; set; }
+    /// <summary>
+    /// DialogWindow's Mode, Default is <see cref="DialogMode.None"/>
+    /// </summary>
+    public DialogMode Mode { get; set; } = DialogMode.None;
+
+    public DialogButton Button { get; set; } = DialogButton.OKCancel;
+}
+
+public class OverlayDialogOptions
+{
+    public bool ClickOnMaskToClose { get; set; } = false;
+}

src/Ursa/Controls/Dialog/OverlayDialog.cs

@@ -0,0 +1,77 @@
+using Avalonia.Controls;
+using Ursa.Common;
+
+namespace Ursa.Controls;
+
+public static class OverlayDialog
+{
+    public static Task<DialogResult> ShowModalAsync<TView, TViewModel>(
+        TViewModel vm, 
+        string? hostId = null, 
+        string? title = null,
+        DialogMode mode = DialogMode.None,
+        DialogButton buttons = DialogButton.OKCancel)
+        where TView : Control, new()
+    {
+        var t = new DefaultDialogControl()
+        {
+            Content = new TView(){ DataContext = vm },
+            DataContext = vm,
+            Buttons = buttons,
+            Title = title,
+            Mode = mode,
+        };
+        var host = OverlayDialogManager.GetHost(hostId);
+        host?.AddModalDialog(t);
+        return t.ShowAsync<DialogResult>();
+    }
+
+    public static Task<TResult> ShowCustomModalAsync<TView, TViewModel, TResult>(
+        TViewModel vm, 
+        string? hostId = null)
+        where TView: Control, new()
+    {
+        var t = new DialogControl()
+        {
+            Content = new TView() { DataContext = vm },
+            DataContext = vm,
+        };
+        var host = OverlayDialogManager.GetHost(hostId);
+        host?.AddModalDialog(t);
+        return t.ShowAsync<TResult>();
+    }
+
+    public static void Show<TView, TViewModel>(
+        TViewModel vm, 
+        string? hostId = null, 
+        string? title = null, 
+        DialogMode mode = DialogMode.None, 
+        DialogButton buttons = DialogButton.OKCancel)
+        where TView: Control, new()
+    {
+        var t = new DefaultDialogControl()
+        {
+            Content = new TView() { DataContext = vm },
+            DataContext = vm,
+            Buttons = buttons,
+            Title = title,
+            Mode = mode,
+        };
+        var host = OverlayDialogManager.GetHost(hostId);
+        host?.AddDialog(t);
+    }
+
+    public static void ShowCustom<TView, TViewModel>(TViewModel vm, string? hostId = null)
+        where TView: Control, new()
+    {
+        var t = new DialogControl()
+        {
+            Content = new TView() { DataContext = vm },
+            DataContext = vm,
+        };
+        var host = OverlayDialogManager.GetHost(hostId);
+        host?.AddDialog(t);
+    }
+    
+    
+}