WPF自定义UserControl模板中Canvas子元素无法显示问题求助

核心问题原因 #

1. 直接给template.canvas字段赋值仅修改了后台变量的引用指向，不会替换XAML模板可视化树中预先声明的空Canvas元素，最终打印时渲染的始终是XAML中定义的无任何子元素的空白Canvas，这是问题的核心诱因。
2. WPF中UI元素同一时间只能属于一个可视化树，你要复用的原Canvas原本隶属于界面的ScrollViewer父容器，未解除原有父级关联的情况下无法在新的打印可视化树中正常渲染。
3. 打印前未手动触发控件的布局测量、排列流程，子元素没有计算得到正确的渲染位置。

另外你代码中存在笔误：pd.PrintableAreHeight拼写错误，修正为pd.PrintableAreaHeight即可。 #

修复步骤 #

步骤1：正确将Canvas内容填充到模板 #

二选一即可：

• 方案A（推荐，不影响原界面显示）：迁移原Canvas子元素到模板自带的Canvas

PageTemplate template = new PageTemplate();
Canvas sourceCanvas = BuildCanvasFunction();
// 同步原Canvas的基础配置到模板Canvas
template.canvas.Background = sourceCanvas.Background;
template.canvas.Width = sourceCanvas.Width;
template.canvas.Height = sourceCanvas.Height;
// 批量迁移子元素
while (sourceCanvas.Children.Count > 0)
{
    UIElement child = sourceCanvas.Children[0];
    sourceCanvas.Children.RemoveAt(0);
    template.canvas.Children.Add(child);
}

• 方案B：直接将生成的Canvas作为子元素插入模板Canvas

PageTemplate template = new PageTemplate();
Canvas sourceCanvas = BuildCanvasFunction();
// 若原Canvas在界面可视化树中，先解除原有父级关联
(sourceCanvas.Parent as ScrollViewer)?.Content = null;
template.canvas.Children.Add(sourceCanvas);

步骤2：添加手动布局更新逻辑 #

在打印前触发控件布局重绘，确保所有元素渲染位置正确：

FixedPage.SetTop(template,0);
FixedPage.SetLeft(template,0);
page.Children.Add(template);

// 新增：手动触发测量、排列、布局更新
template.Measure(new Size(page.Width, page.Height));
template.Arrange(new Rect(0, 0, page.Width, page.Height));
template.UpdateLayout();

PageContent content = new PageContent();
content.Child = page;
document.Pages.Add(content);
pd.PrintDocument(document.DocumentPaginator, "Document");

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