# Print output for @column tags ?>
Developers

- Design
- Develop
- Distribute

Developer Console

## Most visited

## Recently visited

## Results for

Summary: Methods | Inherited Methods

# PrintManager

`public final class PrintManager`
`extends Object` ``

java.lang.Object
↳ | android.print.PrintManager

System level service for accessing the printing capabilities of the platform.

### Print mechanics

The key idea behind printing on the platform is that the content to be printed should be laid out for the currently selected print options resulting in an optimized output and higher user satisfaction. To achieve this goal the platform declares a contract that the printing application has to follow which is defined by the `PrintDocumentAdapter` class. At a higher level the contract is that when the user selects some options from the print UI that may affect the way content is laid out, for example page size, the application receives a callback allowing it to layout the content to better fit these new constraints. After a layout pass the system may ask the application to render one or more pages one or more times. For example, an application may produce a single column list for smaller page sizes and a multi-column table for larger page sizes.

### Print jobs

Print jobs are started by calling the `print(java.lang.String, android.print.PrintDocumentAdapter, android.print.PrintAttributes)` from an activity which results in bringing up the system print UI. Once the print UI is up, when the user changes a selected print option that affects the way content is laid out the system starts to interact with the application following the mechanics described the section above.

Print jobs can be in `PrintJobInfo#STATE_CREATED`, `PrintJobInfo#STATE_QUEUED`, `PrintJobInfo#STATE_STARTED`, `PrintJobInfo#STATE_BLOCKED`, `PrintJobInfo#STATE_COMPLETED`, `PrintJobInfo#STATE_FAILED`, and `PrintJobInfo#STATE_CANCELED` state. Print jobs are stored in dedicated system spooler until they are handled which is they are cancelled or completed. Active print jobs, ones that are not cancelled or completed, are considered failed if the device reboots as the new boot may be after a very long time. The user may choose to restart such print jobs. Once a print job is queued all relevant content is stored in the system spooler and its lifecycle becomes detached from this of the application that created it.

An applications can query the print spooler for current print jobs it created but not print jobs created by other applications.

Requires the `PackageManager#FEATURE_PRINTING` feature which can be detected using `PackageManager.hasSystemFeature(String)`.

See also:

- `PrintJob`
- `PrintJobInfo`

## Summary

### Public methods
`List<PrintJob>` | `getPrintJobs()` Gets the print jobs for this application.
`PrintJob` | `print(String printJobName, PrintDocumentAdapter documentAdapter, PrintAttributes attributes)` Creates a print job for printing a `PrintDocumentAdapter` with default print attributes.

### Inherited methods
From class `java.lang.Object`
`Object` | `clone()` Creates and returns a copy of this object.
`boolean` | `equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void` | `finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>` | `getClass()` Returns the runtime class of this `Object`.
`int` | `hashCode()` Returns a hash code value for the object.
`final void` | `notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void` | `notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String` | `toString()` Returns a string representation of the object.
`final void` | `wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void` | `wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void` | `wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

## Public methods

### getPrintJobs

    public List<PrintJob> getPrintJobs ()

Gets the print jobs for this application.

Returns
`List<PrintJob>` | The print job list. This value cannot be `null`.

See also:

- `PrintJob`

### print

    public PrintJob print (String printJobName,
                    PrintDocumentAdapter documentAdapter,
                    PrintAttributes attributes)

Creates a print job for printing a `PrintDocumentAdapter` with default print attributes.

Calling this method brings the print UI allowing the user to customize the print job and returns a `PrintJob` object without waiting for the user to customize or confirm the print job. The returned print job instance is in a `PrintJobInfo#STATE_CREATED` state.

This method can be called only from an `Activity`. The rationale is that printing from a service will create an inconsistent user experience as the print UI would appear without any context.

Also the passed in `PrintDocumentAdapter` will be considered invalid if your activity is finished. The rationale is that once the activity that initiated printing is finished, the provided adapter may be in an inconsistent state as it may depend on the UI presented by the activity.

The default print attributes are a hint to the system how the data is to be printed. For example, a photo editor may look at the photo aspect ratio to determine the default orientation and provide a hint whether the printing should be in portrait or landscape. The system will do a best effort to selected the hinted options in the print dialog, given the current printer supports them.

Note: Calling this method will bring the print dialog and the system will connect to the provided `PrintDocumentAdapter`. If a 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.

Parameters
`printJobName` | `String`: A name for the new print job which is shown to the user. This value cannot be `null`.
`documentAdapter` | `PrintDocumentAdapter`: An adapter that emits the document to print. This value cannot be `null`.
`attributes` | `PrintAttributes`: The default print job attributes or `null`. This value may be `null`.

Returns
`PrintJob` | The created print job on success or null on failure.

Throws
`IllegalStateException` | If not called from an `Activity`.
`IllegalArgumentException` | If the print job name is empty or the document adapter is null.

See also:

- `PrintJob`

Full name *
Email address *
Company / developer name
One of your Play Store app URLs *
Which best describes your business:*
Apps
Games
Apps & Games
*
*