如何在基于Community Toolkit的Avalonia MVVM应用中绑定命令到按键

1. ViewModel中定义命令方法 #

用Community Toolkit的RelayCommandAttribute直接标记业务方法即可，Toolkit会自动生成对应的命令属性（命名规则为方法名+Command后缀），无需手动实例化RelayCommand：

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;

public class MainViewModel : ObservableObject
{
    [RelayCommand]
    private void OnF3Triggered()
    {
        // 这里编写F3按键触发的业务逻辑
        // 比如刷新数据、切换视图状态等
    }
}

上述代码会自动生成OnF3TriggeredCommand属性，供后续XAML绑定使用。

2. Window的XAML配置按键绑定 #

在Window的XAML中添加InputBindings节点，将KeyBinding绑定到ViewModel的自动生成命令。先确保Window的DataContext已关联到目标ViewModel（示例直接在XAML中实例化，也可通过后台代码设置）：

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:YourAppNamespace"
        x:Class="YourAppNamespace.MainWindow"
        Title="纯键盘控制应用">
    <!-- 设置ViewModel为DataContext -->
    <Window.DataContext>
        <local:MainViewModel />
    </Window.DataContext>

    <!-- 配置F3按键的命令绑定 -->
    <Window.InputBindings>
        <KeyBinding Gesture="F3" Command="{Binding OnF3TriggeredCommand}" />
    </Window.InputBindings>

    <!-- 界面内容（无任何按钮控件） -->
    <Grid>
        <!-- 可添加文本框、数据列表等交互控件 -->
    </Grid>
</Window>

3. UserControl场景快速适配 #

如果是ISingleViewApplicationLifetime场景（视图为UserControl），只需将InputBindings移到UserControl标签下，并设置Focusable="True"确保控件能捕获按键事件：

<UserControl xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:YourAppNamespace"
             x:Class="YourAppNamespace.MainView"
             Focusable="True">
    <UserControl.DataContext>
        <local:MainViewModel />
    </UserControl.DataContext>

    <UserControl.InputBindings>
        <KeyBinding Gesture="F3" Command="{Binding OnF3TriggeredCommand}" />
    </UserControl.InputBindings>

    <!-- 界面内容 -->
</UserControl>

实用细节 #

• 组合键直接在Gesture中声明，例如"Ctrl+F3"、"Shift+Alt+S"均支持；
• 确保已安装CommunityToolkit.Mvvm NuGet包，且项目启用Nullable（Toolkit代码生成依赖该配置）；
• 如需传递参数给命令，可添加CommandParameter属性，例如CommandParameter="{Binding CurrentItem}"。

内容的提问来源于stack exchange，提问作者Ivan