Class: GeometryCollection

GeometryCollection

几何对象集合类,存储在本地的 components 属性中(可作为参数传递给构造函数)。
随着新的几何图形添加到集合中,将不能被克隆,当移动几何图形时,需要指定参照物。
getArea 和 getLength 函数只能通过遍历存储几何对象的 components 数组,总计所有几何图形的面积和长度。

new GeometryCollection(components)

Usage
// 浏览器
<script type="text/javascript" src="https://iclient.supermap.io/dist/openlayers/iclient-ol.js"></script>
<script>
  new ol.supermap.Geometry.Collection(components);
  
  // 弃用的写法
  new SuperMap.Geometry.Collection(components);

</script>

// ES6 Import
import { GeometryCollection } from '@supermap/iclient-ol';

new GeometryCollection(components);

common/commontypes/geometry/Collection.js, line 8
Name Type Description
components Array.<Geometry>

几何对象数组。

Example
var point1 = new GeometryPoint(10,20);
var point2 = new GeometryPoint(30,40);
var col = new GeometryCollection([point1,point2]);

Extends

Members

boundsBounds

几何对象的范围。

componentsArray.<Geometry>

存储几何对象的数组。

componentTypesArray.<string>

components 存储的几何对象所支持的几何类型数组,为空表示类型不受限制。

idstring

几何对象的唯一标识符。

parentGeometry

父类几何对象。

SRIDnumber

投影坐标参数。通过该参数,服务器判断 Geometry 对象的坐标参考系是否与数据集相同,如果不同,则在数据入库前进行投影变换。

Example
var geometry= new Geometry();
geometry. SRID=4326;

Methods

addComponent(component, index){boolean}

common/commontypes/geometry/Collection.js, line 126

添加几何对象到集合中。如果设置了 componentTypes 类型,则添加的几何对象必须是 componentTypes 中的类型。

Name Type Description
component Geometry

待添加的几何对象。

index number 可选

几何对象插入的位置。

Returns:
Type Description
boolean 是否添加成功。

addComponents(components)

common/commontypes/geometry/Collection.js, line 109

给几何图形对象添加元素。

Name Type Description
components Array.<Geometry>

几何对象组件。

Example
var geometryCollection = new GeometryCollection();
geometryCollection.addComponents(new SuerpMap.Geometry.Point(10,10));

calculateBounds()

common/commontypes/geometry/Collection.js, line 88

通过遍历数组重新计算边界,在遍历每一子项中时调用 extend 方法。

inherited clearBounds()

common/commontypes/Geometry.js, line 85

清除几何对象的 bounds。 如果该对象有父类,也会清除父类几何对象的 bounds。

clone(){GeometryCollection}

common/commontypes/geometry/Collection.js, line 58

克隆当前几何对象。

Returns:
Type Description
GeometryCollection 克隆的几何对象集合。

destroy()

common/commontypes/geometry/Collection.js, line 48

销毁几何图形。

equals(geometry){boolean}

common/commontypes/geometry/Collection.js, line 203

判断两个几何图形是否相等。如果所有的 components 具有相同的坐标,则认为是相等的。

Name Type Description
geometry Geometry

需要判断的几何图形。

Returns:
Type Description
boolean 输入的几何图形与当前几何图形是否相等。

inherited extendBounds(newBounds)

common/commontypes/Geometry.js, line 98

扩展现有边界以包含新边界。如果尚未设置几何边界,则设置新边界。

Name Type Description
newBounds Bounds

几何对象的 bounds。

getArea(){number}

common/commontypes/geometry/Collection.js, line 190

计算几何对象的面积。注意,这个方法在 GeometryPolygon 类中需要重写。

Returns:
Type Description
number 几何图形的面积,是几何对象中所有组成部分的面积之和。

inherited getBounds(){Bounds}

common/commontypes/Geometry.js, line 113

获得几何图形的边界。如果没有设置边界,可通过计算获得。

Returns:
Type Description
Bounds 几何对象的边界。

getComponentsString(){string}

common/commontypes/geometry/Collection.js, line 75

获取 components 字符串。

Returns:
Type Description
string components 字符串。

getVertices(nodes){Array}

common/commontypes/geometry/Collection.js, line 229

返回几何对象的所有结点的列表。

Name Type Description
nodes boolean 可选

对于线来说,仅仅返回作为端点的顶点,如果设为 false,则返回非端点的顶点,如果没有设置此参数,则返回所有顶点。

Returns:
Type Description
Array 几何对象的顶点列表。

removeComponent(component){boolean}

common/commontypes/geometry/Collection.js, line 175

从集合中移除几何对象。

Name Type Description
component Geometry

要移除的几何对象。

Returns:
Type Description
boolean 几何对象是否移除成功。

removeComponents(components){boolean}

common/commontypes/geometry/Collection.js, line 157

清除几何对象。

Name Type Description
components Array.<Geometry>

需要清除的几何对象。

Returns:
Type Description
boolean 元素是否被删除。

inherited setBounds(bounds)

common/commontypes/Geometry.js, line 73

设置几何对象的 bounds。

Name Type Description
bounds Bounds

范围。