Winform中WebBrowser控件ShowPrintPreviewDialog()无法正常显示问题

开发者阿泽

2026-9-26

问题根因

你创建的WebBrowser控件未附加到任何窗体的控件树，也没有为弹出的打印预览对话框指定所有者窗口，导致窗口层级异常，无法被前台激活
WebBrowser实例为局部变量，没有稳定的引用持有，可能被GC提前回收，导致关联的预览窗口消息循环异常
原代码中在调用打印预览方法后立刻释放控件资源，也可能引发窗口响应异常

修复方案

修改后的辅助类代码

using System;
using System.Windows.Forms;

namespace Hobbysta.App.Controls.Print
{
    public class PrintingContent
    {
        private readonly string _htmlContent;
        // 持有WebBrowser实例引用，避免被GC提前回收
        private WebBrowser _browser;

        public PrintingContent(string htmlContent)
        {
            _htmlContent = htmlContent;
        }

        public void ShowPreview(IWin32Window owner = null)
        {
            // 未指定所有者时默认取当前活动窗体
            owner ??= Form.ActiveForm;
            ExecuteBrowserAction(owner, b => b.ShowPrintPreviewDialog());
        }

        private void ExecuteBrowserAction(IWin32Window owner, Action<WebBrowser> action)
        {
            _browser = new WebBrowser();
            // 主动完成控件初始化，确保UI上下文正确
            _browser.CreateControl();
            _browser.DocumentCompleted += (_, __) =>
            {
                action(_browser);
                // 等待模态对话框关闭后再释放资源
                _browser.Dispose();
                _browser = null;
            };
            _browser.DocumentText = _htmlContent;
        }
    }
}

调用代码修改

调用时传入当前窗体作为预览窗口的所有者，保证窗口层级正确，同时建议传入符合格式的HTML内容：

private void button1_Click(object sender, EventArgs e)
{
    var printer = new PrintingContent("<html><body>TEST PRINT</body></html>");
    printer.ShowPreview(this);
}