java.awt.geom
類別 Ellipse2D

java.lang.Object
  java.awt.geom.RectangularShape
      java.awt.geom.Ellipse2D

所有已實作的介面：

Shape, Cloneable

直接已知子類別：

Ellipse2D.Double, Ellipse2D.Float

public abstract class Ellipse2D
extends RectangularShape

Ellipse2D 類別描述窗體矩形定義的橢圓。

此類別是所有存儲 2D 橢圓的物件的惟一抽象父級類別。坐標的實際存儲表示形式由子類別決定。

從以下版本開始：

1.2

巢狀類別摘要

static class	Ellipse2D.Double Double 類別以 double 精度定義橢圓。
static class	Ellipse2D.Float Float 類別以 float 精度定義橢圓。

建構子摘要

protected

Ellipse2D() 這是一個無法直接實例化的抽象類別。

方法摘要

boolean	contains(double x, double y) 測試指定坐標是否在 Shape 的邊界內。
boolean	contains(double x, double y, double w, double h) 測試 Shape 內部是否完全包含指定矩形區域。
boolean	equals(Object obj) 確定指定的 Object 是否與此 Ellipse2D 相等。
PathIterator	getPathIterator(AffineTransform at) 返回定義此 Ellipse2D 邊界的迭代物件。
int	hashCode() 返回此 Ellipse2D 的雜湊碼。
boolean	intersects(double x, double y, double w, double h) 測試 Shape 內部是否與指定矩形區域的內部相交。

從類別 java.awt.geom.RectangularShape 繼承的方法

clone, contains, contains, getBounds, getCenterX, getCenterY, getFrame, getHeight, getMaxX, getMaxY, getMinX, getMinY, getPathIterator, getWidth, getX, getY, intersects, isEmpty, setFrame, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal

從類別 java.lang.Object 繼承的方法

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

從介面 java.awt.Shape 繼承的方法

getBounds2D

建構子詳細資訊

Ellipse2D

protected Ellipse2D()

這是一個無法直接實例化的抽象類別。特定於型別的實作子類別可用於實例化，並提供用於存儲滿足以下各種存取方法所需資訊的多種格式。

從以下版本開始：

1.2

另請參見：

Ellipse2D.Float, Ellipse2D.Double

方法詳細資訊

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 相交的可能性很大，但是
• 精確確定相交的計算代價太高。

這意味著對於某些 Shape，即使矩形區域沒有與該 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 是否完全包含矩形區域的代價太高。

這意味著對於某些 Shape，即使 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)

getPathIterator

public PathIterator getPathIterator(AffineTransform at)

返回定義此 Ellipse2D 邊界的迭代物件。此類別的迭代器是多執行緒安全的，這意味著此 Ellipse2D 類別保證對此 Ellipse2D 物件幾何形狀所作的修改不會影響該幾何形狀中正在進行的迭代。

參數：

at - 一個可選的 AffineTransform，用於在迭代中返回的坐標；如果需要未轉換的坐標，則為 null

返回：

返回此 Ellipse2D 輪廓幾何形狀的 PathIterator 物件，一次一段。

從以下版本開始：

1.2

hashCode

public int hashCode()

返回此 Ellipse2D 的雜湊碼。

覆寫：

類別 Object 中的 hashCode

返回：

此 Ellipse2D 的雜湊碼。

從以下版本開始：

1.6

另請參見：

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

確定指定的 Object 是否與此 Ellipse2D 相等。如果指定的 Object 是一個 Ellipse2D 實例並且其位置和大小與此 Ellipse2D 相同，那麼該物件與此 Ellipse2D 相等。

覆寫：

類別 Object 中的 equals

參數：

obj - 將與此 Ellipse2D 進行比較的 Object。

返回：

如果 obj 是一個 Ellipse2D 實例並且具有相同的值，則返回 true；否則返回 false。

從以下版本開始：

1.6

另請參見：

Object.hashCode(), Hashtable