Files
ShrlAlgoToolkit/NeoUI/Melskin/Utilities/RelayCommand.cs
2026-01-02 17:30:41 +08:00

88 lines
3.3 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 Melskin.Utilities;
/// <summary>
/// 一个简单的ICommand实现用于传递动作。
/// </summary>
internal class RelayCommand : ICommand
{
private readonly Action<object?> execute;
/// <summary>
/// 当命令的可执行状态更改时发生的事件。
/// 此事件通知UI当命令的CanExecute方法返回值发生变化时需要重新查询命令的状态。
/// </summary>
#pragma warning disable CS0067
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>
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) => canExecute == null || canExecute((T?)parameter);
/// <summary>
/// 执行命令。
/// </summary>
/// <param name="parameter">传递给命令的参数。</param>
public void Execute(object? parameter)
{
execute((T?)parameter);
}
/// <summary>
/// 通知命令管理器重新查询此命令的CanExecute状态。
/// 此方法用于在命令执行条件可能已更改时更新UI。
/// </summary>
#pragma warning disable CS0067
public void RaiseCanExecuteChanged() => CommandManager.InvalidateRequerySuggested();
}