如何修复WPF XAML中Border.Clip在设计预览中的遮罩问题？

原因分析 #

这是.NET Framework 4.7及更高版本中Visual Studio XAML设计器的兼容性问题。旧版本框架下，设计器对未正确初始化的Clip属性（比如空标签、设计时无法解析的绑定）会做宽松处理；升级后设计器的属性验证逻辑更严格，当Clip关联的几何对象未生成有效可视区域时，会默认将Border的可视范围裁剪为空白，导致所有子元素在预览中被隐藏，但运行时因为绑定或逻辑能正常生成有效几何，所以程序运行不受影响。

解决方案 #

1. 给设计时提供有效默认值 #

如果Clip用了绑定，设计时绑定无法解析，可通过FallbackValue给几何对象设置设计时可用的默认区域：

<Border.Clip>
    <RectangleGeometry RadiusX="10" RadiusY="10">
        <RectangleGeometry.Rect>
            <Binding Path="ActualWidth, ActualHeight" 
                     RelativeSource="{RelativeSource AncestorType=Border}"
                     FallbackValue="0,0,200,200" />
        </RectangleGeometry.Rect>
    </RectangleGeometry>
</Border.Clip>

这样设计器会用FallbackValue指定的矩形区域渲染，保证预览可见。

2. 设计时禁用Clip渲染 #

如果不需要在设计时看裁剪效果，可通过设计器专属属性d:Clip覆盖，或者给几何对象加d:IsHidden：

<!-- 方法一：用设计时属性覆盖Clip -->
<Border Clip="{Binding ...}" d:Clip="{x:Null}">
    <!-- 子元素内容 -->
</Border>

<!-- 方法二：隐藏设计时的几何对象 -->
<Border.Clip>
    <RectangleGeometry RadiusX="10" RadiusY="10" d:IsHidden="True">
        <RectangleGeometry.Rect>
            ...Some binding for dimensions.
        </RectangleGeometry.Rect>
    </RectangleGeometry>
</Border.Clip>

3. 移除空Clip标签 #

绝对不要保留空的<Border.Clip></Border.Clip>标签，这会让设计器判定Clip已设置但无有效几何，直接触发全裁剪。暂时不需要裁剪时，直接删除整个Clip节点即可。

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