WPF自定义BorderWrapper装饰器中Rectangle鼠标事件失效问题

以下是几个常见导致IsMouseOver触发器失效的原因及对应解决方法：

1. Decorator的命中测试优先级问题 #

Decorator类默认的HitTestCore逻辑会优先将鼠标事件传递给内部的Child元素，而非你添加的边框元素。这会导致鼠标悬浮在Left边框上时，实际命中测试被Child拦截，边框的IsMouseOver永远不会触发。

解决方法：重写BorderWrapper的HitTestCore方法，让边框元素也能参与命中测试：

protected override HitTestResult HitTestCore(PointHitTestParameters hitTestParameters)
{
    // 先检查边框元素是否被命中
    var point = hitTestParameters.HitPoint;
    foreach (var borderElement in new[] { LeftBorder, TopBorder, RightBorder, BottomBorder })
    {
        if (borderElement != null)
        {
            var bounds = borderElement.TransformToAncestor(this).TransformBounds(new Rect(borderElement.RenderSize));
            if (bounds.Contains(point))
            {
                return new PointHitTestResult(borderElement, point);
            }
        }
    }
    // 再交给默认的Child命中逻辑
    return base.HitTestCore(hitTestParameters);
}

2. 元素层级覆盖问题 #

如果你的Child元素尺寸过大，覆盖了Left边框的区域，鼠标事件会被Child接收，边框无法响应。

解决方法：

• 确保边框元素的Panel.ZIndex设置为比Child更高的值，比如在添加边框时设置：

LeftBorder.SetValue(Panel.ZIndexProperty, 1);
Child.SetValue(Panel.ZIndexProperty, 0);

• 或者调整布局逻辑，给Child设置对应Margin，避免其覆盖边框区域。

3. 边框元素未正确加入可视化树 #

如果LeftBorder依赖属性赋值后，没有将Rectangle添加到BorderWrapper的可视化树中，元素根本无法接收任何鼠标事件。

解决方法：在依赖属性的变更回调中，将新边框元素添加到可视化树，同时移除旧元素：

public static readonly DependencyProperty LeftBorderProperty =
    DependencyProperty.Register("LeftBorder", typeof(FrameworkElement), typeof(BorderWrapper),
        new PropertyMetadata(null, OnBorderElementChanged));

private static void OnBorderElementChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    var wrapper = (BorderWrapper)d;
    var oldElement = (FrameworkElement)e.OldValue;
    var newElement = (FrameworkElement)e.NewValue;

    if (oldElement != null)
    {
        wrapper.RemoveVisualChild(oldElement);
        wrapper.RemoveLogicalChild(oldElement);
    }
    if (newElement != null)
    {
        wrapper.AddVisualChild(newElement);
        wrapper.AddLogicalChild(newElement);
        wrapper.InvalidateArrange();
    }
}

// 重写可视化树相关方法，确保元素能被正确遍历
protected override int VisualChildrenCount => 
    (LeftBorder != null ? 1 : 0) + (TopBorder != null ? 1 : 0) + 
    (RightBorder != null ? 1 : 0) + (BottomBorder != null ? 1 : 0) + (Child != null ? 1 : 0);

protected override Visual GetVisualChild(int index)
{
    var count = 0;
    if (LeftBorder != null && index == count++) return LeftBorder;
    if (TopBorder != null && index == count++) return TopBorder;
    if (RightBorder != null && index == count++) return RightBorder;
    if (BottomBorder != null && index == count++) return BottomBorder;
    if (Child != null && index == count++) return Child;
    throw new ArgumentOutOfRangeException(nameof(index));
}

4. Style触发器的目标或逻辑错误 #

检查XAML中触发器的定义，确保没有语法错误，且IsMouseOver条件绑定到Rectangle自身：

<Rectangle x:Name="LeftBorderRect">
    <Rectangle.Style>
        <Style TargetType="Rectangle">
            <Setter Property="Fill" Value="Gray"/>
            <Style.Triggers>
                <Trigger Property="IsMouseOver" Value="True">
                    <Setter Property="Fill" Value="Red"/>
                </Trigger>
            </Style.Triggers>
        </Style>
    </Rectangle.Style>
</Rectangle>

注意：如果直接在Rectangle元素上设置Fill属性（而非通过Style的Setter），触发器的Setter将不会生效——本地属性值优先级高于Style触发器。

内容的提问来源于stack exchange，提问作者Youness ES-Salmy