PrintManager.Print(String, PrintDocumentAdapter, PrintAttributes) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un trabajo de impresión para imprimir con PrintDocumentAdapter atributos de impresión predeterminados.
[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.PrintJobParámetros
- printJobName
- String
Nombre del nuevo trabajo de impresión que se muestra al usuario.
- documentAdapter
- PrintDocumentAdapter
Adaptador que emite el documento que se va a imprimir.
- attributes
- PrintAttributes
Atributos de trabajo de impresión predeterminados o null.
Devoluciones
El trabajo de impresión creado con éxito o null en caso de error.
- Atributos
Excepciones
Si no se llama desde un Activity.
Si el nombre del trabajo de impresión está vacío o el adaptador de documento es NULL.
Comentarios
Crea un trabajo de impresión para imprimir con PrintDocumentAdapter atributos de impresión predeterminados.
Al llamar a este método, la interfaz de usuario de impresión permite al usuario personalizar el trabajo de impresión y devuelve un PrintJob objeto sin esperar a que el usuario personalice o confirme el trabajo de impresión. La instancia de trabajo de impresión devuelta está en un PrintJobInfo#STATE_CREATED created estado .
Solo se puede llamar a este método desde un Activity. La lógica es que la impresión desde un servicio creará una experiencia de usuario incoherente, ya que la interfaz de usuario de impresión aparecería sin ningún contexto.
Además, el pasado PrintDocumentAdapter se considerará no válido si la actividad ha finalizado. La justificación es que una vez finalizada la actividad que inició la impresión, el adaptador proporcionado puede estar en un estado incoherente, ya que puede depender de la interfaz de usuario presentada por la actividad.
Los atributos de impresión predeterminados son una sugerencia para el sistema de cómo se van a imprimir los datos. Por ejemplo, un editor de fotos puede mirar la relación de aspecto de la foto para determinar la orientación predeterminada y proporcionar una sugerencia de si la impresión debe estar en vertical o horizontal. El sistema realizará un mejor esfuerzo para seleccionar las opciones indicadas en el cuadro de diálogo de impresión, dado que la impresora actual las admite.
<strong>Note:</strong> Calling this method will bring the print dialog and the system will connect to the provided PrintDocumentAdapter. Si se produce un cambio de configuración que la aplicación no controla, por ejemplo, un cambio de rotación, el sistema quitará la conexión al adaptador, ya que la actividad debe volver a crearse y el adaptador antiguo puede no ser válido en este contexto, por lo que se requiere una nueva instancia de adaptador. Como consecuencia, si la actividad no controla los cambios de configuración (comportamiento predeterminado), debe guardar el estado que estaba imprimiendo y llamar a este método de nuevo cuando se vuelva a crear la actividad.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.