Avalonia中捕获Windows键盘快捷键：Esc关闭对话框的规范实现

1. 框架原生支持（推荐） #

对于作为对话框使用的普通Window，Avalonia内置了直接支持，只需设置CanCloseWithEscape属性为true即可：

• XAML方式：

<Window xmlns="https://github.com/avaloniaui"
        CanCloseWithEscape="True">
    <!-- 对话框内容 -->
</Window>

• 代码后台方式：

public MyDialogWindow()
{
    InitializeComponent();
    CanCloseWithEscape = true;
}

这是最规范的实现，无需手动处理按键逻辑，框架会自动拦截Esc键并触发窗口关闭。

2. 针对DialogHost组件的场景 #

如果使用Avalonia生态中的DialogHost（比如Material.Avalonia的实现），可以通过配置参数允许Esc关闭：

• 打开对话框时设置：

await DialogHost.Show(new MyDialogView(), new DialogHostParameters
{
    CloseOnEscapeKey = true
});

• XAML中全局配置：

<material:DialogHost CloseOnEscapeKey="True">
    <!-- 宿主内容 -->
</material:DialogHost>

3. 自定义Esc关闭逻辑（比如关闭前确认） #

如果需要在关闭前添加确认等自定义操作，可以通过InputBinding绑定Esc键到自定义命令：

• XAML中添加绑定：

<Window.InputBindings>
    <KeyBinding Gesture="Escape" Command="{Binding CloseDialogCommand}" />
</Window.InputBindings>

• ViewModel中实现命令逻辑：

public ICommand CloseDialogCommand => new RelayCommand(async () =>
{
    // 自定义确认逻辑示例
    var result = await MessageBox.Show("确定要关闭对话框吗？", "确认", MessageBoxButton.YesNo);
    if (result == MessageBoxResult.Yes)
    {
        // 执行关闭操作
        this.Close(); // Window场景
        // 或者DialogHost.Close(null); DialogHost场景
    }
});

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