Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 81f14b96 authored by Svetoslav's avatar Svetoslav
Browse files

Updated print docs. 

Added an explanation why the system cannot maintain print UI
state on rotation.

Change-Id: I370158ba4be929b67a4b5476ccacad5335d18b34
parent 5b568aa0

core/java/android/print/PrintManager.java

+9 −0
Original line number Diff line number Diff line
@@ -359,6 +359,15 @@ public final class PrintManager { 
     * selected the hinted options in the print dialog, given the current printer

     * supports them.

     * </p>

     * <p>

     * <strong>Note:</strong> Calling this method will bring the print dialog and

     * the system will connect to the provided {@link PrintDocumentAdapter}. If a

     * configuration change occurs, such as rotation, the system will drop the

     * connection to the adapter as the activity has to be recreated and the old

     * adapter may be invalid in this context. As a consequence, if your activity

     * does not handle rotation, you have to save the state that you were printing

     * and call this method again when your activity is recreated.

     * </p>

     *

     * @param printJobName A name for the new print job which is shown to the user.

     * @param documentAdapter An adapter that emits the document to print.