PrintDocumentAdapter Classe

Definição

[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

Herança

Object

JavaObject

Object

PrintDocumentAdapter

Atributos

RegisterAttribute

Comentários

Classe base que fornece o conteúdo de um documento a ser impresso.

<h3>Ciclo< de vida/h3>

< > <ul li> Inicialmente, você receberá uma chamada para #onStart(). Esse retorno de chamada pode ser usado para alocar recursos. </li><li> Em seguida, você receberá uma ou mais chamadas para #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) informar que os atributos de impressão (tamanho da página, densidade etc.) foram alterados, dando a você a oportunidade de fazer o layout do conteúdo para corresponder às novas restrições. </li><li> Depois de cada chamada para #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle), você <pode>< receber> uma ligação solicitando #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) que você escreva um arquivo PDF com o conteúdo de páginas específicas. </li><li> Por fim, você receberá uma chamada para #onFinish(). Você pode usar esse retorno de chamada para liberar recursos alocados no #onStart(). </li></ul>

O #onStart() retorno de chamada é sempre a primeira chamada que você receberá e é útil para fazer uma configuração única ou alocação de recursos antes de imprimir. Você não receberá uma chamada subsequente aqui.

O #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) retorno de chamada requer que você faça o layout do conteúdo com base no arquivo .PrintAttributes A execução desse método não é considerada concluída até que você invoque um dos métodos na instância de retorno de chamada passada. Portanto, você não receberá uma chamada subsequente para nenhum outro método dessa classe até que a execução desse método seja concluída invocando um dos métodos de retorno de chamada.

O #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) requer que você renderize e grave o conteúdo de algumas páginas no destino fornecido. A execução desse método não é considerada concluída até que você chame um dos métodos na instância de retorno de chamada passada. Portanto, você não receberá uma chamada subsequente para nenhum outro método dessa classe até que a execução desse método seja concluída invocando um dos métodos de retorno de chamada. Você nunca receberá uma seqüência de uma ou mais chamadas para esse método sem uma chamada anterior para #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle).

O #onFinish() retorno de chamada é sempre a última chamada que você receberá e é útil para fazer uma limpeza única ou desalocação de recursos após a impressão. Você não receberá uma chamada subsequente aqui.

</p><h3>Implementação</h3>

As APIs definidas nesta classe são projetadas para permitir a execução de parte ou de todo o trabalho em um thread arbitrário. Por exemplo, se o conteúdo impresso não depender do estado da interface do usuário, ou seja, do que é mostrado na tela, você poderá descarregar todo o trabalho em um thread dedicado, tornando seu aplicativo interativo enquanto o trabalho de impressão está sendo executado. Observe que, embora sua atividade seja coberta pela interface do usuário de impressão do sistema e um usuário não possa interagir com ela, fazer o trabalho de impressão no thread principal do aplicativo pode afetar o desempenho de seus outros componentes do aplicativo, pois eles também são executados nesse thread.

Você também pode trabalhar em threads diferentes, por exemplo, se você imprimir o conteúdo da interface do usuário, poderá manipular #onStart() e #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) no thread da interface do usuário (supondo que onStart inicialize os recursos necessários para o layout). Isso garantirá que a interface do usuário não seja alterada enquanto você estiver definindo o layout do conteúdo impresso. Então você pode lidar com #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) e #onFinish() em outro tópico. Isso garantirá que o thread principal esteja ocupado por um período mínimo de tempo. Além disso, isso pressupõe que você gerará o conteúdo impresso no #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) qual não é obrigatório. Se você usar vários threads, será responsável pela sincronização adequada.

Documentação Java para android.print.PrintDocumentAdapter.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.