如何在Xamarin Forms中将StackLayout内容转为PNG/PDF并在iOS打印

核心步骤拆解 #

要实现需求，需完成三个关键环节：StackLayout转PNG图片、图片转PDF、iOS原生打印集成，以下是具体实现代码：

一、给目标StackLayout命名 #

首先修改你的XAML，给要捕获的StackLayout添加x:Name，方便后台代码获取实例：

<StackLayout x:Name="PrintableStackLayout" HorizontalOptions="FillAndExpand" Padding="20" VerticalOptions="CenterAndExpand">
    <!-- 你的原有Frame及内部内容 -->
</StackLayout>

二、实现StackLayout转PNG #

通过DependencyService调用iOS原生API捕获视图截图：

1. Forms项目定义接口 #

public interface IScreenshotService
{
    Task<byte[]> CaptureViewAsync(View view);
}

2. iOS项目实现接口 #

[assembly: Dependency(typeof(iOSScreenshotService))]
namespace YourAppNamespace.iOS
{
    using CoreGraphics;
    using UIKit;
    using Xamarin.Forms;
    using Xamarin.Forms.Platform.iOS;

    public class iOSScreenshotService : IScreenshotService
    {
        public async Task<byte[]> CaptureViewAsync(View view)
        {
            return await Task.Run(() =>
            {
                var nativeView = view.GetRenderer().NativeView;
                UIGraphics.BeginImageContextWithOptions(nativeView.Bounds.Size, false, UIScreen.MainScreen.Scale);
                
                nativeView.DrawViewHierarchy(nativeView.Bounds, afterScreenUpdates: true);
                var image = UIGraphics.GetImageFromCurrentImageContext();
                UIGraphics.EndImageContext();
                
                using (var imageData = image.AsPNG())
                {
                    var bytes = new byte[imageData.Length];
                    System.Runtime.InteropServices.Marshal.Copy(imageData.Bytes, bytes, 0, Convert.ToInt32(imageData.Length));
                    return bytes;
                }
            });
        }
    }
}

三、实现图片转PDF #

利用iOS的CoreGraphics将PNG转换为PDF文件：

1. Forms项目定义接口 #

public interface IPdfService
{
    Task<byte[]> ImageToPdfAsync(byte[] imageBytes);
}

2. iOS项目实现接口 #

[assembly: Dependency(typeof(iOSPdfService))]
namespace YourAppNamespace.iOS
{
    using CoreGraphics;
    using UIKit;
    using Foundation;

    public class iOSPdfService : IPdfService
    {
        public async Task<byte[]> ImageToPdfAsync(byte[] imageBytes)
        {
            return await Task.Run(() =>
            {
                var image = UIImage.LoadFromData(NSData.FromArray(imageBytes));
                var pdfData = new NSMutableData();
                var pdfConsumer = CGDataConsumer.CreateWithData(pdfData);
                
                var mediaBox = new CGRect(0, 0, image.Size.Width, image.Size.Height);
                var pdfContext = new CGContext(pdfConsumer, mediaBox, null);
                
                pdfContext.BeginPage(mediaBox);
                pdfContext.DrawImage(mediaBox, image.CGImage);
                pdfContext.EndPage();
                pdfContext.Flush();
                pdfContext.Dispose();
                
                var bytes = new byte[pdfData.Length];
                System.Runtime.InteropServices.Marshal.Copy(pdfData.Bytes, bytes, 0, Convert.ToInt32(pdfData.Length));
                return bytes;
            });
        }
    }
}

四、实现iOS打印功能 #

调用iOS原生UIPrintInteractionController完成打印：

1. Forms项目定义接口 #

public interface IPrintService
{
    Task PrintImageAsync(byte[] imageBytes);
    Task PrintPdfAsync(byte[] pdfBytes);
}

2. iOS项目实现接口 #

[assembly: Dependency(typeof(iOSPrintService))]
namespace YourAppNamespace.iOS
{
    using UIKit;
    using Foundation;

    public class iOSPrintService : IPrintService
    {
        public Task PrintImageAsync(byte[] imageBytes)
        {
            var tcs = new TaskCompletionSource<bool>();
            var printController = UIPrintInteractionController.SharedPrintController;
            
            if (!printController.CanPrint)
            {
                tcs.SetException(new InvalidOperationException("设备不支持打印"));
                return tcs.Task;
            }
            
            var image = UIImage.LoadFromData(NSData.FromArray(imageBytes));
            var printInfo = UIPrintInfo.PrintInfo;
            printInfo.OutputType = UIPrintInfoOutputType.Photo;
            printInfo.JobName = "身份卡片打印";
            
            printController.PrintInfo = printInfo;
            printController.PrintingItem = image;
            
            printController.Present(true, (controller, completed, error) =>
            {
                if (error != null)
                    tcs.SetException(error);
                else
                    tcs.SetResult(completed);
            });
            
            return tcs.Task;
        }

        public Task PrintPdfAsync(byte[] pdfBytes)
        {
            var tcs = new TaskCompletionSource<bool>();
            var printController = UIPrintInteractionController.SharedPrintController;
            
            if (!printController.CanPrint)
            {
                tcs.SetException(new InvalidOperationException("设备不支持打印"));
                return tcs.Task;
            }
            
            var pdfData = NSData.FromArray(pdfBytes);
            var printInfo = UIPrintInfo.PrintInfo;
            printInfo.OutputType = UIPrintInfoOutputType.General;
            printInfo.JobName = "身份卡片PDF打印";
            
            printController.PrintInfo = printInfo;
            printController.PrintingItem = pdfData;
            
            printController.Present(true, (controller, completed, error) =>
            {
                if (error != null)
                    tcs.SetException(error);
                else
                    tcs.SetResult(completed);
            });
            
            return tcs.Task;
        }
    }
}

五、整合所有功能（页面调用） #

在Forms页面的后台代码中添加打印按钮点击事件：

private async void OnPrintButtonClicked(object sender, EventArgs e)
{
    // 1. 捕获StackLayout为PNG
    var imageBytes = await DependencyService.Get<IScreenshotService>().CaptureViewAsync(PrintableStackLayout);
    
    // 选项1：直接打印图片
    await DependencyService.Get<IPrintService>().PrintImageAsync(imageBytes);
    
    // 选项2：转PDF后打印（注释掉上面一行，启用下面两行）
    //var pdfBytes = await DependencyService.Get<IPdfService>().ImageToPdfAsync(imageBytes);
    //await DependencyService.Get<IPrintService>().PrintPdfAsync(pdfBytes);
}

在XAML中添加打印按钮：

<Button Text="打印卡片" Clicked="OnPrintButtonClicked" Margin="20" HorizontalOptions="Center"/>

注意事项 #

1. 测试需使用真实iOS设备，模拟器打印功能受限
2. 确保iOS项目引用CoreGraphics、UIKit、Foundation命名空间
3. DrawViewHierarchy可完整捕获超出屏幕的StackLayout内容，无需担心截断

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