VSTO Outlook自定义任务窗格中WPF控件模糊及线条异常求助

问题描述 #

开发的Outlook VSTO插件在顶部添加了嵌入WPF用户控件的自定义任务窗格（CTP），遇到以下渲染异常：

• 单显示器下修改系统分辨率/缩放比例后，CTP内图文模糊
• 多显示器（不同分辨率/缩放）间移动Outlook窗口时，CTP内随机出现黑线条、边框（如右侧黑水平线、右侧黑垂直线、底部黑水平线）
• 仅重启Outlook可恢复，已设置UseLayoutRounding = True和SnapsToDevicePixels = True但无效，推测是WinForms与WPF渲染机制差异导致。

解决方案 #

1. 监听DPI变化并强制WPF控件重渲染 #

WinForms自定义任务窗格不会自动同步DPI变化给内嵌的WPF控件，需手动监听系统显示设置变化或窗口移动事件，触发WPF控件刷新：

// 在WPF UserControl的构造函数或加载事件中添加
SystemEvents.DisplaySettingsChanged += (sender, e) =>
{
    Dispatcher.Invoke(() =>
    {
        InvalidateVisual();
        UpdateLayout();
    });
};

// 同时监听自定义任务窗格的可见性变化
var ctp = Globals.ThisAddIn.CustomTaskPanes.Add(yourWpfHost, "自定义窗格");
ctp.VisibleChanged += (sender, e) =>
{
    if (ctp.Visible)
    {
        yourWpfHost.Child.Dispatcher.Invoke(() =>
        {
            yourWpfHost.Child.InvalidateVisual();
        });
    }
};

2. 启用WPF控件的Per-Monitor DPI感知 #

确保WPF控件支持每显示器DPI感知，避免缩放适配错误：

// .NET 5+ 版本，在WPF UserControl加载时设置
protected override void OnInitialized(EventArgs e)
{
    base.OnInitialized(e);
    if (Environment.OSVersion.Version >= new Version(10, 0, 15063))
    {
        VisualTreeHelper.SetDpiAwarenessContext(this, DpiAwarenessContext.PerMonitorV2);
    }
}

若使用.NET Framework，需在插件的app.manifest中添加DPI感知配置：

<application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
        <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/PM</dpiAware>
    </windowsSettings>
</application>

3. 同步WinForms与WPF的布局大小 #

自定义任务窗格大小变化时，强制WPF控件匹配容器尺寸，避免布局错位：

// 将WPF宿主控件设置为填充整个CTP
yourWpfHost.Dock = DockStyle.Fill;
// 监听CTP大小变化，触发WPF布局更新
ctp.SizeChanged += (sender, e) =>
{
    yourWpfHost.Child.Dispatcher.Invoke(() =>
    {
        yourWpfHost.Child.Measure(new Size(double.PositiveInfinity, double.PositiveInfinity));
        yourWpfHost.Child.Arrange(new Rect(0, 0, ctp.ClientSize.Width, ctp.ClientSize.Height));
    });
};

4. 临时禁用硬件加速（针对显卡驱动兼容性问题） #

若以上方法无效，可尝试禁用WPF硬件加速，改用软件渲染：

// 在WPF UserControl构造函数中添加
RenderOptions.ProcessRenderMode = RenderMode.SoftwareOnly;

额外注意事项 #

• 确保UseLayoutRounding和SnapsToDevicePixels属性设置在WPF控件的根容器上（如Grid、Border），而非单个子控件
• 避免在WPF控件中使用固定尺寸的元素，尽量使用相对布局和自动缩放

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