|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.awt.Graphics
public abstract class Graphics
This is the abstract superclass of classes for drawing to graphics devices such as the screen or printers.
Constructor Summary | |
---|---|
protected |
Graphics()
Default constructor for subclasses. |
Method Summary | |
---|---|
abstract void |
clearRect(int x,
int y,
int width,
int height)
Clears the specified rectangle. |
abstract void |
clipRect(int x,
int y,
int width,
int height)
Sets the clipping region to the intersection of the current clipping region and the rectangle determined by the specified parameters. |
abstract void |
copyArea(int x,
int y,
int width,
int height,
int dx,
int dy)
Copies the specified rectangle to the specified offset location. |
abstract Graphics |
create()
Returns a copy of this Graphics object. |
Graphics |
create(int x,
int y,
int width,
int height)
Returns a copy of this Graphics object. |
abstract void |
dispose()
Free any resources held by this graphics context immediately instead of waiting for the object to be garbage collected and finalized. |
void |
draw3DRect(int x,
int y,
int width,
int height,
boolean raised)
|
abstract void |
drawArc(int x,
int y,
int width,
int height,
int arcStart,
int arcAngle)
Draws an arc using the specified bounding rectangle and the specified angle parameter. |
void |
drawBytes(byte[] data,
int offset,
int length,
int x,
int y)
|
void |
drawChars(char[] data,
int offset,
int length,
int x,
int y)
Draws the specified characters starting at the specified point. |
abstract boolean |
drawImage(Image image,
int x,
int y,
Color bgcolor,
ImageObserver observer)
Draws all of the image that is available and returns. |
abstract boolean |
drawImage(Image image,
int x,
int y,
ImageObserver observer)
Draws all of the image that is available and returns. |
abstract boolean |
drawImage(Image image,
int x,
int y,
int width,
int height,
Color bgcolor,
ImageObserver observer)
Draws all of the image that is available and returns. |
abstract boolean |
drawImage(Image image,
int x,
int y,
int width,
int height,
ImageObserver observer)
Draws all of the image that is available and returns. |
abstract boolean |
drawImage(Image image,
int dx1,
int dy1,
int dx2,
int dy2,
int sx1,
int sy1,
int sx2,
int sy2,
Color bgcolor,
ImageObserver observer)
FIXME: Write Javadocs for this when you understand it. |
abstract boolean |
drawImage(Image image,
int dx1,
int dy1,
int dx2,
int dy2,
int sx1,
int sy1,
int sx2,
int sy2,
ImageObserver observer)
FIXME: Write Javadocs for this when you understand it. |
abstract void |
drawLine(int x1,
int y1,
int x2,
int y2)
Draws a line between the two specified points. |
abstract void |
drawOval(int x,
int y,
int width,
int height)
Draws an oval that just fits within the specified rectangle. |
abstract void |
drawPolygon(int[] xPoints,
int[] yPoints,
int npoints)
Draws a series of interconnected lines determined by the arrays of corresponding x and y coordinates. |
void |
drawPolygon(Polygon polygon)
Draws the specified polygon. |
abstract void |
drawPolyline(int[] xPoints,
int[] yPoints,
int npoints)
Draws a series of interconnected lines determined by the arrays of corresponding 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 the outline of the specified rectangle with rounded cornders. |
abstract void |
drawString(AttributedCharacterIterator ci,
int x,
int y)
|
abstract void |
drawString(String string,
int x,
int y)
Draws the specified string starting at the specified point. |
void |
fill3DRect(int x,
int y,
int width,
int height,
boolean raised)
Fills the specified rectangle with a 3D effect |
abstract void |
fillArc(int x,
int y,
int width,
int height,
int arcStart,
int arcAngle)
Fills the arc define by the specified bounding rectangle and the specified angle parameter. |
abstract void |
fillOval(int x,
int y,
int width,
int height)
Fills an oval that just fits within the specified rectangle. |
abstract void |
fillPolygon(int[] xPoints,
int[] yPoints,
int npoints)
Fills the polygon determined by the arrays of corresponding x and y coordinates. |
void |
fillPolygon(Polygon polygon)
Fills the specified polygon |
abstract void |
fillRect(int x,
int y,
int width,
int height)
Fills the area bounded by the specified rectangle. |
abstract void |
fillRoundRect(int x,
int y,
int width,
int height,
int arcWidth,
int arcHeight)
Fills the specified rectangle with rounded cornders. |
void |
finalize()
Frees the resources held by this graphics context when it is garbage collected. |
abstract Shape |
getClip()
Returns the current clipping region as a Shape object. |
abstract Rectangle |
getClipBounds()
Returns the bounding rectangle of the clipping region for this graphics context. |
Rectangle |
getClipBounds(Rectangle r)
|
Rectangle |
getClipRect()
Deprecated. This method is deprecated in favor of getClipBounds() . |
abstract Color |
getColor()
Returns the current color for this object. |
abstract Font |
getFont()
Returns the current font for this graphics context. |
FontMetrics |
getFontMetrics()
Returns the font metrics for the current font. |
abstract FontMetrics |
getFontMetrics(Font font)
Returns the font metrics for the specified font. |
boolean |
hitClip(int x,
int y,
int width,
int height)
Returns true if the specified rectangle intersects with the
current clip, false otherwise. |
abstract void |
setClip(int x,
int y,
int width,
int height)
Sets the clipping region to the rectangle determined by the specified parameters. |
abstract void |
setClip(Shape clip)
Sets the clipping region to the specified Shape . |
abstract void |
setColor(Color color)
Sets the current color for this object. |
abstract void |
setFont(Font font)
Sets the font for this graphics context to the specified value. |
abstract void |
setPaintMode()
Sets this context into "paint" mode, where the target pixels are completely overwritten when drawn on. |
abstract void |
setXORMode(Color color)
Sets this context info "XOR" mode, where the targe pixles are XOR-ed when drawn on. |
String |
toString()
Returns a string representation of this object. |
abstract void |
translate(int x,
int y)
Translates this context so that its new origin point is the point (x, y). |
Methods inherited from class java.lang.Object |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
protected Graphics()
Method Detail |
---|
public abstract Graphics create()
Graphics
object.
public Graphics create(int x, int y, int width, int height)
Graphics
object. The origin point
will be translated to the point (x, y) and the cliping rectangle set
to the intersection of the clipping rectangle in this object and the
rectangle specified by the parameters to this method.
x
- The new X coordinate of the clipping region rect.y
- The new Y coordinate of the clipping region rect.width
- The width of the clipping region intersect rectangle.height
- The height of the clipping region intersect rectangle.
public abstract void translate(int x, int y)
x
- The new X coordinate of the origin.y
- The new Y coordinate of the origin.public abstract Color getColor()
public abstract void setColor(Color color)
color
- The new color.public abstract void setPaintMode()
public abstract void setXORMode(Color color)
color
- The color to XOR against.public abstract Font getFont()
public abstract void setFont(Font font)
font
- The new font.public FontMetrics getFontMetrics()
public abstract FontMetrics getFontMetrics(Font font)
font
- The font to return metrics for.
public abstract Rectangle getClipBounds()
public Rectangle getClipRect()
getClipBounds()
.
public abstract void clipRect(int x, int y, int width, int height)
x
- The X coordinate of the upper left corner of the intersect rect.y
- The Y coordinate of the upper left corner of the intersect rect.width
- The width of the intersect rect.height
- The height of the intersect rect.public abstract void setClip(int x, int y, int width, int height)
x
- The X coordinate of the upper left corner of the rect.y
- The Y coordinate of the upper left corner of the rect.width
- The width of the rect.height
- The height of the rect.public abstract Shape getClip()
Shape
object.
Shape
.public abstract void setClip(Shape clip)
Shape
.
clip
- The new clipping region.public abstract void copyArea(int x, int y, int width, int height, int dx, int dy)
x
- The X coordinate of the upper left corner of the copy rect.y
- The Y coordinate of the upper left corner of the copy rect.width
- The width of the copy rect.height
- The height of the copy rect.dx
- The offset from the X value to start drawing.dy
- The offset from the Y value to start drawing.public abstract void drawLine(int x1, int y1, int x2, int y2)
x1
- The X coordinate of the first point.y1
- The Y coordinate of the first point.x2
- The X coordinate of the second point.y2
- The Y coordinate of the second point.public abstract void fillRect(int x, int y, int width, int height)
x
- The X coordinate of the upper left corner of the fill rect.y
- The Y coordinate of the upper left corner of the fill rect.width
- The width of the fill rect.height
- The height of the fill rect.public void drawRect(int x, int y, int width, int height)
x
- The X coordinate of the upper left corner of the draw rect.y
- The Y coordinate of the upper left corner of the draw rect.width
- The width of the draw rect.height
- The height of the draw rect.public abstract void clearRect(int x, int y, int width, int height)
x
- The X coordinate of the upper left corner of the clear rect.y
- The Y coordinate of the upper left corner of the clear rect.width
- The width of the clear rect.height
- The height of the clear rect.public abstract void drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
x
- The X coordinate of the upper left corner of the draw rect.y
- The Y coordinate of the upper left corner of the draw rect.width
- The width of the draw rect.height
- The height of the draw rect.arcWidth
- The width of the corner arcs.arcHeight
- The height of the corner arcs.public abstract void fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
x
- The X coordinate of the upper left corner of the fill rect.y
- The Y coordinate of the upper left corner of the fill rect.width
- The width of the fill rect.height
- The height of the fill rect.arcWidth
- The width of the corner arcs.arcHeight
- The height of the corner arcs.public void draw3DRect(int x, int y, int width, int height, boolean raised)
public void fill3DRect(int x, int y, int width, int height, boolean raised)
x
- The X coordinate of the upper left corner of the fill rect.y
- The Y coordinate of the upper left corner of the fill rect.width
- The width of the fill rect.height
- The height of the fill rect.raised
- true
if the rectangle appears raised,
false
if it should appear etched.public abstract void drawOval(int x, int y, int width, int height)
x
- The X coordinate of the upper left corner of the rect.y
- The Y coordinate of the upper left corner of the rect.width
- The width of the rect.height
- The height of the rect.public abstract void fillOval(int x, int y, int width, int height)
x
- The X coordinate of the upper left corner of the rect.y
- The Y coordinate of the upper left corner of the rect.width
- The width of the rect.height
- The height of the rect.public abstract void drawArc(int x, int y, int width, int height, int arcStart, int arcAngle)
x
- The X coordinate of the upper left corner of the rect.y
- The Y coordinate of the upper left corner of the rect.width
- The width of the rect.height
- The height of the rect.arcStart
- The beginning angle of the arc.arcAngle
- The extent of the arc.public abstract void fillArc(int x, int y, int width, int height, int arcStart, int arcAngle)
x
- The X coordinate of the upper left corner of the rect.y
- The Y coordinate of the upper left corner of the rect.width
- The width of the rect.height
- The height of the rect.arcStart
- The beginning angle of the arc.arcAngle
- The extent of the arc.public abstract void drawPolyline(int[] xPoints, int[] yPoints, int npoints)
xPoints
- The X coordinate array.yPoints
- The Y coordinate array.npoints
- The number of points to draw.public abstract void drawPolygon(int[] xPoints, int[] yPoints, int npoints)
xPoints
- The X coordinate array.yPoints
- The Y coordinate array.npoints
- The number of points to draw.public void drawPolygon(Polygon polygon)
polygon
- The polygon to draw.public abstract void fillPolygon(int[] xPoints, int[] yPoints, int npoints)
xPoints
- The X coordinate array.yPoints
- The Y coordinate array.npoints
- The number of points to draw.public void fillPolygon(Polygon polygon)
polygon
- The polygon to fill.public abstract void drawString(String string, int x, int y)
string
- The string to draw.x
- The X coordinate of the point to draw at.y
- The Y coordinate of the point to draw at.public abstract void drawString(AttributedCharacterIterator ci, int x, int y)
public void drawChars(char[] data, int offset, int length, int x, int y)
data
- The array of characters to draw.offset
- The offset into the array to start drawing characters from.length
- The number of characters to draw.x
- The X coordinate of the point to draw at.y
- The Y coordinate of the point to draw at.public void drawBytes(byte[] data, int offset, int length, int x, int y)
public abstract boolean drawImage(Image image, int x, int y, ImageObserver observer)
false
is returned and
the specified iamge observer is notified as more data becomes
available.
image
- The image to draw.x
- The X coordinate of the point to draw at.y
- The Y coordinate of the point to draw at.observer
- The image observer to notify as data becomes available.
true
if all the image data is available,
false
otherwise.public abstract boolean drawImage(Image image, int x, int y, int width, int height, ImageObserver observer)
false
is returned and
the specified iamge observer is notified as more data becomes
available.
image
- The image to draw.x
- The X coordinate of the point to draw at.y
- The Y coordinate of the point to draw at.width
- The width of the rectangle to draw in.height
- The height of the rectangle to draw in.observer
- The image observer to notify as data becomes available.
true
if all the image data is available,
false
otherwise.public abstract boolean drawImage(Image image, int x, int y, Color bgcolor, ImageObserver observer)
false
is returned and
the specified iamge observer is notified as more data becomes
available.
image
- The image to draw.x
- The X coordinate of the point to draw at.y
- The Y coordinate of the point to draw at.bgcolor
- The background color to use for the image.observer
- The image observer to notify as data becomes available.
true
if all the image data is available,
false
otherwise.public abstract boolean drawImage(Image image, int x, int y, int width, int height, Color bgcolor, ImageObserver observer)
false
is returned and
the specified iamge observer is notified as more data becomes
available.
image
- The image to draw.x
- The X coordinate of the point to draw at.y
- The Y coordinate of the point to draw at.width
- The width of the rectangle to draw in.height
- The height of the rectangle to draw in.bgcolor
- The background color to use for the image.observer
- The image observer to notify as data becomes available.
true
if all the image data is available,
false
otherwise.public abstract boolean drawImage(Image image, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer)
public abstract boolean drawImage(Image image, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, Color bgcolor, ImageObserver observer)
public abstract void dispose()
public void finalize()
finalize
in class Object
System.gc()
,
System.runFinalizersOnExit(boolean)
,
java.lang.ref
public String toString()
toString
in class Object
Object.getClass()
,
Object.hashCode()
,
Class.getName()
,
Integer.toHexString(int)
public boolean hitClip(int x, int y, int width, int height)
true
if the specified rectangle intersects with the
current clip, false
otherwise.
x
- the X coordinate of the upper left corner of the test rectangley
- the Y coordinate of the upper left corner of the test rectanglewidth
- the width of the upper left corner of the test rectangleheight
- the height of the upper left corner of the test rectangle
true
if the specified rectangle intersects with the
current clip, false
otherwisepublic Rectangle getClipBounds(Rectangle r)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |