PrintManager.Print(String, PrintDocumentAdapter, PrintAttributes) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea un processo di stampa per la stampa di un PrintDocumentAdapter oggetto con attributi di stampa predefiniti.
[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.PrintJobParametri
- printJobName
- String
Nome del nuovo processo di stampa visualizzato all'utente.
- documentAdapter
- PrintDocumentAdapter
Adattatore che genera il documento da stampare.
- attributes
- PrintAttributes
Attributi predefiniti del processo di stampa o null.
Valori restituiti
Processo di stampa creato in caso di esito positivo o null in caso di errore.
- Attributi
Eccezioni
Se non viene chiamato da un oggetto Activity.
Se il nome del processo di stampa è vuoto o l'adattatore di documenti è Null.
Commenti
Crea un processo di stampa per la stampa di un PrintDocumentAdapter oggetto con attributi di stampa predefiniti.
Chiamando questo metodo viene visualizzata l'interfaccia utente di stampa che consente all'utente di personalizzare il processo di stampa e restituisce un PrintJob oggetto senza attendere che l'utente personalizza o conferma il processo di stampa. L'istanza del processo di stampa restituita è in PrintJobInfo#STATE_CREATED created uno stato.
Questo metodo può essere chiamato solo da un oggetto Activity. La logica è che la stampa da un servizio creerà un'esperienza utente incoerente perché l'interfaccia utente di stampa verrebbe visualizzata senza alcun contesto.
Inoltre, l'oggetto passato PrintDocumentAdapter verrà considerato non valido se l'attività è terminata. La logica è che al termine dell'attività che ha avviato la stampa, l'adattatore fornito potrebbe trovarsi in uno stato incoerente, in quanto può dipendere dall'interfaccia utente presentata dall'attività.
Gli attributi di stampa predefiniti sono un suggerimento per il sistema in cui devono essere stampati i dati. Ad esempio, un editor di foto può esaminare le proporzioni delle foto per determinare l'orientamento predefinito e fornire un suggerimento se la stampa deve essere in verticale o orizzontale. Il sistema farà il massimo sforzo per selezionare le opzioni con hint nella finestra di dialogo di stampa, dato che la stampante corrente le supporta.
<nota forte>:/strong> La chiamata a questo metodo porterà la finestra di dialogo di stampa e il sistema si connetterà all'oggetto fornitoPrintDocumentAdapter<. Se si verifica una modifica di configurazione che non gestisce l'applicazione, ad esempio una modifica di rotazione, il sistema elimina la connessione all'adattatore perché l'attività deve essere ricreata e l'adattatore precedente potrebbe non essere valido in questo contesto, pertanto è necessaria una nuova istanza della scheda. Di conseguenza, se l'attività non gestisce le modifiche di configurazione (comportamento predefinito), è necessario salvare lo stato che si stava stampando e chiamare di nuovo questo metodo quando l'attività viene ricreata.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.