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 的建構子，以及可以修改該物件的方法，都允許將 width 和 height 設置為負值。

對於 width 或 height 正好為 0 的 Rectangle，它在相應軸上存在維數為 0 的位置，但在這種情況下，也可將其視為空的 Rectangle。對於這種 Rectangle，isEmpty() 方法將返回 ture。 如果兩個維數中任一維數為 0，則測試空 Rectangle 是否包含某個點或是否與某個矩形相交的方法將始終返回 false。用點或矩形合併這種 Rectangle 的方法將在結果中包含 Rectangle 在該軸上的位置，正如調用 add(Point) 方法一樣。

對於 width 或 height 為負值的 Rectangle，它在相應軸上並不存在維數為負的位置或維數。這種 Rectangle 將被視為不存在相應的軸上。對於包含計算，這種 Rectangle 也為空，測試它是否包含某個點或是否與某個矩形相交的方法將始終返回 false。用點或矩形合併這種 Rectangle 的方法將在產生結果時完全忽略 Rectangle。如果合併了兩個 Rectangle 物件，且每個物件都具有一個負維數，則結果中至少有一個負維數。

對於僅影響 Rectangle 位置的方法，無論 Rectangle 是否沿任一軸具有負維數或 0 維數，都將在其位置上進行操作。

注意，用預設不帶參數的建構子建構的 Rectangle 將具有 0x0 維數，因此為空。Rectangle 仍然具有 (0,0) 的位置，且將該位置用於合併和添加操作。因此，嘗試累積點集合範圍的程式碼最初應使用具體的負 width 和負 height 來建構 Rectangle，或者應使用該集合中的第一個點建構 Rectangle。例如：

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

如果知道點陣列中至少包含了一個點，那麼也可以：

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()
建構一個新的 Rectangle，其左上角的坐標為 (0,0)，寬度和高度均為 0。

Rectangle(Dimension d)
建構一個新的 Rectangle，其左上角為 (0,0)，其寬度和高度由 Dimension 參數指定。

Rectangle(int width, int height)
建構一個新的 Rectangle，其左上角的坐標為 (0,0)，其寬度和高度由同名的參數指定。

Rectangle(int x, int y, int width, int height)
建構一個新的 Rectangle，其左上角被指定為 (x,y)，其寬度和高度由同名的參數指定。

Rectangle(Point p)
建構一個新的 Rectangle，其左上角是指定的 Point，其寬度和高度均為 0。

Rectangle(Point p, Dimension d)
建構一個新的 Rectangle，其左上角由 Point 參數指定，其寬度和高度由 Dimension 參數指定。

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 是否完全包含位於指定位置 (X,Y) 且具有指定維數 (W,H) 的 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) 檢查兩個矩形是否相等。
Rectangle	getBounds() 獲取此 Rectangle 的邊界 Rectangle。
Rectangle2D	getBounds2D() 返回一個高精度的、比 getBounds 方法更準確的 Shape 邊界框。
double	getHeight() 以 double 精度返回邊界 Rectangle 的高度。
Point	getLocation() 返回此 Rectangle 的位置。
Dimension	getSize() 獲取此 Rectangle 的大小，用返回的 Dimension 表示。
double	getWidth() 以 double 精度返回邊界 Rectangle 的寬度。
double	getX() 以 double 精度返回邊界 Rectangle 的 X 坐標。
double	getY() 以 double 精度返回邊界 Rectangle 的 Y 坐標。
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) 將此 Rectangle 沿 X 坐標軸向右，沿 Y 坐標軸向下平移指定距離。
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()

建構一個新的 Rectangle，其左上角的坐標為 (0,0)，寬度和高度均為 0。

Rectangle

public Rectangle(Rectangle r)

建構一個新的 Rectangle，並將其初始化，以與指定 Rectangle 的值比對。

參數：

r - Rectangle，要從中將初始值複製到新建構的 Rectangle

從以下版本開始：

1.1

Rectangle

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

建構一個新的 Rectangle，其左上角被指定為 (x,y)，其寬度和高度由同名的參數指定。

參數：

x - 指定的 X 坐標

y - 指定的 Y 坐標

width - Rectangle 的寬度

height - Rectangle 的高度

從以下版本開始：

1.0

Rectangle

public Rectangle(int width,
                 int height)

建構一個新的 Rectangle，其左上角的坐標為 (0,0)，其寬度和高度由同名的參數指定。

參數：

width - Rectangle 的寬度

height - Rectangle 的高度

Rectangle

public Rectangle(Point p,
                 Dimension d)

建構一個新的 Rectangle，其左上角由 Point 參數指定，其寬度和高度由 Dimension 參數指定。

參數：

p - 一個 Point，它是 Rectangle 的左上角

d - 一個 Dimension，表示 Rectangle 的寬度和高度

Rectangle

public Rectangle(Point p)

建構一個新的 Rectangle，其左上角是指定的 Point，其寬度和高度均為 0。

參數：

p - 一個 Point，它是 Rectangle 左上角的頂點

Rectangle

public Rectangle(Dimension d)

建構一個新的 Rectangle，其左上角為 (0,0)，其寬度和高度由 Dimension 參數指定。

參數：

d - 一個 Dimension，用於指定寬度和高度

方法詳細資訊

getX

public double getX()

以 double 精度返回邊界 Rectangle 的 X 坐標。

指定者：

類別 RectangularShape 中的 getX

返回：

邊界 Rectangle 的 X 坐標。

getY

public double getY()

以 double 精度返回邊界 Rectangle 的 Y 坐標。

指定者：

類別 RectangularShape 中的 getY

返回：

邊界 Rectangle 的 Y 坐標。

getWidth

public double getWidth()

以 double 精度返回邊界 Rectangle 的寬度。

指定者：

類別 RectangularShape 中的 getWidth

返回：

邊界 Rectangle 的寬度。

getHeight

public double getHeight()

以 double 精度返回邊界 Rectangle 的高度。

指定者：

類別 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 的最小邊界框，只保證 Shape 完全位於指示的 Rectangle2D 中。此方法返回的邊界框通常比 getBounds 方法返回的更緊密，而且永遠不會因為溢位問題而出錯，因為返回值可以是一個使用雙精度值存儲尺寸的 Rectangle2D 實例。

指定者：

介面 Shape 中的 getBounds2D

覆寫：

類別 Rectangle2D 中的 getBounds2D

返回：

一個 Rectangle2D 實例，它是 Shape 的高精度邊界框。

從以下版本開始：

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 坐標

此 - Rectangle 左上角的新 Y 坐標

width - 此 Rectangle 的新寬度

height - 此 Rectangle 的新高度

getLocation

public Point getLocation()

返回此 Rectangle 的位置。

包含此方法是出於完整性考慮，以對應 Component 的 getLocation 方法。

返回：

一個 Point，它是此 Rectangle 左上角的頂點。

從以下版本開始：

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 坐標

translate

public void translate(int dx,
                      int dy)

將此 Rectangle 沿 X 坐標軸向右，沿 Y 坐標軸向下平移指定距離。

參數：

dx - 沿 X 軸移動此 Rectangle 的距離

dy - 沿 Y 軸移動此 Rectangle 的距離

另請參見：

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

getSize

public Dimension getSize()

獲取此 Rectangle 的大小，用返回的 Dimension 表示。

包含此方法是出於完整性考慮，以對應 Component 的 getSize 方法。

返回：

一個 Dimension，表示此 Rectangle 的大小。

從以下版本開始：

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)

檢查此 Rectangle 是否完全包含位於指定位置 (X,Y) 且具有指定維數 (W,H) 的 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 相交。如果兩個矩形的交集為非空(null)，則它們是相交的。

參數：

r - 指定的 Rectangle

返回：

如果指定的 Rectangle 與此 Rectangle 相交，則返回 true；否則返回 false。

intersection

public Rectangle intersection(Rectangle r)

計算此 Rectangle 與指定 Rectangle 的交集。返回一個新的 Rectangle，它表示兩個矩形的交集。如果兩個矩形沒有相交，則結果將是一個空矩形。

參數：

r - 指定的 Rectangle

返回：

同時包含在指定 Rectangle 和此 Rectangle 中的最大 Rectangle；如果這些矩形沒有相交，則返回一個空矩形。

union

public Rectangle union(Rectangle r)

計算此 Rectangle 與指定 Rectangle 的並集。返回一個新的 Rectangle，它表示兩個矩形的並集。

如果兩個 Rectangle 的任何維數小於 0，則應用針對不存在矩形的規則。如果只有一個維數小於 0，那麼結果將是另一個 Rectangle 的副本。如果兩個維數都小於 0，則結果中將至少有一個維數小於 0。

如果得到的 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。對於 Rectangl 右邊和底部邊界線上的點，econtains 方法不返回 true。所以，如果添加的點落在放大的 Rectangle 右邊和底部邊界線上，則 contains 將針對該點返回 false。如果指定的點必須包含在新 Rectangle 中，則應添加 1x1 矩形：

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。對於 Rectangl 右邊和底部邊界線上的點，econtains 方法不返回 true。所以，如果添加的 Point 落在放大的 Rectangle 右邊和底部邊界線上，則 contains 將針對該 Point 返回 false。如果指定的點必須包含在新 Rectangle 中，則應添加 1x1 矩形：

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

參數：

pt - 添加到此 Rectangle 中的新 Point

add

public void add(Rectangle r)

將一個 Rectangle 添加到此 Rectangle 中。得到的 Rectangle 是兩個矩形的並集。

如果任何一個 Rectangle 任何維數小於 0，則結果將是另一個 Rectangle 的維數。如果兩個 Rectangle 都至少有一個維數小於 0，則結果中至少有一個維數小於 0。

如果任何一個 Rectangle 中有一個或兩個維數等於 0，則沿那些軸具有 0 維數的結果將等同於通過將相應原坐標添加到沿該軸的結果矩形中所獲得的結果，這類似於 add(Point) 方法的操作，但沒有超過該坐標的維數。

如果得到的 Rectangle 維數太大而無法表示為 int，則結果中將沿該維數有一個為 Integer.MAX_VALUE 的維數。

參數：

r - 指定的 Rectangle

grow

public void grow(int h,
                 int v)

在水平方向和垂直方向上同時調整 Rectangle 的大小。

此方法修改 Rectangle，使它左邊和右邊都增加 h 個單位，頂部和底部都增加 v 個單位。

新的 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 的位置。此方法計算適當遮罩碼值的二進制或 (OR)，這些遮罩碼值針對此 Rectangle2D 的每個邊指示指定坐標是否在此 Rectangle2D 其餘邊緣的同一側。

指定者：

類別 Rectangle2D 中的 outcode

參數：

x - 指定的 X 坐標

y - 指定的 Y 坐標

返回：

所有適當外碼的邏輯或。

從以下版本開始：

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 - 與此 Rectangle2D 相交的 Rectangle2D

返回：

同時被指定 Rectangle2D 和此 Rectangle2D 套件含的最大 Rectangle2D。

從以下版本開始：

1.2

createUnion

public Rectangle2D createUnion(Rectangle2D r)

返回一個新的 Rectangle2D 物件，它表示此 Rectangle2D 與指定 Rectangle2D 的並集。

指定者：

類別 Rectangle2D 中的 createUnion

參數：

r - 與此 Rectangle2D 合併的 Rectangle2D

返回：

包含指定 Rectangle2D 和此 Rectangle2D 的最小 Rectangle2D。

從以下版本開始：

1.2

equals

public boolean equals(Object obj)

檢查兩個矩形是否相等。

當且僅當參數不是 null，而是一個與此 Rectangle 具有相同左上角、寬度和高度的 Rectangle 物件時，結果才為 true。

覆寫：

類別 Rectangle2D 中的 equals

參數：

obj - 要與此 Rectangle 進行比較的 Object

返回：

如果物件相等，則返回 true；否則返回 false。

另請參見：

Object.hashCode(), Hashtable

toString

public String toString()

返回表示此 Rectangle 及其值的 String。

覆寫：

類別 Object 中的 toString

返回：

表示此 Rectangle 物件的坐標和大小值的 String。