feat(skills): add HandyControl WPF component skills
Build / build (push) Canceled after 0s

This commit is contained in:
chfei committed 2026-10-27 09:12:40 +08:00
1 parent 72d9b295a0
commit 5d81c475c8
335 files changed
+7359

No files matched your search

+39
View File
@@ -0,0 +1,39 @@
---
name: handycontrol-wpf-growl
description: "实现、配置或排查 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 声明与继承关系](references/api.md),再按需求查看
[文档、样式与示例导航](references/usage.md)。源码路径相对于 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 提供。
```xml
<!-- 在窗口可视树中声明;加载后在 UI 线程调用 Growl.Success("保存成功")。 -->
<StackPanel hc:Growl.GrowlParent="True"/>
```
@@ -0,0 +1,4 @@
interface:
display_name: "HandyControl WPF Growl 信息通知"
short_description: "Implement HandyControl WPF controls from verified source guidance"
default_prompt: "Use $handycontrol-wpf-growl to implement the requested HandyControl WPF UI."
@@ -0,0 +1,56 @@
# 源码 API 导航
下面是当前工作区的声明摘录,不是完整 C# 文件,不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制,需打开对应源码核对。
## Growl
源码:[src/Shared/HandyControl_Shared/Controls/Growl/Growl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Growl/Growl.cs)
```text
public class Growl : Control
public static Panel GrowlPanel
public InfoType Type
public bool ShowDateTime
public string Message
public DateTime Time
public Geometry Icon
public Brush IconBrush
public Growl()
public override void OnApplyTemplate()
public static void SetToken(DependencyObject element, string value)
public static string GetToken(DependencyObject element)
public static void SetShowMode(DependencyObject element, GrowlShowMode value)
public static GrowlShowMode GetShowMode(DependencyObject element)
public static void SetTransitionMode(DependencyObject element, TransitionMode value)
public static TransitionMode GetTransitionMode(DependencyObject element)
public static void SetTransitionStoryboard(DependencyObject element, Storyboard value)
public static Storyboard GetTransitionStoryboard(DependencyObject element)
public static void SetGrowlParent(DependencyObject element, bool value)
public static bool GetGrowlParent(DependencyObject element)
public static void Success(string message, string token = "")
public static void Success(GrowlInfo growlInfo)
public static void SuccessGlobal(string message)
public static void SuccessGlobal(GrowlInfo growlInfo)
public static void Info(string message, string token = "")
public static void Info(GrowlInfo growlInfo)
public static void InfoGlobal(string message)
public static void InfoGlobal(GrowlInfo growlInfo)
public static void Warning(string message, string token = "")
public static void Warning(GrowlInfo growlInfo)
public static void WarningGlobal(string message)
public static void WarningGlobal(GrowlInfo growlInfo)
public static void Error(string message, string token = "")
public static void Error(GrowlInfo growlInfo)
public static void ErrorGlobal(string message)
public static void ErrorGlobal(GrowlInfo growlInfo)
public static void Fatal(string message, string token = "")
public static void Fatal(GrowlInfo growlInfo)
public static void FatalGlobal(string message)
public static void FatalGlobal(GrowlInfo growlInfo)
public static void Ask(string message, Func<bool, bool> actionBeforeClose, string token = "")
public static void Ask(GrowlInfo growlInfo)
public static void AskGlobal(string message, Func<bool, bool> actionBeforeClose)
public static void AskGlobal(GrowlInfo growlInfo)
public static void Clear(string token = "")
public static void ClearGlobal()
```
@@ -0,0 +1,17 @@
# Growl 信息通知 使用导航
文档:[doc/source/handycontrol/extend_controls/growl/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/growl/index.md)
在线文档:[控件说明](https://handyorg.github.io/handycontrol/extend_controls/growl/)
按任务阅读原文中的章节:控件效果、准备工作、基础用法、只在激活中的窗口显示信息通知、在任意的`StackPanel`容器中显示信息通知、属性、附加属性、方法、注意、FAQ。
## 当前源码
- [src/Shared/HandyControl_Shared/Controls/Growl/Growl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Growl/Growl.cs)
## 样式及官方示例
- [src/Shared/HandyControl_Shared/Themes/Styles/Growl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Growl.xaml)
- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GrowlDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GrowlDemo.xaml)
- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GrowlDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GrowlDemo.xaml.cs)