PrintDocumentAdapter Klasse

Referenz

Definition

Namespace:: Android.Print

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt.

[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

Vererbung: Object

Object
PrintDocumentAdapter

Attribute: RegisterAttribute

Hinweise

Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt.

<h3>Lifecycle</h3>

<ul><li> Anfänglich erhalten Sie einen Anruf an #onStart(). Dieser Rückruf kann zum Zuordnen von Ressourcen verwendet werden. </li li><> Weiter erhalten Sie einen oder mehrere Aufrufe, um Sie darüber zu #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) informieren, dass die Druckattribute (Seitengröße, Dichte usw.) geändert wurden, sodass Sie die Möglichkeit haben, den Inhalt so zu layouten, dass sie den neuen Einschränkungen entsprechen. </li li><> Nach jedem Aufruf #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)erhalten Sie <möglicherweise<>/stark> einen Aufruf, um Sie aufzufordern#onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback), eine PDF-Datei mit dem Inhalt für bestimmte Seiten zu schreiben. </li li><> Schließlich erhalten Sie einen Anruf an .#onFinish() Sie können diesen Rückruf verwenden, um zugeordnete #onStart()Ressourcen freizugeben. </li></ul>

Der #onStart() Rückruf ist immer der erste Anruf, den Sie erhalten, und ist nützlich für die einmalige Einrichtung oder Ressourcenzuordnung vor dem Drucken. Hier erhalten Sie keinen nachfolgenden Anruf.

Der #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) Rückruf erfordert, dass Sie den Inhalt basierend auf dem aktuellen PrintAttributeslayouten. Die Ausführung dieser Methode gilt erst als abgeschlossen, wenn Sie eine der Methoden für die übergebene Rückrufinstanz aufrufen. Daher erhalten Sie keinen nachfolgenden Aufruf an eine andere Methode dieser Klasse, bis die Ausführung dieser Methode abgeschlossen ist, indem Sie eine der Rückrufmethoden aufrufen.

Dies #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) erfordert, dass Sie den Inhalt einiger Seiten an das angegebene Ziel rendern und schreiben. Die Ausführung dieser Methode gilt erst als abgeschlossen, wenn Sie eine der Methoden für die übergebene Rückrufinstanz aufrufen. Daher erhalten Sie keinen nachfolgenden Aufruf an eine andere Methode dieser Klasse, bis die Ausführung dieser Methode abgeschlossen ist, indem Sie eine der Rückrufmethoden aufrufen. Sie erhalten niemals eine Sequenz von mindestens einem Aufruf dieser Methode ohne vorherigen Aufruf von #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle).

Der #onFinish() Rückruf ist immer der letzte Aufruf, den Sie erhalten, und ist nützlich, um nach dem Drucken eine einmalige Bereinigung oder Ressourcenumsetzung durchzuführen. Hier erhalten Sie keinen nachfolgenden Anruf.

</p><h3>Implementierung</h3>

Die in dieser Klasse definierten APIs sind so konzipiert, dass sie das Ausführen eines Teils oder aller Arbeiten an einem beliebigen Thread ermöglichen. Wenn der gedruckte Inhalt z. B. nicht vom UI-Zustand abhängig ist, d. h. von dem, was auf dem Bildschirm angezeigt wird, können Sie die gesamte Arbeit an einem dedizierten Thread auslagern und so ihre Anwendung interaktiv machen, während die Druckarbeit ausgeführt wird. Beachten Sie, dass ihre Aktivität zwar von der Systemdruckbenutzeroberfläche abgedeckt wird und ein Benutzer nicht damit interagieren kann, während die Druckvorgänge im Hauptanwendungsthread die Leistung Ihrer anderen Anwendungskomponenten beeinträchtigen können, da sie auch in diesem Thread ausgeführt werden.

Sie können auch an verschiedenen Threads arbeiten, z. B. wenn Sie UI-Inhalte drucken, können Sie den UI-Thread verarbeiten #onStart() und #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) verwenden (vorausgesetzt, dass "onStart" Ressourcen initialisiert, die für das Layout erforderlich sind). Dadurch wird sichergestellt, dass sich die Benutzeroberfläche nicht ändert, während Sie den gedruckten Inhalt gestalten. Anschließend können Sie einen anderen Thread behandeln #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) und #onFinish() bearbeiten. Dadurch wird sichergestellt, dass der Hauptthread für einen minimalen Zeitraum ausgelastet ist. Außerdem wird davon ausgegangen, dass Sie den gedruckten Inhalt generieren, in #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) dem es nicht zwingend erforderlich ist. Wenn Sie mehrere Threads verwenden, sind Sie für die ordnungsgemäße Synchronisierung verantwortlich.

Java-Dokumentation für android.print.PrintDocumentAdapter.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

PrintDocumentAdapter()
PrintDocumentAdapter(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.

Felder

ExtraPrintPreview

Extra: Wird einem booleschen Wert zugeordnet, der angibt true , ob das aktuelle Layout für eine Druckvorschau vorgesehen ist, false andernfalls.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
JniIdentityHashCode	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
JniPeerMembers	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt.
PeerReference	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Dispose()	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
Dispose(Boolean)	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
OnFinish()	Wird beim Drucken aufgerufen.
OnLayout(PrintAttributes, PrintAttributes, CancellationSignal, PrintDocumentAdapter+LayoutResultCallback, Bundle)	Wird aufgerufen, wenn sich die Druckattribute (Seitengröße, Dichte usw.) geändert haben, sodass Sie die Möglichkeit haben, den Inhalt so zu layouten, dass sie den neuen Einschränkungen entspricht.
OnStart()	Wird beim Drucken aufgerufen.
OnWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, PrintDocumentAdapter+WriteResultCallback)	Wird aufgerufen, wenn bestimmte Seiten des Inhalts in Form einer PDF-Datei in die angegebene Dateibeschreibung geschrieben werden sollen.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
ToArray<T>()	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
IJavaPeerable.Finalized()	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt.
GetJniTypeName(IJavaPeerable)	Basisklasse, die den Inhalt eines zu druckende Dokuments bereitstellt.

Gilt für:

Freigeben über