WinUI 3自定义ContentDialog：实现多Tab页同时打开对话框方案

核心思路 #

放弃原生ContentDialog，采用自定义UserControl对话框 + Popup + 局部遮罩的组合方案。这种方式既可以复刻原生对话框的外观与交互，又能突破单线程只能打开一个的限制，同时实现仅阻塞当前Tab页交互的需求。

具体实现步骤 #

• 自定义对话框控件
  完全复刻原生ContentDialog的布局结构：头部标题栏、中间内容区、底部操作按钮栏。使用WinUI系统自带的样式资源（如主题背景色、字体、圆角）确保外观一致。封装成UserControl后，暴露与原生ContentDialog对齐的属性（Title、Content、PrimaryButtonText等）和事件（PrimaryButtonClick、SecondaryButtonClick），降低代码迁移成本。

• 为TabItem添加局部交互阻塞容器
  修改每个TabItem的内容模板，最外层使用Grid布局，包含三个层级：

  1. 原Tab页的业务内容区域
  2. 初始隐藏的半透明遮罩（Background="#80000000"，IsHitTestVisible="True"），用于阻止下方内容交互
  3. Popup控件，设置PlacementTarget为当前Tab的内容区域，PlacementMode="Center"，确保对话框悬浮在Tab内容正上方

• 对话框显示/隐藏逻辑

  • 显示：先显示当前Tab的遮罩，将自定义对话框实例赋值给Popup.Child，再设置Popup.IsOpen="True"
  • 隐藏：设置Popup.IsOpen="False"，隐藏遮罩，按需清理对话框实例（或缓存复用）

• 多实例独立管理
  每个TabItem维护自身的对话框实例（或动态创建），由于Popup是Tab级别的独立控件，不同Tab的对话框完全隔离，支持同时打开多个。

关键细节优化 #

• 键盘交互：在自定义对话框中处理KeyDown事件，模拟原生逻辑——按Esc关闭对话框，按Enter触发确认按钮
• 焦点管理：显示对话框时自动将焦点移至对话框的第一个可交互控件，关闭后恢复焦点至之前的操作控件
• 样式一致性：直接引用WinUI系统资源（如ContentDialogThemeBackgroundBrush、ContentDialogForegroundBrush），确保和原生对话框视觉完全匹配

内容的提问来源于stack exchange，提问作者Nuvolari