PrintManager.Print(String, PrintDocumentAdapter, PrintAttributes) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un travail d’impression pour l’impression d’un PrintDocumentAdapter avec des attributs d’impression par défaut.
[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.PrintJobParamètres
- printJobName
- String
Nom du nouveau travail d’impression affiché à l’utilisateur.
- documentAdapter
- PrintDocumentAdapter
Adaptateur qui émet le document à imprimer.
- attributes
- PrintAttributes
Attributs de travail d’impression par défaut ou null.
Retours
Tâche d’impression créée en cas de réussite ou null en cas d’échec.
- Attributs
Exceptions
S’il n’est pas appelé à partir d’un Activity.
Si le nom du travail d’impression est vide ou si l’adaptateur de document a la valeur Null.
Remarques
Crée un travail d’impression pour l’impression d’un PrintDocumentAdapter avec des attributs d’impression par défaut.
L’appel de cette méthode apporte l’interface utilisateur d’impression permettant à l’utilisateur de personnaliser le travail d’impression et retourne un PrintJob objet sans attendre que l’utilisateur personnalise ou confirme le travail d’impression. L’instance de travail d’impression retournée est dans un PrintJobInfo#STATE_CREATED created état.
Cette méthode ne peut être appelée qu’à partir d’un Activity. La logique est que l’impression à partir d’un service crée une expérience utilisateur incohérente, car l’interface utilisateur d’impression apparaît sans contexte.
Le passage PrintDocumentAdapter est également considéré comme non valide si votre activité est terminée. La logique est qu’une fois l’activité lancée à l’impression terminée, l’adaptateur fourni peut être dans un état incohérent, car il peut dépendre de l’interface utilisateur présentée par l’activité.
Les attributs d’impression par défaut sont un indicateur pour le système de l’impression des données. Par exemple, un éditeur de photos peut examiner le rapport d’aspect photo pour déterminer l’orientation par défaut et fournir un indicateur indiquant si l’impression doit être dans le portrait ou le paysage. Le système fera le meilleur effort pour sélectionner les options indiquées dans la boîte de dialogue d’impression, étant donné que l’imprimante actuelle les prend en charge.
<
>strong Remarque :</strong> Calling this method will bring the print dialog and the system will connect to the fourni PrintDocumentAdapter. Si une modification de configuration se produit que votre application ne gère pas, par exemple une modification de rotation, le système supprime la connexion à l’adaptateur, car l’activité doit être recréée et l’ancien adaptateur peut ne pas être valide dans ce contexte, donc une nouvelle instance d’adaptateur est requise. Par conséquent, si votre activité ne gère pas les modifications de configuration (comportement par défaut), vous devez enregistrer l’état que vous imprimez et appeler à nouveau cette méthode lorsque votre activité est recréée.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.