ShrlAlgoToolkit/Melskin/Utilities/RelayCommand.cs

using System.Windows.Input;

namespace Melskin.Utilities;
/// <summary>
/// 一个简单的ICommand实现，用于传递动作。
/// </summary>
internal class RelayCommand : ICommand
{
    private readonly Action<object?> execute;
    private readonly Predicate<object?>? _canExecute;
    /// <summary>
    /// 当命令的可执行状态更改时发生的事件。
    /// 此事件通知UI，当命令的CanExecute方法返回值发生变化时，需要重新查询命令的状态。
    /// </summary>
    public event EventHandler? CanExecuteChanged
    {
        add => CommandManager.RequerySuggested += value;
        remove => CommandManager.RequerySuggested -= value;
    }
    /// <summary>
    /// 一个简单的ICommand实现，用于传递动作。此命令始终可以执行。
    /// </summary>
    public RelayCommand(Action<object?> execute) => this.execute = execute;

    /// <summary>
    /// 判断命令是否可以执行。
    /// </summary>
    /// <param name="parameter">传递给命令的参数。</param>
    /// <returns>返回一个布尔值，指示命令是否能够执行。对于此实现，总是返回true。</returns>
    public bool CanExecute(object? parameter) => _canExecute == null || _canExecute(parameter);

    /// <summary>
    /// 执行命令。
    /// </summary>
    /// <param name="parameter">传递给命令的参数。</param>
    public void Execute(object? parameter) => execute(parameter);

    /// <summary>
    /// 通知命令管理器重新查询此命令的 CanExecute 状态。
    /// </summary>
    public void RaiseCanExecuteChanged() => CommandManager.InvalidateRequerySuggested();
}

/// <summary>
/// 一个简单的ICommand实现，用于传递动作。此命令始终可以执行。
/// </summary>
internal class RelayCommand<T> : ICommand
{
    private readonly Action<T?> execute;
    private readonly Predicate<T?>? canExecute;

    /// <summary>
    /// 一个简单的ICommand实现，用于传递动作。此命令始终可以执行。
    /// </summary>
    public RelayCommand(Action<T?> execute, Predicate<T?>? canExecute = null)
    {
        this.execute = execute ?? throw new ArgumentNullException(nameof(execute));
        this.canExecute = canExecute;
    }

    /// <summary>
    /// 当命令的可执行状态更改时触发的事件。
    /// 此事件允许UI元素订阅并响应命令可执行性变化，从而能够适时更新其状态（如启用或禁用按钮）。
    /// 通过将此事件与CommandManager.RequerySuggested关联，可以确保每当应用程序中的命令状态可能改变时，UI都会自动检查命令是否仍然可执行。
    /// </summary>
    public event EventHandler? CanExecuteChanged
    {
        add => CommandManager.RequerySuggested += value;
        remove => CommandManager.RequerySuggested -= value;
    }

    /// <summary>
    /// 判断命令是否可以执行。
    /// </summary>
    /// <param name="parameter">传递给命令的参数。</param>
    /// <returns>返回一个布尔值，指示命令是否能够执行。对于此实现，总是返回true。</returns>
    public bool CanExecute(object? parameter)
    {
        if (canExecute == null) return true;

        // 使用安全的类型获取机制，防止 InvalidCastException
        T? validParameter = GetSafeParameter(parameter);
        return canExecute(validParameter);
    }

    /// <summary>
    /// 执行命令。
    /// </summary>
    /// <param name="parameter">传递给命令的参数。</param>
    public void Execute(object? parameter)
    {
        T? validParameter = GetSafeParameter(parameter);
        execute(validParameter);
    }

    /// <summary>
    /// 通知命令管理器重新查询此命令的CanExecute状态。
    /// 此方法用于在命令执行条件可能已更改时更新UI。
    /// </summary>
    public void RaiseCanExecuteChanged() => CommandManager.InvalidateRequerySuggested();
    /// <summary>
    /// 安全地将 object 参数转换为泛型 T。如果类型不匹配，则返回 T 的默认值。
    /// </summary>
    private static T? GetSafeParameter(object? parameter)
    {
        if (parameter is T tParam)
        {
            return tParam;
        }

        // 应对 WPF 绑定时可能会传入 null 的情况，特别是在 T 为值类型时
        return default;
    }
}