Rectangle2D类参考

矩形类。 更多...

所有成员的列表。

公有成员

(id) - init
 构造一个新的 Rectangle2D 对象，其坐标值均为 -1.7976931348623157e+308。
(id) - initWithRectangle2D:
 根据给定的 Rectangle2D 对象构造一个与其完全相同的新对象。
(id) - initWithLeftBottom:Width:Height:
 根据指定的参数来构造一个 Rectangle2D 的新对象。
(id) - initWithLeftBottom:RightTop:
 根据指定的参数来构造一个 Rectangle2D 的新对象。
(id) - initWithPoint2D:Size2D:
 根据指定的参数来构造一个 Rectangle2D 的新对象。
(id) - initWith:bottom:right:top:
 根据指定的参数来构造一个 Rectangle2D 的新对象。
(BOOL) - isEmpty
 判断此矩形对象是否为空，即其左边界坐标值、下边界坐标值、右边界坐标值和上边界坐标值是否都为 -1.7976931348623157e+308。关于默认零值判断精度的详细信息请参见 Environment 类。
(Rectangle2D *) - clone
 返回当前 Rectangle2D 对象的一个拷贝。
(BOOL) - containsPoint2D:
 判定指定的点是否包含在此矩形内。当点在矩形内部和边界上时，均认为其包含在矩形内。
(BOOL) - containsRectangle2D:
 判定指定的矩形区域是否完全包含在此矩形内。当指定矩形在此矩形内部，或与此矩形重合时，均认为其完全包含在此矩形内。
(BOOL) - containsX:Y:
 判定指定坐标构成的点是否包含在此矩形内。当点在矩形内部和边界上时，均认为其包含在矩形内。
(BOOL) - equalsID:
 重写基类的equals方法
(BOOL) - equalsRectangle2D:
 判定此矩形对象是否与指定的矩形对象相等，即有相同的边界坐标值。注意其判定精度为零值判断精度。关于更多零值判断精度的信息，请参见 Environment 类。
(void) - inflateX:Y:
 该方法在垂直和水平方向对此矩形进行缩放。
(void) - intersect:
 用此矩形与指定矩形的交集替换此矩形。若此矩形与指定矩形没有交集，此矩形将变为一个空矩形对象。
(BOOL) - hasIntersection:
 判断此矩形与指定矩形是否有交集。当此矩形与指定的矩形有公共点或公共边时，认为其有交集。
(void) - offsetX:Y:
 此方法将此矩形在 x 方向平移 x，在y方向平移 y。
(void) - unions:
 用包含此矩形与指定矩形并集的最小矩形替换此矩形。
(void) - setEmpty
 设置一个空的矩形对象，其左边界坐标值、下边界坐标值、右边界坐标值和上边界坐标值均为 -1.7976931348623157e+308。
(NSString *) - toJson
 将矩形对象转换为JSON串。

静态公有成员

(Rectangle2D *) + getEmpty
 返回一个空的矩形对象，其左边界坐标值、下边界坐标值、右边界坐标值和上边界坐标值均为 -1.7976931348623157e+308。
(Rectangle2D *) + ceiling:
 分别取大于或等于指定矩形对象的左边界的 X 坐标，上边界的 Y 坐标，右边界的 X 坐标和下边界的 Y 坐标的最小整数值，并以这些整数值构造一个新的矩形对象返回。
(Rectangle2D *) + floor:
 返回一个矩形对象，其左边界的 X 坐标，上边界的 Y 坐标，右边界的 X 坐标和下边界的 Y 坐标值是不大于指定矩形对象相应坐标值的最大整数值。
(Rectangle2D *) + round:
 对指定矩形对象的左边界的 X 坐标，上边界的 Y 坐标，右边界的 X 坐标和下边界的 Y 坐标值进行四舍五入处理，并以这些整数值构造一个新的矩形对象返回。

属性

double left
 获取或设置此矩形对象左边界的坐标值。
double right
 获取或设置此矩形对象右边界的坐标值。
double top
 获取或设置此矩形对象上边界的坐标值。
double bottom
 获取或设置此矩形对象下边界的坐标值。
double width
 获取此矩形对象的宽度，其值为右边界坐标值与左边界值之差。
double height
 获取此矩形对象的高度，其值为上边界坐标值与下边界坐标值之差。
Point2D * center
 获取矩形对象的中心点，其 x 坐标值为（左边界坐标值+右边界坐标值）/2，y 坐标值为（上边界坐标值+下边界坐标值）/2。

详细描述

矩形类。

用来表示坐标值为双精度的矩形对象，即其左边界坐标值、下边界坐标值、右边界坐标值、上边界坐标值均为双精度类型，其中左边界坐标值小于等于右边界坐标值，下边界坐标值小于等于上边界坐标值。

该类的对象通常用于确定范围，可用来表示几何对象的最小外接矩形、地图窗口的可视范围，数据集的范围等，另外在进行矩形选择，矩形查询等时也会用到此类的对象。

最通常的构造矩形对象的方法为用指定的左边界坐标值、下边界坐标值、右边界坐标值、上边界坐标值来构造；使用默认构造函数构造矩形对象为一个空对象，即左边界坐标值、下边界坐标值、右边界坐标值和上边界坐标值均为 -1.7976931348623157e+308，另外还可以通过给定左下角点和右上角点的方式，以及给定左下角点和矩形宽度和高度的方式来构造新的矩形对象。

该类提供了与矩形对象相关的关系的判断，以及返回矩形对象之间的交集和并集的方法。使用该类提供的方法，您还可以对矩形对象进行缩放和平移，以及对已有矩形对象的边界坐标值采用某种取整方法来返回边界坐标值为整数的新的矩形对象。

成员函数文档

+ (Rectangle2D *) ceiling: (Rectangle2D *)  rectangle2D  

分别取大于或等于指定矩形对象的左边界的 X 坐标，上边界的 Y 坐标，右边界的 X 坐标和下边界的 Y 坐标的最小整数值，并以这些整数值构造一个新的矩形对象返回。

参数:
rectangle2D 要转换的 Rectanlge2D。
返回:
此方法转换得到的 Rectangle2D。
- (Rectangle2D *) clone  

返回当前 Rectangle2D 对象的一个拷贝。

返回:
通过克隆操作得到的 Rectangle2D 对象。
- (BOOL) containsPoint2D: (Point2D *)  point2D  

判定指定的点是否包含在此矩形内。当点在矩形内部和边界上时，均认为其包含在矩形内。

参数:
point2D 要测试的 Point2D。
返回:
如果指定的点在此矩形内部和边界上时，此方法将返回 true；否则将返回 false。
- (BOOL) containsRectangle2D: (Rectangle2D *)  rectangle2D  

判定指定的矩形区域是否完全包含在此矩形内。当指定矩形在此矩形内部，或与此矩形重合时，均认为其完全包含在此矩形内。

参数:
rectangle2D 要测试的 Rectangle2D。
返回:
如果指定的矩形在此矩形内部，或与此矩形重合时， 此方法将返回 true；否则将返回 false。
- (BOOL) containsX: (double)  x
Y: (double)  y 

判定指定坐标构成的点是否包含在此矩形内。当点在矩形内部和边界上时，均认为其包含在矩形内。

参数:
x 要测试的 X 坐标。
y 要测试的 Y 坐标。
返回:
如果指定坐标构成的点在此矩形内部和边界上时，此方法将返回 true；否则将返回 false。
- (BOOL) equalsID: (id)  obj  

重写基类的equals方法

参数:
obj Object
返回:
boolean
- (BOOL) equalsRectangle2D: (Rectangle2D *)  rectangle2D  

判定此矩形对象是否与指定的矩形对象相等，即有相同的边界坐标值。注意其判定精度为零值判断精度。关于更多零值判断精度的信息，请参见 Environment 类。

参数:
rectangle2D 要测试的 Rectangle2D。
返回:
如果指定的矩形与此 Rectangle2D 的对应边界坐标值都相等，此方法将返回 true；否则将返回 false。
+ (Rectangle2D *) floor: (Rectangle2D *)  rectangle2D  

返回一个矩形对象，其左边界的 X 坐标，上边界的 Y 坐标，右边界的 X 坐标和下边界的 Y 坐标值是不大于指定矩形对象相应坐标值的最大整数值。

参数:
rectangle2D 要转换的 Rectangle2D。
返回:
此方法转换得到的 Rectangle2D。
+ (Rectangle2D *) getEmpty  

返回一个空的矩形对象，其左边界坐标值、下边界坐标值、右边界坐标值和上边界坐标值均为 -1.7976931348623157e+308。

返回:
一个空的 Rectangle2D 对象。
- (BOOL) hasIntersection: (Rectangle2D *)  rectangle2D  

判断此矩形与指定矩形是否有交集。当此矩形与指定的矩形有公共点或公共边时，认为其有交集。

参数:
rectangle2D 要测试的矩形。
返回:
如果两个矩形有交集,则此方法返回 true。
- (void) inflateX: (double)  x
Y: (double)  y 

该方法在垂直和水平方向对此矩形进行缩放。

新的左边界坐标值=Min(原始左边界坐标值-dx，原始右边界坐标值+dx)；

新的下边界坐标值=Min(原始上边界坐标值+dy，原始下边界坐标值-dy)；

新的右边界坐标值=Max(原始左边界坐标值-dx，原始右边界坐标值+dx)；

新的上边界坐标值=Max(原始上边界坐标值+dy，原始下边界坐标值-dy)；

参数:
x 此 Rectangle2D 结构的水平缩放量。
y 此 Rectangle2D 结构的垂直缩放量。
- (id) init  

构造一个新的 Rectangle2D 对象，其坐标值均为 -1.7976931348623157e+308。

- (id) initWith: (double)  left
bottom: (double)  bottom
right: (double)  right
top: (double)  top 

根据指定的参数来构造一个 Rectangle2D 的新对象。

参数:
left 左边界的 X 坐标。
bottom 底边的 Y 坐标。
right 右边界的 X 坐标。
top 顶边的 Y 坐标。
- (id) initWithLeftBottom: (Point2D *)  leftBottom
RightTop: (Point2D *)  rightTop 

根据指定的参数来构造一个 Rectangle2D 的新对象。

参数:
leftBottom 左下角点。
rightTop 右上角点。
- (id) initWithLeftBottom: (Point2D *)  leftBottom
Width: (double)  width
Height: (double)  height 

根据指定的参数来构造一个 Rectangle2D 的新对象。

参数:
leftBottom 矩形的左下角点坐标。
width 矩形的宽度。
height 矩形的高度。
- (id) initWithPoint2D: (Point2D *)  center
Size2D: (Size2D *)  size2D 

根据指定的参数来构造一个 Rectangle2D 的新对象。

参数:
center 指定的矩形的中心点。
size2D 指定的矩形的大小。
- (id) initWithRectangle2D: (Rectangle2D *)  rectangle2D  

根据给定的 Rectangle2D 对象构造一个与其完全相同的新对象。

参数:
rectangle2D 指定的 Rectangle2D 对象。
- (void) intersect: (Rectangle2D *)  recttangle2D  

用此矩形与指定矩形的交集替换此矩形。若此矩形与指定矩形没有交集，此矩形将变为一个空矩形对象。

参数:
recttangle2D 用其进行相交操作的矩形。
- (BOOL) isEmpty  

判断此矩形对象是否为空，即其左边界坐标值、下边界坐标值、右边界坐标值和上边界坐标值是否都为 -1.7976931348623157e+308。关于默认零值判断精度的详细信息请参见 Environment 类。

默认值为 true。

返回:
当矩形对象的左边界的 X 坐标，底边的 Y 坐标，右边界的 X 坐标和顶边的 Y 坐标均为 -1.7976931348623157e+308 时，返回 true， 否则返回 false。
- (void) offsetX: (double)  x
Y: (double)  y 

此方法将此矩形在 x 方向平移 x，在y方向平移 y。

新的左边界坐标值=原始左边界坐标值+x；

新的下边界坐标值=原始下边界坐标值+y；

新的右边界坐标值=原始右边界坐标值+x；

新的上边界坐标值=原始上边界坐标值+y。

参数:
x 水平偏移该位置的量。
y 垂直偏移该位置的量。
+ (Rectangle2D *) round: (Rectangle2D *)  rectangle2D  

对指定矩形对象的左边界的 X 坐标，上边界的 Y 坐标，右边界的 X 坐标和下边界的 Y 坐标值进行四舍五入处理，并以这些整数值构造一个新的矩形对象返回。

参数:
rectangle2D 要转换的 Rectangle2D。
返回:
此方法转换得到的 Rectangle2D。
- (void) setEmpty  

设置一个空的矩形对象，其左边界坐标值、下边界坐标值、右边界坐标值和上边界坐标值均为 -1.7976931348623157e+308。

- (NSString*) toJson  

将矩形对象转换为JSON串。

返回:
矩形对象转换成的JSON串。
- (void) unions: (Rectangle2D *)  rectangle2D  

用包含此矩形与指定矩形并集的最小矩形替换此矩形。

参数:
rectangle2D 要与当前矩形求并集的矩形。

属性文档

- (double) bottom [read, write, assign]

获取或设置此矩形对象下边界的坐标值。

默认值为 -1.7976931348623157e+308。

返回:
此矩形对象下边界的坐标值。
- (Point2D*) center [read, assign]

获取矩形对象的中心点，其 x 坐标值为（左边界坐标值+右边界坐标值）/2，y 坐标值为（上边界坐标值+下边界坐标值）/2。

默认值为 {X = -Infinity,Y = -Infinity}。

返回:
表示矩形中心点的 Point2D 对象。
- (double) height [read, assign]

获取此矩形对象的高度，其值为上边界坐标值与下边界坐标值之差。

默认值为 0。

返回:
此矩形对象的高度。
- (double) left [read, write, assign]

获取或设置此矩形对象左边界的坐标值。

默认值为 -1.79769313486232E+308。

返回:
此矩形对象左边界的坐标值。
- (double) right [read, write, assign]

获取或设置此矩形对象右边界的坐标值。

默认值为 -1.79769313486232E+308。

返回:
此矩形对象右边界的坐标值。
- (double) top [read, write, assign]

获取或设置此矩形对象上边界的坐标值。

默认值为 -1.79769313486232E+308。

返回:
此矩形对象上边界的坐标值。
- (double) width [read, assign]

获取此矩形对象的宽度，其值为右边界坐标值与左边界值之差。

默认值为 -1.79769313486232E+308。

返回:
此矩形对象的宽度。
该类的文档由以下文件生成：

版权所有©2005-2021 北京超图软件股份有限公司。保留所有权利。