WPF中SharedSizeGroup列转FixedDocument时渲染异常问题

问题概述 #

• 场景：WPF应用里，FlowDocument包含的Grid控件使用了SharedSizeGroup列
• 异常表现：将FlowDocument转换为FixedDocument，或把该Grid可视化元素保存为图像时，共享列尺寸失效，各列单独自适应导致布局错乱
• 特殊情况：在DocumentViewer中显示正常，且仅在部分电脑上出现该问题

原因分析 #

• SharedSizeGroup的尺寸计算依赖完整的可视化树布局上下文，直接通过VisualBrush渲染DocumentPage.Visual时，跨元素的尺寸共享逻辑没有被正确传递，导致布局计算跳过了SharedSizeGroup的同步步骤
• 部分电脑出现差异，大概率和WPF渲染引擎版本、硬件加速设置有关，部分环境下VisualBrush渲染会省略完整的布局传递流程

解决方案 #

1. 强制触发完整布局流程 #

在渲染前手动调用目标Visual的Measure和Arrange方法，确保SharedSizeGroup的尺寸计算完成后再进行渲染

2. 优化VisualBrush配置 #

明确设置VisualBrush的Stretch和对齐属性，避免渲染时的自动缩放破坏原有布局

3. 环境适配（可选） #

若问题仅出现在特定硬件/环境，可临时禁用硬件加速，或统一WPF运行环境的.NET版本

修改后的代码示例 #

Private Sub RenderPageContent(container As ContainerVisual, originalPage As DocumentPage)
    ' 强制触发目标Visual的完整布局计算
    Dim targetVisual = originalPage.Visual
    targetVisual.Measure(originalPage.Size)
    targetVisual.Arrange(New Rect(originalPage.Size))
    
    ' 配置VisualBrush确保布局还原
    Dim pageVisual As New DrawingVisual()
    Using ctx As DrawingContext = pageVisual.RenderOpen()
        Dim visualBrush = New VisualBrush(targetVisual) With {
            .Stretch = Stretch.None,
            .AlignmentX = AlignmentX.Left,
            .AlignmentY = AlignmentY.Top
        }
        ctx.DrawRectangle(visualBrush, Nothing, New Rect(New Point(), originalPage.Size))
    End Using

    container.Children.Add(pageVisual)
End Sub

额外排查建议 #

• 检查异常电脑的.NET Framework/.NET Core版本，确保和正常环境一致
• 尝试将FlowDocument先加载到隐藏的DocumentViewer中完成布局，再执行转换操作
• 确认Grid的SharedSizeGroup配置：所有参与共享的列都正确设置了该属性，且未同时设置固定Width属性导致冲突

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