WPF/XAML 通知图标和任务栏（系统托盘）弹出窗口

• MouseLeave 事件是此类中的关键，因此我将从这里开始。
  为了实现我想要的弹出窗口行为，我必须在 Windows Forms 的 NotifyIcon 上构建功能，以添加 MouseLeave 事件。默认情况下，NotifyIcon 只有以下鼠标事件：MouseClick、MouseDoubleClick、MouseDown、MouseMove 和 MouseUp。更复杂的是，我不想让新的 MouseLeave 事件立即触发，而是允许延迟后再触发。此延迟对于 WpfXamlPopup 项目中的弹出窗口至关重要，因为它为鼠标离开任务栏中的 NotifyIcon 提供了时间缓冲，从而实现了三个重要功能：
  • 用户可以在短时间内离开并重新回到图标上，而不会导致弹出窗口关闭（例如，如果用户不小心将鼠标移开然后又移回图标；或者短暂离开图标，然后改变主意又回到图标上）。
  • 消除鼠标悬停在图标边缘时有时出现的重复命中/未命中场景引起的闪烁/闪烁。
  • 用户可以从图标移到弹出窗口，而不会导致弹出窗口关闭，即，如果用户在延迟时间内从图标移到弹出窗口，则弹出窗口会保持打开状态，以实现无缝过渡。
• ExtendedNotifyIcon(int millisecondsToDelayMouseLeaveEvent) 是构造函数，它设置 Windows Forms NotifyIcon 控件的实例，并关联用于跟踪鼠标位置的 MouseMove 事件。构造函数还设置 delayMouseLeaveEventTimer 定时器，该定时器用于计算鼠标离开/退出图标上方的时间延迟以及 MouseLeave 事件的触发。链式构造函数将默认延迟设置为 100 毫秒。
• targetNotifyIcon_MouseMove 方法会拦截 NotifyIcon 上的 MouseMove 事件，并跟踪屏幕上的鼠标位置。它还会启动定时器（delayMouseLeaveEventTimer.Start）。当定时器触发时，它会调用 delayMouseLeaveEventTimer_Tick 方法，该方法会检查鼠标是否仍然位于 NotifyIcon 上方。如果是，则忽略任何操作。如果不是，它将触发 MouseLeave 事件。认识到这一点之所以有效，主要是因为两个原因：
  • 如果定时器过期且鼠标仍然悬停在 NotifyIcon 上方，则不执行任何操作。
  • 当鼠标移到图标上方时，它会不断重置定时器并跟踪鼠标 - 这意味着当鼠标从图标上方移开时，离开事件的定时器将从头开始计时。
• StartMouseLeaveTimer 和 StopMouseLeaveEventFromFiring 方法为调用代码提供自定义 MouseLeave 事件的手动覆盖。
• IDisposable 接口：如果 Windows NotifyIcon 没有被释放，它将在应用程序终止后保持可见，并且只有在用户将鼠标悬停在图标上后才会消失。

• LinearGradientBrush：用于生成弹出窗口的渐变背景。
• OuterGlowBitmapEffect：用于生成窗口周围的阴影，使其从背景中脱颖而出。
• MainGridBorder：一种样式，用于设置圆角、边框和默认背景。

• 两个故事板 <Storyboard x:Key="gridFadeInStoryBoard"> 和 <Storyboard x:Key="gridFadeOutStoryBoard"> 简单地将主网格淡入淡出，以提供淡入/淡出效果。这些在代码隐藏中进行处理（有关详细信息，请参阅下文）。
• <Grid x:Name="uiGridMain" Margin="10"> 是弹出窗口的“框架”，定义了分隔线、按钮和窗口内容的区域。它使用 MainGridStyleRD.xaml 中的 MainGridBorder 资源定义进行样式化。
• SlickToggleButtons 在 SlickButtonRD.xaml 中定义，并用于弹出窗口的固定和关闭控件框选项。
• 简单的 Label 提供了弹出窗口的标题。
• 两个 StackPanels 定义了窗口的主要内容区域。
  • 第一个包含用于在任务栏中切换图标图像的单选按钮。
  • 第二个包含一系列可用于弹出窗口各种操作的按钮。

MainNotifyWindow.cs

• MainNotifyWindow() 是构造函数，它通过以下方式设置弹出应用程序：
  • 将 NotifyIcon 添加到任务栏并注册相关的事件以调用弹出窗口。
  • 将弹出窗口的位置设置在屏幕的右下角。
  • 将弹出窗口的默认状态设置为隐藏，方法是将窗口和主网格的不透明度设置为 0。
  • 缓存弹出窗口所需的动画，并将事件与动画完成时的操作关联起来。
• SetNotifyIcon(string iconPrefix) 通过接受一个前缀并附加 Orb.ico 来更改实际图标，以生成一个已内置到资源文件中的图标名称。例如，“BlueOrb.Ico”，然后使用 pack:// URI 表示法检索并分配给 NotifyIcon。
• SetWindowToBottomRightOfScreen() 将弹出窗口定位在屏幕的右下角。
• extendedNotifyIcon_OnShowWindow() 处理鼠标移动到任务栏中的 NotifyIcon 时触发的事件。如果没有动画正在执行（uiGridMain.Opacity > 0 && uiGridMain.Opacity < 1），则处理程序开始动画故事板以淡入弹出窗口。在这种情况下，将立即显示弹出窗口和主网格，以提供即时访问弹出窗口。这种情况通常发生在用户无意中将鼠标移出 NotifyIcon，看到弹出窗口开始淡出，然后迅速将焦点移回图标以“恢复”窗口时。
• extendedNotifyIcon_OnHideWindow() 处理鼠标离开任务栏中的 NotifyIcon 或鼠标离开弹出窗口时触发的事件。如果窗口未固定打开，则处理程序开始动画故事板以淡出弹出窗口。与上面的 extendedNotifyIcon_OnShowWindow() 方法一样，此处理程序仅在弹出窗口完全可见时才进行动画处理，以避免将窗口的不透明度重置为完全不透明，从而有效重启动画，导致可怕的闪烁。
• uiWindowMainNotification_MouseEnter(...) 处理鼠标进入弹出窗口时触发的事件。在这种情况下，用户显然希望与窗口进行交互，所有“关闭/淡出”事件都会被取消，并且窗口的主网格设置为完全不透明。
• uiWindowMainNotification_MouseLeave(...) 处理鼠标离开弹出窗口时触发的事件。在这种情况下，假设用户已完成与弹出窗口的交互，并发出指令以淡出弹出窗口。
• gridFadeOutStoryBoard_Completed(...) 此事件通过将窗口的 Opacity = 0; 来确保窗口已隐藏。
• gridFadeInStoryBoard_Completed(...) 此事件通过将窗口的 Opacity = 1; 来确保窗口在淡入后完全可见。
• PinButton_Click(...) 确保在固定按钮上显示正确的图像以表示按钮的状态（已选中/未选中）。
• colourRadioButton_Click(...) 切换任务栏中 NotifyIcon 使用的图像。
• CloseButton_Click(...) 执行任务栏图标的必要清理并关闭应用程序。