功能完善

NeuWPF/NeoUI/Utilities/RelayCommand.cs

@@ -0,0 +1,83 @@
+using System.Windows.Input;
+
+namespace NeumUI.Utilities;
+
+/// <summary>
+/// 一个简单的ICommand实现，用于传递动作。
+/// </summary>
+public class RelayCommand : ICommand
+{
+    private readonly Action<object> execute;
+
+    /// <summary>
+    /// 当命令的可执行状态更改时发生的事件。
+    /// 此事件通知UI，当命令的CanExecute方法返回值发生变化时，需要重新查询命令的状态。
+    /// </summary>
+    public event EventHandler? CanExecuteChanged;
+
+    /// <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) => true;
+
+    /// <summary>
+    /// 执行命令。
+    /// </summary>
+    /// <param name="parameter">传递给命令的参数。</param>
+    public void Execute(object parameter) => execute(parameter);
+}
+
+/// <summary>
+/// 一个简单的ICommand实现，用于传递动作。此命令始终可以执行。
+/// </summary>
+public 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) => canExecute == null || canExecute((T)parameter);
+
+    /// <summary>
+    /// 执行命令。
+    /// </summary>
+    /// <param name="parameter">传递给命令的参数。</param>
+    public void Execute(object parameter) => execute((T)parameter);
+
+    /// <summary>
+    /// 通知命令管理器重新查询此命令的CanExecute状态。
+    /// 此方法用于在命令执行条件可能已更改时更新UI。
+    /// </summary>
+    public void RaiseCanExecuteChanged() => CommandManager.InvalidateRequerySuggested();
+}