android.print

概述

提供在应用程序中实现打印支持的类，并且还包含打印中涉及的所有基类和抽象。 这些基类也被其他更专门的打印相关软件包使用。

与打印系统交互的入口点是PrintManager ，它是可以从当前上下文获得的系统服务。 打印管理器提供用于打印的API，查询打印作业的状态等。

Print contract

要实现打印的应用程序必须扩展PrintDocumentAdapter ，该应用程序定义了系统和应用程序之间的合同。此适配器背后的关键思想是，打印的内容可能会根据所选的打印选项（如介质大小，方向）进行更改，这需要内容将被重新布置。 内容必须根据哪些约束被封装在PrintAttributes类中。 布局完成后，应用程序回调系统，传递描述生成内容的PrintDocumentInfo实例。 内容布置完成后，可能会要求应用程序渲染该内容的某些页面以进行预览或打印。 必须呈现的页面范围由PageRange类提取。

Print jobs

打印作业由具有行为方法的PrintJob类表示，以及用于查询其状态的方法。 每个打印作业都有一个由PrintJobId类表示的唯一ID，并公开用于获取作为其状态快照的PrintJobInfo API。 打印作业状态可能随时间而改变。

Printers

由表示的可用的打印机PrinterInfo类有一个唯一的ID它是由抽象PrinterId类。 PrinterInfo包含封装在PrinterCapabilitiesInfo类中的打印机属性，例如id，名称，说明，状态和打印机功能。 打印机功能描述了打印机如何打印内容，例如支持的介质尺寸，色彩模式，分辨率等。

Classes

PageRange	代表一系列页面。
PrintAttributes	此类表示打印作业的属性。
PrintAttributes.Builder	用于创建 PrintAttributes生成器。
PrintAttributes.Margins	这个类指定了内容边距。
PrintAttributes.MediaSize	此类指定支持的媒体大小。
PrintAttributes.Resolution	此类指定DPI支持的分辨率（每英寸点数）。
PrintDocumentAdapter	提供要打印的文档内容的基类。
PrintDocumentAdapter.LayoutResultCallback	用于实现 onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)结果回调的基类。
PrintDocumentAdapter.WriteResultCallback	用于实现 onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback)结果回调的基类。
PrintDocumentInfo	该类为了打印目的封装了关于文档的信息。
PrintDocumentInfo.Builder	用于创建 PrintDocumentInfo生成器。
PrinterCapabilitiesInfo	该类表示打印机的功能。
PrinterCapabilitiesInfo.Builder	用于创建 PrinterCapabilitiesInfo生成器。
PrinterId	此类表示打印机的唯一ID。
PrinterInfo	这个类表示打印机的描述。
PrinterInfo.Builder	用于创建 PrinterInfo生成器。
PrintJob	这个类从应用程序的角度来表示一个打印作业。
PrintJobId	此类表示打印作业的ID。
PrintJobInfo	这个类表示打印作业的描述。
PrintJobInfo.Builder	用于创建 PrintJobInfo生成器。
PrintManager	用于访问平台打印功能的系统级服务。