PrintDocumentAdapter Clase

Definición

[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

Herencia

Object

Object

PrintDocumentAdapter

Atributos

RegisterAttribute

Comentarios

Clase base que proporciona el contenido de un documento que se va a imprimir.

<h3>Lifecycle</h3>

<ul><li> Inicialmente, recibirá una llamada a #onStart(). Esta devolución de llamada se puede usar para asignar recursos. </li li><> Siguiente, recibirá una o varias llamadas para #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) informarle de que los atributos de impresión (tamaño de página, densidad, etc.) han cambiado, lo que le da la oportunidad de diseñar el contenido para que coincida con las nuevas restricciones. </li li><> Después de cada llamada a #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle), es<> posible</fuerte> obtener una llamada para #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) pedirle que escriba un archivo PDF con el contenido de páginas específicas. </li li><> Por último, recibirá una llamada a .#onFinish() Puede usar esta devolución de llamada para liberar los recursos asignados en #onStart(). </li></ul>

La #onStart() devolución de llamada siempre es la primera llamada que recibirá y es útil para realizar una configuración o asignación de recursos una vez antes de imprimir. No recibirá una llamada posterior aquí.

La #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) devolución de llamada requiere que se diseño el contenido en función del objeto actual PrintAttributes. La ejecución de este método no se considera completada hasta que se invoca uno de los métodos en la instancia de devolución de llamada pasada. Por lo tanto, no recibirá una llamada posterior a ningún otro método de esta clase hasta que se complete la ejecución de este método invocando uno de los métodos de devolución de llamada.

#onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) requiere que represente y escriba el contenido de algunas páginas en el destino proporcionado. La ejecución de este método no se considera completa hasta que se invoca uno de los métodos de la instancia de devolución de llamada pasada. Por lo tanto, no recibirá una llamada posterior a ningún otro método de esta clase hasta que se complete la ejecución de este método invocando uno de los métodos de devolución de llamada. Nunca recibirá una secuencia de una o varias llamadas a este método sin una llamada anterior a #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle).

La #onFinish() devolución de llamada siempre es la última llamada que recibirá y es útil para realizar una limpieza o desasignación de recursos una vez después de la impresión. No recibirá una llamada posterior aquí.

</p><h3>Implementation</h3>

Las API definidas en esta clase están diseñadas para habilitar la realización de parte o todo el trabajo en un subproceso arbitrario. Por ejemplo, si el contenido impreso no depende del estado de la interfaz de usuario, es decir, en lo que se muestra en la pantalla, puede descargar todo el trabajo en un subproceso dedicado, lo que hace que la aplicación sea interactiva mientras se realiza el trabajo de impresión. Tenga en cuenta que, aunque la actividad está cubierta por la interfaz de usuario de impresión del sistema y un usuario no puede interactuar con ella, realizar el trabajo de impresión en el subproceso de aplicación principal puede afectar al rendimiento de los otros componentes de la aplicación, ya que también se ejecutan en ese subproceso.

También puede trabajar en diferentes subprocesos, por ejemplo, si imprime contenido de la interfaz de usuario, puede controlar #onStart() y #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) en el subproceso de la interfaz de usuario (suponiendo que onStart inicializa los recursos necesarios para el diseño). Esto garantizará que la interfaz de usuario no cambie mientras se está estableciendo el contenido impreso. A continuación, puede controlar #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) y #onFinish() en otro subproceso. Esto garantizará que el subproceso principal esté ocupado durante un período mínimo de tiempo. También se supone que generará el contenido impreso en #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) el que no es obligatorio. Si usa varios subprocesos, es responsable de la sincronización adecuada.

Java documentación para android.print.PrintDocumentAdapter.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.