java.awt.geom
クラス RectangularShape

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

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

Shape, Cloneable

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

Arc2D, Ellipse2D, Rectangle2D, RoundRectangle2D

public abstract class RectangularShape
extends Object
implements Shape, Cloneable

RectangularShape は、幾何学的図形が矩形フレームによって定義される多くの Shape オブジェクトの基底クラスです。このクラスは、それ自体で特定の幾何学的図形を直接に指定せず、単にすべての Shape オブジェクトの全カテゴリによって継承される操作メソッドを提供します。このクラスが提供する操作メソッドを使用すると、サブクラスがその幾何学的図形を定義するための参照を提供する矩形フレームを問い合わせたり、変更したりできます。

導入されたバージョン:

1.2

コンストラクタの概要

protected

RectangularShape() これは、インスタンスを直接には生成できない abstract クラスです。

メソッドの概要

Object	clone() このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
boolean	contains(Point2D p) 指定された Point2D が Shape の境界内にあるかどうかを判定します。
boolean	contains(Rectangle2D r) Shape の内部が、指定された Rectangle2D を完全に内包するかどうかを判定します。
Rectangle	getBounds() Shape を完全に囲む整数型の Rectangle を返します。
double	getCenterX() Shape の表示枠矩形の中心の X 座標を double 精度で返します。
double	getCenterY() Shape の表示枠矩形の中心の Y 座標を double 精度で返します。
Rectangle2D	getFrame() このオブジェクトの形状全体を定義する表示枠 Rectangle2D を返します。
abstract double	getHeight() 表示枠矩形の高さを double 精度で返します。
double	getMaxX() Shape の表示枠矩形の最大の X 座標を double 精度で返します。
double	getMaxY() Shape の表示枠矩形の最大の Y 座標を double 精度で返します。
double	getMinX() Shape の表示枠矩形の最小の X 座標を double 精度で返します。
double	getMinY() Shape の表示枠矩形の最小の Y 座標を double 精度で返します。
PathIterator	getPathIterator(AffineTransform at, double flatness) Shape オブジェクトの境界に沿って繰り返し処理する反復子オブジェクトを返し、Shape オブジェクトの幾何学的図形の輪郭の平坦化されたビューへのアクセスを提供します。
abstract double	getWidth() 表示枠矩形の幅を double 精度で返します。
abstract double	getX() 表示枠矩形の左上隅の X 座標を double 精度で返します。
abstract double	getY() 表示枠矩形の左上隅の Y 座標を double 精度で返します。
boolean	intersects(Rectangle2D r) Shape の内部が、指定された Rectangle2D の内部と交差するかどうかを判定します。
abstract boolean	isEmpty() RectangularShape が空かどうかを判定します。
abstract void	setFrame(double x, double y, double w, double h) この Shape の表示枠矩形の位置とサイズを、指定された矩形値に設定します。
void	setFrame(Point2D loc, Dimension2D size) この Shape の表示枠矩形の位置とサイズを、それぞれ指定された Point2D と Dimension2D に設定します。
void	setFrame(Rectangle2D r) この Shape の表示枠矩形を、指定された Rectangle2D に設定します。
void	setFrameFromCenter(double centerX, double centerY, double cornerX, double cornerY) この Shape の表示枠矩形を、指定された中心点および角の点の座標に基づいて設定します。
void	setFrameFromCenter(Point2D center, Point2D corner) この Shape の表示枠矩形を、中心を表す Point2D および角を表す Point2D に基づいて設定します。
void	setFrameFromDiagonal(double x1, double y1, double x2, double y2) この Shape の表示枠矩形の対角線を、指定された 2 つの座標に基づいて設定します。
void	setFrameFromDiagonal(Point2D p1, Point2D p2) この Shape の表示枠矩形の対角線を、指定された 2 つの Point2D オブジェクトに基づいて設定します。

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

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

contains, contains, getBounds2D, getPathIterator, intersects

コンストラクタの詳細

RectangularShape

protected RectangularShape()

これは、インスタンスを直接には生成できない abstract クラスです。

導入されたバージョン:

1.2

関連項目:

Arc2D, Ellipse2D, Rectangle2D, RoundRectangle2D

メソッドの詳細

getX

public abstract double getX()

表示枠矩形の左上隅の X 座標を double 精度で返します。

戻り値:

表示枠矩形の左上隅の X 座標

導入されたバージョン:

1.2

getY

public abstract double getY()

表示枠矩形の左上隅の Y 座標を double 精度で返します。

戻り値:

表示枠矩形の左上隅の Y 座標

導入されたバージョン:

1.2

getWidth

public abstract double getWidth()

表示枠矩形の幅を double 精度で返します。

戻り値:

表示枠矩形の幅

導入されたバージョン:

1.2

getHeight

public abstract double getHeight()

表示枠矩形の高さを double 精度で返します。

戻り値:

表示枠矩形の高さ

導入されたバージョン:

1.2

getMinX

public double getMinX()

Shape の表示枠矩形の最小の X 座標を double 精度で返します。

戻り値:

Shape の表示枠矩形の最小の X 座標

導入されたバージョン:

1.2

getMinY

public double getMinY()

Shape の表示枠矩形の最小の Y 座標を double 精度で返します。

戻り値:

Shape の表示枠矩形の最小の Y 座標

導入されたバージョン:

1.2

getMaxX

public double getMaxX()

Shape の表示枠矩形の最大の X 座標を double 精度で返します。

戻り値:

Shape の表示枠矩形の最大の X 座標

導入されたバージョン:

1.2

getMaxY

public double getMaxY()

Shape の表示枠矩形の最大の Y 座標を double 精度で返します。

戻り値:

Shape の表示枠矩形の最大の Y 座標

導入されたバージョン:

1.2

getCenterX

public double getCenterX()

Shape の表示枠矩形の中心の X 座標を double 精度で返します。

戻り値:

Shape の表示枠矩形の中心の X 座標

導入されたバージョン:

1.2

getCenterY

public double getCenterY()

Shape の表示枠矩形の中心の Y 座標を double 精度で返します。

戻り値:

Shape の表示枠矩形の中心の Y 座標

導入されたバージョン:

1.2

getFrame

public Rectangle2D getFrame()

このオブジェクトの形状全体を定義する表示枠 Rectangle2D を返します。

戻り値:

double 型の座標で指定された Rectangle2D

導入されたバージョン:

1.2

関連項目:

setFrame(double, double, double, double), setFrame(Point2D, Dimension2D), setFrame(Rectangle2D)

isEmpty

public abstract boolean isEmpty()

RectangularShape が空かどうかを判定します。空の場合は、RectangularShape に領域はありません。

戻り値:

RectangularShape が空である場合は true、そうでない場合は false

導入されたバージョン:

1.2

setFrame

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

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

パラメータ:

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

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

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

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

導入されたバージョン:

1.2

関連項目:

getFrame()

setFrame

public void setFrame(Point2D loc,
                     Dimension2D size)

この Shape の表示枠矩形の位置とサイズを、それぞれ指定された Point2D と Dimension2D に設定します。表示枠矩形は、RectangularShape のサブクラスが幾何学的図形を定義するために使用します。

パラメータ:

loc - 指定された Point2D

size - 指定された Dimension2D

導入されたバージョン:

1.2

関連項目:

getFrame()

setFrame

public void setFrame(Rectangle2D r)

この Shape の表示枠矩形を、指定された Rectangle2D に設定します。表示枠矩形は、RectangularShape のサブクラスが幾何学的図形を定義するために使用します。

パラメータ:

r - 指定された Rectangle2D

導入されたバージョン:

1.2

関連項目:

getFrame()

setFrameFromDiagonal

public void setFrameFromDiagonal(double x1,
                                 double y1,
                                 double x2,
                                 double y2)

この Shape の表示枠矩形の対角線を、指定された 2 つの座標に基づいて設定します。表示枠矩形は、RectangularShape のサブクラスが幾何学的図形を定義するために使用します。

パラメータ:

x1 - 指定された対角線の始点の X 座標

y1 - 指定された対角線の始点の Y 座標

x2 - 指定された対角線の終点の X 座標

y2 - 指定された対角線の終点の Y 座標

導入されたバージョン:

1.2

setFrameFromDiagonal

public void setFrameFromDiagonal(Point2D p1,
                                 Point2D p2)

この Shape の表示枠矩形の対角線を、指定された 2 つの Point2D オブジェクトに基づいて設定します。表示枠矩形は、RectangularShape のサブクラスが幾何学的図形を定義するために使用します。

パラメータ:

p1 - 指定された対角線の始点を表す Point2D

p2 - 指定された対角線の終点を表す Point2D

導入されたバージョン:

1.2

setFrameFromCenter

public void setFrameFromCenter(double centerX,
                               double centerY,
                               double cornerX,
                               double cornerY)

この Shape の表示枠矩形を、指定された中心点および角の点の座標に基づいて設定します。表示枠矩形は、RectangularShape のサブクラスが幾何学的図形を定義するために使用します。

パラメータ:

centerX - 指定された中心点の X 座標

centerY - 指定された中心点の Y 座標

cornerX - 指定された角の点の X 座標

cornerY - 指定された角の点の Y 座標

導入されたバージョン:

1.2

setFrameFromCenter

public void setFrameFromCenter(Point2D center,
                               Point2D corner)

この Shape の表示枠矩形を、中心を表す Point2D および角を表す Point2D に基づいて設定します。表示枠矩形は、RectangularShape のサブクラスが幾何学的図形を定義するために使用します。

パラメータ:

center - 指定された中心の Point2D

corner - 指定された角の Point2D

導入されたバージョン:

1.2

contains

public boolean contains(Point2D p)

指定された Point2D が Shape の境界内にあるかどうかを判定します。

定義:

インタフェース Shape 内の contains

パラメータ:

p - 判定対象の、指定された Point2D

戻り値:

指定された Point2D が Shape の境界内にある場合は true、そうでない場合は false

導入されたバージョン:

1.2

intersects

public boolean intersects(Rectangle2D r)

Shape の内部が、指定された Rectangle2D の内部と交差するかどうかを判定します。Shape.intersects() メソッドを使用すると、次のような場合に Shape 実装は true を返すことがあります。

• Rectangle2D と Shape が交差する可能性が高いが、
• この共通部分を正確に判断する計算の負荷がかなり大きい

つまり、Shape によっては、Rectangle2D が Shape と交差しない場合でもこのメソッドが true を返すことがあります。Area クラスは、ほとんどの Shape オブジェクトの幾何学的な共通部分のより精密な計算を行うため、より正確な結果が必要な場合に使用できます。

定義:

インタフェース Shape 内の intersects

パラメータ:

r - 指定された Rectangle2D

戻り値:

Shape の内部領域と指定された Rectangle2D の内部領域が交差する場合、または交差する可能性が高いが、負荷が大き過ぎて共通部分の計算を行えない場合は true、そうでない場合は false

導入されたバージョン:

1.2

関連項目:

Shape.intersects(double, double, double, double)

contains

public boolean contains(Rectangle2D r)

Shape の内部が、指定された Rectangle2D を完全に内包するかどうかを判定します。Shape.contains() メソッドを使用すると、次のような場合に Shape 実装は false を返すことがあります。

• intersect メソッドが true を返し、
• Shape が Rectangle2D を完全に包含するかどうかを判断する計算の負荷が大きい

つまり、Shape によっては、Shape が Rectangle2D を包含する場合でもこのメソッドが false を返すことがあります。Area クラスは、ほとんどの Shape オブジェクトのより精密な幾何学的計算を行うため、より正確な結果が必要な場合に使用できます。

定義:

インタフェース Shape 内の contains

パラメータ:

r - 指定された Rectangle2D

戻り値:

Shape の内部領域が、Rectangle2D を完全に包含する場合は true、そうでない場合は false。また、Shape が Rectangle2D を包含し、intersects メソッドが true を返し、負荷が大き過ぎて包含の計算が行えない場合も false

導入されたバージョン:

1.2

関連項目:

Shape.contains(double, double, double, double)

getBounds

public Rectangle getBounds()

Shape を完全に囲む整数型の Rectangle を返します。返された Rectangle が Shape を囲む最小のバウンディングボックスであるとは限りません。 示された Rectangle 内に Shape が完全に収まるというだけです。また、Shape が整数型の制限範囲を超える場合、返された Rectangle は Shape を完全に囲むことができないこともあります。通常は、getBounds2D メソッドの方が、表現の自由度が高いために、比較的ぴったりしたバウンディングボックスを返します。

定義:

インタフェース Shape 内の getBounds

戻り値:

Shape を完全に囲む整数型の Rectangle

導入されたバージョン:

1.2

関連項目:

Shape.getBounds2D()

getPathIterator

public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)

Shape オブジェクトの境界に沿って繰り返し処理する反復子オブジェクトを返し、Shape オブジェクトの幾何学的図形の輪郭の平坦化されたビューへのアクセスを提供します。

反復子によって返されるのは、SEG_MOVETO、SEG_LINETO、および SEG_CLOSE のポイントの型だけです。

曲線セグメントの分割の量は、平坦化されない変換を受けた曲線上の点が、返される平坦化されたパスセグメントからもっとも離れる距離を指定する flatness パラメータによって制御されます。任意で AffineTransform を指定でき、その場合は繰り返し処理で返される座標はそれに応じて変換されます。

定義:

インタフェース Shape 内の getPathIterator

パラメータ:

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

flatness - 曲線セグメントを近似するために使用されるラインセグメントが、元の曲線上の任意の点から離れることができる最大の距離

戻り値:

Shape オブジェクトの平坦化された幾何学的図形へのアクセスを提供する PathIterator オブジェクト

導入されたバージョン:

1.2

clone

public Object clone()

このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。

オーバーライド:

クラス Object 内の clone

戻り値:

このインスタンスの複製

例外:

OutOfMemoryError - 十分なメモリがない場合

導入されたバージョン:

1.2

関連項目:

Cloneable