PrintDocumentAdapter 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供要打印的文档内容的基类。
[Android.Runtime.Register("android/print/PrintDocumentAdapter", DoNotGenerateAcw=true)]
public abstract class PrintDocumentAdapter : Java.Lang.Object[<Android.Runtime.Register("android/print/PrintDocumentAdapter", DoNotGenerateAcw=true)>]
type PrintDocumentAdapter = class
inherit Object- 继承
- 属性
注解
提供要打印的文档内容的基类。
<h3>生命周期</h3>
<ul><li> Initially， you will receive a call to #onStart(). 此回调可用于分配资源。 </li li><> Next， you will get one or more calls to #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) inform you that the print attributes （page size， density， etc） changed that you a opportunity to layout the content to match the new constraints. </li li><> 在每次呼叫#onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)后，你<强>可能会</强>接到电话，#onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback)要求你编写 PDF 文件，其中包含特定页面的内容。 </li li><> 最后，你将收到一#onFinish()个来电。 可以使用此回调释放分配的资源 #onStart()。 </li></ul>
回调 #onStart() 始终是你收到的第一次调用，在打印之前执行一次设置或资源分配非常有用。 你不会在此处收到后续呼叫。
回调 #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) 要求你根据当前 PrintAttributes内容布局。 在调用传入的回调实例上的方法之一之前，此方法的执行不会被视为已完成。 因此，在调用其中一个回调方法来完成此方法的执行之前，将不会收到对此类的任何其他方法的后续调用。
需要 #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) 将某些页面的内容呈现并写入到提供的目标。 在调用传入回调实例上的方法之一之前，此方法的执行不会被视为已完成。 因此，在调用其中一个回调方法来完成此方法的执行之前，将不会收到对此类的任何其他方法的后续调用。 你永远不会收到对此方法的一个或多个调用的序列，而无需之前调用 #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)此方法。
回调 #onFinish() 始终是你收到的最后一次调用，在打印后执行一次清理或资源解除分配非常有用。 你不会在此处收到后续呼叫。
</p><h3>实现</h3>
此类中定义的 API 旨在允许在任意线程上执行部分或全部工作。 例如，如果打印内容不依赖于 UI 状态，即在屏幕上显示的内容，则可以在专用线程上卸载整个工作，从而在执行打印工作时使应用程序具有交互性。 请注意，当系统打印 UI 涵盖你的活动并且用户无法与之交互时，在主应用程序线程上执行打印工作可能会影响其他应用程序组件的性能，因为它们也在该线程上执行。
还可以在不同的线程上执行工作，例如，如果打印 UI 内容，则可以处理 #onStart() UI 线程，并在 #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) UI 线程上（假设 onStart 初始化布局所需的资源）。 这将确保在布局打印内容时 UI 不会更改。 然后，可以处理 #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) 另 #onFinish() 一个线程。 这将确保主线程在最少时间内处于繁忙状态。 此外，还假定你将生成不强制的 #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) 打印内容。 如果使用多个线程，则负责正确同步。
适用于 . 的 android.print.PrintDocumentAdapterJava 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
| PrintDocumentAdapter() | |
| PrintDocumentAdapter(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
字段
| ExtraPrintPreview |
额外：映射到一个布尔值，即 |
属性
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
提供要打印的文档内容的基类。 (继承自 Object) |
| JniPeerMembers |
提供要打印的文档内容的基类。 |
| PeerReference |
提供要打印的文档内容的基类。 (继承自 Object) |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
方法
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| Dispose() |
提供要打印的文档内容的基类。 (继承自 Object) |
| Dispose(Boolean) |
提供要打印的文档内容的基类。 (继承自 Object) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| JavaFinalize() |
当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| OnFinish() |
打印完成后调用。 |
| OnLayout(PrintAttributes, PrintAttributes, CancellationSignal, PrintDocumentAdapter+LayoutResultCallback, Bundle) |
当打印属性（页面大小、密度等）发生更改时调用，使你有机会布局内容，使其与新约束匹配。 |
| OnStart() |
打印开始时调用。 |
| OnWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, PrintDocumentAdapter+WriteResultCallback) |
当内容的特定页面应以 PDF 文件的形式写入给定文件描述符时调用。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| ToArray<T>() |
提供要打印的文档内容的基类。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
提供要打印的文档内容的基类。 (继承自 Object) |
| Wait() |
使当前线程等待，直到唤醒它，通常是通过 em 通知/em> 或 <em>interrupted</em>。<>< (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| IJavaPeerable.Disposed() |
提供要打印的文档内容的基类。 (继承自 Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
提供要打印的文档内容的基类。 (继承自 Object) |
| IJavaPeerable.Finalized() |
提供要打印的文档内容的基类。 (继承自 Object) |
| IJavaPeerable.JniManagedPeerState |
提供要打印的文档内容的基类。 (继承自 Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
提供要打印的文档内容的基类。 (继承自 Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
提供要打印的文档内容的基类。 (继承自 Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
提供要打印的文档内容的基类。 (继承自 Object) |
扩展方法
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
提供要打印的文档内容的基类。 |
| GetJniTypeName(IJavaPeerable) |
提供要打印的文档内容的基类。 |