PrintDocumentAdapter

EXTRA_PRINT_PREVIEW

String EXTRA_PRINT_PREVIEW

Extra：如果当前布局用于打印预览，则映射为布尔值true ，否则为false 。 onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)回调的Bundle参数中提供了此额外信息。

常量值：“EXTRA_PRINT_PREVIEW”

PrintDocumentAdapter

PrintDocumentAdapter ()

onFinish

void onFinish ()

打印完成时调用。 您可以使用此回调释放onStart()获取的资源。 此方法在主线程上调用。

onLayout

void onLayout (PrintAttributes oldAttributes, 
                PrintAttributes newAttributes, 
                CancellationSignal cancellationSignal, 
                PrintDocumentAdapter.LayoutResultCallback callback, 
                Bundle extras)

当打印属性（页面大小，密度等）发生变化时会调用，使您有机会对内容进行布局，使其与新约束匹配。 此方法在主线程上调用。

完成布局之后，您必须调用： onLayoutFinished(PrintDocumentInfo, boolean) ，最后一个参数为true或false具体取决于布局是否分别更改了内容; 或者onLayoutFailed(CharSequence) ，如果发生错误; 或onLayoutCancelled()如果通过CancellationSignal的传递取消请求响应中取消CancellationSignal 。 请注意，您必须调用给定回调的其中一个方法，才能将此方法视为已完成，即在调用回调实例上的方法完成当前布局操作之前，您将不会收到对此适配器的任何调用。 回调方法可以从任意线程中调用。

传递给此方法的参数之一是CancellationSignal ，它用于将请求从系统传播到您的应用程序以取消当前的布局操作。 例如，如果用户在执行布局操作时更改可能影响布局的打印选项，则可能会要求取消。 在这种情况下，系统将尝试取消当前布局，因为必须执行另一个布局。 通常，您应该在取消信号中注册取消回拨。 取消回调不会在主线程中进行，并且可以按如下注册：

 cancellationSignal.setOnCancelListener(new OnCancelListener() {
     @Override
     public void onCancel() {
         // Cancel layout
     }
 });
 

注意：如果内容很大并且将执行布局，则最好在专用线程上安排工作并在提供的 CancellationSignal注册一个观察者，在调用该 CancellationSignal时应停止布局。

onStart

void onStart ()

打印开始时调用。 您可以使用此回调来分配资源。 此方法在主线程上调用。

onWrite

void onWrite (PageRange[] pages, 
                ParcelFileDescriptor destination, 
                CancellationSignal cancellationSignal, 
                PrintDocumentAdapter.WriteResultCallback callback)

当内容的特定页面应该以PDF文件的形式写入给定的文件描述符时调用。 此方法在主线程上调用。

onWriteFinished(PageRange[]) ，如果写入成功完成，应关闭文件描述符并调用onWriteFinished(PageRange[]) ; 或onWriteFailed(CharSequence) ，如果发生错误; 或者onWriteCancelled() ，如果通过在CancellationSignal传递的取消请求的回复取消CancellationSignal 。 请注意， 必须调用给定回调的其中一个方法，才能将此方法视为已完成，即在调用回调实例上的方法完成当前写入操作之前，您将不会收到对此适配器的任何调用。 回调方法可以从任意线程中调用。

传递给此方法的参数之一是CancellationSignal ，它用于将请求从系统传播到您的应用程序以取消当前写入操作。 例如，如果用户在执行写入操作时更改可能影响布局的打印选项，则可能会要求取消。 在这种情况下，系统将尝试取消当前的写入，因为必须执行布局，然后可以写入。 通常，您应该在取消信号中注册取消回拨。 取消回调不会在主线程中进行，并且可以按如下注册：

 cancellationSignal.setOnCancelListener(new OnCancelListener() {
     @Override
     public void onCancel() {
         // Cancel write
     }
 });
 

注意：如果打印的内容很大，最好将其编写在专用线程上，并在提供的 CancellationSignal注册一个观察者，然后您应该停止写入。