|
Java Platform 1.2 Beta 4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.awt.geom.RectangularShape | +--java.awt.geom.Rectangle2D | +--java.awt.Rectangle
A rectangle's width
and height
are
public fields. The constructors that allow you to create a
rectangle, and the methods that allow you to modify one, do not
prevent you from setting a negative value for width or height.
A rectangle whose width or height is negative is considered
empty, and all methods defined by the Rectangle
class
behave accordingly. If the rectangle is empty, then the method
isEmpty
returns true
. No point can be
contained by or inside an empty rectangle, however the values of
width
and height
are still valid. An
empty rectangle still has a location in the coordinate space, and
methods that change its size or location remain valid. The
behavior of methods that operate on more than one rectangle is
undefined if any of the participating rectangles has a negative
width
or height
. These methods include
intersects
, intersection
, and
union
.
specified in integer coordinates.
Inner classes inherited from class java.awt.geom.Rectangle2D | |
Rectangle2D.Double , Rectangle2D.Float |
Field Summary | |
int | height
The height of the rectangle. |
int | width
The width of the rectangle. |
int | x
The x coordinate of the rectangle. |
int | y
The y coordinate of the rectangle. |
Fields inherited from class java.awt.geom.Rectangle2D | |
OUT_BOTTOM , OUT_LEFT , OUT_RIGHT , OUT_TOP |
Constructor Summary | |
Rectangle()
Constructs a new rectangle whose top-left corner is at (0, 0) in the coordinate space, and whose width and height are zero. |
|
Rectangle(Dimension d)
Constructs a new rectangle whose top left corner is (0, 0) and whose width and height are specified by the dimension argument. |
|
Rectangle(int x,
int y,
int width,
int height)
Constructs a new rectangle whose top-left corner is specified as ( x , y ) and whose width and height
are specified by the arguments of the same name. |
|
Rectangle(int width,
int height)
Constructs a new rectangle whose top-left corner is at (0, 0) in the coordinate space, and whose width and height are specified by the arguments of the same name. |
|
Rectangle(Point p,
Dimension d)
Constructs a new rectangle whose top-left corner is specified by the point argument, and whose width and height
are specified by the dimension argument. |
|
Rectangle(Point p)
Constructs a new rectangle whose top-left corner is the specified point, and whose width and height are zero. |
|
Rectangle(Rectangle r)
Constructs a new rectangle, initialized to match the values of the specificed rectangle. |
Method Summary | |
void | add(int newx,
int newy)
Adds a point, specified by the integer arguments newx
and newy , to this rectangle. |
void | add(Point pt)
Adds the point pt to this rectangle. |
void | add(Rectangle r)
Adds a rectangle to this rectangle. |
boolean | contains(int X,
int Y,
int W,
int H)
Checks whether this rectangle entirely contains the rectangle at the specified location (X, Y) with the specified dimensions (W, H). |
boolean | contains(int x,
int y)
Checks whether this rectangle contains the point at the specified location (x, y). |
boolean | contains(Point p)
Checks whether this rectangle contains the specified point. |
boolean | contains(Rectangle r)
Checks whether this rectangle entirely contains the specified rectangle. |
Rectangle2D | createIntersection(Rectangle2D r)
Return a new Rectangle2D object representing the intersection of this rectangle with the given rectangle. |
Rectangle2D | createUnion(Rectangle2D r)
Return a new Rectangle2D object representing the union of this rectangle with the given rectangle. |
boolean | equals(Object obj)
Checks whether two rectangles are equal. |
Rectangle | getBounds()
Gets the bounding rectangle of this rectangle. |
double | getHeight()
Returns the height of the bounding rectangle in double precision. |
Point | getLocation()
Returns the location of this rectangle. |
Dimension | getSize()
Gets the size (width and height) of this rectangle. |
double | getWidth()
Returns the width of the bounding rectangle in double precision. |
double | getX()
Returns the X coordinate of the bounding rectangle in double precision. |
double | getY()
Returns the Y coordinate of the bounding rectangle in double precision. |
void | grow(int h,
int v)
Grows the rectangle both horizontally and vertically. |
int | hashCode()
Returns the hashcode for this rectangle. |
boolean | inside(int x,
int y)
Deprecated. As of JDK version 1.1, replaced by contains(int, int) . |
Rectangle | intersection(Rectangle r)
Computes the intersection of this rectangle with the specified rectangle. |
boolean | intersects(Rectangle r)
Determines whether this rectangle and the specified rectangle intersect. |
boolean | isEmpty()
Determines whether this rectangle is empty. |
void | move(int x,
int y)
Deprecated. As of JDK version 1.1, replaced by setLocation(int, int) . |
int | outcode(double x,
double y)
Determines where the specified float coordinates lie with respect to this Rectangle. |
void | reshape(int x,
int y,
int width,
int height)
Deprecated. As of JDK version 1.1, replaced by setBounds(int, int, int, int) . |
void | resize(int width,
int height)
Deprecated. As of JDK version 1.1, replaced by setSize(int, int) . |
void | setBounds(int x,
int y,
int width,
int height)
Sets the bounding rectangle of this rectangle to the specified values for x , y , width ,
and height .
|
void | setBounds(Rectangle r)
Sets the bounding rectangle of this rectangle to match the specified rectangle. |
void | setLocation(int x,
int y)
Moves the rectangle to the specified location. |
void | setLocation(Point p)
Moves the rectangle to the specified location. |
void | setRect(double x,
double y,
double width,
double height)
Set the bounds of this rectangle to the specified x, y, width, and height. |
void | setSize(Dimension d)
Sets the size of this rectangle to match the specified dimension. |
void | setSize(int width,
int height)
Sets the size of this rectangle to the specified width and height. |
String | toString()
Returns a string representation of this rectangle and its values. |
void | translate(int x,
int y)
Translates the rectangle the indicated distance, to the right along the x coordinate axis, and downward along the y coordinate axis. |
Rectangle | union(Rectangle r)
Computes the union of this rectangle with the specified rectangle. |
Methods inherited from class java.awt.geom.Rectangle2D | |
add , add , add , contains , contains , getBounds2D , getPathIterator , getPathIterator , intersect , intersects , intersectsLine , intersectsLine , outcode , setFrame , setRect , union |
Methods inherited from class java.awt.geom.RectangularShape | |
clone , contains , contains , getCenterX , getCenterY , getFrame , getMaxX , getMaxY , getMinX , getMinY , intersects , setFrame , setFrame , setFrameFromCenter , setFrameFromCenter , setFrameFromDiagonal , setFrameFromDiagonal |
Methods inherited from class java.lang.Object | |
finalize , getClass , notify , notifyAll , wait , wait , wait |
Field Detail |
public int x
public int y
public int width
public int height
Constructor Detail |
public Rectangle()
public Rectangle(Rectangle r)
r
- a rectangle from which to copy initial values.public Rectangle(int x, int y, int width, int height)
x
, y
) and whose width and height
are specified by the arguments of the same name.
x
- the x coordinate.
y
- the y coordinate.
width
- the width of the rectangle.
height
- the height of the rectangle.public Rectangle(int width, int height)
width
- the width of the rectangle.
height
- the height of the rectangle.public Rectangle(Point p, Dimension d)
point
argument, and whose width and height
are specified by the dimension
argument.
p
- a point, the top-left corner of the rectangle.
d
- a dimension, representing the width and height.public Rectangle(Point p)
p
- the top left corner of the rectangle.public Rectangle(Dimension d)
dimension
argument.
d
- a dimension, specifying width and height.Method Detail |
public double getX()
public double getY()
public double getWidth()
public double getHeight()
public Rectangle getBounds()
This method is included for completeness, to parallel the
getBounds
method of Component
.
Component.getBounds()
public void setBounds(Rectangle r)
This method is included for completeness, to parallel the
setBounds
method of Component
.
r
- a rectangle.Component.setBounds(java.awt.Rectangle)
public void setBounds(int x, int y, int width, int height)
x
, y
, width
,
and height
.
This method is included for completeness, to parallel the
setBounds
method of Component
.
x
- the new x coordinate for the top-left
corner of this rectangle.
y
- the new y coordinate for the top-left
corner of this rectangle.
width
- the new width for this rectangle.
height
- the new height for this rectangle.Component.setBounds(int, int, int, int)
public void setRect(double x, double y, double width, double height)
width
- the new width for the Dimension object
height
- the new height for the Dimension objectpublic void reshape(int x, int y, int width, int height)
setBounds(int, int, int, int)
.public Point getLocation()
This method is included for completeness, to parallel the
getLocation
method of Component
.
Component.getLocation()
public void setLocation(Point p)
This method is included for completeness, to parallel the
setLocation
method of Component
.
p
- the new location for the point.Component.setLocation(java.awt.Point)
public void setLocation(int x, int y)
This method is included for completeness, to parallel the
setLocation
method of Component
.
x
- the x coordinate of the new location.
y
- the y coordinate of the new location.Component.setLocation(int, int)
public void move(int x, int y)
setLocation(int, int)
.public void translate(int x, int y)
dx
- the distance to move the rectangle
along the x axis.
dy
- the distance to move the rectangle
along the y axis.setLocation(int, int)
,
setLocation(java.awt.Point)
public Dimension getSize()
This method is included for completeness, to parallel the
getSize
method of Component
.
Component.getSize()
public void setSize(Dimension d)
This method is included for completeness, to parallel the
setSize
method of Component
.
d
- the new size for the Dimension objectComponent.setSize(java.awt.Dimension)
public void setSize(int width, int height)
This method is included for completeness, to parallel the
setSize
method of Component
.
width
- the new width for this rectangle object.
height
- the new height for this rectangle object.Component.setSize(int, int)
public void resize(int width, int height)
setSize(int, int)
.public boolean contains(Point p)
p
- the point (location) to test.true
if the point
(x, y) is inside this rectangle;
false
otherwise.public boolean contains(int x, int y)
x
- the x coordinate.
y
- the y coordinate.true
if the point
(x, y) is inside this rectangle;
false
otherwise.public boolean contains(Rectangle r)
r
- the rectangle.true
if the rectangle (r)
is contained entirely inside this rectangle;
false
otherwise.public boolean contains(int X, int Y, int W, int H)
X
- the x coordinate.
Y
- the y coordinate.
W
- the width of the rectangle.
H
- the height of the rectangle.true
if the rectangle specified by
(X, Y, W, H)
is entirely enclosed inside this rectangle;
false
otherwise.public boolean inside(int x, int y)
contains(int, int)
.public boolean intersects(Rectangle r)
r
- a rectangle.true
if the specified rectangle
and this rectangle insersect;
false
otherwise.public Rectangle intersection(Rectangle r)
r
- a rectangle.public Rectangle union(Rectangle r)
r
- a rectangle.public void add(int newx, int newy)
newx
and newy
, to this rectangle. The resulting rectangle is
the smallest rectangle that contains both the original rectangle
and the specified point.
After adding a point, a call to contains
with the
added point as an argument will not necessarily return
true
. The contains
method does not
return true
for points on the right or bottom
edges of a rectangle. Therefore if the added point falls on
the right or bottom edge of the enlarged rectangle,
contains
will return false
for that point.
newx
- the x coordinate of the new point.
newy
- the y coordinate of the new point.
public void add(Point pt)
pt
to this rectangle. The resulting
rectangle is the smallest rectangle that contains both the
original rectangle and the specified point.
After adding a point, a call to contains
with the
added point as an argument will not necessarily return
true
. The contains
method does not
return true
for points on the right or bottom
edges of a rectangle. Therefore if the added point falls on
the right or bottom edge of the enlarged rectangle,
contains
will return false
for that point.
pt
- the new point to add to the rectangle.
public void add(Rectangle r)
a
- rectangle.public void grow(int h, int v)
This method modifies the rectangle so that it is
h
units larger on both the left and right side,
and v
units larger at both the top and bottom.
The new rectangle has (x - h
,
y - v
) as its top-left corner, a
width of
width
+
2h
,
and a height of
height
+
2v
.
If negative values are supplied for h
and
v
, the size of the rectangle decreases accordingly.
The grow
method does not check whether the resulting
values of width
and height
are
non-negative.
h
- the horizontal expansion.
v
- the vertical expansion.public boolean isEmpty()
true
if this rectangle is empty;
false
otherwise.public int outcode(double x, double y)
Rectangle2D.OUT_LEFT
,
Rectangle2D.OUT_TOP
,
Rectangle2D.OUT_RIGHT
,
Rectangle2D.OUT_BOTTOM
public Rectangle2D createIntersection(Rectangle2D r)
r
- the rectangle to be intersected withpublic Rectangle2D createUnion(Rectangle2D r)
r
- the rectangle to be combined withpublic int hashCode()
public boolean equals(Object obj)
The result is true if and only if the argument is not null and is a Rectangle object that has the same top-left corner, width, and height as this rectangle.
obj
- the object to compare with.true
if the objects are equal;
false
otherwise.public String toString()
|
Java Platform 1.2 Beta 4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |