Adorner是WPF中专用于装饰层的轻量级可视化元素，需通过AdornerLayer管理而非手动AddVisualChild；它独立于目标元素的逻辑树和视觉树，必须正确实现坐标转换、渲染与生命周期清理以避免异常和内存泄漏。
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 就无法回收被装饰元素及其父逻辑树。
