Avalonia中如何为TemplatedControl内的控件添加事件？

错误原因解析 #

你遇到的No Content property or any Add methods found错误，是因为给<Styles>根元素添加了x:Class属性导致的。在Avalonia中，<Styles>是样式集合容器，用于定义控件的样式规则，它不需要绑定到TemplatedControl类。当你指定x:Class="MyNamespace.MyTemplatedControl"时，编译器会尝试将<Style>元素作为控件的子内容处理，但TemplatedControl没有对应的Content属性或Add方法来接收Style元素，从而触发报错。

解决方案步骤 #

1. 修正AXAML样式文件 #

移除x:Class属性，并给模板内的控件添加x:Name标识，方便后续在代码中获取：

<Styles xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:controls="using:MyNamespace">
    <Design.PreviewWith>
        <controls:MyTemplatedControl />
    </Design.PreviewWith>

    <Style Selector="controls|MyTemplatedControl">
        <Setter Property="Template">
            <ControlTemplate>
                <StackPanel>
                    <TextBlock
                        x:Name="TitleTextBlock"
                        Text="Templated Control"/>
                    <TextBox
                        x:Name="InputTextBox"/>
                </StackPanel>
            </ControlTemplate>
        </Setter>
    </Style>
</Styles>

2. 在控件类中绑定事件 #

TemplatedControl的模板元素无法直接在AXAML中绑定事件，需要在控件类的OnApplyTemplate方法中，手动获取模板内的控件并订阅事件。同时要注意在模板重新应用时取消旧订阅，避免内存泄漏：

using Avalonia.Controls;
using Avalonia.Controls.Primitives;
using Avalonia.Input;
using Avalonia.Media;

namespace MyNamespace;

public class MyTemplatedControl : TemplatedControl
{
    private TextBlock? _titleTextBlock;
    private TextBox? _inputTextBox;

    protected override void OnApplyTemplate(TemplateAppliedEventArgs e)
    {
        base.OnApplyTemplate(e);

        // 取消旧控件的事件订阅
        _titleTextBlock?.DoubleTapped -= InputElement_OnTapped;
        _inputTextBox?.KeyDown -= InputElement_OnKeyDown;

        // 通过NameScope获取模板内的控件
        _titleTextBlock = e.NameScope.Find<TextBlock>("TitleTextBlock");
        _inputTextBox = e.NameScope.Find<TextBox>("InputTextBox");

        // 订阅新事件
        _titleTextBlock?.DoubleTapped += InputElement_OnTapped;
        _inputTextBox?.KeyDown += InputElement_OnKeyDown;
    }

    private void InputElement_OnTapped(object? sender, RoutedEventArgs e)
    {
        _titleTextBlock?.Text = "DOUBLE TAPPED";
    }

    private void InputElement_OnKeyDown(object? sender, KeyEventArgs e)
    {
        _inputTextBox?.Background = new SolidColorBrush(Colors.Green);
    }
}

关于访问模板内控件的补充 #

TemplatedControl的模板元素只有在控件应用模板后才会实例化，因此必须在OnApplyTemplate方法中通过e.NameScope.Find<T>(控件名)来获取。这种方式是Avalonia中访问模板内部控件的标准做法，确保在控件生命周期的正确阶段获取到元素。

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