Files
ShrlAlgoToolkit/NeuWPF/NeoUI/Utilities/RelayCommand.cs
ShrlAlgo 955a01f564 整理
2025-08-20 12:10:35 +08:00

84 lines
3.2 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using System.Windows.Input;
namespace NeoUI.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();
}