WPF中Adorner是什么，为什么不能直接用UIElement.AddVisualChild
Adorner 是 WPF 中专用于「装饰层」的轻量级可视化元素，它被设计为附着在目标
UIElement之上、独立于其逻辑树和视觉树生命周期运行。你不能靠手动调用
AddVisualChild或往
Children集合里加控件来模拟——那样会破坏布局测量、触发无限递归重绘，甚至导致
InvalidOperationException: Visual is already a child of another visual。
真正起作用的是
AdornerLayer：它是 WPF 自动为每个
AdornerDecorator（通常由
Window、
ScrollViewer等容器隐式提供）创建的专用图层，负责管理所有 Adorner 的渲染顺序、坐标映射与生命周期。
如何正确创建并附加一个自定义Adorner
关键步骤是三步：继承
Adorner、重写
GetDesiredTransform和
OnRender（或使用
VisualTree）、通过
AdornerLayer.GetAdornerLayer获取并调用
Add。
Adorner构造函数必须传入被装饰的
UIElement，这是它定位和坐标转换的基础 重写
GetDesiredTransform很重要：默认实现只返回平移，但如果你的被装饰元素有缩放、旋转或 RenderTransform，必须手动合并，否则装饰层会“脱钩” 不要在
OnRender里调用
base.OnRender；若需绘制几何图形，用
drawingContext.DrawGeometry；若需嵌入控件，得用
VisualTree方式（见下一条）
示例：一个简单边框装饰器
public class BorderAdorner : Adorner
{
public BorderAdorner(UIElement adornedElement) : base(adornedElement) { }
protected override void OnRender(DrawingContext drawingContext)
{
var rect = new Rect(RenderSize);
drawingContext.DrawRectangle(null, new Pen(Brushes.Red, 2), rect);
base.OnRender(drawingContext); // 实际上这里 base 不做任何事，可省略
}
}
附加方式：
var adornerLayer = AdornerLayer.GetAdornerLayer(targetElement);
if (adornerLayer != null)
{
adornerLayer.Add(new BorderAdorner(targetElement));
}
想在Adorner里放Button/TextBlock等控件？用VisualTree方式
Adorner本身不是
FrameworkElement，不支持模板、绑定、事件冒泡。若需要交互控件，必须走
VisualTree路线：在构造函数中创建
UIElement子树，并在
OnVisualChildrenChanged或构造时手动调用
AddVisualChild/
AddLogicalChild，同时重写
VisualChildrenCount和
GetVisualChild。 控件不会自动参与布局，
MeasureOverride和
ArrangeOverride必须自己实现（哪怕只是返回
desiredSize） 坐标系仍以被装饰元素左上角为原点，但
RenderTransform不会自动应用到子控件，需在
ArrangeOverride中手动计算偏移 强烈建议将子控件包裹在
Canvas中，用
Canvas.Left/Top控制位置，避免依赖复杂布局逻辑
常见错误：
NullReferenceException在
GetVisualChild中抛出——因为没正确维护子元素列表，或返回了 null。
Adorner的销毁时机与内存泄漏风险
Adorner 不会随被装饰元素卸载自动释放。如果目标元素被移除（如从
ItemsControl移除、导航离开页面），而你没显式调用
adornerLayer.Remove(adorner)，它就会滞留在
AdornerLayer中，持续监听目标元素的
IsVisibleChanged、
LayoutUpdated等事件，造成事件句柄泄露和 UI 线程卡顿。 最佳实践是在目标元素的
Unloaded事件中清理：
adornerLayer?.Remove(this)如果目标元素可能重复加载（如 TabControl 切换），建议用弱事件模式或在
Adorner内部监听
AdornedElement.IsLoaded变化 调试时可检查
AdornerLayer.Adorners集合长度是否异常增长，这是内存泄漏的明显信号
最易被忽略的一点：Adorner 的
AdornedElement属性是弱引用，但它的事件订阅不是——只要没手动解绑，GC 就无法回收被装饰元素及其父逻辑树。
