当前位置：首页 > news >正文

ToastNotifications：打造WPF应用中令人惊艳的通知系统完全指南

news 2026/7/4 8:04:34

ToastNotifications：打造WPF应用中令人惊艳的通知系统完全指南

【免费下载链接】ToastNotificationsToast notifications for WPF allows you to create and display rich notifications in WPF applications. It's highly configurable with set of built-in options like positions, behaviours, themes and many others. It's extendable, it gives you possibility to create custom and interactive notifications in simply manner.项目地址: https://gitcode.com/gh_mirrors/to/ToastNotifications

ToastNotifications是一款专为WPF应用设计的通知组件库，它让开发者能够轻松创建和展示丰富多样的通知效果。这款强大的工具不仅提供了高度可配置的内置选项，如位置设置、行为控制和主题选择，还支持自定义扩展，让你能够以简单的方式打造独特且具有交互性的通知体验。

🚀 为什么选择ToastNotifications？

在现代桌面应用中，有效的用户反馈至关重要。ToastNotifications通过以下特性脱颖而出：

高度可定制：从位置、动画到生命周期，一切都可以根据需求调整
丰富的内置通知类型：包含错误、信息、警告和成功等常用通知样式
简单易用的API：只需几行代码即可集成到你的WPF项目中
强大的扩展性：轻松创建符合应用风格的自定义通知

核心功能概览

ToastNotifications v2采用插件化架构，主要包含两个核心包：

ToastNotifications：核心包，包含创建和显示通知的主要机制
ToastNotifications.Messages：消息包，包含错误、信息、警告和成功等基本消息类型

图：ToastNotifications通知系统在WPF应用中的实际效果展示

⚡ 快速开始：安装与基础配置

1. 安装NuGet包

通过NuGet包管理器安装必要的组件：

Install-Package ToastNotifications Install-Package ToastNotifications.Messages

2. 导入主题资源

在你的App.xaml文件中导入ToastNotifications.Messages主题：

<Application.Resources> <ResourceDictionary> <ResourceDictionary.MergedDictionaries> <ResourceDictionary Source="pack://application:,,,/ToastNotifications.Messages;component/Themes/Default.xaml" /> </ResourceDictionary.MergedDictionaries> </ResourceDictionary> </Application.Resources>

3. 创建通知管理器

在应用程序中创建通知管理器实例：

using ToastNotifications; using ToastNotifications.Lifetime; using ToastNotifications.Position; var notifier = new Notifier(cfg => { cfg.PositionProvider = new WindowPositionProvider( parentWindow: Application.Current.MainWindow, corner: Corner.TopRight, offsetX: 10, offsetY: 10); cfg.LifetimeSupervisor = new TimeAndCountBasedLifetimeSupervisor( notificationLifetime: TimeSpan.FromSeconds(3), maximumNotificationCount: MaximumNotificationCount.FromCount(5)); cfg.Dispatcher = Application.Current.Dispatcher; });

4. 显示通知

使用简单的API显示不同类型的通知：

using ToastNotifications.Messages; notifier.ShowInformation("操作成功", "数据已成功保存到服务器"); notifier.ShowSuccess("任务完成", "报表生成已完成"); notifier.ShowWarning("注意", "磁盘空间不足"); notifier.ShowError("错误", "无法连接到数据库");

🛠️ 高级配置选项

ToastNotifications提供了丰富的配置选项，让你能够精确控制通知的行为和外观。详细配置指南可参考项目文档：Configuration.md

位置配置

你可以将通知显示在屏幕的任何角落：

// 屏幕右上角（默认位置） cfg.PositionProvider = new PrimaryScreenPositionProvider(Corner.TopRight, 10, 10); // 相对于窗口的位置 cfg.PositionProvider = new WindowPositionProvider(Application.Current.MainWindow, Corner.BottomLeft, 10, 10);

生命周期管理

控制通知的显示时间和数量：

// 基于时间和数量的生命周期管理 cfg.LifetimeSupervisor = new TimeAndCountBasedLifetimeSupervisor( notificationLifetime: TimeSpan.FromSeconds(5), maximumNotificationCount: MaximumNotificationCount.FromCount(3)); // 仅基于数量的生命周期管理 cfg.LifetimeSupervisor = new CountBasedLifetimeSupervisor( maximumNotificationCount: MaximumNotificationCount.FromCount(5));

✨ 创建自定义通知

ToastNotifications的强大之处在于其可扩展性。你可以创建完全符合应用风格的自定义通知。详细指南请参考：CustomNotificatios.md

自定义通知的基本步骤

创建通知数据类，继承自NotificationBase
创建通知UI控件（XAML用户控件）
实现通知显示逻辑
创建扩展方法以便于使用

示例自定义通知类：

using ToastNotifications.Core; public class CustomNotification : NotificationBase { public string Title { get; } public string Message { get; } public ICommand ActionCommand { get; } public CustomNotification(string title, string message, ICommand actionCommand) { Title = title; Message = message; ActionCommand = actionCommand; } public override NotificationDisplayPart CreateDisplayPart() { return new NotificationDisplayPart(this, typeof(CustomDisplayPart)); } }