PrintManager.Print(String, PrintDocumentAdapter, PrintAttributes) Methode
Definition
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.
Erstellt einen Druckauftrag zum Drucken von Standarddruckattributen PrintDocumentAdapter .
[Android.Runtime.Register("print", "(Ljava/lang/String;Landroid/print/PrintDocumentAdapter;Landroid/print/PrintAttributes;)Landroid/print/PrintJob;", "")]
public Android.Print.PrintJob Print(string printJobName, Android.Print.PrintDocumentAdapter documentAdapter, Android.Print.PrintAttributes? attributes);[<Android.Runtime.Register("print", "(Ljava/lang/String;Landroid/print/PrintDocumentAdapter;Landroid/print/PrintAttributes;)Landroid/print/PrintJob;", "")>]
member this.Print : string * Android.Print.PrintDocumentAdapter * Android.Print.PrintAttributes -> Android.Print.PrintJobParameter
- printJobName
- String
Ein Name für den neuen Druckauftrag, der dem Benutzer angezeigt wird.
- documentAdapter
- PrintDocumentAdapter
Ein Adapter, der das Zu druckende Dokument ausgibt.
- attributes
- PrintAttributes
Die Standardattribute des Druckauftrags oder null.
Gibt zurück
Der erstellte Druckauftrag bei Erfolg oder NULL beim Fehler.
- Attribute
Ausnahmen
Wenn nicht von einem Activity.
Wenn der Name des Druckauftrags leer ist oder der Dokumentadapter null ist.
Hinweise
Erstellt einen Druckauftrag zum Drucken von Standarddruckattributen PrintDocumentAdapter .
Durch Aufrufen dieser Methode wird die Druck-UI verwendet, mit der der Benutzer den Druckauftrag anpassen und ein PrintJob Objekt zurückgibt, ohne darauf zu warten, dass der Benutzer den Druckauftrag anpassen oder bestätigen kann. Die zurückgegebene Druckauftragsinstanz befindet sich in einem PrintJobInfo#STATE_CREATED created Zustand.
Diese Methode kann nur aus einem Activity. Der Grund dafür ist, dass das Drucken aus einem Dienst eine inkonsistente Benutzeroberfläche erzeugt, da die Druckbenutzeroberfläche ohne Kontext angezeigt wird.
Auch die übergebene PrintDocumentAdapter Wird wird als ungültig betrachtet, wenn Ihre Aktivität abgeschlossen ist. Der Grund dafür ist, dass der bereitgestellte Adapter nach Abschluss des Druckvorgangs in einem inkonsistenten Zustand sein kann, da er von der benutzeroberfläche abhängig ist, die von der Aktivität dargestellt wird.
Die Standarddruckattribute sind ein Hinweis auf das System, wie die Daten gedruckt werden sollen. Beispielsweise kann ein Foto-Editor das Seitenverhältnis des Fotos betrachten, um die Standardausrichtung zu ermitteln und einen Hinweis bereitzustellen, ob sich der Druck im Hoch- oder Querformat befinden soll. Das System bemüht sich am besten, die angedeuteten Optionen im Druckdialogfeld auszuwählen, da der aktuelle Drucker sie unterstützt.
<strong>Note:</strong> Calling this method will bring the print dialog and the system will connect to the provided PrintDocumentAdapter. Wenn eine Konfigurationsänderung auftritt, die von Der Anwendung nicht verarbeitet wird, z. B. eine Drehungsänderung, wird die Verbindung mit dem Adapter vom System getrennt, da die Aktivität neu erstellt werden muss und der alte Adapter in diesem Kontext ungültig sein kann, daher ist eine neue Adapterinstanz erforderlich. Wenn Ihre Aktivität konfigurationsänderungen nicht verarbeitet (Standardverhalten), müssen Sie den Zustand speichern, den Sie drucken und diese Methode erneut aufrufen, wenn Ihre Aktivität neu erstellt wird.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.