--- 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(); ```