PrintManager

public final class PrintManager
extends Object

用于访问平台打印功能的系统级服务。

要获得打印管理器的句柄，请执行以下操作：

 PrintManager printManager =
         (PrintManager) context.getSystemService(Context.PRINT_SERVICE);
 

Print mechanics

在平台上打印的关键思想是，要打印的内容应该针对当前选定的打印选项进行布局，从而实现优化的输出和更高的用户满意度。 为了实现这个目标，平台宣布打印应用程序必须遵循的由PrintDocumentAdapter类定义的PrintDocumentAdapter 。 在更高层次上，合同是当用户从打印用户界面中选择一些可能影响内容布局方式的选项时（例如页面大小），应用程序会收到一个回调，允许其对内容进行布局以更好地适应这些新约束。 布局通过后，系统可能会要求应用程序一次或多次渲染一个或多个页面。 例如，应用程序可能会生成较小页面大小的单列列表和较大页面大小的多列表格。

Print jobs

通过调用print(String, PrintDocumentAdapter, PrintAttributes)来启动打印作业，这会导致系统打印UI。 一旦打印用户界面启动，当用户更改选定的打印选项时，会影响内容布局的方式，系统会按照上面介绍的机制开始与应用程序交互。

打印作业可以在created ， queued ， started ， blocked ， completed ， failed ，并canceled状态。 打印作业存储在专用系统假脱机程序中，直至它们被取消或完成处理。 如果设备重新启动，活动的打印作业（未被取消或完成的作业）被视为失败，因为新的启动可能会持续很长时间。 用户可以选择重新启动这样的打印作业。 一旦打印作业排队，所有相关内容都存储在系统假脱机程序中，并且其生命周期与创建它的应用程序的生命周期分离。

应用程序可以向打印后台处理程序查询其创建的当前打印作业，但不打印其他应用程序创建的作业。

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者其他某个线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public methods

List<PrintJob> getPrintJobs ()

PrintJob print (String printJobName, 
                PrintDocumentAdapter documentAdapter, 
                PrintAttributes attributes)