H.NotifyIcon API完全手册：从基础方法到高级事件处理的全面解析

H.NotifyIcon API完全手册从基础方法到高级事件处理的全面解析【免费下载链接】H.NotifyIconTrayIcon for WPF/WinUI/Uno/MAUI项目地址: https://gitcode.com/gh_mirrors/hn/H.NotifyIconH.NotifyIcon是一款功能强大的托盘图标组件支持WPF、WinUI、Uno和MAUI等多种框架让开发者能够轻松实现系统托盘图标的创建、管理和交互。本文将全面解析H.NotifyIcon的API从基础方法到高级事件处理帮助开发者快速掌握这个实用工具。核心功能概览 H.NotifyIcon提供了丰富的托盘图标功能包括图标管理、通知显示、上下文菜单、弹出窗口和事件处理等。无论是简单的状态指示还是复杂的用户交互H.NotifyIcon都能满足需求。H.NotifyIcon支持多种框架提供一致的托盘图标体验基础API方法详解1. 图标管理UpdateIcon(Icon value): 更新托盘图标taskbarIcon.UpdateIcon(new Icon(icon.ico));该方法位于TaskbarIcon.Properties.cs文件中用于动态更新托盘图标。ForceCreate(bool enablesEfficiencyMode true): 强制创建托盘图标taskbarIcon.ForceCreate();该方法位于TaskbarIcon.cs文件中用于确保托盘图标被创建可选择启用效率模式。2. 通知管理ShowNotification(): 显示通知taskbarIcon.ShowNotification(标题, 内容);该方法位于TaskbarIcon.Notifications.cs文件中用于显示系统通知。ClearNotifications(): 清除所有通知taskbarIcon.ClearNotifications();同样位于TaskbarIcon.Notifications.cs文件用于清除所有显示的通知。3. 上下文菜单ShowContextMenu(Point cursorPosition): 显示上下文菜单taskbarIcon.ShowContextMenu(Cursor.Position);该方法在WPF和WinRT平台分别实现于TaskbarIcon.ContextMenu.Wpf.cs和TaskbarIcon.ContextMenu.WinRT.cs文件中。CloseContextMenu(): 关闭上下文菜单taskbarIcon.CloseContextMenu();同样在WPF和WinRT平台有对应的实现。4. 自定义气泡通知ShowCustomBalloon(UIElement balloon, PopupAnimation animation, int? timeout): 显示自定义气泡通知var balloon new MyCustomBalloon(); taskbarIcon.ShowCustomBalloon(balloon, PopupAnimation.Slide, 5000);该方法位于TaskbarIcon.CustomNotifications.Wpf.cs文件中仅适用于WPF平台。CloseBalloon(): 关闭气泡通知taskbarIcon.CloseBalloon();同样位于TaskbarIcon.CustomNotifications.Wpf.cs文件。5. 弹出窗口ShowTrayPopup(Point cursorPosition): 显示托盘弹出窗口taskbarIcon.ShowTrayPopup(Cursor.Position);该方法位于TaskbarIcon.Popups.cs文件中。CloseTrayPopup(): 关闭托盘弹出窗口taskbarIcon.CloseTrayPopup();同样位于TaskbarIcon.Popups.cs文件。6. 资源释放Dispose(): 释放资源taskbarIcon.Dispose();该方法位于TaskbarIcon.Dispose.cs文件中用于释放托盘图标相关资源。高级事件处理H.NotifyIcon提供了丰富的事件用于处理用户交互和系统通知。以下是一些常用事件1. 鼠标事件MouseLeftButtonDown: 鼠标左键按下事件MouseLeftButtonUp: 鼠标左键释放事件MouseRightButtonDown: 鼠标右键按下事件MouseRightButtonUp: 鼠标右键释放事件MouseDoubleClick: 鼠标双击事件MouseMove: 鼠标移动事件这些事件定义在TaskbarIcon.MouseEvents.cs文件中可以通过以下方式订阅taskbarIcon.MouseLeftButtonDown (sender, e) { // 处理鼠标左键按下事件 };2. 键盘事件PreviewKeyDown: 键盘按键按下预览事件KeyUp: 键盘按键释放事件这些事件定义在TaskbarIcon.KeyboardEvents.cs文件中。3. 通知事件BalloonOpened: 气泡通知打开事件BalloonClosed: 气泡通知关闭事件BalloonClicked: 气泡通知点击事件这些事件定义在TaskbarIcon.Notifications.cs文件中。4. 图标事件TrayIconCreated: 托盘图标创建事件TrayIconDestroyed: 托盘图标销毁事件这些事件可以用于跟踪托盘图标的生命周期。多框架支持H.NotifyIcon支持多种框架包括WPF、WinUI、Uno和MAUI。每个框架都有对应的实现WPF: H.NotifyIcon.WpfWinUI: H.NotifyIcon.WinUIUno: H.NotifyIcon.UnoMAUI: H.NotifyIcon.MauiH.NotifyIcon在不同框架下保持一致的API和功能快速开始指南要开始使用H.NotifyIcon首先需要克隆仓库git clone https://gitcode.com/gh_mirrors/hn/H.NotifyIcon然后根据您的目标框架引用相应的库项目。例如对于WPF项目引用H.NotifyIcon.Wpf.csproj。在XAML中添加TaskbarIcon控件notifyicon:TaskbarIcon x:NameMyTaskbarIcon IconSource/Icons/MyIcon.ico /在代码中使用API方法// 显示通知 MyTaskbarIcon.ShowNotification(欢迎, H.NotifyIcon已成功加载); // 订阅事件 MyTaskbarIcon.MouseDoubleClick (sender, e) { // 处理双击事件 MainWindow.Show(); MainWindow.WindowState WindowState.Normal; };总结H.NotifyIcon提供了一套完整的API用于在各种.NET框架中实现功能丰富的托盘图标。从基础的图标管理到高级的事件处理H.NotifyIcon都能满足开发者的需求。无论您是开发桌面应用还是移动应用H.NotifyIcon都能为您提供一致且强大的托盘图标功能。通过本文的介绍您应该已经掌握了H.NotifyIcon的核心API和使用方法。现在您可以开始在自己的项目中使用H.NotifyIcon为用户提供更好的系统集成体验。【免费下载链接】H.NotifyIconTrayIcon for WPF/WinUI/Uno/MAUI项目地址: https://gitcode.com/gh_mirrors/hn/H.NotifyIcon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考