2.1 KiB
name, description
| name | description |
|---|---|
| handycontrol-wpf-growl | 实现、配置或排查 HandyControl WPF 的 Growl 信息通知(Growl)。适用于该扩展控件的 XAML、绑定、事件和模板;不用于 Avalonia 或其他厂商控件。 |
HandyControl WPF Growl 信息通知
实现或排查 Growl 信息通知。相关类型:Growl。
接入
程序集/NuGet 为 HandyControl,XAML 命名空间为
xmlns:hc="https://handyorg.github.io/handycontrol",C# 控件命名空间为 HandyControl.Controls。
在 App.xaml 合并 pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml,
然后合并 pack://application:,,,/HandyControl;component/Themes/Theme.xaml。
已有主题配置时先检查,避免重复合并。版本和目标框架以使用方项目为准。
实现
先读 API 声明与继承关系,再按需求查看 文档、样式与示例导航。源码路径相对于 HandyControl 仓库根目录; 在本仓库优先读本地文件,安装到其他项目后使用内附声明与链接,遇到版本差异检查实际引用版本的源码。 不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
Growl 是通知 API 与控件的组合。页面内通知需要 Panel 上的 Growl.GrowlParent 或 Growl.Token;多窗口使用唯一 token。普通通知与 Global 方法的显示范围不同。后台任务更新 UI 先切回 Dispatcher。
用目标项目现有的 MVVM 方式绑定;需要回写时明确 TwoWay 和更新时机, 不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。 交付时运行目标框架的构建,并在窗口加载后检查模板、绑定错误、空值和相关输入边界; 无法运行 WPF 时明确说明尚未验证 UI 行为。
最小片段
依赖上面的应用资源配置;Binding 路径由使用方 ViewModel 提供。
<!-- 在窗口可视树中声明;加载后在 UI 线程调用 Growl.Success("保存成功")。 -->
<StackPanel hc:Growl.GrowlParent="True"/>