クラス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の値として負の値を設定できます。

幅または高さが正確にゼロのRectangleは、ディメンションがゼロの軸に沿ってロケーションを持ちますが、それ以外の場合、空とみなされます。 isEmpty()メソッドは、このようなRectangleに対してtrueを返します。 空のRectangleに点または矩形が含まれているか交差しているかをテストするメソッドは、いずれかのディメンションがゼロの場合、常に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
関連項目:

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

    クラスRectangle2Dで宣言されたネストされたクラス/インタフェース

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

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    int
    height
    Rectangleの高さ。
    int
    width
    Rectangleの幅。
    int
    x
    Rectangleの左上隅のX座標。
    int
    y
    Rectangleの左上隅のY座標。

    クラスで宣言されたフィールド Rectangle2D

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

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

    コンストラクタ
    コンストラクタ
    説明
    Rectangle()
    左上隅が座標空間内の(0, 0)にあり、幅と高さがどちらも0である新しい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(Dimension d)
    左上隅が(0, 0)であり、幅と高さがDimension引数によって指定される新しい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)
    このRectangleに、指定された寸法(W,H)を持つ指定された位置(X,Y)にある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バージョン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バージョン1.1で、setLocation(int, int)に置き換えられています。
    int
    outcode(double x, double y)
    このRectangle2Dを基準に、指定された座標がある場所を判定します。
    void
    reshape(int x, int y, int width, int height)
    非推奨。
    JDKバージョン1.1で、setBounds(int, int, int, int)に置き換えられています。
    void
    resize(int width, int height)
    非推奨。
    JDKバージョン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(int width, int height)
    このRectangleのサイズを指定された幅と高さに設定します。
    void
    setSize(Dimension d)
    このRectangleのサイズを指定されたDimensionに一致するように設定します。
    String
    toString()
    このRectangleとその値を表すStringを返します。
    void
    translate(int dx, int dy)
    このRectangleをX座標軸に沿って右方向に、Y座標軸に沿って下方向に、示された距離だけ平行移動します。
    Rectangle
    union(Rectangle r)
    このRectangleと指定されたRectangleの和集合を計算します。

    クラスで宣言されたメソッド Rectangle2D

    add, add, add, contains, contains, getPathIterator, getPathIterator, hashCode, intersect, intersects, intersectsLine, intersectsLine, outcode, setFrame, setRect, union
    修飾子と型
    メソッド
    説明
    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の内部に、指定された矩形領域が完全に含まれるかどうかをテストします。
    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の内部と交差するかどうかを判定します。
    int
    outcode(Point2D p)
    このRectangle2Dを基準に、指定されたPoint2Dがある場所を判定します。
    void
    setFrame(double x, double y, double w, double h)
    このRectangle2Dの外部境界の位置およびサイズを、指定された矩形値に設定します。
    void
    setRect(Rectangle2D r)
    このRectangle2Dを、指定されたRectangle2Dと同じになるように設定します。
    static void
    union(Rectangle2D src1, Rectangle2D src2, Rectangle2D dest)
    元のRectangle2Dオブジェクトのペアを結合し、その結果を指定された転送先Rectangle2Dオブジェクトに格納します。

    クラスで宣言されたメソッド RectangularShape

    clone, contains, contains, getCenterX, getCenterY, getFrame, getMaxX, getMaxY, getMinX, getMinY, intersects, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal
    修飾子と型
    メソッド
    説明
    Object
    clone()
    このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
    boolean
    contains(Point2D p)
    指定されたPoint2Dが、内側の定義によって記述されたShapeの境界の内側にあるかどうかをテストします。
    boolean
    contains(Rectangle2D r)
    Shapeの内部に、指定されたRectangle2Dが完全に含まれるかどうかをテストします。
    double
    getCenterX()
    Shapeの表示枠矩形の中心のX座標をdouble精度で返します。
    double
    getCenterY()
    Shapeの表示枠矩形の中心のY座標をdouble精度で返します。
    Rectangle2D
    getFrame()
    このオブジェクトの形状全体を定義する表示枠Rectangle2Dを返します。
    double
    getMaxX()
    Shapeの表示枠矩形の最大のX座標をdouble精度で返します。
    double
    getMaxY()
    Shapeの表示枠矩形の最大のY座標をdouble精度で返します。
    double
    getMinX()
    Shapeの表示枠矩形の最小のX座標をdouble精度で返します。
    double
    getMinY()
    Shapeの表示枠矩形の最小のY座標をdouble精度で返します。
    boolean
    intersects(Rectangle2D r)
    Shapeの内部が指定されたRectangle2Dの内部と交差しているかどうかをテストします。
    void
    setFrame(Point2D loc, Dimension2D size)
    このShapeの表示枠矩形の位置とサイズを、それぞれ指定されたPoint2DとDimension2Dに設定します。
    void
    setFrame(Rectangle2D r)
    このShapeの表示枠矩形を、指定されたRectangle2Dに設定します。
    void
    setFrameFromCenter(double centerX, double centerY, double cornerX, double cornerY)
    このShapeの表示枠矩形を、指定された中心点および角の点の座標に基づいて設定します。
    void
    setFrameFromCenter(Point2D center, Point2D corner)
    このShapeの表示枠矩形を、中心を表すPoint2Dおよび角を表すPoint2Dに基づいて設定します。
    void
    setFrameFromDiagonal(double x1, double y1, double x2, double y2)
    このShapeの表示枠矩形の対角線を、指定された2つの座標に基づいて設定します。
    void
    setFrameFromDiagonal(Point2D p1, Point2D p2)
    このShapeの表示枠矩形の対角線を、指定された2つのPoint2Dオブジェクトに基づいて設定します。

    クラスオブジェクトで宣言されたメソッド

    finalize, getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

  • コンストラクタの詳細

    • 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精度で返します。
      定義:
      getX、クラスRectangularShape
      戻り値:
      境界のRectangle領域のX座標。

    • getY

      public double getY()
      境界のRectangleのY座標をdouble精度で返します。
      定義:
      getY、クラスRectangularShape
      戻り値:
      境界のRectangle領域のY座標。

    • getWidth

      public double getWidth()
      境界のRectangleの幅をdouble精度で返します。
      定義:
      getWidth、クラスRectangularShape
      戻り値:
      境界のRectangle領域の幅。

    • getHeight

      public double getHeight()
      境界のRectangleの高さをdouble精度で返します。
      定義:
      getHeight、クラスRectangularShape
      戻り値:
      境界のRectangle領域の高さ。

    • getBounds

      public Rectangle getBounds()
      このRectangleの境界のRectangleを取得します。

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

      定義:
      getBounds、インタフェースShape
      オーバーライド:
      getBounds、クラスRectangularShape
      戻り値:
      新しいRectangle。このRectangleの境界のRectangle領域に等しい。
      導入されたバージョン:
      1.1
      関連項目:

    • 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)を示さない

      定義:
      getBounds2D、インタフェースShape
      オーバーライド:
      getBounds2D、クラスRectangle2D
      戻り値:
      Shapeの高精度のバウンディング・ボックスであるRectangle2Dのインスタンス。
      導入されたバージョン:
      1.2
      関連項目:

    • setBounds

      public void setBounds(Rectangle r)
      このRectangleの境界のRectangleを指定されたRectangleに一致するように設定します。

      このメソッドは完全性のために含まれており、ComponentのsetBoundsメソッドに対応します。

      パラメータ:
      r - 指定されたRectangle
      導入されたバージョン:
      1.1
      関連項目:

    • 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
      関連項目:

    • setRect

      public void setRect(double x, double y, double width, double height)
      このRectangleの境界を、指定されたx、y、width、およびheightを取り囲む整数境界に設定します。 これらのパラメータによって整数の最大範囲を超えるRectangleが指定される場合、最大整数境界と交差する、指定されたRectangleの最適表現が得られます。
      定義:
      setRect、クラスRectangle2D
      パラメータ:
      x - 指定された矩形の左上隅のX座標
      y - 指定された矩形の左上隅のY座標
      width - 指定された矩形の幅
      height - 指定された矩形の新しい高さ

    • reshape

      @Deprecated public void reshape(int x, int y, int width, int height)
      非推奨。
      JDKバージョン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
      関連項目:

    • setLocation

      public void setLocation(Point p)
      このRectangleを指定された位置に移動します。

      このメソッドは完全性のために含まれており、ComponentのsetLocationメソッドに対応します。

      パラメータ:
      p - このRectangleの新しい位置を指定するPoint
      導入されたバージョン:
      1.1
      関連項目:

    • setLocation

      public void setLocation(int x, int y)
      このRectangleを指定された位置に移動します。

      このメソッドは完全性のために含まれており、ComponentのsetLocationメソッドに対応します。

      パラメータ:
      x - 新しい位置のX座標
      y - 新しい位置のY座標
      導入されたバージョン:
      1.1
      関連項目:

    • move

      @Deprecated public void move(int x, int y)
      非推奨。
      JDKバージョン1.1で、setLocation(int, int)に置き換えられています。
      このRectangleを指定された位置に移動します。
      パラメータ:
      x - 新しい位置のX座標
      y - 新しい位置のY座標

    • translate

      public void translate(int dx, int dy)
      このRectangleをX座標軸に沿って右方向に、Y座標軸に沿って下方向に、示された距離だけ平行移動します。
      パラメータ:
      dx - X軸に沿ってこのRectangleが移動する距離
      dy - Y軸に沿ってこのRectangleが移動する距離
      関連項目:

    • getSize

      public Dimension getSize()
      返されたDimensionで表された、このRectangleのサイズを取得します。

      このメソッドは完全性のために含まれており、ComponentのgetSizeメソッドに対応します。

      戻り値:
      このRectangleのサイズを表すDimension。
      導入されたバージョン:
      1.1
      関連項目:

    • setSize

      public void setSize(Dimension d)
      このRectangleのサイズを指定されたDimensionに一致するように設定します。

      このメソッドは完全性のために含まれており、ComponentのsetSizeメソッドに対応します。

      パラメータ:
      d - Dimensionオブジェクトの新しいサイズ
      導入されたバージョン:
      1.1
      関連項目:

    • setSize

      public void setSize(int width, int height)
      このRectangleのサイズを指定された幅と高さに設定します。

      このメソッドは完全性のために含まれており、ComponentのsetSizeメソッドに対応します。

      パラメータ:
      width - このRectangleの新しい幅
      height - このRectangleの新しい高さ
      導入されたバージョン:
      1.1
      関連項目:

    • resize

      @Deprecated public void resize(int width, int height)
      非推奨。
      JDKバージョン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)
      このRectangleに、指定された寸法(W,H)を持つ指定された位置(X,Y)にある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バージョン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のディメンションがゼロ未満の場合、non-existent矩形のルールが適用されます。 一方だけに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のディメンションがゼロ未満の場合は、non-existent矩形のルールが適用されます。 この結果、このRectangleの新しい境界の位置は、指定された座標と同じになり、幅と高さは0になります。

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

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

      パラメータ:
      newx - 新しい点のX座標
      newy - 新しい点のY座標

    • add

      public void add(Point pt)
      指定されたPointをこのRectangleの境界に追加します。

      このRectangleのディメンションがゼロ未満の場合は、non-existent矩形のルールが適用されます。 この結果、このRectangleの新しい境界の位置は、指定されたPointの座標と同じになり、幅と高さは0になります。

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

          r.add(new Rectangle(pt, new Dimension(1, 1)));

      パラメータ:
      pt - このRectangleに追加される新しいPoint

    • add

      public void add(Rectangle r)
      RectangleをこのRectangleに追加します。 その結果のRectangleは、2つの矩形の和集合となります。

      一方の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が空の場合は、領域はありません。
      定義:
      isEmpty、クラスRectangularShape
      戻り値:
      RectangularShapeが空である場合はtrue、そうでない場合はfalse。
      導入されたバージョン:
      1.2

    • outcode

      public int outcode(double x, double y)
      このRectangle2Dを基準に、指定された座標がある場所を判定します。 このメソッドは、このRectangle2Dの各辺について、指定された座標がこのRectangle2Dのほかの辺と同じサイドにあるかどうかを示す適切なマスク値の2項論理和を計算します。
      定義:
      outcode、クラスRectangle2D
      パラメータ:
      x - 指定されたX座標
      y - 指定されたY座標
      戻り値:
      すべての適切なOUTコードの論理和。
      導入されたバージョン:
      1.2
      関連項目:

    • createIntersection

      public Rectangle2D createIntersection(Rectangle2D r)
      このRectangle2Dと指定されたRectangle2Dの共通部分を表す新しいRectangle2Dオブジェクトを返します。
      定義:
      createIntersection、クラスRectangle2D
      パラメータ:
      r - このRectangle2Dと交差させるRectangle2D
      戻り値:
      指定されたRectangle2DとこのRectangle2Dの両方に含まれる最大のRectangle2D。
      導入されたバージョン:
      1.2

    • createUnion

      public Rectangle2D createUnion(Rectangle2D r)
      このRectangle2Dと指定されたRectangle2Dの和集合を表す新しいRectangle2Dオブジェクトを返します。
      定義:
      createUnion、クラスRectangle2D
      パラメータ:
      r - このRectangle2Dと結合されるRectangle2D
      戻り値:
      指定されたRectangle2DとこのRectangle2Dの両方を含む最小のRectangle2D。
      導入されたバージョン:
      1.2

    • equals

      public boolean equals(Object obj)
      2つの矩形が同じかどうかを判定します。

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

      オーバーライド:
      equals、クラスRectangle2D
      パラメータ:
      obj - このRectangleと比較するObject
      戻り値:
      オブジェクトが等しい場合はtrue、そうでない場合はfalse。
      関連項目:

    • toString

      public String toString()
      このRectangleとその値を表すStringを返します。
      オーバーライド:
      toString、クラスObject
      戻り値:
      このRectangleオブジェクトの座標およびサイズの値を表すString。