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

つまり、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、 そうでない場合は false。 また、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 のハッシュコードを返します。

オーバーライド:

クラス 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