PrintManager.Print(String, PrintDocumentAdapter, PrintAttributes) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria um trabalho de impressão para imprimir um PrintDocumentAdapter com atributos de impressão padrão.
[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
Um nome para o novo trabalho de impressão que é mostrado ao usuário.
- documentAdapter
- PrintDocumentAdapter
Um adaptador que emite o documento para imprimir.
- attributes
- PrintAttributes
Os atributos de trabalho de impressão padrão ou null.
Retornos
O trabalho de impressão criado com êxito ou nulo na falha.
- Atributos
Exceções
Se não for chamado de um Activity.
Se o nome do trabalho de impressão estiver vazio ou o adaptador de documento for nulo.
Comentários
Cria um trabalho de impressão para imprimir um PrintDocumentAdapter com atributos de impressão padrão.
Chamar esse método traz a interface do usuário de impressão permitindo que o usuário personalize o trabalho de impressão e retorna um PrintJob objeto sem esperar que o usuário personalize ou confirme o trabalho de impressão. A instância de trabalho de impressão retornada está em um PrintJobInfo#STATE_CREATED created estado.
Esse método só pode ser chamado de um Activity. A lógica é que a impressão de um serviço criará uma experiência de usuário inconsistente, pois a interface do usuário de impressão aparecerá sem nenhum contexto.
Além disso, a passagem PrintDocumentAdapter será considerada inválida se sua atividade for concluída. A lógica é que, depois que a atividade que iniciou a impressão for concluída, o adaptador fornecido poderá estar em um estado inconsistente, pois pode depender da interface do usuário apresentada pela atividade.
Os atributos de impressão padrão são uma dica para o sistema como os dados devem ser impressos. Por exemplo, um editor de fotos pode examinar a taxa de proporção de fotos para determinar a orientação padrão e fornecer uma dica se a impressão deve estar em retrato ou paisagem. O sistema fará um esforço melhor para selecionar as opções sugeridas na caixa de diálogo de impressão, dado que a impressora atual dá suporte a elas.
<Observação forte>:</a chamada forte> desse método trará a caixa de diálogo de impressão e o sistema se conectará ao fornecido PrintDocumentAdapter. Se ocorrer uma alteração de configuração que o aplicativo não manipula, por exemplo, uma alteração de rotação, o sistema removerá a conexão com o adaptador, pois a atividade deve ser recriada e o adaptador antigo pode ser inválido nesse contexto, portanto, uma nova instância do adaptador é necessária. Como consequência, se sua atividade não tratar alterações de configuração (comportamento padrão), você precisará salvar o estado que estava imprimindo e chamar esse método novamente quando sua atividade for recriada.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.