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

自定义通知的基本步骤

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

示例自定义通知类：

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)); } }

📚 学习资源与示例

项目提供了多个示例应用，帮助你快速掌握ToastNotifications的使用：

• 基础用法示例：BasicUsageExample
• 配置示例：ConfigurationExample
• 自定义通知示例：CustomNotificationsExample
• .NET Core用法示例：DotNetCoreUsageExample

🔄 从v1迁移到v2

如果你正在使用ToastNotifications v1，想要升级到v2，请参考迁移指南：Migration.md。请注意，v2是全新实现，与v1不兼容，需要按照指南进行相应调整。

📝 许可证信息

ToastNotifications采用LGPL v3许可证。项目程序集已签名，详细信息请参考：StronglyNamedAssemblies.md

🎯 总结

ToastNotifications为WPF应用提供了一个功能强大、高度可定制的通知系统。无论是简单的状态提示还是复杂的交互式通知，它都能满足你的需求。通过本文介绍的基础配置和高级功能，你可以快速将专业级通知系统集成到自己的应用中，提升用户体验。

立即尝试使用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