This commit is contained in:
1 parent
72d9b295a0
commit
5d81c475c8
335 files changed
+7359
No files matched your search
@@ -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)
|
||||
Reference in new issue
Block a user