sun.print

Class PrintJob2D [ source ]

java.lang.Object

java.awt.PrintJob

sun.print.PrintJob2D

All Implemented Interfaces:

Printable, Runnable

public class PrintJob2D
extends PrintJob
implements Printable, Runnable

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

See Also:

Toolkit#getPrintJob

Field Summary

Fields inherited from interface java.awt.print.Printable

NO_SUCH_PAGE, PAGE_EXISTS

Constructor Summary

Constructors

Constructor and Description
PrintJob2D(Frame frame, String doctitle, JobAttributes jobAttributes, PageAttributes pageAttributes)
PrintJob2D(Frame frame, String doctitle, Properties props)

Method Summary

Methods

Modifier and Type	Method and Description
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)

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PrintJob2D

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

PrintJob2D

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

Method Detail

printDialog

public boolean printDialog()

getGraphics

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.

Specified by:

getGraphics in class PrintJob

See Also:

PrintGraphics

getPageDimension

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.

Specified by:

getPageDimension in class PrintJob

getPageResolution

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.

Specified by:

getPageResolution in class PrintJob

lastPageFirst

public boolean lastPageFirst()

Returns true if the last page will be printed first.

Specified by:

lastPageFirst in class PrintJob

end

public void end()

Ends the print job and does any necessary cleanup.

Specified by:

end in class PrintJob

finalize

public void finalize()

Ends this print job once it is no longer referenced.

Overrides:

finalize in class PrintJob

See Also:

end()

print

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

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.

Specified by:

print in interface Printable

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.

run

public void run()

Description copied from interface: Runnable

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.

Specified by:

run in interface Runnable

See Also:

Thread.run()

mapMedia

public static MediaSizeName mapMedia(PageAttributes.MediaType mType)

unMapMedia

public static PageAttributes.MediaType unMapMedia(MediaSizeName mSize)