WPF的事件路由系统传播机制（隧道传播、直接传播和冒泡传播）

WPF的事件路由系统包括三种类型的事件传播机制：隧道传播、直接传播和冒泡传播。每种传播机制都有不同的传播路径和使用场景。

1. 隧道传播（Tunneling）

隧道传播是事件从根元素向下传递的机制。事件会依次经过可视化树中的每个元素，直到达到事件的原始源。在隧道传播中，事件处理程序会首先被调用，然后再向下传递。

示例代码：

private void Grid_PreviewMouseDown(object sender, MouseButtonEventArgs e)
{
    Console.WriteLine("Grid PreviewMouseDown");
    e.Handled = true; // 停止事件传播
}

private void Button_PreviewMouseDown(object sender, MouseButtonEventArgs e)
{
    Console.WriteLine("Button PreviewMouseDown");
}

使用场景：

• 可以在父级元素上捕获事件并进行处理，然后决定是否继续传播给子级元素。
• 可以在事件的早期阶段对事件进行拦截或干预。
• 可以在父级元素上实现一些全局的事件处理逻辑。

2. 直接传播（Direct）

直接传播是事件沿着可视化树的路径上的每个元素进行传播的机制。它对事件的处理顺序没有要求，只是按照元素在视觉树中的顺序触发。

示例代码：

private void Grid_PreviewMouseDown(object sender, MouseButtonEventArgs e)
{
    Console.WriteLine("Grid PreviewMouseDown");
}

private void Button_PreviewMouseDown(object sender, MouseButtonEventArgs e)
{
    Console.WriteLine("Button PreviewMouseDown");
}

使用场景：

• 可以在父级元素和子级元素上都处理事件，并且不影响传播的顺序。
• 可以在不同元素上进行不同的事件处理逻辑。

3. 冒泡传播（Bubbling）

冒泡传播是事件从事件源开始向上传递的机制，沿着可视化树向上冒泡直到达到根元素。在冒泡传播中，事件处理程序会首先被子级元素调用，然后再依次向上传递。

示例代码：

private void Grid_MouseDown(object sender, MouseButtonEventArgs e)
{
    Console.WriteLine("Grid MouseDown");
}

private void Button_MouseDown(object sender, MouseButtonEventArgs e)
{
    Console.WriteLine("Button MouseDown");
    e.Handled = true; // 停止事件传播
}

使用场景：

• 可以在父级元素上捕获子级元素的事件并进行处理。
• 可以在父级元素上实现一些全局的事件处理逻辑。

鼠标单击事件序列说明：

• PreviewMouseLeftButtonDown for Window (Tunnel)：窗口接收到鼠标左键按下的预览事件。
• PreviewMouseDown for Window (Tunnel)：窗口接收到鼠标按下的预览事件。
• PreviewMouseLeftButtonDown for StackPanel (Tunnel)：StackPanel（堆栈面板）接收到鼠标左键按下的预览事件。
• PreviewMouseDown for StackPanel (Tunnel)：StackPanel接收到鼠标按下的预览事件。
• PreviewMouseLeftButtonDown for Label (Tunnel)：Label（标签）接收到鼠标左键按下的预览事件。
• PreviewMouseDown for Label (Tunnel)：Label接收到鼠标按下的预览事件。
• MouseLeftButtonDown for Label (Bubble)：Label接收到鼠标左键按下的冒泡事件。
• MouseDown for Label (Bubble)：Label接收到鼠标按下的冒泡事件。
• MouseLeftButtonDown for StackPanel (Bubble)：StackPanel接收到鼠标左键按下的冒泡事件。
• MouseDown for StackPanel (Bubble)：StackPanel接收到鼠标按下的冒泡事件。
• MouseLeftButtonDown for Window (Bubble)：窗口接收到鼠标左键按下的冒泡事件。
• MouseDown for Window (Bubble)：窗口接收到鼠标按下的冒泡事件。
• PreviewMouseLeftButtonUp for Window (Tunnel)：窗口接收到鼠标左键释放的预览事件。
• PreviewMouseUp for Window (Tunnel)：窗口接收到鼠标释放的预览事件。
• PreviewMouseLeftButtonUp for StackPanel (Tunnel)：StackPanel接收到鼠标左键释放的预览事件。
• PreviewMouseUp for StackPanel (Tunnel)：StackPanel接收到鼠标释放的预览事件。
• PreviewMouseLeftButtonUp for Label (Tunnel)：Label接收到鼠标左键释放的预览事件。
• PreviewMouseUp for Label (Tunnel)：Label接收到鼠标释放的预览事件。
• MouseLeftButtonUp for Label (Bubble)：Label接收到鼠标左键释放的冒泡事件。
• MouseUp for Label (Bubble)：Label接收到鼠标释放的冒泡事件。
• MouseLeftButtonUp for StackPanel (Bubble)：StackPanel接收到鼠标左键释放的冒泡事件。
• MouseUp for StackPanel (Bubble)：StackPanel接收到鼠标释放的冒泡事件。
• MouseLeftButtonUp for Window (Bubble)：窗口接收到鼠标左键释放的冒泡事件。
• MouseUp for Window (Bubble)：窗口接收到鼠标释放的冒泡事件。

通过这个事件序列，可以看到鼠标单击事件从窗口顶层元素开始，在隧道传播阶段（Tunnel）逐级向下，然后在直接传播阶段（Direct）从最深的子元素开始逐级向上，最后在冒泡传播阶段（Bubble）再次逐级向上传播。这个事件序列反映了鼠标单击事件的路由过程。