PrintDocumentAdapter Classe

Définition

[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

Héritage

Object

JavaObject

Object

PrintDocumentAdapter

Attributs

RegisterAttribute

Remarques

Classe de base qui fournit le contenu d’un document à imprimer.

<cycle de vie> h3</h3>

<ul><li> Initialement, vous recevrez un appel à #onStart(). Ce rappel peut être utilisé pour allouer des ressources. </li li><> Next, vous obtiendrez un ou plusieurs appels pour #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) vous informer que les attributs d’impression (taille de page, densité, etc.) vous donnent la possibilité de mettre en page le contenu en fonction des nouvelles contraintes. </li li><> Après chaque appel à #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle), vous <pouvez></fort> obtenir un appel pour vous demander d’écrire #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) un fichier PDF avec le contenu pour des pages spécifiques. </li li><> Enfin, vous recevrez un appel à #onFinish(). Vous pouvez utiliser ce rappel pour libérer les ressources allouées dans #onStart(). </li></ul>

Le #onStart() rappel est toujours le premier appel que vous recevrez et est utile pour effectuer une configuration ou une allocation de ressources ponctuelle avant l’impression. Vous ne recevrez pas d’appel ultérieur ici.

Le #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) rappel nécessite que vous layoutiez le contenu en fonction de l’état actuel PrintAttributes. L’exécution de cette méthode n’est pas considérée comme terminée tant que vous n’appelez pas l’une des méthodes sur l’instance de rappel passée. Par conséquent, vous ne recevrez pas d’appel ultérieur à une autre méthode de cette classe tant que l’exécution de cette méthode n’est pas terminée en appelant l’une des méthodes de rappel.

Vous #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) devez afficher et écrire le contenu de certaines pages dans la destination fournie. L’exécution de cette méthode n’est pas considérée comme terminée tant que vous n’appelez pas l’une des méthodes sur l’instance de rappel passée. Par conséquent, vous ne recevrez pas d’appel ultérieur à une autre méthode de cette classe tant que l’exécution de cette méthode n’est pas terminée en appelant l’une des méthodes de rappel. Vous ne recevrez jamais une séquence d’un ou plusieurs appels à cette méthode sans appel précédent à #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle).

Le #onFinish() rappel est toujours le dernier appel que vous recevrez et est utile pour effectuer un nettoyage ou une désallocation de ressources une fois après l’impression. Vous ne recevrez pas d’appel ultérieur ici.

<Implémentation> /p<>h3</h3>

Les API définies dans cette classe sont conçues pour permettre d’effectuer une partie ou l’ensemble du travail sur un thread arbitraire. Par exemple, si le contenu imprimé ne dépend pas de l’état de l’interface utilisateur, c’est-à-dire de ce qui est affiché à l’écran, vous pouvez décharger l’intégralité du travail sur un thread dédié, ce qui rend votre application interactive pendant que le travail d’impression est en cours d’exécution. Notez que si votre activité est couverte par l’interface utilisateur d’impression système et qu’un utilisateur ne peut pas interagir avec celui-ci, le travail d’impression sur le thread d’application principal peut affecter les performances de vos autres composants d’application, car ils sont également exécutés sur ce thread.

Vous pouvez également travailler sur différents threads, par exemple si vous imprimez du contenu de l’interface utilisateur, vous pouvez gérer #onStart() et #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) sur le thread d’interface utilisateur (en supposant que onStart initialise les ressources nécessaires pour la disposition). Cela garantit que l’interface utilisateur ne change pas pendant la disposition du contenu imprimé. Vous pouvez ensuite gérer #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) et #onFinish() sur un autre thread. Cela permet de s’assurer que le thread principal est occupé pendant une durée minimale. Cela suppose également que vous générerez le contenu imprimé dans #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) lequel il n’est pas obligatoire. Si vous utilisez plusieurs threads, vous êtes responsable de la synchronisation appropriée.

Java documentation pour android.print.PrintDocumentAdapter.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.