java.awt.geom

クラス RoundRectangle2D

java.lang.Object

java.awt.geom.RectangularShape

java.awt.geom.RoundRectangle2D

すべての実装されたインタフェース:

Shape、Cloneable

直系の既知のサブクラス:

RoundRectangle2D.Double, RoundRectangle2D.Float

public abstract class RoundRectangle2D
extends RectangularShape

RoundRectangle2D クラスは、位置 (x,y)、サイズ (w x h)、および角を丸める弧の幅と高さで定義される丸みを付けた角を持つ矩形を定義します。

このクラスは、2D の角を丸めた矩形を格納するすべてのオブジェクトの抽象スーパークラスです。座標の実際の記憶域表現はサブクラスに委ねられます。

導入されたバージョン:

1.2

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

ネストされたクラス

修飾子と型	クラスと説明
static class	RoundRectangle2D.Double Double クラスは、すべてが double 座標で指定された、丸みを付けた角を持つ矩形を定義します。
static class	RoundRectangle2D.Float Float クラスは、すべてが float 座標で指定された、丸みを付けた角を持つ矩形を定義します。

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

コンストラクタ

修飾子	コンストラクタと説明
protected	RoundRectangle2D() これは、インスタンスを直接には生成できない abstract クラスです。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
boolean	contains(double x, double y) 指定された座標が、内側の定義によって記述された Shape の境界の内側にあるかどうかをテストします。
boolean	contains(double x, double y, double w, double h) Shape の内部に、指定された矩形領域が完全に含まれるかどうかをテストします。
boolean	equals(Object obj) 指定された Object がこの RoundRectangle2D と等しいかどうかを判定します。
abstract double	getArcHeight() 角を丸める弧の高さを返します。
abstract double	getArcWidth() 角を丸める弧の幅を返します。
PathIterator	getPathIterator(AffineTransform at) この RoundRectangle2D の境界を定義する反復オブジェクトを返します。
int	hashCode() この RoundRectangle2D のハッシュコードを返します。
boolean	intersects(double x, double y, double w, double h) Shape の内部が指定された矩形領域の内部と交差しているかどうかをテストします。
void	setFrame(double x, double y, double w, double h) この Shape の表示枠矩形の位置とサイズを、指定された矩形値に設定します。
abstract void	setRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight) この RoundRectangle2D の位置、サイズ、および角の半径を、指定された double 値に設定します。
void	setRoundRect(RoundRectangle2D rr) この RoundRectangle2D を、指定された RoundRectangle2D と同じになるように設定します。

クラス java.awt.geom.RectangularShape から継承されたメソッド

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

クラス java.lang.Object から継承されたメソッド

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

インタフェース java.awt.Shape から継承されたメソッド

getBounds2D

コンストラクタの詳細

RoundRectangle2D

protected RoundRectangle2D()

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

導入されたバージョン:

1.2

関連項目:

RoundRectangle2D.Float、RoundRectangle2D.Double

メソッドの詳細

getArcWidth

public abstract double getArcWidth()

角を丸める弧の幅を返します。

戻り値:

この RoundRectangle2D の角を丸める弧の幅。

導入されたバージョン:

1.2

getArcHeight

public abstract double getArcHeight()

角を丸める弧の高さを返します。

戻り値:

この RoundRectangle2D の角を丸める弧の高さ。

導入されたバージョン:

1.2

setRoundRect

public abstract void setRoundRect(double x,
                double y,
                double w,
                double h,
                double arcWidth,
                double arcHeight)

この RoundRectangle2D の位置、サイズ、および角の半径を、指定された double 値に設定します。

パラメータ:

x - 次の位置を設定する X 座標: RoundRectangle2D

y - 次の位置を設定する Y 座標: RoundRectangle2D

w - 次に対して設定される幅: RoundRectangle2D

h - 次に対して設定される高さ: RoundRectangle2D

arcWidth - 次の弧を設定する幅: RoundRectangle2D

arcHeight - 次の弧を設定する高さ: RoundRectangle2D

導入されたバージョン:

1.2

setRoundRect

public void setRoundRect(RoundRectangle2D rr)

この RoundRectangle2D を、指定された RoundRectangle2D と同じになるように設定します。

パラメータ:

rr - 指定されたRoundRectangle2D

導入されたバージョン:

1.2

setFrame

public void setFrame(double x,
            double y,
            double w,
            double h)

この Shape の表示枠矩形の位置とサイズを、指定された矩形値に設定します。

定義:

setFrame、クラス: RectangularShape

パラメータ:

x - 指定された矩形形状の左上隅の X 座標

y - 指定された矩形形状の左上隅の Y 座標

w - 指定された矩形形状の幅

h - 指定された矩形形状の高さ

導入されたバージョン:

1.2

関連項目:

RectangularShape.getFrame()

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)

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

パラメータ:

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

戻り値:

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

導入されたバージョン:

1.2

hashCode

public int hashCode()

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

オーバーライド:

hashCode、クラス: Object

戻り値:

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

導入されたバージョン:

1.6

関連項目:

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

equals

public boolean equals(Object obj)

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

オーバーライド:

equals、クラス: Object

パラメータ:

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

戻り値:

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

導入されたバージョン:

1.6

関連項目:

Object.hashCode()、HashMap