- java.lang.Object
-
- java.awt.geom.RectangularShape
-
- 已知直接子类:
-
Arc2D
,Ellipse2D
,Rectangle2D
,RoundRectangle2D
public abstract class RectangularShape extends Object implements Shape, Cloneable
RectangularShape
是几何由矩形框架定义的Shape
对象的基类。 这个类本身并不直接指定任何特定的几何体,而只是提供由Shape
对象的整个类别继承的操作方法。 该类提供的操作方法可用于查询和修改矩形框架,为框架子集定义几何图形提供了参考。- 从以下版本开始:
- 1.2
-
-
构造方法摘要
构造方法 Modifier Constructor 描述 protected
RectangularShape()
这是一个无法直接实例化的抽象类。
-
方法摘要
所有方法 接口方法 抽象方法 具体的方法 Modifier and Type 方法 描述 Object
clone()
创建与该对象相同的类和新内容相同的新对象。boolean
contains(Point2D p)
测试指定Point2D
是的边界内Shape
,如所描述的definition of insideness 。boolean
contains(Rectangle2D r)
测试Shape
的内部Shape
全部包含指定的Rectangle2D
。Rectangle
getBounds()
返回一个整数Rectangle
完全包围Shape
。double
getCenterX()
以double
精度Shape
double
框架矩形中心的X坐标。double
getCenterY()
以double
精度Shape
double
框架矩形中心的Y坐标。Rectangle2D
getFrame()
返回定义此对象的整体形状的框架Rectangle2D
。abstract double
getHeight()
以double
精度返回框架矩形的高度。double
getMaxX()
以double
精度返回Shape
的成帧矩形的最大X坐标。double
getMaxY()
以double
精度返回Shape
的成帧矩形的最大Y坐标。double
getMinX()
以double
精度返回Shape
的框架矩形的最小X坐标。double
getMinY()
以double
精度返回Shape
的成帧矩形的最小Y坐标。PathIterator
getPathIterator(AffineTransform at, double flatness)
返回一个迭代器对象,它沿Shape
对象的边界进行迭代,并提供对Shape
对象的几何体轮廓的平坦化视图的访问。abstract double
getWidth()
以double
精度返回成帧矩形的宽度。abstract double
getX()
以double
精度返回成帧矩形左上角的X坐标。abstract double
getY()
返回double
精度的框架矩形左上角的Y坐标。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)
根据指定的中心Point2D
和角Point2D
设置此Shape
的框架矩形。void
setFrameFromDiagonal(double x1, double y1, double x2, double y2)
基于两个指定的坐标,设置此Shape
框架矩形的对角线。void
setFrameFromDiagonal(Point2D p1, Point2D p2)
基于两个指定的Point2D
对象设置Shape
的框架矩形的对角线。-
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface java.awt.Shape
contains, contains, getBounds2D, getPathIterator, intersects
-
-
-
-
构造方法详细信息
-
RectangularShape
protected RectangularShape()
这是一个无法直接实例化的抽象类。- 从以下版本开始:
- 1.2
- 另请参见:
-
Arc2D
,Ellipse2D
,Rectangle2D
,RoundRectangle2D
-
-
方法详细信息
-
getX
public abstract double getX()
以double
精度返回成帧矩形左上角的X坐标。- 结果
- 框架矩形左上角的X坐标。
- 从以下版本开始:
- 1.2
-
getY
public abstract double getY()
以double
精度返回成帧矩形左上角的Y坐标。- 结果
- 框架矩形左上角的Y坐标。
- 从以下版本开始:
- 1.2
-
getWidth
public abstract double getWidth()
以double
精度返回成帧矩形的宽度。- 结果
- 框架矩形的宽度。
- 从以下版本开始:
- 1.2
-
getHeight
public abstract double getHeight()
以double
精度返回框架矩形的高度。- 结果
- 框架矩形的高度。
- 从以下版本开始:
- 1.2
-
getMinX
public double getMinX()
以double
精度返回Shape
的成帧矩形的最小X坐标。- 结果
-
Shape
的框架矩形的最小X坐标。 - 从以下版本开始:
- 1.2
-
getMinY
public double getMinY()
以double
精度返回Shape
的成帧矩形的最小Y坐标。- 结果
-
Shape
的框架矩形的最小Y坐标。 - 从以下版本开始:
- 1.2
-
getMaxX
public double getMaxX()
以double
精度返回Shape
的成帧矩形的最大X坐标。- 结果
-
Shape
的框架矩形的最大X坐标。 - 从以下版本开始:
- 1.2
-
getMaxY
public double getMaxY()
以double
精度返回Shape
的成帧矩形的最大Y坐标。- 结果
-
Shape
框架矩形的最大Y坐标。 - 从以下版本开始:
- 1.2
-
getCenterX
public double getCenterX()
以double
精度返回Shape
的框架矩形中心的X坐标。- 结果
-
Shape
框架矩形中心的X坐标。 - 从以下版本开始:
- 1.2
-
getCenterY
public double getCenterY()
以double
精度Shape
double
框架矩形中心的Y坐标。- 结果
-
Shape
框架矩形中心的Y坐标。 - 从以下版本开始:
- 1.2
-
getFrame
public Rectangle2D getFrame()
返回定义此对象的整体形状的框架Rectangle2D
。- 结果
-
一个
Rectangle2D
,在double
指定坐标。 - 从以下版本开始:
- 1.2
- 另请参见:
-
setFrame(double, double, double, double)
,setFrame(Point2D, Dimension2D)
,setFrame(Rectangle2D)
-
isEmpty
public abstract boolean isEmpty()
确定RectangularShape
是否为空。 当RectangularShape
为空时,它不会包围任何区域。- 结果
-
true
如果RectangularShape
是空的; 否则为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
的框架矩形的对角线。 框架矩形由RectangularShape
的子类用于定义其几何。- 参数
-
x1
- 指定对角线起始点的X坐标 -
y1
- 指定对角线起始点的Y坐标 -
x2
- 指定对角线的终点的X坐标 -
y2
- 指定对角线终点的Y坐标 - 从以下版本开始:
- 1.2
-
setFrameFromDiagonal
public void setFrameFromDiagonal(Point2D p1, Point2D p2)
基于两个指定的Point2D
对象设置Shape
的框架矩形的对角线。 框架矩形由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)
根据指定的中心Point2D
和角Point2D
设置此Shape
的框架矩形。 框架矩形由RectangularShape
的子类用于定义其几何。- 参数
-
center
- 指定中心Point2D
-
corner
- 指定的角Point2D
- 从以下版本开始:
- 1.2
-
contains
public boolean contains(Point2D p)
测试指定Point2D
是的边界内Shape
,如所描述的definition of insideness 。
-
intersects
public boolean intersects(Rectangle2D r)
测试Shape
的内部是否与指定的内部相交Rectangle2D
。Shape.intersects()
方法允许一个Shape
实现保守返回true
当:-
Rectangle2D
和Shape
相交的概率很高,但是 - 准确地确定这个交叉点的计算是非常昂贵的。
Shapes
这个方法可能会返回true
即使Rectangle2D
不与Shape
相交。Area
类对大多数Shape
对象执行几何交集的更准确的计算,因此如果需要更准确的答案,则可以使用它。- Specified by:
-
intersects
在接口Shape
- 参数
-
r
- 指定的Rectangle2D
- 结果
-
true
如果Shape
的内部和指定的Rectangle2D
的内部相交,或者两者都很可能相交,并且交叉点计算将太昂贵执行; 否则为false
。 - 从以下版本开始:
- 1.2
- 另请参见:
-
Shape.intersects(double, double, double, double)
-
-
contains
public boolean contains(Rectangle2D r)
测试Shape
的内部Shape
完全包含指定的Rectangle2D
。Shape.contains()
方法允许一个Shape
实现保守地返回false
当:-
intersect
方法返回true
和 - 确定
Shape
是否完全包含Rectangle2D
是非常昂贵的。
Shapes
这种方法也可能返回false
即使Shape
包含Rectangle2D
。Area
类比大多数Shape
对象执行更准确的几何计算,因此如果需要更精确的答案,则可以使用它。- Specified by:
-
contains
在接口Shape
- 参数
-
r
- 指定的Rectangle2D
- 结果
-
true
如果内部的Shape
完全包含Rectangle2D
;false
否则或如果Shape
包含Rectangle2D
和intersects
方法返回true
,并且包含计算将太昂贵执行。 - 从以下版本开始:
- 1.2
- 另请参见:
-
Shape.contains(double, double, double, double)
-
-
getBounds
public Rectangle getBounds()
返回一个整数Rectangle
完全包围Shape
。 请注意,不保证返回的Rectangle
是封闭的最小边界框Shape
,只表示Shape
完全在指定的范围内Rectangle
。 如果Shape
溢出整数数据类型的有限范围,则返回的Rectangle
也可能无法完全包含Shape
。getBounds2D
方法通常返回更严格的边界框,因为它具有更大的表示灵活性。需要注意的是definition of insideness可能会导致出现对的定义轮廓点的情况下
shape
可能不被认为包含在返回bounds
对象,但只有在这些点也未审议了原有的情况下shape
。如果
point
是内部shape
根据contains(point)
方法,那么它必须是内部返回Rectangle
界限根据对象contains(point)
所述的方法bounds
。 特别:shape.contains(x,y)
需要bounds.contains(x,y)
如果一个
point
不在shape
,那么它可能仍然包含在bounds
对象中:bounds.contains(x,y)
并不表示shape.contains(x,y)
- Specified by:
-
getBounds
在接口Shape
- 结果
-
整数
Rectangle
完全包围了Shape
。 - 从以下版本开始:
- 1.2
- 另请参见:
-
Shape.getBounds2D()
-
getPathIterator
public PathIterator getPathIterator(AffineTransform at, double flatness)
返回一个迭代器对象,该对象沿Shape
对象的边界进行迭代,并提供对Shape
对象的几何体轮廓的平坦化视图的访问。只有SEG_MOVETO,SEG_LINETO和SEG_CLOSE点类型将由迭代器返回。
曲线段的细分量由
flatness
参数控制,该参数指定未平坦化变换曲线上的任何点可能偏离返回的平坦化路径段的最大距离。 可以指定可选的AffineTransform
,以便相应地转换迭代中返回的坐标。- Specified by:
-
getPathIterator
在接口Shape
- 参数
-
at
- 要在迭代中返回时应用于坐标的可选AffineTransform
,如果需要未转换的坐标,null
。 -
flatness
- 用于近似曲线段的线段的最大距离允许偏离原始曲线上的任何点 - 结果
-
一个
PathIterator
对象,可以访问Shape
对象的展平几何。 - 从以下版本开始:
- 1.2
-
clone
public Object clone()
创建与该对象相同的类和新内容相同的新对象。- 重写:
-
clone
在Object
- 结果
- 这个实例的一个克隆。
- 异常
-
OutOfMemoryError
- 如果没有足够的内存 - 从以下版本开始:
- 1.2
- 另请参见:
-
Cloneable
-
-