Files
2026-10-27 09:12:40 +08:00

45 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: handycontrol-wpf-dialog
description: "实现、配置或排查 HandyControl WPF 的 Dialog 对话框(Dialog)。适用于该扩展控件的 XAML、绑定、事件和模板;不用于 Avalonia 或其他厂商控件。"
---
# HandyControl WPF Dialog 对话框
实现或排查 **Dialog 对话框**。相关类型:`Dialog`。
## 接入
程序集/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 或示例资源直接复制进使用方项目。
Dialog.Show 返回覆盖层 Dialog,不等于 Window.ShowDialog。无 token 时依赖活动窗口的 AdornerDecorator;指定 token 时先配置 Dialog.Token 和 DialogContainer。关闭使用返回实例的 Close()。异步结果需要实现库要求的结果接口并引入扩展命名空间,不能直接假定存在任意 Task 返回值。
用目标项目现有的 MVVM 方式绑定;需要回写时明确 TwoWay 和更新时机,
不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
交付时运行目标框架的构建,并在窗口加载后检查模板、绑定错误、空值和相关输入边界;
无法运行 WPF 时明确说明尚未验证 UI 行为。
## 最小片段
依赖上面的应用资源配置;Binding 路径由使用方 ViewModel 提供。
```csharp
// 在已显示且具备装饰层的 WPF 窗口的 UI 线程执行。
var dialog = HandyControl.Controls.Dialog.Show(new System.Windows.Controls.TextBlock
{
Text = "正在处理"
});
// 操作完成后关闭。
dialog.Close();
```