Merge "Update print docs"

This commit is contained in:
Svetoslav
2014-03-18 18:00:01 +00:00
committed by Android (Google) Code Review

View File

@@ -362,11 +362,13 @@ public final class PrintManager {
* <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.
* configuration change occurs that you application does not handle, for example
* a rotation change, 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,
* hence a new adapter instance is required. As a consequence, if your activity
* does not handle configuration changes (default behavior), 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.