|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.4.2
java.awt.print
|
Constructor Summary | |
PrinterJob()
A PrinterJob object should be created using the
static method. |
Method Summary | |
abstract void |
cancel()
Cancels a print job that is in progress. |
PageFormat |
defaultPage()
Creates a new PageFormat instance and
sets it to a default size and orientation. |
abstract PageFormat |
defaultPage(PageFormat page)
Clones the PageFormat argument and alters the
clone to describe a default page size and orientation. |
abstract int |
getCopies()
Gets the number of copies to be printed. |
abstract String |
getJobName()
Gets the name of the document to be printed. |
static PrinterJob |
getPrinterJob()
Creates and returns a PrinterJob which is initially
associated with the default printer. |
PrintService |
getPrintService()
Returns the service (printer) for this printer job. |
abstract String |
getUserName()
Gets the name of the printing user. |
abstract boolean |
isCancelled()
Returns true if a print job is
in progress, but is going to be cancelled
at the next opportunity; otherwise returns
false . |
static PrintService[] |
lookupPrintServices()
A convenience method which looks up 2D print services. |
static StreamPrintServiceFactory[] |
lookupStreamPrintServices(String mimeType)
A convenience method which locates factories for stream print services which can image 2D graphics. |
abstract PageFormat |
pageDialog(PageFormat page)
Displays a dialog that allows modification of a PageFormat instance. |
PageFormat |
pageDialog(PrintRequestAttributeSet attributes)
A convenience method which displays a cross-platform page setup dialog. |
abstract void |
print()
Prints a set of pages. |
void |
print(PrintRequestAttributeSet attributes)
Prints a set of pages using the settings in the attribute set. |
abstract boolean |
printDialog()
Presents a dialog to the user for changing the properties of the print job. |
boolean |
printDialog(PrintRequestAttributeSet attributes)
A convenience method which displays a cross-platform print dialog for all services which are capable of printing 2D graphics using the Pageable interface. |
abstract void |
setCopies(int copies)
Sets the number of copies to be printed. |
abstract void |
setJobName(String jobName)
Sets the name of the document to be printed. |
abstract void |
setPageable(Pageable document)
Queries document for the number of pages and
the PageFormat and Printable for each
page held in the Pageable instance,
document . |
abstract void |
setPrintable(Printable painter)
Calls painter to render the pages. |
abstract void |
setPrintable(Printable painter,
PageFormat format)
Calls painter to render the pages in the specified
format . |
void |
setPrintService(PrintService service)
Associate this PrinterJob with a new PrintService. |
abstract PageFormat |
validatePage(PageFormat page)
Returns the clone of page with its settings
adjusted to be compatible with the current printer of this
PrinterJob . |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public PrinterJob()
PrinterJob
object should be created using the
static getPrinterJob
method.
Method Detail |
public static PrinterJob getPrinterJob()
PrinterJob
which is initially
associated with the default printer.
If no printers are available on the system, a PrinterJob will still
be returned from this method, but getPrintService()
will return null
, and calling
print
with this PrinterJob
might
generate an exception. Applications that need to determine if
there are suitable printers before creating a PrinterJob
should ensure that the array returned from
lookupPrintServices
is not empty.
PrinterJob
.public static PrintService[] lookupPrintServices()
PrinterJob
s which support print services.
Calling this method is equivalent to calling
PrintServiceLookup.lookupPrintServices()
and specifying a Pageable DocFlavor.
public static StreamPrintServiceFactory[] lookupStreamPrintServices(String mimeType)
FileOutputStream outstream; StreamPrintService psPrinter; String psMimeType = "application/postscript"; StreamPrintServiceFactory[] factories = PrinterJob.lookupStreamPrintServices(psMimeType); if (factories.length > 0) { try { outstream = new File("out.ps"); psPrinter = factories[0].getPrintService(fos); // psPrinter can now be set as the service on a PrinterJob } catch (FileNotFoundException e) { } }Services returned from this method may be installed on
PrinterJob
instances which support print services.
Calling this method is equivalent to calling
StreamPrintServiceFactory.lookupStreamPrintServiceFactories()
and specifying a Pageable DocFlavor.
mimeType
- the required output format, or null to mean any format.
public PrintService getPrintService()
setPrintService(PrintService)
public void setPrintService(PrintService service) throws PrinterException
PrinterException
if the specified service
cannot support the Pageable
and
Printable
interfaces necessary to support 2D printing.
service
- a print service that supports 2D printing
PrinterException
- if the specified service does not support
2D printing, or this PrinterJob class does not support
setting a 2D print service, or the specified service is
otherwise not a valid print service.getPrintService()
public abstract void setPrintable(Printable painter)
painter
to render the pages. The pages in the
document to be printed by this
PrinterJob
are rendered by the Printable
object, painter
. The PageFormat
for each page
is the default page format.
painter
- the Printable
that renders each page of
the document.public abstract void setPrintable(Printable painter, PageFormat format)
painter
to render the pages in the specified
format
. The pages in the document to be printed by
this PrinterJob
are rendered by the
Printable
object, painter
. The
PageFormat
of each page is format
.
painter
- the Printable
called to render
each page of the documentformat
- the size and orientation of each page to
be printedpublic abstract void setPageable(Pageable document) throws NullPointerException
document
for the number of pages and
the PageFormat
and Printable
for each
page held in the Pageable
instance,
document
.
document
- the pages to be printed. It can not be
null
.
NullPointerException
- the Pageable
passed in
was null
.PageFormat
,
Printable
public abstract boolean printDialog() throws HeadlessException
printDialog(PrintRequestAttributeSet)
.
PrinterJob implementations which can use PrintService's will update the PrintService for this PrinterJob to reflect the new service selected by the user.
true
if the user does not cancel the dialog;
false
otherwise.
HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true.GraphicsEnvironment.isHeadless()
public boolean printDialog(PrintRequestAttributeSet attributes) throws HeadlessException
Pageable
interface. The selected printer when the
dialog is initially displayed will reflect the print service currently
attached to this print job.
If the user changes the print service, the PrinterJob will be
updated to reflect this, unless the user cancels the dialog.
As well as allowing the user to select the destination printer,
the user can also select values of various print request attributes.
The attributes parameter on input will reflect the applications required initial selections in the user dialog. Attributes not specified display using the default for the service. On return it will reflect the user's choices. Selections may be updated by the implementation to be consistent with the supported values for the currently selected print service.
As the user scrolls to a new print service selection, the values copied are based on the settings for the previous service, together with any user changes. The values are not based on the original settings supplied by the client.
With the exception of selected printer, the PrinterJob state is
not updated to reflect the user's changes.
For the selections to affect a printer job, the attributes must
be specified in the call to the
print(PrintRequestAttributeSet)
method. If using
the Pageable interface, clients which intend to use media selected
by the user must create a PageFormat derived from the user's
selections.
If the user cancels the dialog, the attributes will not reflect
any changes made by the user.
attributes
- on input is application supplied attributes,
on output the contents are updated to reflect user choices.
This parameter may not be null.
true
if the user does not cancel the dialog;
false
otherwise.
HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true.
NullPointerException
- if attributes
parameter
is null.GraphicsEnvironment.isHeadless()
public abstract PageFormat pageDialog(PageFormat page) throws HeadlessException
PageFormat
instance.
The page
argument is used to initialize controls
in the page setup dialog.
If the user cancels the dialog then this method returns the
original page
object unmodified.
If the user okays the dialog then this method returns a new
PageFormat
object with the indicated changes.
In either case, the original page
object is
not modified.
page
- the default PageFormat
presented to the
user for modification
page
object if the dialog
is cancelled; a new PageFormat
object
containing the format indicated by the user if the
dialog is acknowledged.
HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true.GraphicsEnvironment.isHeadless()
public PageFormat pageDialog(PrintRequestAttributeSet attributes) throws HeadlessException
The attributes parameter on input will reflect the client's required initial selections in the user dialog. Attributes which are not specified display using the default for the service. On return it will reflect the user's choices. Selections may be updated by the implementation to be consistent with the supported values for the currently selected print service.
The return value will be a PageFormat equivalent to the selections in the PrintRequestAttributeSet. If the user cancels the dialog, the attributes will not reflect any changes made by the user, and the return value will be null.
attributes
- on input is application supplied attributes,
on output the contents are updated to reflect user choices.
This parameter may not be null.
null
otherwise.
HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true.
NullPointerException
- if attributes
parameter
is null.GraphicsEnvironment.isHeadless()
public abstract PageFormat defaultPage(PageFormat page)
PageFormat
argument and alters the
clone to describe a default page size and orientation.
page
- the PageFormat
to be cloned and altered
page
, altered to describe a default
PageFormat
.public PageFormat defaultPage()
PageFormat
instance and
sets it to a default size and orientation.
PageFormat
set to a default size and
orientation.public abstract PageFormat validatePage(PageFormat page)
page
with its settings
adjusted to be compatible with the current printer of this
PrinterJob
. For example, the returned
PageFormat
could have its imageable area
adjusted to fit within the physical area of the paper that
is used by the current printer.
page
- the PageFormat
that is cloned and
whose settings are changed to be compatible with
the current printer
PageFormat
that is cloned from
page
and whose settings are changed
to conform with this PrinterJob
.public abstract void print() throws PrinterException
PrinterException
- an error in the print system
caused the job to be aborted.Book
,
Pageable
,
Printable
public void print(PrintRequestAttributeSet attributes) throws PrinterException
Note that some attributes may be set directly on the PrinterJob
by equivalent method calls, (for example), copies:
setcopies(int)
, job name: setJobName(String)
and specifying media size and orientation though the
PageFormat
object.
If a supported attribute-value is specified in this attribute set,
it will take precedence over the API settings for this print()
operation only.
The following behaviour is specified for PageFormat:
If a client uses the Printable interface, then the
attributes
parameter to this method is examined
for attributes which specify media (by size), orientation, and
imageable area, and those are used to construct a new PageFormat
which is passed to the Printable object's print() method.
For clients of the Pageable interface, the PageFormat will always
be as supplied by that interface, on a per page basis.
These behaviours allow an application to directly pass the
user settings returned from
printDialog(PrintRequestAttributeSet attributes
to
this print() method.
attributes
- a set of attributes for the job
PrinterException
- an error in the print system
caused the job to be aborted.Book
,
Pageable
,
Printable
public abstract void setCopies(int copies)
copies
- the number of copies to be printedgetCopies()
public abstract int getCopies()
setCopies(int)
public abstract String getUserName()
public abstract void setJobName(String jobName)
null
.
jobName
- the name of the document to be printedgetJobName()
public abstract String getJobName()
setJobName(java.lang.String)
public abstract void cancel()
print
has been called but has not
returned then this method signals
that the job should be cancelled at the next
chance. If there is no print job in progress then
this call does nothing.
public abstract boolean isCancelled()
true
if a print job is
in progress, but is going to be cancelled
at the next opportunity; otherwise returns
false
.
true
if the job in progress
is going to be cancelled; false
otherwise.