WPF Drop事件触发两次：Panel.ZIndex为何引发该异常？

嘿，这个问题我之前也踩过类似的坑！咱们来拆解一下到底是怎么回事：

问题复盘 #

你遇到的情况是：自定义State控件从WrapPanel拖去MainCanvas时，Drop事件莫名其妙触发两次，搞出两个重复实例。试了e.Handled=true、换PreviewDrop都不管用，直到把ControlTemplate里MoveThumb和Border的Panel.ZIndex删掉才恢复正常。

背后的核心原因 #

这其实是WPF的命中测试和事件路由在捣鬼：

• 当你给模板里的多个子元素单独设置Panel.ZIndex时，这些元素会被提升到更高的视觉层级，变成独立的「命中测试目标」。
• 拖拽释放的瞬间，WPF会在鼠标位置做命中测试，寻找可以接收Drop的元素。这时候模板里的MoveThumb和Border因为ZIndex高，会同时被判定为有效目标——但它们都属于同一个State控件的模板，事件会顺着视觉树往上路由，最终两次触发MainCanvas的Drop事件。
• 哪怕你在事件里设e.Handled=true也没用，因为这两次事件来自不同的视觉节点，是两个独立的事件实例：第一次处理的是MoveThumb的路由事件，第二次是Border的，互不影响。

怎么验证这个结论？ #

你可以在MainCanvas_Drop方法里加一行调试代码：

Console.WriteLine($"触发Drop的源元素：{e.OriginalSource.GetType().Name}");

运行后会看到两次输出分别是MoveThumb和Border——这就实锤了是两个不同的子元素触发了事件路由。

解决办法（鱼和熊掌兼得） #

如果还想保留ZIndex的视觉效果，又不想重复触发事件，有两个实用思路：

• 统一设置ZIndex：别给模板里的多个子元素单独设Panel.ZIndex，而是给模板的根容器（比如最外层的Grid）设置。这样整个控件的视觉层级提升，但命中测试只会命中根容器，不会产生多个触发源。
• 去重逻辑兜底：给拖拽的State实例加个唯一标识（比如Guid），每次在Drop事件里添加前，检查Canvas里有没有相同标识的实例，避免重复创建。

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