ProxyPrintGraphics

extends ProxyGraphics
implements PrintGraphics

java.lang.Object
↳	java.awt.Graphics
	↳	sun.print.ProxyGraphics
		↳	sun.print.ProxyPrintGraphics

Class Overview

A subclass of Graphics that can be printed to. The graphics calls are forwared to another Graphics instance that does the actual rendering.

Summary

Public Constructors
	ProxyPrintGraphics(Graphics graphics, PrintJob thePrintJob)

Public Methods
Graphics	create() Creates a new `Graphics` object that is a copy of this `Graphics` object.
Graphics	create(int x, int y, int width, int height) Creates a new `Graphics` object based on this `Graphics` object, but with a new translation and clip area.
void	dispose() Disposes of this graphics context and releases any system resources that it is using.
Graphics	getGraphics()
PrintJob	getPrintJob() Returns the PrintJob object from which this PrintGraphics object originated.

[Expand]

Inherited Methods

From class sun.print.ProxyGraphics

void	clearRect(int x, int y, int width, int height) Clears the specified rectangle by filling it with the background color of the current drawing surface.
void	clipRect(int x, int y, int width, int height) Intersects the current clip with the specified rectangle.
void	copyArea(int x, int y, int width, int height, int dx, int dy) Copies an area of the component by a distance specified by `dx` and `dy`.
Graphics	create(int x, int y, int width, int height) Creates a new `Graphics` object based on this `Graphics` object, but with a new translation and clip area.
Graphics	create() Creates a new `Graphics` object that is a copy of this `Graphics` object.
void	dispose() Disposes of this graphics context and releases any system resources that it is using.
void	draw3DRect(int x, int y, int width, int height, boolean raised) Draws a 3-D highlighted outline of the specified rectangle.
void	drawArc(int x, int y, int width, int height, int startAngle, int arcAngle) Draws the outline of a circular or elliptical arc covering the specified rectangle.
void	drawBytes(byte[] data, int offset, int length, int x, int y) Draws the text given by the specified byte array, using this graphics context's current font and color.
void	drawChars(char[] data, int offset, int length, int x, int y) Draws the text given by the specified character array, using this graphics context's current font and color.
boolean	drawImage(Image img, int x, int y, int width, int height, Color bgcolor, ImageObserver observer) Draws as much of the specified image as has already been scaled to fit inside the specified rectangle.
boolean	drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, Color bgcolor, ImageObserver observer) Draws as much of the specified area of the specified image as is currently available, scaling it on the fly to fit inside the specified area of the destination drawable surface.
boolean	drawImage(Image img, int x, int y, Color bgcolor, ImageObserver observer) Draws as much of the specified image as is currently available.
boolean	drawImage(Image img, int x, int y, ImageObserver observer) Draws as much of the specified image as is currently available.
boolean	drawImage(Image img, int x, int y, int width, int height, ImageObserver observer) Draws as much of the specified image as has already been scaled to fit inside the specified rectangle.
boolean	drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer) Draws as much of the specified area of the specified image as is currently available, scaling it on the fly to fit inside the specified area of the destination drawable surface.
void	drawLine(int x1, int y1, int x2, int y2) Draws a line, using the current color, between the points `(x1, y1)` and `(x2, y2)` in this graphics context's coordinate system.
void	drawOval(int x, int y, int width, int height) Draws the outline of an oval.
void	drawPolygon(Polygon p) Draws the outline of a polygon defined by the specified `Polygon` object.
void	drawPolygon(int[] xPoints, int[] yPoints, int nPoints) Draws a closed polygon defined by arrays of x and y coordinates.
void	drawPolyline(int[] xPoints, int[] yPoints, int nPoints) Draws a sequence of connected lines defined by arrays of x and y coordinates.
void	drawRect(int x, int y, int width, int height) Draws the outline of the specified rectangle.
void	drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight) Draws an outlined round-cornered rectangle using this graphics context's current color.
void	drawString(String str, int x, int y) Draws the text given by the specified string, using this graphics context's current font and color.
void	drawString(AttributedCharacterIterator iterator, int x, int y) Draws the text given by the specified iterator, using this graphics context's current color.
void	fill3DRect(int x, int y, int width, int height, boolean raised) Paints a 3-D highlighted rectangle filled with the current color.
void	fillArc(int x, int y, int width, int height, int startAngle, int arcAngle) Fills a circular or elliptical arc covering the specified rectangle.
void	fillOval(int x, int y, int width, int height) Fills an oval bounded by the specified rectangle with the current color.
void	fillPolygon(Polygon p) Fills the polygon defined by the specified Polygon object with the graphics context's current color.
void	fillPolygon(int[] xPoints, int[] yPoints, int nPoints) Fills a closed polygon defined by arrays of x and y coordinates.
void	fillRect(int x, int y, int width, int height) Fills the specified rectangle.
void	fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight) Fills the specified rounded corner rectangle with the current color.
void	finalize() Empty finalizer as no clean up needed here.
Shape	getClip() Gets the current clipping area.
Rectangle	getClipBounds(Rectangle r) Returns the bounding rectangle of the current clipping area.
Rectangle	getClipBounds() Returns the bounding rectangle of the current clipping area.
Rectangle	getClipRect() This method is deprecated. As of JDK version 1.1, replaced by `getClipBounds()`.
Color	getColor() Gets this graphics context's current color.
Font	getFont() Gets the current font.
FontMetrics	getFontMetrics(Font f) Gets the font metrics for the specified font.
FontMetrics	getFontMetrics() Gets the font metrics of the current font.
boolean	hitClip(int x, int y, int width, int height) Returns true if the specified rectangular area intersects the bounding rectangle of the current clipping area.
void	setClip(Shape clip) Sets the current clipping area to an arbitrary clip shape.
void	setClip(int x, int y, int width, int height) Sets the current clip to the rectangle specified by the given coordinates.
void	setColor(Color c) Sets this graphics context's current color to the specified color.
void	setFont(Font font) Sets this graphics context's font to the specified font.
void	setPaintMode() Sets the paint mode of this graphics context to overwrite the destination with this graphics context's current color.
void	setXORMode(Color c1) Sets the paint mode of this graphics context to alternate between this graphics context's current color and the new specified color.
String	toString() Returns a `String` object representing this `Graphics` object's value.
void	translate(int x, int y) Translates the origin of the graphics context to the point (x, y) in the current coordinate system.

From class java.awt.Graphics

abstract void	clearRect(int x, int y, int width, int height) Clears the specified rectangle by filling it with the background color of the current drawing surface.
abstract void	clipRect(int x, int y, int width, int height) Intersects the current clip with the specified rectangle.
abstract void	copyArea(int x, int y, int width, int height, int dx, int dy) Copies an area of the component by a distance specified by `dx` and `dy`.
Graphics	create(int x, int y, int width, int height) Creates a new `Graphics` object based on this `Graphics` object, but with a new translation and clip area.
abstract Graphics	create() Creates a new `Graphics` object that is a copy of this `Graphics` object.
abstract void	dispose() Disposes of this graphics context and releases any system resources that it is using.
void	draw3DRect(int x, int y, int width, int height, boolean raised) Draws a 3-D highlighted outline of the specified rectangle.
abstract void	drawArc(int x, int y, int width, int height, int startAngle, int arcAngle) Draws the outline of a circular or elliptical arc covering the specified rectangle.
void	drawBytes(byte[] data, int offset, int length, int x, int y) Draws the text given by the specified byte array, using this graphics context's current font and color.
void	drawChars(char[] data, int offset, int length, int x, int y) Draws the text given by the specified character array, using this graphics context's current font and color.
abstract boolean	drawImage(Image img, int x, int y, int width, int height, Color bgcolor, ImageObserver observer) Draws as much of the specified image as has already been scaled to fit inside the specified rectangle.
abstract boolean	drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, Color bgcolor, ImageObserver observer) Draws as much of the specified area of the specified image as is currently available, scaling it on the fly to fit inside the specified area of the destination drawable surface.
abstract boolean	drawImage(Image img, int x, int y, Color bgcolor, ImageObserver observer) Draws as much of the specified image as is currently available.
abstract boolean	drawImage(Image img, int x, int y, ImageObserver observer) Draws as much of the specified image as is currently available.
abstract boolean	drawImage(Image img, int x, int y, int width, int height, ImageObserver observer) Draws as much of the specified image as has already been scaled to fit inside the specified rectangle.
abstract boolean	drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer) Draws as much of the specified area of the specified image as is currently available, scaling it on the fly to fit inside the specified area of the destination drawable surface.
abstract void	drawLine(int x1, int y1, int x2, int y2) Draws a line, using the current color, between the points `(x1, y1)` and `(x2, y2)` in this graphics context's coordinate system.
abstract void	drawOval(int x, int y, int width, int height) Draws the outline of an oval.
void	drawPolygon(Polygon p) Draws the outline of a polygon defined by the specified `Polygon` object.
abstract void	drawPolygon(int[] xPoints, int[] yPoints, int nPoints) Draws a closed polygon defined by arrays of x and y coordinates.
abstract void	drawPolyline(int[] xPoints, int[] yPoints, int nPoints) Draws a sequence of connected lines defined by arrays of x and y coordinates.
void	drawRect(int x, int y, int width, int height) Draws the outline of the specified rectangle.
abstract void	drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight) Draws an outlined round-cornered rectangle using this graphics context's current color.
abstract void	drawString(String str, int x, int y) Draws the text given by the specified string, using this graphics context's current font and color.
abstract void	drawString(AttributedCharacterIterator iterator, int x, int y) Renders the text of the specified iterator applying its attributes in accordance with the specification of the `TextAttribute` class.
void	fill3DRect(int x, int y, int width, int height, boolean raised) Paints a 3-D highlighted rectangle filled with the current color.
abstract void	fillArc(int x, int y, int width, int height, int startAngle, int arcAngle) Fills a circular or elliptical arc covering the specified rectangle.
abstract void	fillOval(int x, int y, int width, int height) Fills an oval bounded by the specified rectangle with the current color.
void	fillPolygon(Polygon p) Fills the polygon defined by the specified Polygon object with the graphics context's current color.
abstract void	fillPolygon(int[] xPoints, int[] yPoints, int nPoints) Fills a closed polygon defined by arrays of x and y coordinates.
abstract void	fillRect(int x, int y, int width, int height) Fills the specified rectangle.
abstract void	fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight) Fills the specified rounded corner rectangle with the current color.
void	finalize() Disposes of this graphics context once it is no longer referenced.
abstract Shape	getClip() Gets the current clipping area.
Rectangle	getClipBounds(Rectangle r) Returns the bounding rectangle of the current clipping area.
abstract Rectangle	getClipBounds() Returns the bounding rectangle of the current clipping area.
Rectangle	getClipRect() This method is deprecated. As of JDK version 1.1, replaced by `getClipBounds()`.
abstract Color	getColor() Gets this graphics context's current color.
abstract Font	getFont() Gets the current font.
abstract FontMetrics	getFontMetrics(Font f) Gets the font metrics for the specified font.
FontMetrics	getFontMetrics() Gets the font metrics of the current font.
boolean	hitClip(int x, int y, int width, int height) Returns true if the specified rectangular area might intersect the current clipping area.
abstract void	setClip(Shape clip) Sets the current clipping area to an arbitrary clip shape.
abstract void	setClip(int x, int y, int width, int height) Sets the current clip to the rectangle specified by the given coordinates.
abstract void	setColor(Color c) Sets this graphics context's current color to the specified color.
abstract void	setFont(Font font) Sets this graphics context's font to the specified font.
abstract void	setPaintMode() Sets the paint mode of this graphics context to overwrite the destination with this graphics context's current color.
abstract void	setXORMode(Color c1) Sets the paint mode of this graphics context to alternate between this graphics context's current color and the new specified color.
String	toString() Returns a `String` object representing this `Graphics` object's value.
abstract void	translate(int x, int y) Translates the origin of the graphics context to the point (x, y) in the current coordinate system.

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() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this 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.

From interface java.awt.PrintGraphics

Public Constructors

public ProxyPrintGraphics (Graphics graphics, PrintJob thePrintJob)

Public Methods

public Graphics create ()

Creates a new Graphics object that is a copy of this Graphics object.

Returns

a new graphics context that is a copy of this graphics context.

public Graphics create (int x, int y, int width, int height)

Creates a new Graphics object based on this Graphics object, but with a new translation and clip area. Refer to sun.print.ProxyGraphics#createGraphics for a complete description of this method.

Parameters

x	the x coordinate.
y	the y coordinate.
width	the width of the clipping rectangle.
height	the height of the clipping rectangle.

Returns

a new graphics context.

public void dispose ()

Disposes of this graphics context and releases any system resources that it is using. A Graphics object cannot be used after disposehas been called.

When a Java program runs, a large number of Graphics objects can be created within a short time frame. Although the finalization process of the garbage collector also disposes of the same system resources, it is preferable to manually free the associated resources by calling this method rather than to rely on a finalization process which may not run to completion for a long period of time.

Graphics objects which are provided as arguments to the paint and update methods of components are automatically released by the system when those methods return. For efficiency, programmers should call dispose when finished using a Graphics object only if it was created directly from a component or another Graphics object.

public Graphics getGraphics ()

public PrintJob getPrintJob ()

Returns the PrintJob object from which this PrintGraphics object originated.

Interfaces

Classes

ProxyPrintGraphics

Class Overview

Summary

Public Constructors

public ProxyPrintGraphics (Graphics graphics, PrintJob thePrintJob)

Public Methods

public Graphics create ()

Returns

public Graphics create (int x, int y, int width, int height)

Parameters

Returns

See Also

public void dispose ()

public Graphics getGraphics ()

public PrintJob getPrintJob ()