UWP打印预览首次打开时图片不显示问题求助

这个问题我之前在做UWP/WinUI打印功能时也踩过坑！核心原因大多是首次打印时图片还没完成加载或渲染，打印预览直接捕获了未加载完成的视觉树，导致图片显示空白；而后续打开时图片已经被系统缓存，所以能正常显示。下面给你几个针对性的解决方案：

方案一：等待图片完全加载后再触发打印预览 #

这是最直接的解决思路，确保打印预览启动前，图片控件已经完成图片的加载和解码。

步骤： #

1. 假设你的打印内容页面（比如PrintPage.xaml）里有一个用于显示图片的Image控件：

<!-- PrintPage.xaml -->
<Grid>
    <TextBlock Text="打印标题" FontSize="24"/>
    <Image x:Name="printImage" Source="ms-appx:///Assets/YourPrintImage.png" Margin="0,40,0,0"/>
</Grid>

2. 在主页面的打印按钮点击事件中，先等待图片加载完成，再初始化打印文档：

// MainPage.xaml.cs
private async void btnPrint_Click(object sender, RoutedEventArgs e)
{
    // 创建打印内容页面实例
    var printPage = new PrintPage();
    
    // 等待图片加载完成
    await WaitForImageLoaded(printPage.printImage);
    
    // 初始化打印文档
    var printDocument = new PrintDocument();
    printDocument.PrintPage += PrintDocument_PrintPage;
    printDocument.SetPreviewPage(1, printPage);
    
    // 弹出打印对话框
    var printDialog = new PrintDialog();
    if (await printDialog.ShowPrintUIAsync())
    {
        await printDocument.PrintAsync();
    }
}

// 封装等待图片加载的工具方法
private Task WaitForImageLoaded(Image image)
{
    var tcs = new TaskCompletionSource<bool>();
    
    // 如果图片已经加载完成，直接返回完成任务
    if (image.IsLoaded)
    {
        tcs.SetResult(true);
        return tcs.Task;
    }
    
    // 否则绑定Loaded事件，加载完成后标记任务完成
    RoutedEventHandler loadedHandler = null;
    loadedHandler = (s, e) =>
    {
        image.Loaded -= loadedHandler;
        tcs.SetResult(true);
    };
    image.Loaded += loadedHandler;
    
    return tcs.Task;
}

// 打印页面事件处理
private void PrintDocument_PrintPage(object sender, PrintPageEventArgs e)
{
    var printPage = e.PrintPageAsFrameworkElement() as PrintPage;
    e.PageVisual = printPage;
    e.HasMorePages = false;
}

方案二：预加载图片并强制解码 #

如果你的图片是从网络或本地文件加载，可能存在解码延迟的问题，可以提前创建BitmapImage并强制完成解码：

// 在打印页面的构造函数或加载事件中预加载图片
public PrintPage()
{
    this.InitializeComponent();
    _ = LoadImageAsync();
}

private async Task LoadImageAsync()
{
    var bitmap = new BitmapImage();
    // 设置解码宽度，提前触发解码流程
    bitmap.DecodePixelWidth = 800;
    // 禁用延迟创建，确保立即加载
    bitmap.CreateOptions = BitmapCreateOptions.None;
    bitmap.UriSource = new Uri("ms-appx:///Assets/YourPrintImage.png");
    
    // 等待图片完成加载和解码
    await bitmap.SetSourceAsync(await new HttpClient().GetStreamAsync(bitmap.UriSource));
    
    printImage.Source = bitmap;
}

方案三：确保打印页面视觉树完全渲染 #

有时候打印预览捕获视觉树时，页面还没完成布局渲染，也会导致图片不显示。可以手动触发页面的测量和布局，确保渲染完成：

private async void btnPrint_Click(object sender, RoutedEventArgs e)
{
    var printPage = new PrintPage();
    
    // 强制触发页面的测量和布局
    printPage.Measure(new Size(double.PositiveInfinity, double.PositiveInfinity));
    printPage.Arrange(new Rect(0, 0, printPage.DesiredSize.Width, printPage.DesiredSize.Height));
    // 等待UI线程完成渲染
    await printPage.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () => {});
    
    // 后续打印逻辑和方案一一致...
}

总结 #

优先尝试方案一，它能精准解决“图片未加载完成就触发打印”的核心问题；如果是网络图片或大尺寸图片，结合方案二的预加载解码效果会更好；方案三作为兜底，处理视觉树渲染不及时的情况。

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