如何在CustomControl的ControlTemplate中使用事件？

你遇到的问题其实是WPF控件设计的常见规范限制：ControlTemplate作为控件的视觉模板，不应该直接在内部绑定具体的事件处理逻辑——这会破坏控件的封装性和可定制性（毕竟使用者可能会替换你的模板）。下面给你两种推荐的解决方案：

方案一：使用命令（Command）—— 推荐（符合MVVM思想） #

这种方式把点击逻辑的控制权交给控件的使用者，是WPF控件设计的最佳实践：

步骤1：在CustomControl类中添加命令依赖属性 #

打开CustomControl1.cs，添加一个ICommand类型的依赖属性：

using System.Windows;
using System.Windows.Input;

namespace YourNamespace
{
    public class CustomControl1 : Control
    {
        static CustomControl1()
        {
            DefaultStyleKeyProperty.OverrideMetadata(typeof(CustomControl1), new FrameworkPropertyMetadata(typeof(CustomControl1)));
        }

        // 定义按钮点击命令的依赖属性
        public static readonly DependencyProperty ButtonClickCommandProperty =
            DependencyProperty.Register(
                nameof(ButtonClickCommand), 
                typeof(ICommand), 
                typeof(CustomControl1), 
                new PropertyMetadata(null));

        public ICommand ButtonClickCommand
        {
            get => (ICommand)GetValue(ButtonClickCommandProperty);
            set => SetValue(ButtonClickCommandProperty, value);
        }
    }
}

步骤2：在Generic.xaml中绑定命令 #

修改你的ControlTemplate，给Button绑定这个命令：

<Style TargetType="{x:Type local:CustomControl1}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:CustomControl1}">
                <Border>
                    <Grid>
                        <Grid.RowDefinitions>
                            <RowDefinition Height="*"></RowDefinition>
                            <RowDefinition Height="auto"></RowDefinition>
                        </Grid.RowDefinitions>
                        <TextBlock></TextBlock>
                        <!-- 绑定到控件的ButtonClickCommand属性 -->
                        <Button Grid.Row="1" Command="{TemplateBinding ButtonClickCommand}" />
                    </Grid>
                </Border>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

步骤3：使用控件时绑定命令逻辑 #

在使用CustomControl1的地方，你可以绑定ViewModel中的命令（比如RelayCommand）：

<!-- 假设你的ViewModel有一个名为MyButtonCommand的ICommand属性 -->
<local:CustomControl1 ButtonClickCommand="{Binding MyButtonCommand}" />

方案二：定义自定义路由事件 #

如果你更习惯使用事件的方式，可以通过定义路由事件来暴露Button的点击行为：

步骤1：在CustomControl类中添加路由事件和模板部件标记 #

修改CustomControl1.cs，添加模板部件标记、路由事件，并在模板应用时订阅Button的点击事件：

using System.Windows;
using System.Windows.Controls;

namespace YourNamespace
{
    // 标记模板中需要的Button部件，名称要和XAML中的一致
    [TemplatePart(Name = "PART_ActionButton", Type = typeof(Button))]
    public class CustomControl1 : Control
    {
        private Button _actionButton;

        static CustomControl1()
        {
            DefaultStyleKeyProperty.OverrideMetadata(typeof(CustomControl1), new FrameworkPropertyMetadata(typeof(CustomControl1)));
        }

        // 定义自定义路由事件
        public static readonly RoutedEvent ButtonClickedEvent =
            EventManager.RegisterRoutedEvent(
                nameof(ButtonClicked), 
                RoutingStrategy.Bubble, 
                typeof(RoutedEventHandler), 
                typeof(CustomControl1));

        // 暴露事件给使用者
        public event RoutedEventHandler ButtonClicked
        {
            add => AddHandler(ButtonClickedEvent, value);
            remove => RemoveHandler(ButtonClickedEvent, value);
        }

        // 当控件应用模板时执行
        public override void OnApplyTemplate()
        {
            base.OnApplyTemplate();

            // 先移除旧的事件订阅，避免内存泄漏
            if (_actionButton != null)
            {
                _actionButton.Click -= ActionButton_Click;
            }

            // 从模板中找到标记的Button部件
            _actionButton = GetTemplateChild("PART_ActionButton") as Button;

            // 订阅Button的Click事件
            if (_actionButton != null)
            {
                _actionButton.Click += ActionButton_Click;
            }
        }

        // Button点击时触发自定义路由事件
        private void ActionButton_Click(object sender, RoutedEventArgs e)
        {
            RaiseEvent(new RoutedEventArgs(ButtonClickedEvent));
        }
    }
}

步骤2：在Generic.xaml中命名Button部件 #

修改ControlTemplate中的Button，给它指定约定好的名称：

<Style TargetType="{x:Type local:CustomControl1}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:CustomControl1}">
                <Border>
                    <Grid>
                        <Grid.RowDefinitions>
                            <RowDefinition Height="*"></RowDefinition>
                            <RowDefinition Height="auto"></RowDefinition>
                        </Grid.RowDefinitions>
                        <TextBlock></TextBlock>
                        <!-- 必须使用PART_ActionButton作为名称，和代码中的TemplatePart对应 -->
                        <Button x:Name="PART_ActionButton" Grid.Row="1" />
                    </Grid>
                </Border>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

步骤3：使用控件时绑定事件 #

现在你可以像使用普通WPF控件事件一样绑定这个自定义事件：

<local:CustomControl1 ButtonClicked="CustomControl1_ButtonClicked" />

然后在代码后台添加处理逻辑：

private void CustomControl1_ButtonClicked(object sender, RoutedEventArgs e)
{
    // 这里写你的点击处理逻辑
}

为什么不能直接在模板里加Click事件？ #

Visual Studio禁止你这么做，本质是因为这种做法违反了WPF控件的设计原则：

• ControlTemplate是控件的视觉表现层，应该和业务逻辑解耦，直接绑定事件会把逻辑硬编码到模板里，导致控件无法灵活定制。
• 如果使用者替换了你的ControlTemplate，原来的事件绑定会完全失效，控件的行为会变得不可预测。

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