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() これは、インスタンスを直接には生成できない abstract クラスです。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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()

これは、インスタンスを直接には生成できない abstract クラスです。インスタンス生成のためには型固有の実装サブクラスが用意されており、これらのサブクラスにより、下記の各種アクセス用メソッドに必要な情報を格納するための形式が多数提供されます。

導入されたバージョン:

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 が交差している可能性が高いが、
• この共通部分を正確に判断する計算の負荷がかなり大きい。

つまり、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)

getPathIterator

public PathIterator getPathIterator(AffineTransform at)

この Ellipse2D の境界を定義する反復オブジェクトを返します。このクラスのイテレータは、マルチスレッドに対して安全です。つまりこの Ellipse2D クラスは、この Ellipse2D オブジェクトの幾何学的図形に対する変更が、幾何学的図形についてすでに進行中の反復処理に影響を与えないことを保証します。

パラメータ:

at - 反復処理で返されるときに座標に適用されるオプションの AffineTransform、または変換されていない座標が必要な場合は null

戻り値:

この Ellipse2D の輪郭の幾何学的図形を一度に 1 セグメントずつ返す PathIterator オブジェクト。

導入されたバージョン:

1.2

hashCode

public int hashCode()

この Ellipse2D のハッシュコードを返します。

オーバーライド:

hashCode、クラス: Object

戻り値:

この Ellipse2D のハッシュコード。

導入されたバージョン:

1.6

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

指定された Object がこの Ellipse2D と等しいかどうかを判定します。指定された Object は、Ellipse2D のインスタンスであり、位置およびサイズがこの Ellipse2D と同じ場合に、この Ellipse2D と等しいと見なされます。

オーバーライド:

equals、クラス: Object

パラメータ:

obj - この Ellipse2D と比較される Object。

戻り値:

obj が Ellipse2D のインスタンスであり、同じ値を持つ場合は true、そうでない場合は false。

導入されたバージョン:

1.6

関連項目:

Object.hashCode()、HashMap