JavaTM Platform
Standard Ed. 6

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)
          指定された Point2DShape の境界内にあるかどうかを判定します。
 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 の表示枠矩形の位置とサイズを、それぞれ指定された Point2DDimension2D に設定します。
 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 の表示枠矩形の位置とサイズを、それぞれ指定された Point2DDimension2D に設定します。表示枠矩形は、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)
指定された Point2DShape の境界内にあるかどうかを判定します。

定義:
インタフェース Shape 内の contains
パラメータ:
p - 判定対象の、指定された Point2D
戻り値:
指定された Point2DShape の 境界内にある場合は true、 そうでない場合は false
導入されたバージョン:
1.2

intersects

public boolean intersects(Rectangle2D r)
Shape の内部が、指定された Rectangle2D の内部と交差するかどうかを判定します。Shape.intersects() メソッドを使用すると、次のような場合に Shape 実装は true を返すことがあります。 つまり、Shape によっては、Rectangle2DShape と交差しない場合でもこのメソッドが 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 を返すことがあります。 つまり、Shape によっては、ShapeRectangle2D を包含する場合でもこのメソッドが false を返すことがあります。Area クラスは、ほとんどの Shape オブジェクトのより精密な幾何学的計算を行うため、より正確な結果が必要な場合に使用できます。

定義:
インタフェース Shape 内の contains
パラメータ:
r - 指定された Rectangle2D
戻り値:
Shape の内部領域が、Rectangle2D を 完全に包含する場合は true、 そうでない場合は false。 また、ShapeRectangle2D を包含し、 intersects メソッドが true を返し、 負荷が大き過ぎて包含の計算が行えない場合も false
導入されたバージョン:
1.2
関連項目:
Shape.contains(double, double, double, double)

getBounds

public Rectangle getBounds()
Shape を完全に囲む整数型の Rectangle を返します。返された RectangleShape を囲む最小のバウンディングボックスであるとは限りません。 示された Rectangle 内に Shape が完全に収まるというだけです。また、Shape が整数型の制限範囲を超える場合、返された RectangleShape を完全に囲むことができないこともあります。通常は、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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。