java.awt
クラス Rectangle

java.lang.Object
  java.awt.geom.RectangularShape
      java.awt.geom.Rectangle2D
          java.awt.Rectangle

すべての実装されたインタフェース:

Shape, Serializable, Cloneable

直系の既知のサブクラス:

DefaultCaret

public class Rectangle
extends Rectangle2D
implements Shape, Serializable

Rectangle は、Rectangle オブジェクトの座標空間での左上の点 (x,y)、およびその幅と高さによって囲まれる座標空間内の領域を指定します。

Rectangle オブジェクトの width および height は public フィールドです。Rectangle を作成するコンストラクタ、および Rectangle を変更できるメソッドには、width や height の値として負の値を設定できます。

幅または高さが正確に 0 である Rectangle は、これらの軸に沿った位置で寸法 0 ですが、それ以外の場合は空であると見なされます。isEmpty() メソッドは、そのような Rectangle に対して true を返します。空の Rectangle が点または矩形を含むか交差するかを判定するメソッドは、いずれかの寸法が 0 であれば常に false を返します。そのような Rectangle を点または矩形と結合するメソッドの結果には、add(Point) メソッドが呼び出された場合と同じように、その軸上の Rectangle の位置が含まれます。

幅または高さが負である Rectangle は、寸法が負でこれらの軸に沿った位置も寸法もありません。このような Rectangle は、これらの軸に沿って存在しないものとして扱われます。また、このような Rectangle は、包含の計算では空であるとみなされ、点または矩形を含むか交差するかを判定するメソッドは常に false を返します。このような Rectangle を点または矩形と結合するメソッドでは、結果の生成時に Rectangle 全体が無視されます。2 つの Rectangle オブジェクトを結合する場合に、どちらの寸法も負であると、結果には負の寸法が少なくとも 1 つ含まれます。

Rectangle の位置のみに影響するメソッドは、その寸法がどちらかの軸に沿って負または 0 であるかどうかに関係なく、Rectangle の位置で機能します。

デフォルトの引数をとらないコンストラクタで構築された Rectangle は、寸法が 0x0 であり、そのため空になります。この Rectangle の位置は (0,0) になり、この位置は結合操作および追加操作で使用されます。そのため、点のセットの境界を累積しようとするコードでは、最初に負の幅と高さを使用して Rectangle を構築するか、セットの最初の点を使用して Rectangle を構築する必要があります。次に例を示します。

     Rectangle bounds = new Rectangle(0, 0, -1, -1);
     for (int i = 0; i < points.length; i++) {
         bounds.add(points[i]);
     }
 

点の配列に少なくとも 1 つの点が含まれることがわかっている場合は、次のようになります。

     Rectangle bounds = new Rectangle(points[0]);
     for (int i = 1; i < points.length; i++) {
         bounds.add(points[i]);
     }
 

このクラスは 32 ビット整数を使用して、位置および寸法を格納します。操作によっては、結果が 32 ビット整数の範囲を超えることもあります。メソッドは結果を計算する際に、中間結果で 32 ビットオーバーフローが発生しないような方法を使用し、位置および寸法を保持する 32 ビットフィールドに最終結果を格納するための最適表現を選択します。結果の位置は、実際の結果を直近の 32 ビット値にクリッピングして、x および y フィールドに格納されます。width および height 寸法フィールドに格納される値には、実際の結果を最大限に含むような 32 ビット値が選択されます。一般に、寸法は 32 ビット整数の範囲とは無関係にクリッピングされます。ただし、位置を 32 ビットフィールドのペアに格納できるように位置を移動した場合は、位置の「最適表現」に合わせて寸法が調整されます。実際の結果に負の寸法が含まれるために一方または両方の軸に沿って存在しないものとされている場合、格納される寸法はそれらの軸で負の値になります。実際の結果の位置が、32 ビット整数の範囲内で表現可能だが、一方または両方の軸で寸法が 0 である場合、格納される寸法はそれらの軸で 0 になります。

導入されたバージョン:

1.0

関連項目:

直列化された形式

入れ子のクラスの概要

クラス java.awt.geom.Rectangle2D から継承された入れ子のクラス/インタフェース

Rectangle2D.Double, Rectangle2D.Float

フィールドの概要

int	height Rectangle の高さです。
int	width Rectangle の幅です。
int	x Rectangle の左上隅の X 座標です。
int	y Rectangle の左上隅の Y 座標です。

クラス java.awt.geom.Rectangle2D から継承されたフィールド

OUT_BOTTOM, OUT_LEFT, OUT_RIGHT, OUT_TOP

コンストラクタの概要

Rectangle()
左上隅が座標空間の (0, 0) にあり、幅と高さが両方とも 0 の新しい Rectangle を構築します。

Rectangle(Dimension d)
左上隅が (0, 0) で、幅と高さが Dimension 引数で指定される新しい Rectangle を構築します。

Rectangle(int width, int height)
左上隅が座標空間の (0, 0) にあり、幅と高さが width 引数および height 引数で指定される新しい Rectangle を構築します。

Rectangle(int x, int y, int width, int height)
左上隅が (x,y) として指定され、幅と高さが width 引数および height 引数で指定される新しい Rectangle を構築します。

Rectangle(Point p)
左上隅が指定された Point で、幅と高さが両方とも 0 である新しい Rectangle を構築します。

Rectangle(Point p, Dimension d)
左上隅が Point 引数で指定され、幅と高さが Dimension 引数で指定される新しい Rectangle を構築します。

Rectangle(Rectangle r)
指定された Rectangle の値に一致するように初期化された新しい Rectangle を構築します。

メソッドの概要

void	add(int newx, int newy) 整数型の引数 newx,newy によって指定される点をこの Rectangle の境界に追加します。
void	add(Point pt) 指定された Point をこの Rectangle の境界に追加します。
void	add(Rectangle r) Rectangle をこの Rectangle に追加します。
boolean	contains(int x, int y) この Rectangle が、指定された位置 (x,y) にある点を含むかどうかを判定します。
boolean	contains(int X, int Y, int W, int H) 指定された位置 (X,Y) にあり、指定されたサイズ (W,H) である Rectangle を、この Rectangle が完全に含むかどうかを判定します。
boolean	contains(Point p) この Rectangle が指定された Point を含むかどうかを判定します。
boolean	contains(Rectangle r) この Rectangle が、指定された Rectangle を完全に含むかどうかを判定します。
Rectangle2D	createIntersection(Rectangle2D r) この Rectangle2D と指定された Rectangle2D の共通部分を表す新しい Rectangle2D オブジェクトを返します。
Rectangle2D	createUnion(Rectangle2D r) この Rectangle2D と指定された Rectangle2D の和集合を表す新しい Rectangle2D オブジェクトを返します。
boolean	equals(Object obj) 2 つの矩形が同じかどうかを判定します。
Rectangle	getBounds() この Rectangle の境界の Rectangle 領域を取得します。
Rectangle2D	getBounds2D() 高精度で getBounds メソッドより精密な、Shape のバウンディングボックスを返します。
double	getHeight() 境界の Rectangle 領域の高さを double 精度で返します。
Point	getLocation() この Rectangle の位置を返します。
Dimension	getSize() 返された Dimension で表された、この Rectangle のサイズを返します。
double	getWidth() 境界の Rectangle 領域の幅を double 精度で返します。
double	getX() 境界の Rectangle 領域の X 座標を double 精度で返します。
double	getY() 境界の Rectangle 領域の Y 座標を double 精度で返します。
void	grow(int h, int v) Rectangle を水平方向と垂直方向の両方にサイズ変更します。
boolean	inside(int X, int Y) 推奨されていません。 JDK version 1.1 以降は、 contains(int, int) に置き換えられました。
Rectangle	intersection(Rectangle r) この Rectangle と指定された Rectangle との共通部分を算出します。
boolean	intersects(Rectangle r) この Rectangle と指定された Rectangle とが交差するかどうかを判定します。
boolean	isEmpty() RectangularShape が空かどうかを判定します。
void	move(int x, int y) 推奨されていません。 JDK version 1.1 以降は、 setLocation(int, int) に置き換えられました。
int	outcode(double x, double y) この Rectangle2D を基準に、指定された座標のある場所を判定します。
void	reshape(int x, int y, int width, int height) 推奨されていません。 JDK version 1.1 以降は、 setBounds(int, int, int, int) に置き換えられました。
void	resize(int width, int height) 推奨されていません。 JDK version 1.1 以降は、 setSize(int, int) に置き換えられました。
void	setBounds(int x, int y, int width, int height) この Rectangle の境界の Rectangle 領域を、x、y、width、および height で指定された値に設定します。
void	setBounds(Rectangle r) この Rectangle の境界の Rectangle 領域を、指定された Rectangle に一致するように設定します。
void	setLocation(int x, int y) この Rectangle を指定された位置に移動します。
void	setLocation(Point p) この Rectangle を指定された位置に移動します。
void	setRect(double x, double y, double width, double height) この Rectangle の境界を、指定された x、y、width、および height を取り囲む整数境界に設定します。
void	setSize(Dimension d) この Rectangle のサイズを、指定された Dimension に一致するように設定します。
void	setSize(int width, int height) この Rectangle の大きさを指定された幅と高さに設定します。
String	toString() この Rectangle およびその値を表す String 表現を返します。
void	translate(int dx, int dy) X 座標軸に沿って右方向、Y 座標軸に沿って下方向へ、指定された距離だけこの Rectangle を平行移動します。
Rectangle	union(Rectangle r) この Rectangle と指定された Rectangle との結合部分を算出します。

クラス java.awt.geom.Rectangle2D から継承されたメソッド

add, add, add, contains, contains, getPathIterator, getPathIterator, hashCode, intersect, intersects, intersectsLine, intersectsLine, outcode, setFrame, setRect, union

クラス java.awt.geom.RectangularShape から継承されたメソッド

clone, contains, contains, getCenterX, getCenterY, getFrame, getMaxX, getMaxY, getMinX, getMinY, intersects, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal

クラス java.lang.Object から継承されたメソッド

finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェース java.awt.Shape から継承されたメソッド

contains, contains, contains, contains, getPathIterator, getPathIterator, intersects, intersects

フィールドの詳細

x

public int x

Rectangle の左上隅の X 座標です。

導入されたバージョン:

1.0

関連項目:

setLocation(int, int), getLocation()

y

public int y

Rectangle の左上隅の Y 座標です。

導入されたバージョン:

1.0

関連項目:

setLocation(int, int), getLocation()

width

public int width

Rectangle の幅です。

導入されたバージョン:

1.0

関連項目:

setSize(int, int), getSize()

height

public int height

Rectangle の高さです。

導入されたバージョン:

1.0

関連項目:

setSize(int, int), getSize()

コンストラクタの詳細

Rectangle

public Rectangle()

左上隅が座標空間の (0, 0) にあり、幅と高さが両方とも 0 の新しい Rectangle を構築します。

Rectangle

public Rectangle(Rectangle r)

指定された Rectangle の値に一致するように初期化された新しい Rectangle を構築します。

パラメータ:

r - 新しく構築される Rectangle の 初期値のコピー元となる Rectangle

導入されたバージョン:

1.1

Rectangle

public Rectangle(int x,
                 int y,
                 int width,
                 int height)

左上隅が (x,y) として指定され、幅と高さが width 引数および height 引数で指定される新しい Rectangle を構築します。

パラメータ:

x - 指定された X 座標

y - 指定された Y 座標

width - Rectangle の幅

height - Rectangle の高さ

導入されたバージョン:

1.0

Rectangle

public Rectangle(int width,
                 int height)

左上隅が座標空間の (0, 0) にあり、幅と高さが width 引数および height 引数で指定される新しい Rectangle を構築します。

パラメータ:

width - Rectangle の幅

height - Rectangle の高さ

Rectangle

public Rectangle(Point p,
                 Dimension d)

左上隅が Point 引数で指定され、幅と高さが Dimension 引数で指定される新しい Rectangle を構築します。

パラメータ:

p - この Rectangle の左上隅の Point

d - Rectangle の幅と高さを表す Dimension

Rectangle

public Rectangle(Point p)

左上隅が指定された Point で、幅と高さが両方とも 0 である新しい Rectangle を構築します。

パラメータ:

p - この Rectangle の左上隅の Point

Rectangle

public Rectangle(Dimension d)

左上隅が (0, 0) で、幅と高さが Dimension 引数で指定される新しい Rectangle を構築します。

パラメータ:

d - 幅と高さを指定する Dimension

メソッドの詳細

getX

public double getX()

境界の Rectangle 領域の X 座標を double 精度で返します。

定義:

クラス RectangularShape 内の getX

戻り値:

境界の Rectangle 領域の X 座標

getY

public double getY()

境界の Rectangle 領域の Y 座標を double 精度で返します。

定義:

クラス RectangularShape 内の getY

戻り値:

境界の Rectangle 領域の Y 座標

getWidth

public double getWidth()

境界の Rectangle 領域の幅を double 精度で返します。

定義:

クラス RectangularShape 内の getWidth

戻り値:

境界の Rectangle 領域の幅

getHeight

public double getHeight()

境界の Rectangle 領域の高さを double 精度で返します。

定義:

クラス RectangularShape 内の getHeight

戻り値:

境界の Rectangle 領域の高さ

getBounds

public Rectangle getBounds()

この Rectangle の境界の Rectangle 領域を取得します。

このメソッドは完全性のために用意されているもので、Component の getBounds メソッドに対応します。

定義:

インタフェース Shape 内の getBounds

オーバーライド:

クラス RectangularShape 内の getBounds

戻り値:

新しい Rectangle。 この Rectangle の境界の Rectangle 領域に等しい

導入されたバージョン:

1.1

関連項目:

Component.getBounds(), setBounds(Rectangle), setBounds(int, int, int, int)

getBounds2D

public Rectangle2D getBounds2D()

高精度で getBounds メソッドより精密な、Shape のバウンディングボックスを返します。返された Rectangle2D が Shape を囲む最小のバウンディングボックスであるとは限りません。 示された Rectangle2D 内に Shape が完全に収まるというだけです。戻り値を、倍精度値を使用して寸法を格納する Rectangle2D のインスタンスにすることもできるため、このメソッドによって返されるバウンディングボックスは、通常、getBounds メソッドによって返されるバウンディングボックスよりもぴったりしたものになり、オーバーフローのために失敗することはありません。

定義:

インタフェース Shape 内の getBounds2D

オーバーライド:

クラス Rectangle2D 内の getBounds2D

戻り値:

Shape の高精度バウンディングボックスを表す Rectangle2D のインスタンス

導入されたバージョン:

1.2

関連項目:

Shape.getBounds()

setBounds

public void setBounds(Rectangle r)

この Rectangle の境界の Rectangle 領域を、指定された Rectangle に一致するように設定します。

このメソッドは完全性のために用意されているもので、Component の setBounds メソッドに対応します。

パラメータ:

r - 指定された Rectangle

導入されたバージョン:

1.1

関連項目:

getBounds(), Component.setBounds(java.awt.Rectangle)

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

この Rectangle の境界の Rectangle 領域を、x、y、width、および height で指定された値に設定します。

このメソッドは完全性のために用意されているもので、Component の setBounds メソッドに対応します。

パラメータ:

x - この Rectangle の 左上隅の新しい X 座標

y - この Rectangle の 左上隅の新しい Y 座標

width - この Rectangle の新しい幅

height - この Rectangle の新しい高さ

導入されたバージョン:

1.1

関連項目:

getBounds(), Component.setBounds(int, int, int, int)

setRect

public void setRect(double x,
                    double y,
                    double width,
                    double height)

この Rectangle の境界を、指定された x、y、width、および height を取り囲む整数境界に設定します。これらのパラメータによって整数の最大範囲を超える Rectangle が指定される場合、最大整数境界と交差する、指定された Rectangle の最適表現が得られます。

定義:

クラス Rectangle2D 内の setRect

パラメータ:

x - 指定された矩形の左上隅の X 座標

y - 指定された矩形の左上隅の Y 座標

width - 指定された矩形の幅

height - 指定された矩形の新しい高さ

reshape

@Deprecated
public void reshape(int x,
                               int y,
                               int width,
                               int height)

推奨されていません。 JDK version 1.1 以降は、 setBounds(int, int, int, int) に置き換えられました。

この Rectangle の境界の Rectangle 領域を、x、y、width、および height で指定された値に設定します。

パラメータ:

x - この Rectangle の 左上隅の新しい X 座標

y - この Rectangle の 左上隅の新しい Y 座標

width - この Rectangle の新しい幅

height - この Rectangle の新しい高さ

getLocation

public Point getLocation()

この Rectangle の位置を返します。

このメソッドは完全性のために用意されているもので、Component の getLocation メソッドに対応します。

戻り値:

この Rectangle の左上隅の Point

導入されたバージョン:

1.1

関連項目:

Component.getLocation(), setLocation(Point), setLocation(int, int)

setLocation

public void setLocation(Point p)

この Rectangle を指定された位置に移動します。

このメソッドは完全性のために用意されているもので、Component の setLocation メソッドに対応します。

パラメータ:

p - この Rectangle の新しい位置を指定する Point

導入されたバージョン:

1.1

関連項目:

Component.setLocation(java.awt.Point), getLocation()

setLocation

public void setLocation(int x,
                        int y)

この Rectangle を指定された位置に移動します。

このメソッドは完全性のために用意されているもので、Component の setLocation メソッドに対応します。

パラメータ:

x - 新しい位置の X 座標

y - 新しい位置の Y 座標

導入されたバージョン:

1.1

関連項目:

getLocation(), Component.setLocation(int, int)

move

@Deprecated
public void move(int x,
                            int y)

推奨されていません。 JDK version 1.1 以降は、 setLocation(int, int) に置き換えられました。

この Rectangle を指定された位置に移動します。

パラメータ:

x - 新しい位置の X 座標

y - 新しい位置の Y 座標

translate

public void translate(int dx,
                      int dy)

X 座標軸に沿って右方向、Y 座標軸に沿って下方向へ、指定された距離だけこの Rectangle を平行移動します。

パラメータ:

dx - X 軸に沿ってこの Rectangle が移動する 距離

dy - Y 軸に沿ってこの Rectangle が移動する 距離

関連項目:

setLocation(int, int), setLocation(java.awt.Point)

getSize

public Dimension getSize()

返された Dimension で表された、この Rectangle のサイズを返します。

このメソッドは完全性のために用意されているもので、Component の getSize メソッドに対応します。

戻り値:

この Rectangle のサイズを表す Dimension

導入されたバージョン:

1.1

関連項目:

Component.getSize(), setSize(Dimension), setSize(int, int)

setSize

public void setSize(Dimension d)

この Rectangle のサイズを、指定された Dimension に一致するように設定します。

このメソッドは完全性のために用意されているもので、Component の setSize メソッドに対応します。

パラメータ:

d - Dimension オブジェクトの新しいサイズ

導入されたバージョン:

1.1

関連項目:

Component.setSize(java.awt.Dimension), getSize()

setSize

public void setSize(int width,
                    int height)

この Rectangle の大きさを指定された幅と高さに設定します。

このメソッドは完全性のために用意されているもので、Component の setSize メソッドに対応します。

パラメータ:

width - この Rectangle の新しい幅

height - この Rectangle の新しい高さ

導入されたバージョン:

1.1

関連項目:

Component.setSize(int, int), getSize()

resize

@Deprecated
public void resize(int width,
                              int height)

推奨されていません。 JDK version 1.1 以降は、 setSize(int, int) に置き換えられました。

この Rectangle の大きさを指定された幅と高さに設定します。

パラメータ:

width - この Rectangle の新しい幅

height - この Rectangle の新しい高さ

contains

public boolean contains(Point p)

この Rectangle が指定された Point を含むかどうかを判定します。

パラメータ:

p - 判定する対象となる Point

戻り値:

指定された Point がこの Rectangle の 内部にある場合は true、 そうでない場合は false

導入されたバージョン:

1.1

contains

public boolean contains(int x,
                        int y)

この Rectangle が、指定された位置 (x,y) にある点を含むかどうかを判定します。

パラメータ:

x - 指定された X 座標

y - 指定された Y 座標

戻り値:

点 (x,y) がこの Rectangle の 内部にある場合は true、 そうでない場合は false

導入されたバージョン:

1.1

contains

public boolean contains(Rectangle r)

この Rectangle が、指定された Rectangle を完全に含むかどうかを判定します。

パラメータ:

r - 指定された Rectangle

戻り値:

Rectangle がこの Rectangle に 完全に含まれる場合は true、 そうでない場合は false

導入されたバージョン:

1.2

contains

public boolean contains(int X,
                        int Y,
                        int W,
                        int H)

指定された位置 (X,Y) にあり、指定されたサイズ (W,H) である Rectangle を、この Rectangle が完全に含むかどうかを判定します。

パラメータ:

X - 指定された X 座標

Y - 指定された Y 座標

W - Rectangle の幅

H - Rectangle の高さ

戻り値:

(X, Y, W, H) で指定される Rectangle が 完全にこの Rectangle 内に 収まる場合は true、 そうでない場合は false

導入されたバージョン:

1.1

inside

@Deprecated
public boolean inside(int X,
                                 int Y)

推奨されていません。 JDK version 1.1 以降は、 contains(int, int) に置き換えられました。

この Rectangle が、指定された位置 (X,Y) にある点を含むかどうかを判定します。

パラメータ:

X - 指定された X 座標

Y - 指定された Y 座標

戻り値:

点 (X,Y) がこの Rectangle の 内部にある場合は true、 そうでない場合は false

intersects

public boolean intersects(Rectangle r)

この Rectangle と指定された Rectangle とが交差するかどうかを判定します。共通部分が空でない場合、2 つの矩形は交差します。

パラメータ:

r - 指定された Rectangle

戻り値:

指定された Rectangle とこの Rectangle が 交差する場合は true、 そうでない場合は false

intersection

public Rectangle intersection(Rectangle r)

この Rectangle と指定された Rectangle との共通部分を算出します。2 つの矩形の共通部分を表す新しい Rectangle を返します。2 つの矩形が交差しない場合、空の矩形が返されます。

パラメータ:

r - 指定された Rectangle

戻り値:

指定された Rectangle と この Rectangle の両方に収まる 最大の Rectangle、 これらの矩形が交差しない場合は空の矩形

union

public Rectangle union(Rectangle r)

この Rectangle と指定された Rectangle との結合部分を算出します。2 つの矩形の結合部分を表す新しい Rectangle を返します。

いずれかの Rectangle で寸法が 0 未満の場合、存在しない矩形の規則が適用されます。一方だけが 0 未満の場合は、別の Rectangle のコピーが返されます。両方とも 0 未満の場合は、0 未満の寸法が少なくとも 1 つ含まれます。

得られる Rectangle の寸法が int で表現できないほど大きい場合は、その寸法に合わせた Integer.MAX_VALUE の寸法になります。

パラメータ:

r - 指定された Rectangle

戻り値:

指定された Rectangle と この Rectangle の両方が収まる 最小の Rectangle

add

public void add(int newx,
                int newy)

整数型の引数 newx,newy によって指定される点をこの Rectangle の境界に追加します。

この Rectangle で寸法が 0 未満の場合、存在しない矩形の規則が適用されます。この結果、この Rectangle の新しい境界の位置は、指定された座標と同じになり、幅と高さは 0 になります。

点を追加したあと、追加された点を引数とする contains の呼び出しは、必ずしも true を返しません。contains メソッドは、Rectangle の右端または下端に位置する点の場合は true を返しません。そのため、追加された点が拡大後の Rectangle の右端または下端に位置する点である場合には、contains は false を返します。指定された点が新しい Rectangle 内部に含まれる必要がある場合は、代わりに次のようにして 1 × 1 矩形を追加してください。

     r.add(newx, newy, 1, 1);
 

パラメータ:

newx - 新しい点の X 座標

newy - 新しい点の Y 座標

add

public void add(Point pt)

指定された Point をこの Rectangle の境界に追加します。

この Rectangle で寸法が 0 未満の場合、存在しない矩形の規則が適用されます。この結果、この Rectangle の新しい境界の位置は、指定された Point の座標と同じになり、幅と高さは 0 になります。

Point を追加したあとで、追加された Point を引数として指定して contains を呼び出した場合、必ず true が返されるとは限りません。contains メソッドは、Rectangle の右端または下端に位置する点の場合は true を返しません。そのため、追加された Point が拡大後の Rectangle の右端または下端に位置する点である場合には、contains は Point に対して false を返します。指定された点が新しい Rectangle 内部に含まれる必要がある場合は、代わりに次のようにして 1 × 1 矩形を追加してください。

     r.add(pt.x, pt.y, 1, 1);
 

パラメータ:

pt - この Rectangle に追加される新しい Point

add

public void add(Rectangle r)

Rectangle をこの Rectangle に追加します。この結果、2 つの矩形の結合部分となる Rectangle が作成されます。

いずれかの Rectangle で寸法が 0 未満の場合、別の Rectangle の寸法が返されます。両方の Rectangle で 0 未満の寸法が少なくとも 1 つ含まれる場合は、結果に 0 未満の寸法が少なくとも 1 つ含まれます。

いずれかの Rectangle で一方または両方の寸法が 0 である場合、これらの軸に沿った寸法 0 の結果は、対応する原点座標をその軸に沿った結果の矩形に追加することで得られる結果と等しくなります。これは add(Point) メソッドによる操作に似ていますが、結果の矩形を超える寸法は使用されません。

得られる Rectangle の寸法が int で表現できないほど大きい場合は、その寸法に合わせた Integer.MAX_VALUE の寸法になります。

パラメータ:

r - 指定された Rectangle

grow

public void grow(int h,
                 int v)

Rectangle を水平方向と垂直方向の両方にサイズ変更します。

このメソッドは、左右にそれぞれ h 単位ずつ、上下にそれぞれ v 単位ずつ大きくなるように、Rectangle を変更します。

新しい Rectangle は、左上隅が (x - h, y - v)、幅が (width + 2h)、高さが (height + 2v) になります。

h と v に負の値が指定された場合、Rectangle のサイズは小さくなります。grow メソッドは、整数型のオーバーフローおよびアンダーフローを確認しますが、width および height で得られる値が負の値から負でない値へと増加するか、負でない値から負の値へと減少するかについては確認しません。

パラメータ:

h - 水平方向に拡大する量

v - 垂直方向に拡大する量

isEmpty

public boolean isEmpty()

RectangularShape が空かどうかを判定します。空の場合は、RectangularShape に領域はありません。

定義:

クラス RectangularShape 内の isEmpty

戻り値:

RectangularShape が空である場合は true、 そうでない場合は false

導入されたバージョン:

1.2

outcode

public int outcode(double x,
                   double y)

この Rectangle2D を基準に、指定された座標のある場所を判定します。このメソッドは、この Rectangle2D の各辺について、指定された座標がこの Rectangle2D のほかの辺と同じサイドにあるかどうかを示す適切なマスク値の 2 項論理和を計算します。

定義:

クラス Rectangle2D 内の outcode

パラメータ:

x - 指定された X 座標

y - 指定された Y 座標

戻り値:

すべての適切な OUT コードの論理和

導入されたバージョン:

1.2

関連項目:

Rectangle2D.OUT_LEFT, Rectangle2D.OUT_TOP, Rectangle2D.OUT_RIGHT, Rectangle2D.OUT_BOTTOM

createIntersection

public Rectangle2D createIntersection(Rectangle2D r)

この Rectangle2D と指定された Rectangle2D の共通部分を表す新しい Rectangle2D オブジェクトを返します。

定義:

クラス Rectangle2D 内の createIntersection

パラメータ:

r - この Rectangle と重なり合う Rectangle2D

戻り値:

指定された Rectangle2D と この Rectangle2D の両方に含まれる 最大の Rectangle2D

導入されたバージョン:

1.2

createUnion

public Rectangle2D createUnion(Rectangle2D r)

この Rectangle2D と指定された Rectangle2D の和集合を表す新しい Rectangle2D オブジェクトを返します。

定義:

クラス Rectangle2D 内の createUnion

パラメータ:

r - この Rectangle と結合される Rectangle2D

戻り値:

指定された Rectangle2D と この Rectangle2D の両方を含む 最小の Rectangle2D

導入されたバージョン:

1.2

equals

public boolean equals(Object obj)

2 つの矩形が同じかどうかを判定します。

引数が null でなく、この Rectangle と同じ左上隅、高さ、および幅を持つ Rectangle オブジェクトである場合にだけ、結果は true になります。

オーバーライド:

クラス Rectangle2D 内の equals

パラメータ:

obj - この Rectangle と比較する Object

戻り値:

オブジェクトが等しい場合は true、 そうでない場合は false

関連項目:

Object.hashCode(), Hashtable

toString

public String toString()

この Rectangle およびその値を表す String 表現を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

この Rectangle オブジェクトの 座標およびサイズの値を表す String