IEnvelope用法

IEnvelope是指地物的外接矩形，用来表示地物图形的大体位置和形状，一

般可用于检索地物，判断地物间的拓扑关系，可以使得检索、判断的速度加快，

因为有了IEnvelope，可以首先判断该外接矩形是否在检索范围内，而判断一个

外接矩形是比较简单的。

Envelope也称包络线，是一个矩形区域，是每个几何形体的最小外接矩形。

每个Geometry都拥有一个Envelope，包括Envelope自身。IEnv是包络线对象的

主要接口，定义了XMax、XMin、YMax、YMin、Height和Width等属性，用于

获取或设置一个存在的包络线对象的空间坐标。IEnvelope接口也提供了一些方

法，如Expand、offt、CenterAt、PutCoords等。Expand方法用于按比例缩放包

络线的范围，产生一个新的包络线对象；offt是一个偏移方法，通过一个给定

的（X，y）移动包络线；CenterAt方法则通过改变包络线的中心点来移动包络

线；PutCoords方法饿公国指定的坐标点来构造包络线。

接口的属性和方法：

IEnvelope接口的长宽属性Height和Width属性（读写，可以通过该属性获取或

设置该边框的长和宽）

IEnvelope接口的4个顶点属性UpperLeft、UpperRight、LowerLeft和LowerRight

（读写，返回IPoint类型的四个顶点，比直接获得最值坐标更加方便严谨）

IEnvelope接口的最值坐标属性XMax、XMin、YMax和YMin（读写，可以通过

该属性获取或设置该边框的四个顶点的坐标）

IEnvelope接口的CenterAt(pPoint)（方法，将这个矩形的边框移动到参数pPoint

的位置，但是其他属性不变，如它的Width和Height）

IEnvelope接口的Union(inEnvelope)（方法，将参数输入的几何边框和调用该

方法的几何边框求并集，并将结果赋值给第一个边框，即调用此方法的object）

IEnvelope接口的Interct(inEnvelope)（方法，返回与输入参数相交的区域的

几何边框，并将结果赋值给第一个边框，即调用此方法的object）

IEnvelope接口的PutCoords(XMin,YMin,XMax,YMax)（方法，将新建的一个边

框的4个极坐标设置为输入的参数）

IEnvelope接口的QueryCoords(XMin,YMin,XMax,YMax)（方法，将已有的一个

边框的4个极坐标输出到参数当中以备后用）

IEnvelope接口的Expand(dx,dy,asRatio)（方法，按照输入的dx与dy参数来放

大或者缩小当前的边框，用与对ArcMap窗体的中心放大或缩小，或者点击屏幕

获得点击点的坐标，并将中心点设置成点击点，并进行一定比例的放大或者缩小）

IEnvelope接口的Offt(X,Y)（方法，将已有的一个边框的按照输入参数的大

小来进行水平竖直的移动）

限定符和类型方法和说明

voidcenterAt(IPointcenter)

voiddefineFromPoints(intcount,IPoint[]pts)

voidexpand(doubledx,doubledy,booleanasRatio)

移动中心到指定位置，宽高不变。

根据Point数组修改矩形类。

缩放矩形类，保持矩形中心位置不变。

doublegetHeight()

IPointgetLowerLeft()

IPointgetLowerRight()

IPointgetUpperLeft()

IPointgetUpperRight()

doublegetWidth()

doublegetXMax()

doublegetXMin()

doublegetYMax()

doublegetYMin()

voidofft(doublex,doubley)

voidputCoords(doublexmin,doubleymin,doublexmax,doubleymax)

获取矩形的高度。

获取矩形的左下角坐标点

获取矩形的右下角坐标点

获取左上角坐标点

获取右上角坐标点

获取宽度

获取x方向最大值

获取x方向最小值

获取y方向最大值

获取y方向最小值

移动矩形。

设置矩形坐标。

voidputCoords(IEnvelopeenv)

voidqueryCoords(xmin,ymin,

设置矩形坐标

xmax,ymax)

得到矩形的各项值

voidtHeight(doubleheight)

voidtLowerLeft(IPointpt)

voidtLowerRight(IPointpt)

voidtUpperLeft(IPointpt)

voidtUpperRight(IPointpt)

voidtWidth(doublewidth)

voidtXMax(doublexmax)

voidtXMin(doublexmin)

voidtYMax(doubleymax)

voidtYMin(doubleymin)

voidunion(IEnvelopeinEnvelope)



设置矩形的高度。

设置左下角坐标点。

设置右下角坐标点。

设置左上角坐标点

设置右上角坐标点

设置宽度

设置x方向最大值

设置x方向最小值

设置y方向最大值

设置y方向最小值

合并矩形

centerAt

voidcenterAt(IPointcenter)

参数:

center

-新的中心点

移动中心到指定位置，宽高不变。



defineFromPoints

voiddefineFromPoints(intcount,IPoint[]pts)

参数:

countpts

-Point的个数-Point数组

根据Point数组修改矩形类。



expand

voidexpand(doubledxdoubledy,booleanasRatio)

不变。

缩放矩形类，保持矩形中心位置

参数:

dxdy

-缩放x因子。-缩放y因子。

asRatio

-按照比例缩放标志。为fal，则按照比例缩放矩形类。例如dx＝0.2，且asRatio＝fal，

则矩形宽度缩小到原来的80％。为true，则直接加上缩放因子。例如dx＝0.2，且asRatio＝true，则新矩

形宽度＝原矩形宽度－2×0.2



getHeight

doublegetHeight()



获取矩形的高度。高度

返回:

tHeight

voidtHeight(doubleheight)

设置矩形的高度。-高度

参数:

height



getLowerLeft

IPointgetLowerLeft()

获取矩形的左下角坐标点左下角坐标点

返回:



tLowerLeft

voidtLowerLeft(IPointpt)

设置左下角坐标点。-左下角坐标点

参数:

pt



getLowerRight

IPointgetLowerRight()

获取矩形的右下角坐标点左下角坐标点

返回:



tLowerRight

voidtLowerRight(IPointpt)

设置右下角坐标点。-右下角坐标点

参数:

pt



offt

voidofft(doublex,doubley)

移动矩形。

参数:

xy

-x轴方向移动分量-y轴方向移动分量



putCoords

voidputCoords(doublexmin,doubleymin，doublexmax,doubleymax)

设置矩形坐标。

参数:

xminyminxmaxymax

-最小横坐标。-最小纵坐标。-最大横坐标。-最大纵坐标。



putCoords

voidputCoords(IEnvelopeenv)

设置矩形坐标-矩形

参数:

env



queryCoords

voidqueryCoords(xmin,ymin,

atxmax,ymax)

得到矩形的各项值

参数:

xminymin

-最小横坐标，输出参数-最小纵坐标，输出参数

xmaxymax

-最大横坐标，输出参数-最大纵坐标，输出参数



union

voidunion(IEnvelopeinEnvelope)

合并矩形-矩形

参数:

inEnvelope



tUpperLeft

voidtUpperLeft(IPointpt)



设置左上角坐标点-左上角坐标点

参数:

pt

getUpperLeft

IPointgetUpperLeft()

获取左上角坐标点左上角坐标点

返回:



tUpperRight

voidtUpperRight(IPointpt)

设置右上角坐标点-右上角坐标点

参数:

pt



getUpperRight

IPointgetUpperRight()

获取右上角坐标点右上角坐标点

返回:



tWidth

voidtWidth(doublewidth)

设置宽度-宽度

参数:

width



getWidth

doublegetWidth()

获取宽度宽度

返回:



tXMax

voidtXMax(doublexmax)

设置x方向最大值-x方向最大值

参数:

xmax



getXMax

doublegetXMax()

获取x方向最大值x方向最大值

返回:



tXMin

voidtXMin(doublexmin)

设置x方向最小值-x方向最小值

参数:

xmin



getXMin

doublegetXMin()

获取x方向最小值

返回:



tYMax

voidtYMax(doubleymax)

设置y方向最大值-y方向最大值

参数:

ymax



getYMax

doublegetYMax()

获取y方向最大值



tYMin

voidtYMin(doubleymin)

设置y方向最小值-y方向最小值

参数:

ymin



getYMin

doublegetYMin()

获取y方向最小值y方向最小值

返回: