WPF中如何优雅访问CheckBox模板内子元素的渲染尺寸？

针对你遇到的「依赖VisualTreeHelper遍历模板元素易失效」的问题，推荐两种低耦合、更健壮的实现方案，避免模板结构变更导致的代码崩溃：

方案一：附加属性解耦（完全不依赖模板结构） #

通过自定义附加属性，让模板内的InnerBorder主动将自身尺寸传递给CheckBox，彻底解除对模板层级/命名的依赖。

1. 定义附加属性类 #

public static class ElementSizeTracker
{
    // 存储目标元素接收的尺寸
    public static readonly DependencyProperty ElementSizeProperty =
        DependencyProperty.RegisterAttached(
            "ElementSize",
            typeof(Size),
            typeof(ElementSizeTracker),
            new PropertyMetadata(default(Size)));

    // 指定接收尺寸的目标元素
    public static readonly DependencyProperty TargetElementProperty =
        DependencyProperty.RegisterAttached(
            "TargetElement",
            typeof(FrameworkElement),
            typeof(ElementSizeTracker),
            new PropertyMetadata(null, OnTargetElementChanged));

    public static Size GetElementSize(DependencyObject obj) => (Size)obj.GetValue(ElementSizeProperty);
    public static void SetElementSize(DependencyObject obj, Size value) => obj.SetValue(ElementSizeProperty, value);

    public static FrameworkElement GetTargetElement(DependencyObject obj) => (FrameworkElement)obj.GetValue(TargetElementProperty);
    public static void SetTargetElement(DependencyObject obj, FrameworkElement value) => obj.SetValue(TargetElementProperty, value);

    private static void OnTargetElementChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not FrameworkElement sourceElement) return;

        sourceElement.SizeChanged -= SourceElement_SizeChanged;
        if (e.NewValue is FrameworkElement targetElement)
        {
            // 监听尺寸变化并同步给目标元素
            sourceElement.SizeChanged += (s, args) =>
            {
                targetElement.SetValue(ElementSizeProperty, new Size(sourceElement.ActualWidth, sourceElement.ActualHeight));
            };
            // 初始化同步当前尺寸
            targetElement.SetValue(ElementSizeProperty, new Size(sourceElement.ActualWidth, sourceElement.ActualHeight));
        }
    }

    private static void SourceElement_SizeChanged(object sender, SizeChangedEventArgs e)
    {
        // 空实现，仅用于解绑事件
    }
}

2. 修改CheckBox模板 #

在模板内给InnerBorder绑定附加属性，指定目标为CheckBox本身：

<ControlTemplate TargetType="CheckBox">
    <!-- 其他模板元素 -->
    <Border x:Name="InnerBorder"
            xmlns:local="clr-namespace:YourNamespace"
            local:ElementSizeTracker.TargetElement="{Binding RelativeSource={RelativeSource TemplatedParent}}">
        <!-- InnerBorder内容 -->
    </Border>
    <!-- 其他模板元素 -->
</ControlTemplate>

3. 在CheckBox后台监听尺寸变化 #

public class CustomCheckBox : CheckBox
{
    private RectangleAdorner _adorner;

    public CustomCheckBox()
    {
        Loaded += OnLoaded;
        // 监听尺寸属性变化
        DependencyPropertyDescriptor.FromProperty(ElementSizeTracker.ElementSizeProperty, typeof(CustomCheckBox))
            .AddValueChanged(this, OnElementSizeUpdated);
    }

    private void OnLoaded(object sender, RoutedEventArgs e)
    {
        var adornerLayer = AdornerLayer.GetAdornerLayer(this);
        _adorner = new RectangleAdorner(this);
        adornerLayer.Add(_adorner);
        // 初始化装饰器尺寸
        UpdateAdornerSize();
    }

    private void OnElementSizeUpdated(object sender, EventArgs e) => UpdateAdornerSize();

    private void UpdateAdornerSize()
    {
        if (_adorner == null) return;
        var size = ElementSizeTracker.GetElementSize(this);
        _adorner.UpdateSize(size);
    }
}

优势：完全不依赖模板内元素的命名或层级，只要InnerBorder保留附加属性绑定，模板任意变更都不会影响尺寸获取逻辑。

方案二：TemplatePart特性（符合WPF官方规范） #

如果模板结构相对稳定，可使用WPF内置的TemplatePartAttribute标记模板内需要的元素，通过Template.FindName直接获取，比VisualTreeHelper更简洁可靠。

1. 标记TemplatePart并获取元素 #

[TemplatePart(Name = "InnerBorder", Type = typeof(Border))]
public class CustomCheckBox : CheckBox
{
    private Border _innerBorder;
    private RectangleAdorner _adorner;

    public override void OnApplyTemplate()
    {
        base.OnApplyTemplate();

        // 移除旧元素的事件监听
        if (_innerBorder != null)
        {
            _innerBorder.SizeChanged -= OnInnerBorderSizeChanged;
        }

        // 从模板中获取指定元素
        _innerBorder = Template.FindName("InnerBorder", this) as Border;
        if (_innerBorder != null)
        {
            _innerBorder.SizeChanged += OnInnerBorderSizeChanged;
            UpdateAdornerSize();
        }
    }

    private void OnInnerBorderSizeChanged(object sender, SizeChangedEventArgs e) => UpdateAdornerSize();

    private void UpdateAdornerSize()
    {
        if (_adorner == null)
        {
            var adornerLayer = AdornerLayer.GetAdornerLayer(this);
            _adorner = new RectangleAdorner(this);
            adornerLayer.Add(_adorner);
        }
        _adorner.UpdateSize(new Size(_innerBorder.ActualWidth, _innerBorder.ActualHeight));
    }
}

优势：代码简洁，符合WPF模板开发的官方规范，仅依赖元素命名（比遍历层级更可靠），适合模板变更频率低的场景。

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