NSHipster项目解析：深入理解UIPrintInteractionController

2025-06-06 02:24:00作者：姚月梅Lane

在移动设备上，打印功能可能不是最引人注目的特性，但在某些场景下却非常实用。UIKit框架提供了UIPrintInteractionController类，让开发者能够轻松地在iOS应用中实现打印功能。本文将全面解析这个强大的打印API，帮助你掌握在iOS应用中实现高质量打印输出的技巧。

打印基础概念

打印工作流程

在iOS中，打印工作主要涉及三个核心组件：

UIPrintInteractionController：打印交互控制器，管理打印任务和用户界面
UIPrintInfo：包含打印任务的元数据（如作业名称、方向等）
内容格式化器：决定如何将内容呈现到纸张上

准备工作

在开始编码前，开发者需要：

确保项目已导入UIKit框架
了解要打印内容的类型（图片、PDF、HTML或自定义视图）
考虑打印输出的布局需求

配置打印任务

UIPrintInfo详解

UIPrintInfo是打印任务的核心配置对象，包含以下重要属性：

let printInfo = UIPrintInfo.printInfo()
printInfo.jobName = "我的文档"  // 打印任务名称
printInfo.outputType = .general  // 输出类型
printInfo.orientation = .portrait  // 打印方向
printInfo.duplex = .longEdge  // 双面打印设置

输出类型选项：

.general：通用类型（混合文本和图形）
.grayscale：灰度打印
.photo：照片打印（禁用双面打印）
.photoGrayscale：灰度照片打印

打印机交互控制器设置

UIPrintInteractionController提供了一些实用配置选项：

let printController = UIPrintInteractionController.shared
printController.printInfo = printInfo
printController.showsNumberOfCopies = true  // 显示份数选择
printController.showsPageRange = true  // 显示页码范围选择

内容格式化策略

UIKit提供了三种不同级别的打印内容控制方式，开发者可以根据需求选择适合的方案。

1. 直接打印已有内容

最简单的打印方式是使用printingItem或printingItems属性，适用于已经格式化的内容（如图片或PDF）。

if let image = UIImage(named: "recipe") {
    printController.printingItem = image
}

适用场景：

打印单张图片
打印PDF文档
不需要额外格式化的内容

2. 使用打印格式化器

对于需要基本格式化的内容，可以使用UIPrintFormatter及其子类：

UISimpleTextPrintFormatter：简单文本格式化
UIMarkupTextPrintFormatter：HTML内容格式化
UIViewPrintFormatter：特定视图的格式化（UITextView、UIWebView、MKMapView）

示例：打印HTML内容

let htmlString = "<h1>食谱</h1><p>这是美味的食谱内容...</p>"
let formatter = UIMarkupTextPrintFormatter(markupText: htmlString)
formatter.perPageContentInsets = UIEdgeInsets(top: 72, left: 72, bottom: 72, right: 72)  // 1英寸边距
printController.printFormatter = formatter

3. 自定义页面渲染器

对于需要完全控制打印布局的场景，可以创建UIPrintPageRenderer的子类：

class CustomPrintRenderer: UIPrintPageRenderer {
    override func drawHeaderForPage(at pageIndex: Int, in headerRect: CGRect) {
        // 自定义页眉绘制代码
    }
    
    override func drawContentForPage(at pageIndex: Int, in contentRect: CGRect) {
        // 自定义内容绘制代码
    }
    
    override func drawFooterForPage(at pageIndex: Int, in footerRect: CGRect) {
        // 自定义页脚绘制代码
    }
}

关键方法：

numberOfPages：返回总页数
drawPage(at:in:)：绘制特定页面
prepare(forDrawingPages:)：准备绘制页面范围

高级技巧与实践

处理多页内容

当打印内容可能跨越多页时，需要考虑：

分页逻辑
页眉页脚的一致性
页面编号

打印预览优化

虽然UIKit自动处理预览生成，但开发者可以通过以下方式优化体验：

提供清晰的打印任务名称
设置合适的默认打印选项
确保预览内容与实际打印结果一致

错误处理

完善的打印功能应该包含错误处理：

printController.present(animated: true) { (controller, completed, error) in
    if let error = error {
        print("打印失败: \(error.localizedDescription)")
    }
}

实际应用示例

让我们看一个完整的食谱打印示例，结合了自定义页眉和内容布局：

class RecipePrintRenderer: UIPrintPageRenderer {
    let recipe: Recipe
    
    init(recipe: Recipe) {
        self.recipe = recipe
        super.init()
        
        self.headerHeight = 36  // 页眉高度
        self.footerHeight = 36  // 页脚高度
        
        // 添加HTML内容格式化器
        let htmlFormatter = UIMarkupTextPrintFormatter(markupText: recipe.htmlContent)
        addPrintFormatter(htmlFormatter, startingAtPageAt: 0)
    }
    
    override func drawHeaderForPage(at pageIndex: Int, in headerRect: CGRect) {
        let title = recipe.title as NSString
        title.draw(at: headerRect.origin, withAttributes: [
            .font: UIFont.boldSystemFont(ofSize: 14),
            .foregroundColor: UIColor.black
        ])
    }
    
    override func drawFooterForPage(at pageIndex: Int, in footerRect: CGRect) {
        let pageNumber = "第 \(pageIndex + 1) 页" as NSString
        let size = pageNumber.size(withAttributes: [.font: UIFont.systemFont(ofSize: 12)])
        let point = CGPoint(x: footerRect.midX - size.width/2, y: footerRect.origin.y)
        pageNumber.draw(at: point, withAttributes: [.font: UIFont.systemFont(ofSize: 12)])
    }
}