.NET MAUI如何实现类似wxDialog的弹出式模态窗口？

针对你需要的弹出式、阻塞父窗口、随父窗口关闭的模态窗口需求，以下是跨平台的可行实现方案，重点解决Windows平台的原生模态行为：

核心思路 #

• 非Windows平台直接使用MAUI Shell的原生模态导航（PushModalAsync）即可满足需求；
• Windows平台通过调用WinUI原生API，将MAUI Window以模态方式显示，并关联父子窗口生命周期，实现阻塞和随父关闭的特性。

实现代码 #

1. 创建模态窗口辅助类 #

using Microsoft.Maui.Controls;
#if WINDOWS
using Microsoft.UI.Xaml;
#endif

public static class ModalWindowHelper
{
    public static async Task ShowModalWindowAsync(Page contentPage, Window parentWindow = null)
    {
        // 默认使用主窗口作为父窗口
        parentWindow ??= Application.Current.MainWindow;

#if WINDOWS
        var modalWindow = new Window(contentPage)
        {
            Width = 720,
            Height = 440,
            Title = contentPage.Title // 同步页面标题到窗口标题栏
        };

        // 等待窗口Handler初始化（确保能获取到原生窗口）
        modalWindow.HandlerChanged += (s, e) =>
        {
            if (modalWindow.Handler?.PlatformView is Window nativeWindow)
            {
                // 设置父窗口，实现随父窗口关闭+阻塞交互
                if (parentWindow.Handler?.PlatformView is Window parentNativeWindow)
                {
                    nativeWindow.Owner = parentNativeWindow;
                }

                // 自定义标题栏样式（可选，比如设置标题文本为紫色）
                var appWindow = nativeWindow.AppWindow;
                appWindow.TitleBar.TitleForegroundColor = Microsoft.UI.Colors.Purple;
                appWindow.TitleBar.ButtonForegroundColor = Microsoft.UI.Colors.Purple;

                // 以模态方式显示窗口
                nativeWindow.ShowDialog();
            }
        };

        // 添加窗口到应用
        Application.Current.OpenWindow(modalWindow);
#else
        // 非Windows平台使用Shell模态导航
        await Shell.Current.Navigation.PushModalAsync(contentPage, true);
#endif
    }
}

2. 调用方式 #

在需要弹出注册表单的地方，直接调用：

await ModalWindowHelper.ShowModalWindowAsync(new RegistrationPage());

方案优势 #

• 满足全部需求：
  • 弹出独立窗口；
  • Windows平台通过ShowDialog()阻塞父窗口交互；
  • 通过设置nativeWindow.Owner，父窗口关闭时自动关闭模态窗口；
  • 标题栏显示页面Title，还可自定义样式。
• 无需复杂子类化：仅通过平台特定代码调用原生API，避免架构层面的自定义，降低维护成本。
• 跨平台兼容：非Windows平台沿用MAUI原生模态导航，保证一致性。

常见疑问解答 #

1. 为什么不直接用OpenWindow？
   MAUI的OpenWindow默认是非模态的，不会阻塞父窗口，也没有父子窗口关联逻辑，无法满足wxDialog的行为。
2. 是否需要深入平台API？
   仅Windows平台需要少量WinUI API调用，逻辑简单，你具备Windows基础完全可以驾驭。
3. 自定义标题栏样式
   如果需要和Shell的标题栏样式一致，可通过AppWindow.TitleBar属性自定义颜色、字体等，示例代码已包含标题文本紫色的设置。

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