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方向最小值

返回: