Rectangle2D (Java Platform SE 8)

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

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

Shape, Cloneable

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

Rectangle, Rectangle2D.Double, Rectangle2D.Float
```
public abstract class Rectangle2D
extends RectangularShape
```
Rectangle2Dクラスは、位置(x,y)およびサイズ(w x h)で定義される矩形を記述します。
このクラスは、2D矩形を格納するすべてのオブジェクトの抽象スーパー・クラスにすぎません。座標の実際の記憶域表現はサブクラスに委ねられます。

導入されたバージョン:

1.2

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型	クラス	説明
`static class`	`Rectangle2D.Double`	`Double`クラスは、double座標で指定される矩形を定義します。
`static class`	`Rectangle2D.Float`	`Float`クラスは、float座標で指定される矩形を定義します。

フィールドのサマリー

フィールド
修飾子と型	フィールド	説明
`static int`	`OUT_BOTTOM`	点がこの`Rectangle2D`の下にあることを示すビット・マスクです。
`static int`	`OUT_LEFT`	点がこの`Rectangle2D`の左にあることを示すビット・マスクです。
`static int`	`OUT_RIGHT`	点がこの`Rectangle2D`の右にあることを示すビット・マスクです。
`static int`	`OUT_TOP`	点がこの`Rectangle2D`の上にあることを示すビット・マスクです。

コンストラクタのサマリー

コンストラクタ
修飾子コンストラクタ説明

protected Rectangle2D()
これは、インスタンスを直接には生成できない抽象クラスです。

コンストラクタ
修飾子	コンストラクタ	説明
`protected`	`Rectangle2D()`	これは、インスタンスを直接には生成できない抽象クラスです。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド抽象メソッド具象メソッド
修飾子と型	メソッド	説明
`void`	`add(double newx, double newy)`	倍精度の`newx`引数および`newy`引数で指定された点をこの`Rectangle2D`に追加します。
`void`	`add(Point2D pt)`	`Point2D`オブジェクト`pt`をこの`Rectangle2D`に追加します。
`void`	`add(Rectangle2D r)`	`Rectangle2D`オブジェクトをこの`Rectangle2D`に追加します。
`boolean`	`contains(double x, double y)`	指定された座標が、内側の定義によって記述された`Shape`の境界の内側にあるかどうかをテストします。
`boolean`	`contains(double x, double y, double w, double h)`	`Shape`の内部に、指定された矩形領域が完全に含まれるかどうかをテストします。
`abstract Rectangle2D`	`createIntersection(Rectangle2D r)`	この`Rectangle2D`と指定された`Rectangle2D`の共通部分を表す新しい`Rectangle2D`オブジェクトを返します。
`abstract Rectangle2D`	`createUnion(Rectangle2D r)`	この`Rectangle2D`と指定された`Rectangle2D`の和集合を表す新しい`Rectangle2D`オブジェクトを返します。
`boolean`	`equals(Object obj)`	指定された`Object`がこの`Rectangle2D`と等しいかどうかを判定します。
`Rectangle2D`	`getBounds2D()`	高精度で、かつ`getBounds`メソッドより正確な`Shape`のバウンディング・ボックスを返します。
`PathIterator`	`getPathIterator(AffineTransform at)`	この`Rectangle2D`の境界を定義する反復オブジェクトを返します。
`PathIterator`	`getPathIterator(AffineTransform at, double flatness)`	平坦化された`Rectangle2D`の境界を定義する反復オブジェクトを返します。
`int`	`hashCode()`	この`Rectangle2D`のハッシュ・コードを返します。
`static void`	`intersect(Rectangle2D src1, Rectangle2D src2, Rectangle2D dest)`	指定された元の`Rectangle2D`オブジェクトのペアの共通部分をとり、その結果を指定された転送先`Rectangle2D`オブジェクトに格納します。
`boolean`	`intersects(double x, double y, double w, double h)`	`Shape`の内部が指定された矩形領域の内部と交差しているかどうかをテストします。
`boolean`	`intersectsLine(double x1, double y1, double x2, double y2)`	指定されたライン・セグメントが、この`Rectangle2D`の内部と交差するかどうかを判定します。
`boolean`	`intersectsLine(Line2D l)`	指定されたライン・セグメントが、この`Rectangle2D`の内部と交差するかどうかを判定します。
`abstract int`	`outcode(double x, double y)`	この`Rectangle2D`を基準に、指定された座標がある場所を判定します。
`int`	`outcode(Point2D p)`	この`Rectangle2D`を基準に、指定された`Point2D`がある場所を判定します。
`void`	`setFrame(double x, double y, double w, double h)`	この`Rectangle2D`の外部境界の位置およびサイズを、指定された矩形値に設定します。
`abstract void`	`setRect(double x, double y, double w, double h)`	この`Rectangle2D`の位置およびサイズを、指定された`double`型の値に設定します。
`void`	`setRect(Rectangle2D r)`	この`Rectangle2D`を、指定された`Rectangle2D`と同じになるように設定します。
`static void`	`union(Rectangle2D src1, Rectangle2D src2, Rectangle2D dest)`	元の`Rectangle2D`オブジェクトのペアを結合し、その結果を指定された転送先`Rectangle2D`オブジェクトに格納します。

クラス java.awt.geom.RectangularShapeから継承されたメソッド
clone, contains, contains, getBounds, getCenterX, getCenterY, getFrame, getHeight, getMaxX, getMaxY, getMinX, getMinY, getWidth, getX, getY, intersects, isEmpty, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal

クラス java.lang.Objectから継承されたメソッド
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - OUT_LEFT
```
public static final int OUT_LEFT
```
    点がこのRectangle2Dの左にあることを示すビット・マスクです。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    定数フィールド値
  - OUT_TOP
```
public static final int OUT_TOP
```
    点がこのRectangle2Dの上にあることを示すビット・マスクです。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    定数フィールド値
  - OUT_RIGHT
```
public static final int OUT_RIGHT
```
    点がこのRectangle2Dの右にあることを示すビット・マスクです。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    定数フィールド値
  - OUT_BOTTOM
```
public static final int OUT_BOTTOM
```
    点がこのRectangle2Dの下にあることを示すビット・マスクです。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    定数フィールド値
- コンストラクタの詳細
  - Rectangle2D
```
protected Rectangle2D()
```
    これは、インスタンスを直接には生成できない抽象クラスです。インスタンス生成のためには型固有の実装サブクラスが用意されており、これらのサブクラスにより、下記の各種アクセス用メソッドに必要な情報を格納するための形式が多数提供されます。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Rectangle2D.Float, Rectangle2D.Double, Rectangle
- メソッドの詳細
  - setRect
```
public abstract void setRect(double x,
                             double y,
                             double w,
                             double h)
```
    このRectangle2Dの位置およびサイズを、指定されたdouble型の値に設定します。
    
    パラメータ:
    
    x - このRectangle2Dの左上隅のX座標
    
    y - このRectangle2Dの左上隅のY座標
    
    w - このRectangle2Dの幅
    
    h - Rectangle2Dに対する高さ
    
    導入されたバージョン:
    
    1.2
  - setRect
```
public void setRect(Rectangle2D r)
```
    このRectangle2Dを、指定されたRectangle2Dと同じになるように設定します。
    
    パラメータ:
    
    r - 指定されたRectangle2D
    
    導入されたバージョン:
    
    1.2
  - intersectsLine
```
public boolean intersectsLine(double x1,
                              double y1,
                              double x2,
                              double y2)
```
    指定されたライン・セグメントが、このRectangle2Dの内部と交差するかどうかを判定します。
    
    パラメータ:
    
    x1 - 指定されたライン・セグメントの始点のX座標
    
    y1 - 指定されたライン・セグメントの始点のY座標
    
    x2 - 指定されたライン・セグメントの終点のX座標
    
    y2 - 指定されたライン・セグメントの終点のY座標
    
    戻り値:
    
    指定されたライン・セグメントがこのRectangle2Dの内部と交差する場合はtrue。それ以外の場合はfalse。
    
    導入されたバージョン:
    
    1.2
  - intersectsLine
```
public boolean intersectsLine(Line2D l)
```
    指定されたライン・セグメントが、このRectangle2Dの内部と交差するかどうかを判定します。
    
    パラメータ:
    
    l - このRectangle2Dの内部と交差するかどうかをテストする、指定されたLine2D
    
    戻り値:
    
    指定されたLine2DがこのRectangle2Dの内部と交差する場合はtrue。それ以外の場合はfalse。
    
    導入されたバージョン:
    
    1.2
  - outcode
```
public abstract int outcode(double x,
                            double y)
```
    このRectangle2Dを基準に、指定された座標がある場所を判定します。このメソッドは、このRectangle2Dの各辺について、指定された座標がこのRectangle2Dのほかの辺と同じサイドにあるかどうかを示す適切なマスク値の2項論理和を計算します。
    
    パラメータ:
    
    x - 指定されたX座標
    
    y - 指定されたY座標
    
    戻り値:
    
    すべての適切なOUTコードの論理和。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    OUT_LEFT, OUT_TOP, OUT_RIGHT, OUT_BOTTOM
  - outcode
```
public int outcode(Point2D p)
```
    このRectangle2Dを基準に、指定されたPoint2Dがある場所を判定します。このメソッドは、このRectangle2Dの各辺について、指定されたPoint2DがこのRectangle2Dのほかの辺と同じサイドにあるかどうかを示す適切なマスク値の2項論理和を計算します。
    
    パラメータ:
    
    p - 指定されたPoint2D
    
    戻り値:
    
    すべての適切なOUTコードの論理和。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    OUT_LEFT, OUT_TOP, OUT_RIGHT, OUT_BOTTOM
  - setFrame
```
public void setFrame(double x,
                     double y,
                     double w,
                     double h)
```
    このRectangle2Dの外部境界の位置およびサイズを、指定された矩形値に設定します。
    
    定義:
    
    setFrame、クラスRectangularShape
    
    パラメータ:
    
    x - このRectangle2Dの左上隅のX座標
    
    y - このRectangle2Dの左上隅のY座標
    
    w - このRectangle2Dの幅
    
    h - Rectangle2Dに対する高さ
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    RectangularShape.getFrame()
  - getBounds2D
```
public Rectangle2D getBounds2D()
```
    高精度で、かつgetBoundsメソッドより正確なShapeのバウンディング・ボックスを返します。返されたRectangle2Dが、Shapeを囲む最小のバウンディング・ボックスであるという保証はありません。Shapeが、示されたRectangle2D内に完全に含まれているだけです。戻り値を、倍精度値を使用して寸法を格納するRectangle2Dのインスタンスにすることができるため、このメソッドによって返されたバウンディング・ボックスは通常、getBoundsメソッドによって返されたものより厳密であり、オーバーフローの問題のために失敗することはありません。
    内側の定義によって、shapeの定義する輪郭上の点が、返されたboundsオブジェクトに含まれていると見なされない状況が発生する場合があります。ただし、これは、これらの点が元のshapeにも含まれていないと見なされる場合のみです。
    
    pointがcontains(point)メソッドに従ってshapeの内側にある場合は、boundsのcontains(point)メソッドに従って、返されたRectangle2D境界オブジェクトの内側にある必要があります。具体的には、次のようになります。
    
    shape.contains(p)にはbounds.contains(p)が必要
    
    pointがshapeの内側にない場合は、引き続きboundsオブジェクトに含まれている可能性があります。
    
    bounds.contains(p)はshape.contains(p)を示さない
    
    戻り値:
    
    Shapeの高精度のバウンディング・ボックスであるRectangle2Dのインスタンス。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Shape.getBounds()
  - contains
```
public boolean contains(double x,
                        double y)
```
    指定された座標が、内側の定義によって記述されたShapeの境界の内側にあるかどうかをテストします。
    
    パラメータ:
    
    x - テストされる指定されたX座標
    
    y - テストされる指定されたY座標
    
    戻り値:
    
    指定された座標がShape境界の内側にある場合はtrue、それ以外の場合はfalse。
    
    導入されたバージョン:
    
    1.2
  - intersects
```
public boolean intersects(double x,
                          double y,
                          double w,
                          double h)
```
    Shapeの内部が指定された矩形領域の内部と交差しているかどうかをテストします。 Shapeの内部と指定された矩形領域の両方に含まれている点が存在する場合、その矩形領域はShapeと交差していると見なされます。
    Shape.intersects()メソッドを使用すると、次のような場合に、Shape実装は内部的にtrueを返すことができます。
    - 矩形領域とShapeが交差している可能性が高いが、
    - この共通部分を正確に判断する計算の負荷がかなり大きい。
    つまり、Shapesによっては、矩形領域がShapeと交差していない場合でもこのメソッドがtrueを返すことがあります。 Areaクラスは、ほとんどのShapeオブジェクトより正確な、幾何学的な共通部分の計算を実行するため、より的確な答えが必要な場合に使用できます。
    パラメータ:
    
    x - 指定された矩形領域の左上隅のX座標
    
    y - 指定された矩形領域の左上隅のY座標
    
    w - 指定された矩形領域の幅
    
    h - 指定された矩形領域の高さ
    
    戻り値:
    
    Shapeの内部と矩形領域の内部が交差しているか、またはどちらも交差している可能性が高いが、負荷が大きすぎて共通部分の計算を実行できない場合はtrue、それ以外の場合はfalse。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Area
  - contains
```
public boolean contains(double x,
                        double y,
                        double w,
                        double h)
```
    Shapeの内部に、指定された矩形領域が完全に含まれるかどうかをテストします。矩形領域全体がShape内に含まれていると見なされるには、矩形領域の内側にあるすべての座標がShape内にある必要があります。
    Shape.contains()メソッドを使用すると、次のような場合に、Shape実装は内部的にfalseを返すことができます。
    - intersectメソッドがtrueを返し、かつ
    - Shapeに矩形領域が完全に含まれるかどうかを判定するための計算の負荷が非常に大きい。
    つまり、Shapesによっては、Shapeに矩形領域が含まれている場合でもこのメソッドがfalseを返すことがあります。 Areaクラスは、ほとんどのShapeオブジェクトより正確な幾何学的計算を実行するため、より的確な答えが必要な場合に使用できます。
    パラメータ:
    
    x - 指定された矩形領域の左上隅のX座標
    
    y - 指定された矩形領域の左上隅のY座標
    
    w - 指定された矩形領域の幅
    
    h - 指定された矩形領域の高さ
    
    戻り値:
    
    Shapeの内部に、指定された矩形領域が完全に含まれる場合はtrue、それ以外の場合、またはShapeに矩形領域が含まれ、intersectsメソッドがtrueを返し、さらに負荷が大きすぎて包含の計算を実行できない場合はfalse。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Area、Shape.intersects(double, double, double, double)
  - createIntersection
```
public abstract Rectangle2D createIntersection(Rectangle2D r)
```
    このRectangle2Dと指定されたRectangle2Dの共通部分を表す新しいRectangle2Dオブジェクトを返します。
    
    パラメータ:
    
    r - このRectangle2Dと交差させるRectangle2D
    
    戻り値:
    
    指定されたRectangle2DとこのRectangle2Dの両方に含まれる最大のRectangle2D。
    
    導入されたバージョン:
    
    1.2
  - intersect
```
public static void intersect(Rectangle2D src1,
                             Rectangle2D src2,
                             Rectangle2D dest)
```
    指定された元のRectangle2Dオブジェクトのペアの共通部分をとり、その結果を指定された転送先Rectangle2Dオブジェクトに格納します。元の矩形の1つを転送先にして、3番目のRectangle2Dオブジェクトを作成しないようにすることもできますが、その場合、元の矩形の元の点はこのメソッドで上書きされます。
    
    パラメータ:
    
    src1 - 互いに交差させるRectangle2Dオブジェクトの最初のペア
    
    src2 - 互いに交差させるRectangle2Dオブジェクトの2番目のペア
    
    dest - src1とsrc2の共通部分の結果を保持するRectangle2D
    
    導入されたバージョン:
    
    1.2
  - createUnion
```
public abstract Rectangle2D createUnion(Rectangle2D r)
```
    このRectangle2Dと指定されたRectangle2Dの和集合を表す新しいRectangle2Dオブジェクトを返します。
    
    パラメータ:
    
    r - このRectangle2Dと結合されるRectangle2D
    
    戻り値:
    
    指定されたRectangle2DとこのRectangle2Dの両方を含む最小のRectangle2D。
    
    導入されたバージョン:
    
    1.2
  - union
```
public static void union(Rectangle2D src1,
                         Rectangle2D src2,
                         Rectangle2D dest)
```
    元のRectangle2Dオブジェクトのペアを結合し、その結果を指定された転送先Rectangle2Dオブジェクトに格納します。元の矩形の1つを転送先にして、3番目のRectangle2Dオブジェクトを作成しないようにすることもできますが、その場合、元の矩形の元の点はこのメソッドで上書きされます。
    
    パラメータ:
    
    src1 - 互いに結合させるRectangle2Dオブジェクトの最初のペア
    
    src2 - 互いに結合させるRectangle2Dオブジェクトの2番目のペア
    
    dest - src1とsrc2の和集合の結果を保持するRectangle2D
    
    導入されたバージョン:
    
    1.2
  - add
```
public void add(double newx,
                double newy)
```
    倍精度のnewx引数およびnewy引数で指定された点をこのRectangle2Dに追加します。結果として得られるRectangle2Dは、元のRectangle2Dと指定された点の両方を含む最小のRectangle2Dです。
    点を追加したあと、追加された点を引数とするcontainsの呼出しは、必ずしもtrueを返しません。 containsメソッドは、矩形の右端または下端にある点についてはtrueを返しません。そのため、追加された点が拡大された矩形の左端または下端にある場合、containsはその点についてfalseを返します。
    
    パラメータ:
    
    newx - 新しい点のX座標
    
    newy - 新しい点のY座標
    
    導入されたバージョン:
    
    1.2
  - add
```
public void add(Point2D pt)
```
    Point2DオブジェクトptをこのRectangle2Dに追加します。結果として得られるRectangle2Dは、元のRectangle2Dと指定されたPoint2Dの両方を含む最小のRectangle2Dです。
    点を追加したあと、追加された点を引数とするcontainsの呼出しは、必ずしもtrueを返しません。 containsメソッドは、矩形の右端または下端にある点についてはtrueを返しません。そのため、追加された点が拡大された矩形の左端または下端にある場合、containsはその点についてfalseを返します。
    
    パラメータ:
    
    pt - このRectangle2Dに追加する新しいPoint2D。
    
    導入されたバージョン:
    
    1.2
  - add
```
public void add(Rectangle2D r)
```
    Rectangle2DオブジェクトをこのRectangle2Dに追加します。結果として得られるRectangle2Dは、2つのRectangle2Dオブジェクトの和集合です。
    
    パラメータ:
    
    r - このRectangle2Dに追加するRectangle2D。
    
    導入されたバージョン:
    
    1.2
  - getPathIterator
```
public PathIterator getPathIterator(AffineTransform at)
```
    このRectangle2Dの境界を定義する反復オブジェクトを返します。このクラスのイテレータは、マルチ・スレッドに対して安全です。つまりこのRectangle2Dクラスは、このRectangle2Dオブジェクトの幾何学的図形に対する変更が、幾何学的図形についてすでに進行中の反復処理に影響を与えないことを保証します。
    
    パラメータ:
    
    at - 反復処理で返されるときに座標に適用されるオプションのAffineTransform、または変換されていない座標が必要な場合はnull
    
    戻り値:
    
    このRectangle2Dの輪郭の幾何学的図形を一度に1セグメントずつ返すPathIteratorオブジェクト。
    
    導入されたバージョン:
    
    1.2
  - getPathIterator
```
public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)
```
    平坦化されたRectangle2Dの境界を定義する反復オブジェクトを返します。矩形はすでに平坦であるため、flatnessパラメータは無視される。このクラスのイテレータは、マルチ・スレッドに対して安全です。つまりこのRectangle2Dクラスは、このRectangle2Dオブジェクトの幾何学的図形に対する変更が、幾何学的図形についてすでに進行中の反復処理に影響を与えないことを保証します。
    
    定義:
    
    getPathIterator、インタフェースShape
    
    オーバーライド:
    
    getPathIterator、クラスRectangularShape
    
    パラメータ:
    
    at - 反復処理で返されるときに座標に適用されるオプションのAffineTransform、または変換されていない座標が必要な場合はnull
    
    flatness - 曲線セグメントを近似するために使用されるライン・セグメントが、元の曲線上の任意の点から離れることができる最大の距離。矩形はすでに平坦であるため、flatnessパラメータは無視される。
    
    戻り値:
    
    このRectangle2Dの輪郭の幾何学的図形を一度に1セグメントずつ返すPathIteratorオブジェクト。
    
    導入されたバージョン:
    
    1.2
  - hashCode
```
public int hashCode()
```
    このRectangle2Dのハッシュ・コードを返します。
    
    オーバーライド:
    
    hashCode、クラスObject
    
    戻り値:
    
    このRectangle2Dのハッシュ・コード。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(Object obj)
```
    指定されたObjectがこのRectangle2Dと等しいかどうかを判定します。指定されたObjectは、Rectangle2Dのインスタンスであり、位置およびサイズがこのRectangle2Dと同じ場合に、このRectangle2Dと等しいと見なされます。
    
    オーバーライド:
    
    equals、クラスObject
    
    パラメータ:
    
    obj - このRectangle2Dと比較されるObject。
    
    戻り値:
    
    objがRectangle2Dのインスタンスであり、同じ値を持つ場合はtrue、そうでない場合はfalse。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Object.hashCode()、HashMap

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスRectangle2D

ネストされたクラスのサマリー

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

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

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

フィールドの詳細

OUT_LEFT

OUT_TOP

OUT_RIGHT

OUT_BOTTOM

コンストラクタの詳細

Rectangle2D

メソッドの詳細

setRect

setRect

intersectsLine

intersectsLine

outcode

outcode

setFrame

getBounds2D

contains

intersects

contains

createIntersection

intersect

createUnion

union

add

add

add

getPathIterator

getPathIterator

hashCode

equals