PrintDocumentAdapter Classe

Référence

Définition

Espace de noms:: Android.Print

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

[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

Object
PrintDocumentAdapter

Attributs: RegisterAttribute

Remarques

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

<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.

Documentation Java pour android.print.PrintDocumentAdapter.

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

Constructeurs

PrintDocumentAdapter()
PrintDocumentAdapter(IntPtr, JniHandleOwnership)	Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime.

Champs

ExtraPrintPreview

Extra : mappé à une valeur booléenne qui correspond true à la disposition actuelle pour un aperçu avant impression, false sinon.

Propriétés

Class	Retourne la classe runtime de ce `Object`. (Hérité de Object)
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
JniIdentityHashCode	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
JniPeerMembers	Classe de base qui fournit le contenu d’un document à imprimer.
PeerReference	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

Méthodes

Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
Dispose()	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
Dispose(Boolean)	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetHashCode()	Retourne une valeur de code de hachage pour l'objet. (Hérité de Object)
JavaFinalize()	Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
OnFinish()	Appelé à la fin de l’impression.
OnLayout(PrintAttributes, PrintAttributes, CancellationSignal, PrintDocumentAdapter+LayoutResultCallback, Bundle)	Appelé lorsque les attributs d’impression (taille de page, densité, etc.) ont changé en vous donnant la possibilité de mettre en page le contenu afin qu’il corresponde aux nouvelles contraintes.
OnStart()	Appelé au démarrage de l’impression.
OnWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, PrintDocumentAdapter+WriteResultCallback)	Appelé lorsque des pages spécifiques du contenu doivent être écrites sous la forme d’un fichier PDF dans le descripteur de fichier donné.
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
ToArray<T>()	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
ToString()	Retourne une représentation de chaîne de l'objet. (Hérité de Object)
UnregisterFromRuntime()	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)

Implémentations d’interfaces explicites

IJavaPeerable.Disposed()	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
IJavaPeerable.DisposeUnlessReferenced()	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
IJavaPeerable.Finalized()	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
IJavaPeerable.JniManagedPeerState	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Classe de base qui fournit le contenu d’un document à imprimer. (Hérité de Object)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Classe de base qui fournit le contenu d’un document à imprimer.
GetJniTypeName(IJavaPeerable)	Classe de base qui fournit le contenu d’un document à imprimer.

S’applique à

Partager via