java.awt.print
public abstract class PrinterJob extends Object
Constructor and Description |
---|
PrinterJob()
Initializes a new instance of
PrinterJob . |
Modifier and Type | Method and Description |
---|---|
abstract void |
cancel()
Cancels an in progress print job.
|
PageFormat |
defaultPage()
Returns an instance of the default page which will have the default
paper and orientation.
|
abstract PageFormat |
defaultPage(PageFormat page_format)
Clones the specified
PageFormat object then alters the
clone so that it represents the default page format. |
abstract int |
getCopies()
Returns the number of copies to be printed.
|
abstract String |
getJobName()
Returns the name of the print job.
|
static PrinterJob |
getPrinterJob()
Creates a new print job.
|
PrintService |
getPrintService()
Return the printer for this job.
|
abstract String |
getUserName()
Returns the printing user name.
|
abstract boolean |
isCancelled()
Tests whether or not this job has been cancelled.
|
static PrintService[] |
lookupPrintServices()
Find and return 2D image print services.
|
static StreamPrintServiceFactory[] |
lookupStreamPrintServices(String mimeType)
Find and return 2D image stream print services.
|
abstract PageFormat |
pageDialog(PageFormat page_format)
Displays a dialog box to the user which allows the page format
attributes to be modified.
|
PageFormat |
pageDialog(PrintRequestAttributeSet attributes) |
abstract void |
print()
Prints the pages.
|
void |
print(PrintRequestAttributeSet attributes)
Prints the page with given attributes.
|
abstract boolean |
printDialog()
Displays a dialog box to the user which allows the print job
attributes to be modified.
|
boolean |
printDialog(PrintRequestAttributeSet attributes)
Displays a dialog box to the user which allows the print job
attributes to be modified.
|
abstract void |
setCopies(int copies)
Sets the number of copies to be printed.
|
abstract void |
setJobName(String job_name)
Sets the name of the print job.
|
abstract void |
setPageable(Pageable pageable)
This sets the pages that are to be printed.
|
abstract void |
setPrintable(Printable printable)
Sets this specified
Printable as the one to use for
rendering the pages on the print device. |
abstract void |
setPrintable(Printable printable,
PageFormat page_format)
Sets the
Printable and the page format for the pages
to be printed. |
void |
setPrintService(PrintService service)
Change the printer for this print job to service.
|
abstract PageFormat |
validatePage(PageFormat page_format)
Makes any alterations to the specified
PageFormat
necessary to make it work with the current printer. |
public PrinterJob()
PrinterJob
.public static PrinterJob getPrinterJob()
PrinterJob
object for the newly created print job.public abstract int getCopies()
public abstract void setCopies(int copies)
copies
- The number of copies to be printed.public abstract String getJobName()
public abstract void setJobName(String job_name)
job_name
- The name of the print job.public abstract String getUserName()
public abstract void cancel()
public abstract boolean isCancelled()
true
if this job has been cancelled, false
otherwise.public PageFormat defaultPage()
PageFormat
.public abstract PageFormat defaultPage(PageFormat page_format)
PageFormat
object then alters the
clone so that it represents the default page format.page_format
- The PageFormat
to clone.public abstract PageFormat pageDialog(PageFormat page_format) throws HeadlessException
page_format
- The PageFormat
object to modify.PageFormat
.HeadlessException
public PageFormat pageDialog(PrintRequestAttributeSet attributes) throws HeadlessException
HeadlessException
public abstract void print() throws PrinterException
PrinterException
public void print(PrintRequestAttributeSet attributes) throws PrinterException
PrinterException
public abstract boolean printDialog() throws HeadlessException
false
if the user cancels the dialog box,
true
otherwise.HeadlessException
public boolean printDialog(PrintRequestAttributeSet attributes) throws HeadlessException
false
if the user cancels the dialog box,
true
otherwise.HeadlessException
public abstract void setPageable(Pageable pageable)
pageable
- The pages to be printed, which may not be null
.public abstract void setPrintable(Printable printable)
Printable
as the one to use for
rendering the pages on the print device.printable
- The Printable
for the print job.public abstract void setPrintable(Printable printable, PageFormat page_format)
Printable
and the page format for the pages
to be printed.printable
- The Printable
for the print job.page_format
- The PageFormat
for the print job.public abstract PageFormat validatePage(PageFormat page_format)
PageFormat
necessary to make it work with the current printer. The alterations
are made to a clone of the input object, which is then returned.page_format
- The PageFormat
to validate.PageFormat
.public static PrintService[] lookupPrintServices()
public static StreamPrintServiceFactory[] lookupStreamPrintServices(String mimeType)
mimeType
- The output format mime type, or null for any type.public PrintService getPrintService()
public void setPrintService(PrintService service) throws PrinterException
service
- The new printer to use.PrinterException
- if service is not valid.