public class

PrintJob2D

extends PrintJob
implements Printable Runnable
java.lang.Object
   ↳ java.awt.PrintJob
     ↳ sun.print.PrintJob2D

Class Overview

A class which initiates and executes a print job using the underlying PrinterJob graphics conversions.

See Also
  • Toolkit#getPrintJob

Summary

[Expand]
Inherited Constants
From interface java.awt.print.Printable
Public Constructors
PrintJob2D(Frame frame, String doctitle, Properties props)
PrintJob2D(Frame frame, String doctitle, JobAttributes jobAttributes, PageAttributes pageAttributes)
Public Methods
synchronized void end()
Ends the print job and does any necessary cleanup.
void finalize()
Ends this print job once it is no longer referenced.
Graphics getGraphics()
Gets a Graphics object that will draw to the next page.
Dimension getPageDimension()
Returns the dimensions of the page in pixels.
int getPageResolution()
Returns the resolution of the page in pixels per inch.
boolean lastPageFirst()
Returns true if the last page will be printed first.
static MediaSizeName mapMedia(PageAttributes.MediaType mType)
int print(Graphics graphics, PageFormat pageFormat, int pageIndex)
Prints the page at the specified index into the specified Graphics context in the specified format.
boolean printDialog()
void run()
When an object implementing interface Runnable is used to create a thread, starting the thread causes the object's run method to be called in that separately executing thread.
static PageAttributes.MediaType unMapMedia(MediaSizeName mSize)
[Expand]
Inherited Methods
From class java.awt.PrintJob
From class java.lang.Object
From interface java.awt.print.Printable
From interface java.lang.Runnable

Public Constructors

public PrintJob2D (Frame frame, String doctitle, Properties props)

public PrintJob2D (Frame frame, String doctitle, JobAttributes jobAttributes, PageAttributes pageAttributes)

Public Methods

public synchronized void end ()

Ends the print job and does any necessary cleanup.

public void finalize ()

Ends this print job once it is no longer referenced.

See Also

public Graphics getGraphics ()

Gets a Graphics object that will draw to the next page. The page is sent to the printer when the graphics object is disposed. This graphics object will also implement the PrintGraphics interface.

See Also
  • PrintGraphics

public Dimension getPageDimension ()

Returns the dimensions of the page in pixels. The resolution of the page is chosen so that it is similar to the screen resolution. Except (since 1.3) when the application specifies a resolution. In that case it it scaled accordingly.

public int getPageResolution ()

Returns the resolution of the page in pixels per inch. Note that this doesn't have to correspond to the physical resolution of the printer.

public boolean lastPageFirst ()

Returns true if the last page will be printed first.

public static MediaSizeName mapMedia (PageAttributes.MediaType mType)

public int print (Graphics graphics, PageFormat pageFormat, int pageIndex)

Prints the page at the specified index into the specified Graphics context in the specified format. A PrinterJob calls the Printable interface to request that a page be rendered into the context specified by graphics. The format of the page to be drawn is specified by pageFormat. The zero based index of the requested page is specified by pageIndex. If the requested page does not exist then this method returns NO_SUCH_PAGE; otherwise PAGE_EXISTS is returned. The Graphics class or subclass implements the PrinterGraphics interface to provide additional information. If the Printable object aborts the print job then it throws a PrinterException.

Parameters
graphics the context into which the page is drawn
pageFormat the size and orientation of the page being drawn
pageIndex the zero based index of the page to be drawn
Returns
  • PAGE_EXISTS if the page is rendered successfully or NO_SUCH_PAGE if pageIndex specifies a non-existent page.
Throws
PrinterException thrown when the print job is terminated.

public boolean printDialog ()

public void run ()

When an object implementing interface Runnable is used to create a thread, starting the thread causes the object's run method to be called in that separately executing thread.

The general contract of the method run is that it may take any action whatsoever.

public static PageAttributes.MediaType unMapMedia (MediaSizeName mSize)