AboutBox.cs

using System.Drawing;
using System.Numerics;
using Gondwana.Drawing.Direct;
using Gondwana.Rendering;
using Gondwana.Rendering.Views;
using Gondwana.Widgets.Controls;
using SkiaSharp;
 
namespace Gondwana.Widgets.Dialogs;

public sealed class AboutBox : DialogBox
{
    private const int DefaultWidth = 520;
    private const int DefaultHeight = 330;
 
    private bool _disposed;
 
    #region constructors

    public AboutBox(RenderSurfaceHostBase renderSurfaceHost,
                    View view,
                    string applicationName,
                    string version,
                    string? description = null,
                    string? copyright = null,
                    SKImage? logo = null,
                    Rectangle? bounds = null,
                    string? nickname = null,
                    IExternalUriLauncher? uriLauncher = null,
                    Uri? hyperlinkUri = null,
                    string? hyperlinkText = null)
        : base(renderSurfaceHost,
               view,
               ResolveBounds(view, bounds),
               $"About {applicationName}",
               showCloseButton: true,
               nickname: nickname ?? "__gondwana_about__")
    {
        ApplicationName = applicationName;
        Version = version;
        Description = description;
        Copyright = copyright;
 
        bool hasHyperlinkConfiguration = uriLauncher is not null ||
                                         hyperlinkUri is not null ||
                                         hyperlinkText is not null;
 
        if (hasHyperlinkConfiguration)
        {
            if (uriLauncher is null)
            {
                throw new ArgumentNullException(nameof(uriLauncher), "A URI launcher is required when configuring the hyperlink.");
            }
 
            if (hyperlinkUri is null)
            {
                throw new ArgumentNullException(nameof(hyperlinkUri), "A hyperlink URI is required when configuring the hyperlink.");
            }
 
            if (!hyperlinkUri.IsAbsoluteUri)
            {
                throw new ArgumentException("The hyperlink URI must be absolute.", nameof(hyperlinkUri));
            }
        }
 
        Rectangle resolvedBounds = ResolveBounds(view, bounds);
 
        int contentTop = resolvedBounds.Top + 52;
        int contentLeft = resolvedBounds.Left + 24;
 
        int contentRightPadding = 24;
 
        if (logo is not null)
        {
            var logoScreenBounds = new Rectangle(contentLeft, contentTop, 112, 112);
            Logo = new DirectImage(logo,
                                   renderSurfaceHost,
                                   view,
                                   logoScreenBounds,
                                   $"{Nickname}.logo").SetScaleMode(DirectImage.ScaleMode.Fit);
 
            Logo.ZOrder = 10_002;
            Add(Logo);
 
            contentLeft += 132;
        }
 
        var headerTextScreenBounds = new Rectangle(contentLeft, contentTop, resolvedBounds.Right - contentRightPadding - contentLeft, 44);
        HeaderText = new TextBlock(renderSurfaceHost,
                                   view,
                                   headerTextScreenBounds,
                                   $"{Nickname}.header").SetText(applicationName)
                                                        .SetFont(SKTypeface.Default, 26f, minSize: 16f)
                                                        .SetColors(SKColors.White, SKColors.Transparent)
                                                        .SetAlignment(SKTextAlign.Left, TextBlock.VerticalAlign.Center)
                                                        .EnableWrapping(false);
 
        HeaderText.ZOrder = 10_002;
        Add(HeaderText);
 
        var versionTextScreenBounds = new Rectangle(contentLeft, contentTop + 44, resolvedBounds.Right - contentRightPadding - contentLeft, 30);
        VersionText = new TextBlock(renderSurfaceHost,
                                    view,
                                    versionTextScreenBounds,
                                    $"{Nickname}.version").SetText($"Version {version}")
                                                          .SetFont(SKTypeface.Default, 15f, minSize: 11f)
                                                          .SetColors(new SKColor(205, 205, 215), SKColors.Transparent)
                                                          .SetAlignment(SKTextAlign.Left, TextBlock.VerticalAlign.Center)
                                                          .EnableWrapping(false);
 
        VersionText.ZOrder = 10_002;
        Add(VersionText);
 
        if (uriLauncher is not null && hyperlinkUri is not null)
        {
            Rectangle hyperlinkBounds = new(contentLeft,
                                            contentTop + 74,
                                            resolvedBounds.Right - contentRightPadding - contentLeft,
                                            28);
 
            Hyperlink = new HyperlinkWidget(uriLauncher,
                                            renderSurfaceHost,
                                            view,
                                            hyperlinkBounds,
                                            hyperlinkText ?? hyperlinkUri.ToString(),
                                            hyperlinkUri,
                                            $"{Nickname}.hyperlink");
 
            Hyperlink.Label.ZOrder = 10_002;
            Add(Hyperlink, new Vector2(hyperlinkBounds.Left - resolvedBounds.Left,
                                                   hyperlinkBounds.Top - resolvedBounds.Top));
        }
 
        var detailsTextScreenBounds = new Rectangle(resolvedBounds.Left + 24, contentTop + 126, resolvedBounds.Width - 48, resolvedBounds.Height - 222);
        string detailText = string.Join(Environment.NewLine + Environment.NewLine,
                                        new[] { description, copyright }
                                    .Where(static value => !string.IsNullOrWhiteSpace(value)));
 
        DetailsText = new TextBlock(renderSurfaceHost,
                                    view,
                                    detailsTextScreenBounds,
                                    $"{Nickname}.details").SetText(detailText)
                                                          .SetFont(SKTypeface.Default, 14f, minSize: 10f)
                                                          .SetColors(new SKColor(225, 225, 232), SKColors.Transparent)
                                                          .SetAlignment(SKTextAlign.Left, TextBlock.VerticalAlign.Top)
                                                          .EnableWrapping(true);
 
        DetailsText.ZOrder = 10_002;
        Add(DetailsText);
 
        Rectangle okBounds = new(resolvedBounds.Right - 116, resolvedBounds.Bottom - 54, 92, 34);
        OkButton = new ButtonWidget(renderSurfaceHost, view, okBounds, "OK", $"{Nickname}.ok");
 
        Add(OkButton, new Vector2(resolvedBounds.Width - 116, resolvedBounds.Height - 54));
 
        OkButton.SetButtonZOrder(10_003);
        OkButton.Clicked += OnOkClicked;
    }
 
    #endregion constructors
 
    #region public properties

    public string ApplicationName { get; }

    public string Version { get; }

    public string? Description { get; }

    public string? Copyright { get; }

    public DirectImage? Logo { get; }

    public TextBlock HeaderText { get; }

    public TextBlock VersionText { get; }

    public TextBlock DetailsText { get; }

    public ButtonWidget OkButton { get; }

    public HyperlinkWidget? Hyperlink { get; }
 
    #endregion public properties
 
    #region exposed methods

    protected override void OnAcceptRequested()
    {
        Close(DialogResult.OK);
    }

    public override void Dispose()
    {
        if (_disposed)
            return;
 
        _disposed = true;
        OkButton.Clicked -= OnOkClicked;
 
        base.Dispose();
    }
 
    #endregion exposed methods
 
    #region private methods
 
    private void OnOkClicked()
    {
        Close(DialogResult.OK);
    }
 
    private static Rectangle ResolveBounds(View view, Rectangle? bounds)
    {
        ArgumentNullException.ThrowIfNull(view);
 
        if (bounds is not null)
            return bounds.Value;
 
        Rectangle viewport = view.Viewport.TargetRectPx;
 
        int availableWidth = Math.Max(1, viewport.Width - 40);
        int availableHeight = Math.Max(1, viewport.Height - 40);
        int width = Math.Min(DefaultWidth, availableWidth);
        int height = Math.Min(DefaultHeight, availableHeight);
 
        return new Rectangle(viewport.Left + (viewport.Width - width) / 2,
                             viewport.Top + (viewport.Height - height) / 2,
                             width,
                             height);
    }
 
    #endregion private methods
}